изменение-атрибутов-балансировщика-нагрузки

Описание

Изменяет указанные атрибуты указанного балансировщика приложений, балансировщика сети или балансировщика шлюза.

Если какой-либо из указанных атрибутов не может быть изменён в соответствии с запросом, вызов завершается неудачно. Все существующие атрибуты, которые не изменяются, сохраняют свои текущие значения.

См. также: Документацию API AWS

Синтаксис

  modify-load-balancer-attributes
--load-balancer-arn <value>
--attributes <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--load-balancer-arn (строка)

Amazon Resource Name (ARN) балансировщика.

--attributes (список)

Атрибуты балансировщика.

(структура)

Информация об атрибуте балансировщика.

Ключ -> (строка)

Имя атрибута.

Следующие атрибуты поддерживаются всеми балансировщиками:

deletion_protection.enabled - Указывает, включена ли защита от удаления. Значение — true или false. По умолчанию — false.
load_balancing.cross_zone.enabled - Указывает, включено ли межзонное распределение нагрузки. Возможные значения — true и false. По умолчанию для балансировщиков сети и балансировщиков шлюза — false. По умолчанию для балансировщиков приложений — true и изменить его нельзя.

Следующие атрибуты поддерживаются как балансировщиками приложений, так и балансировщиками сети:

access_logs.s3.enabled - Указывает, включены ли журналы доступа. Значение — true или false. По умолчанию — false.
access_logs.s3.bucket - Имя ведра S3 для журналов доступа. Этот атрибут требуется, если включены журналы доступа. Ведро должно находиться в той же области, что и балансировщик, и иметь политику ведра, предоставляющую Elastic Load Balancing разрешения на запись в ведро.
access_logs.s3.prefix - Префикс для расположения в ведре S3 для журналов доступа.
ipv6.deny_all_igw_traffic - Блокирует доступ интернет-шлюза (IGW) к балансировщику. Устанавливается в false для балансировщиков, ориентированных на Интернет, и в true для внутренних балансировщиков, предотвращая несанкционированный доступ к вашему внутреннему балансировщику через интернет-шлюз.
zonal_shift.config.enabled - Указывает, включен ли сдвиг зоны. Возможные значения — true и false. По умолчанию — false.

Следующие атрибуты поддерживаются только балансировщиками приложений:

idle_timeout.timeout_seconds - Значение таймаута бездействия в секундах. Допустимый диапазон — 1–4000 секунд. По умолчанию — 60 секунд.
client_keep_alive.seconds - Значение сохранения соединения в секундах. Допустимый диапазон — 60–604800 секунд. По умолчанию — 3600 секунд.
connection_logs.s3.enabled - Указывает, включены ли журналы подключений. Значение — true или false. По умолчанию — false.
connection_logs.s3.bucket - Имя ведра S3 для журналов подключений. Этот атрибут требуется, если включены журналы подключений. Ведро должно находиться в той же области, что и балансировщик, и иметь политику ведра, предоставляющую Elastic Load Balancing разрешения на запись в ведро.
connection_logs.s3.prefix - Префикс для расположения в ведре S3 для журналов подключений.
routing.http.desync_mitigation_mode - Определяет, как балансировщик обрабатывает запросы, которые могут представлять угрозу безопасности для вашего приложения. Возможные значения — monitor, defensive и strictest. По умолчанию — defensive.
routing.http.drop_invalid_header_fields.enabled - Указывает, удаляет ли балансировщик HTTP-заголовки с недопустимыми полями заголовка (true) или перенаправляет их целевым узлам (false). По умолчанию — false.
routing.http.preserve_host_header.enabled - Указывает, должен ли балансировщик приложений сохранить заголовок Host в HTTP-запросе и отправить его целевому узлу без изменений. Возможные значения — true и false. По умолчанию — false.
routing.http.x_amzn_tls_version_and_cipher_suite.enabled - Указывает, добавляются ли два заголовка (x-amzn-tls-version и x-amzn-tls-cipher-suite), содержащие информацию о переговорённой версии TLS и наборе шифров, в запрос клиента перед отправкой целевому узлу. Заголовок x-amzn-tls-version содержит информацию о версии протокола TLS, согласованной с клиентом, а заголовок x-amzn-tls-cipher-suite содержит информацию о согласованном наборе шифров. Оба заголовка находятся в формате OpenSSL. Возможные значения для атрибута — true и false. По умолчанию — false.
routing.http.xff_client_port.enabled - Указывает, должен ли заголовок X-Forwarded-For сохранять исходный порт, который клиент использовал для подключения к балансировщику. Возможные значения — true и false. По умолчанию — false.
routing.http.xff_header_processing.mode - Позволяет изменять, сохранять или удалять заголовок X-Forwarded-For в HTTP-запросе перед отправкой запроса балансировщиком приложений целевому узлу. Возможные значения — append, preserve и remove. По умолчанию — append.
- Если значение — append, балансировщик приложений добавляет IP-адрес клиента (последней точки) в заголовок X-Forwarded-For в HTTP-запросе перед отправкой целевым узлам.
- Если значение — preserve, балансировщик приложений сохраняет заголовок X-Forwarded-For в HTTP-запросе и отправляет его целевым узлам без изменений.
- Если значение — remove, балансировщик приложений удаляет заголовок X-Forwarded-For в HTTP-запросе перед отправкой целевым узлам.
routing.http2.enabled - Указывает, включен ли HTTP/2. Возможные значения — true и false. По умолчанию — true. Elastic Load Balancing требует, чтобы имена заголовков сообщений содержали только буквенно-цифровые символы и дефисы.
waf.fail_open.enabled - Указывает, разрешать ли балансировщику с включенным WAF перенаправлять запросы целевым узлам, если он не может перенаправить запрос в Amazon Web Services WAF. Возможные значения — true и false. По умолчанию — false.

Следующие атрибуты поддерживаются только балансировщиками сети:

dns_record.client_routing_policy - Указывает, как трафик распределяется между зонами доступности балансировщика. Возможные значения — availability_zone_affinity с 100-процентным зональным сродством, partial_availability_zone_affinity с 85-процентным зональным сродством и any_availability_zone с 0-процентным зональным сродством.

Значение -> (строка)

Значение атрибута.

Сокращённый синтаксис:

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения перекроют значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью предоставленного значения JSON, поскольку строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, выполняет проверку входных данных команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Общие параметры

--debug (boolean)

Включить отладку логов.

--endpoint-url (string)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружаться, если этот аргумент предоставлен.

--ca-bundle (string)

Файл с набором сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и будет использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного параметра cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод пагинатора CLI.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров, необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры потребуется адаптировать к правилам цитирования вашей оболочки. См. раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.

Для включения защиты от удаления

В этом примере включена защита от удаления для указанного балансировщика нагрузки.

Команда:

aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=deletion_protection.enabled,Value=true

Вывод:

{
  "Attributes": [
      {
          "Value": "true",
          "Key": "deletion_protection.enabled"
      },
      {
          "Value": "false",
          "Key": "access_logs.s3.enabled"
      },
      {
          "Value": "60",
          "Key": "idle_timeout.timeout_seconds"
      },
      {
          "Value": "",
          "Key": "access_logs.s3.prefix"
      },
      {
          "Value": "",
          "Key": "access_logs.s3.bucket"
      }
  ]
}

Для изменения таймаута бездействия

В этом примере изменяется значение таймаута бездействия для указанного балансировщика нагрузки.

Команда:

aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=idle_timeout.timeout_seconds,Value=30

Вывод:

{
  "Attributes": [
      {
          "Value": "30",
          "Key": "idle_timeout.timeout_seconds"
      },
      {
          "Value": "false",
          "Key": "access_logs.s3.enabled"
      },
      {
          "Value": "",
          "Key": "access_logs.s3.prefix"
      },
      {
          "Value": "true",
          "Key": "deletion_protection.enabled"
      },
      {
          "Value": "",
          "Key": "access_logs.s3.bucket"
      }
  ]
}

Для включения логов доступа

В этом примере включены логи доступа для указанного балансировщика нагрузки. Обратите внимание, что ведро S3 должно существовать в том же регионе, что и балансировщик нагрузки, и должно иметь прикрепленную политику, предоставляющую доступ к службе Elastic Load Balancing.

Команда:

aws elbv2 modify-load-balancer-attributes --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188 --attributes Key=access_logs.s3.enabled,Value=true Key=access_logs.s3.bucket,Value=my-loadbalancer-logs Key=access_logs.s3.prefix,Value=myapp

Вывод:

{
  "Attributes": [
      {
          "Value": "true",
          "Key": "access_logs.s3.enabled"
      },
      {
          "Value": "my-load-balancer-logs",
          "Key": "access_logs.s3.bucket"
      },
      {
          "Value": "myapp",
          "Key": "access_logs.s3.prefix"
      },
      {
          "Value": "60",
          "Key": "idle_timeout.timeout_seconds"
      },
      {
          "Value": "false",
          "Key": "deletion_protection.enabled"
      }
  ]
}

Вывод

Атрибуты -> (список)

Информация об атрибутах балансировщика нагрузки.

(структура)

Информация об атрибуте балансировщика нагрузки.

Ключ -> (строка)

Имя атрибута.

Следующие атрибуты поддерживаются всеми балансировщиками нагрузки:

deletion_protection.enabled - Указывает, включена ли защита от удаления. Значение равно true или false. По умолчанию значение false.
load_balancing.cross_zone.enabled - Указывает, включено ли межзонное распределение нагрузки. Возможные значения: true и false. По умолчанию для балансировщиков сетевой нагрузки и шлюзовых балансировщиков — false. По умолчанию для балансировщиков прикладной нагрузки — true, и изменить его нельзя.

Следующие атрибуты поддерживаются как балансировщиками прикладной нагрузки, так и балансировщиками сетевой нагрузки:

access_logs.s3.enabled - Указывает, включены ли журналы доступа. Значение равно true или false. По умолчанию значение false.
access_logs.s3.bucket - Имя ведра S3 для журналов доступа. Этот атрибут необходим, если включены журналы доступа. Ведро должно находиться в той же области, что и балансировщик нагрузки, и иметь политику ведра, которая предоставляет Elastic Load Balancing разрешения на запись в ведро.
access_logs.s3.prefix - Префикс расположения в ведре S3 для журналов доступа.
ipv6.deny_all_igw_traffic - Блокирует доступ интернет-шлюза (IGW) к балансировщику нагрузки. Установлено в false для балансировщиков, обращенных к интернету, и в true для внутренних балансировщиков, предотвращая несанкционированный доступ к внутреннему балансировщику через интернет-шлюз.
zonal_shift.config.enabled - Указывает, включен ли сдвиг зоны. Возможные значения — true и false. По умолчанию значение false.

Следующие атрибуты поддерживаются только балансировщиками прикладной нагрузки:

idle_timeout.timeout_seconds - Значение тайм-аута бездействия в секундах. Допустимый диапазон — от 1 до 4000 секунд. По умолчанию 60 секунд.
client_keep_alive.seconds - Значение для поддержания активности клиента в секундах. Допустимый диапазон — от 60 до 604800 секунд. По умолчанию 3600 секунд.
connection_logs.s3.enabled - Указывает, включены ли журналы соединений. Значение равно true или false. По умолчанию значение false.
connection_logs.s3.bucket - Имя ведра S3 для журналов соединений. Этот атрибут необходим, если включены журналы соединений. Ведро должно находиться в той же области, что и балансировщик нагрузки, и иметь политику ведра, которая предоставляет Elastic Load Balancing разрешения на запись в ведро.
connection_logs.s3.prefix - Префикс расположения в ведре S3 для журналов соединений.
routing.http.desync_mitigation_mode - Определяет, как балансировщик нагрузки обрабатывает запросы, которые могут представлять собой угрозу безопасности для приложения. Возможные значения — monitor, defensive и strictest. По умолчанию значение defensive.
routing.http.drop_invalid_header_fields.enabled - Указывает, удаляет ли балансировщик нагрузки HTTP-заголовки с недопустимыми полями заголовка (true) или направляет их в целевые сервера (false). По умолчанию значение false.
routing.http.preserve_host_header.enabled - Указывает, должен ли балансировщик прикладной нагрузки сохранять заголовок Host в HTTP-запросе и отправлять его целевому серверу без изменений. Возможные значения — true и false. По умолчанию значение false.
routing.http.x_amzn_tls_version_and_cipher_suite.enabled - Указывает, добавляются ли два заголовка (x-amzn-tls-version и x-amzn-tls-cipher-suite), содержащие информацию о согласованной версии TLS и наборе шифров, в запрос клиента перед отправкой его целевому серверу. Заголовок x-amzn-tls-version содержит информацию о версии протокола TLS, согласованной с клиентом, а заголовок x-amzn-tls-cipher-suite — информацию о согласованном наборе шифров с клиентом. Оба заголовка в формате OpenSSL. Возможные значения атрибута — true и false. По умолчанию значение false.
routing.http.xff_client_port.enabled - Указывает, сохраняется ли заголовок X-Forwarded-For исходный порт, который клиент использовал для подключения к балансировщику нагрузки. Возможные значения — true и false. По умолчанию значение false.
routing.http.xff_header_processing.mode - Позволяет изменять, сохранять или удалять заголовок X-Forwarded-For в HTTP-запросе перед отправкой его целевому серверу балансировщиком прикладной нагрузки. Возможные значения — append, preserve и remove. По умолчанию значение append.
- Если значение равно append, балансировщик прикладной нагрузки добавляет IP-адрес клиента (последнего узла) в заголовок X-Forwarded-For в HTTP-запросе перед его отправкой целевым серверам.
- Если значение равно preserve, балансировщик прикладной нагрузки сохраняет заголовок X-Forwarded-For в HTTP-запросе и отправляет его целевым серверам без изменений.
- Если значение равно remove, балансировщик прикладной нагрузки удаляет заголовок X-Forwarded-For в HTTP-запросе перед его отправкой целевым серверам.
routing.http2.enabled - Указывает, включен ли HTTP/2. Возможные значения — true и false. По умолчанию значение true. Elastic Load Balancing требует, чтобы имена заголовков сообщений содержали только буквенно-цифровые символы и дефисы.
waf.fail_open.enabled - Указывает, разрешить ли балансировщику нагрузки с включенным WAF маршрутизацию запросов к целевым серверам, если он не может переслать запрос в Amazon Web Services WAF. Возможные значения — true и false. По умолчанию значение false.

Следующие атрибуты поддерживаются только балансировщиками сетевой нагрузки:

dns_record.client_routing_policy - Указывает, как трафик распределяется между зонами доступности балансировщика нагрузки. Возможные значения — availability_zone_affinity с 100-процентной привязкой к зоне, partial_availability_zone_affinity с 85-процентной привязкой к зоне и any_availability_zone с 0-процентной привязкой к зоне.

Значение -> (строка)

Значение атрибута.