describe-load-balancer-attributes

Описание

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

Для получения дополнительной информации см.:

Атрибуты балансировщика в руководстве Руководство по балансировщикам приложений
Атрибуты балансировщика в руководстве Руководство по сетевым балансировщикам
Атрибуты балансировщика в руководстве Руководство по балансировщикам шлюзов

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

Синтаксис

  describe-load-balancer-attributes
--load-balancer-arn <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) балансировщика.

--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 (логическое значение)

Включает отладочную запись в журнал.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

json
text
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат 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 (логическое значение)

Отключить пейджер CLI для вывода.

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Для описания атрибутов балансировщика

Следующий describe-load-balancer-attributes пример отображает атрибуты указанного балансировщика.

aws elbv2 describe-load-balancer-attributes \
    --load-balancer-arn arn:aws:elasticloadbalancing:us-west-2:123456789012:loadbalancer/app/my-load-balancer/50dc6c495c0c9188

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

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

Следующий пример вывода включает атрибуты сетевого балансировщика.

{
    "Attributes": [
        {
            "Value": "false",
            "Key": "access_logs.s3.enabled"
        },
        {
            "Value": "",
            "Key": "access_logs.s3.bucket"
        },
        {
            "Value": "",
            "Key": "access_logs.s3.prefix"
        },
        {
            "Value": "false",
            "Key": "deletion_protection.enabled"
        },
        {
            "Value": "false",
            "Key": "load_balancing.cross_zone.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-процентным зональным сродством.

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

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