Spec-Zone.ru › AWS CLI v2

[ aws . vpc-lattice ]

update-listener

Описание

Обновляет указанный слушатель для указанной службы.

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

Синтаксис

  update-listener
--default-action <value>
--listener-identifier <value>
--service-identifier <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]

Параметры

--default-action (структура помеченных объединений)

Действие для правила по умолчанию.

Примечание

Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан: fixedResponse, forward.

fixedResponse -> (структура)

Действие фиксированного ответа. Правило возвращает пользовательский HTTP-ответ.

statusCode -> (целое число)

Код HTTP-ответа.

forward -> (структура)

Действие переадресации. Трафик, соответствующий правилу, перенаправляется на указанные группы целевых серверов.

targetGroups -> (список)

Группы целевых серверов. Трафик, соответствующий правилу, перенаправляется на указанные группы целевых серверов. При действиях переадресации можно назначить вес, который контролирует приоритет и выбор каждой группы целевых серверов. Это означает, что запросы распределяются по отдельным группам целевых серверов на основе их весов. Например, если две группы целевых серверов имеют одинаковый вес, каждая группа получает половину трафика.

Значение по умолчанию равно 1. Это означает, что если указана только одна группа целевых серверов, нет необходимости устанавливать вес; 100% трафика направляется в эту группу.

(структура)

Описание веса группы целевых серверов.

targetGroupIdentifier -> (строка)

Идентификатор или ARN группы целевых серверов.

weight -> (целое число)

Требуется только в том случае, если для действия переадресации указано несколько групп целевых серверов. Вес определяет, как запросы распределяются по группам целевых серверов. Например, если указаны две группы целевых серверов, каждая с весом 10, каждая группа получает половину запросов. Если указаны две группы целевых серверов, одна с весом 10, а другая с весом 20, группа с весом 20 получает вдвое больше запросов, чем другая группа. Если указана только одна группа, значение по умолчанию равно 100.

Синтаксис JSON:

{
  "fixedResponse": {
    "statusCode": integer
  },
  "forward": {
    "targetGroups": [
      {
        "targetGroupIdentifier": "string",
        "weight": integer
      }
      ...
    ]
  }
}

--listener-identifier (строка)

Идентификатор или ARN слушателя.

--service-identifier (строка)

Идентификатор или 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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

arn -> (строка)

Amazon Resource Name (ARN) слушателя.

defaultAction -> (структура помеченных объединений)

Действие для правила по умолчанию.

Примечание

Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан: fixedResponse, forward.

fixedResponse -> (структура)

Действие фиксированного ответа. Правило возвращает пользовательский HTTP-ответ.

statusCode -> (целое число)

Код HTTP-ответа.

forward -> (структура)

Действие переадресации. Трафик, соответствующий правилу, перенаправляется на указанные группы целевых серверов.

targetGroups -> (список)

Группы целевых серверов. Трафик, соответствующий правилу, перенаправляется на указанные группы целевых серверов. При действиях переадресации можно назначить вес, который контролирует приоритет и выбор каждой группы целевых серверов. Это означает, что запросы распределяются по отдельным группам целевых серверов на основе их весов. Например, если две группы целевых серверов имеют одинаковый вес, каждая группа получает половину трафика.

Значение по умолчанию равно 1. Это означает, что если указана только одна группа целевых серверов, нет необходимости устанавливать вес; 100% трафика направляется в эту группу.

(структура)

Описание веса группы целевых серверов.

targetGroupIdentifier -> (строка)

Идентификатор или ARN группы целевых серверов.

weight -> (целое число)

Требуется только в том случае, если для действия переадресации указано несколько групп целевых серверов. Вес определяет, как запросы распределяются по группам целевых серверов. Например, если указаны две группы целевых серверов, каждая с весом 10, каждая группа получает половину запросов. Если указаны две группы целевых серверов, одна с весом 10, а другая с весом 20, группа с весом 20 получает вдвое больше запросов, чем другая группа. Если указана только одна группа, значение по умолчанию равно 100.

id -> (строка)

Идентификатор слушателя.

name -> (строка)

Имя слушателя.

port -> (целое число)

Порт слушателя.

protocol -> (строка)

Протокол слушателя.

serviceArn -> (строка)

Amazon Resource Name (ARN) службы.

serviceId -> (строка)

Идентификатор службы.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API