Spec-Zone.ru › AWS CLI v2

[ aws . globalaccelerator ]

add-endpoints

Описание

Добавление конечных точек в группу конечных точек. Рекомендуемая операция API для добавления конечных точек — это операция AddEndpoints. Альтернативные варианты — добавление конечных точек при создании группы конечных точек (с помощью API CreateEndpointGroup) или при обновлении группы конечных точек (с помощью API UpdateEndpointGroup).

Существует два преимущества использования AddEndpoints для добавления конечных точек в Global Accelerator:

  • Это быстрее, поскольку Global Accelerator должен разрешать только новые конечные точки, которые вы добавляете, а не новые и существующие конечные точки.
  • Это удобнее, так как вам не нужно указывать текущие конечные точки, которые уже находятся в группе конечных точек, помимо новых конечных точек, которые вы хотите добавить.

Сведения о типах конечных точек и требованиях к конечным точкам, которые можно добавить в Global Accelerator, см. в разделе «Конечные точки для стандартных ускорителей» в руководстве разработчика Global Accelerator.

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

Синтаксис

  add-endpoints
--endpoint-configurations <value>
--endpoint-group-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]

Параметры

--endpoint-configurations (список)

Список объектов конечных точек.

(структура)

Сложный тип для конечных точек. Ресурс должен быть валидным и активным при добавлении его в качестве конечной точки.

EndpointId -> (строка)

Идентификатор конечной точки. Если конечная точка является балансировщиком сетевого трафика или балансировщиком прикладного трафика, это имя Amazon Resource Name (ARN) ресурса. Если конечная точка — это Elastic IP-адрес, это идентификатор выделения Elastic IP-адреса. Для экземпляров Amazon EC2 это идентификатор экземпляра EC2. Ресурс должен быть валидным и активным при добавлении его в качестве конечной точки.

Для конечных точек между учетными записями это должно быть ARN ресурса.

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

Вес, связанный с конечной точкой. При добавлении весов к конечным точкам вы настраиваете Global Accelerator на маршрутизацию трафика в соответствии с указанными пропорциями. Например, вы можете указать веса конечных точек 4, 5, 5 и 6 (сумма = 20). В результате 4/20 вашего трафика в среднем будет маршрутизироваться на первую конечную точку, 5/20 — на вторую и третью конечные точки, а 6/20 — на последнюю конечную точку. Дополнительные сведения см. в разделе «Веса конечных точек» в руководстве разработчика Global Accelerator.

ClientIPPreservationEnabled -> (булево значение)

Указывает, включена ли защита IP-адреса клиента для конечной точки. Значение равно true или false. Значение по умолчанию равно true для конечных точек балансировщика прикладного трафика.

Если значение равно true, IP-адрес клиента сохраняется в заголовке запроса X-Forwarded-For при перемещении трафика к приложениям на конечной точке, обращенной к ускорителю.

Защита IP-адреса клиента поддерживается в определенных регионах Amazon Web Services для конечных точек, которые являются балансировщиками прикладного трафика, экземплярами Amazon EC2 и балансировщиками сетевого трафика с группами безопасности. ВАЖНО: нельзя использовать защиту IP-адреса клиента с балансировщиками сетевого трафика с TLS-слушателями.

Дополнительные сведения см. в разделе «Сохранение IP-адресов клиентов в Global Accelerator» в руководстве разработчика Global Accelerator.

AttachmentArn -> (строка)

Идентификатор ресурса Amazon (ARN) привязки между учетными записями, которая определяет конечные точки (ресурсы), которые можно добавить к ускорителям и принципалам, имеющим разрешение на добавление конечных точек.

Сокращенная форма записи:

EndpointId=string,Weight=integer,ClientIPPreservationEnabled=boolean,AttachmentArn=string ...

Синтаксис JSON:

[
  {
    "EndpointId": "string",
    "Weight": integer,
    "ClientIPPreservationEnabled": true|false,
    "AttachmentArn": "string"
  }
  ...
]

--endpoint-group-arn (строка)

Идентификатор ресурса Amazon (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
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • авто

--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.

Вывод

EndpointDescriptions -> (список)

Список объектов конечных точек.

(структура)

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

EndpointId -> (строка)

Идентификатор конечной точки. Если конечная точка является балансировщиком сетевого трафика или балансировщиком прикладного трафика, это имя Amazon Resource Name (ARN) ресурса. Если конечная точка — это Elastic IP-адрес, это идентификатор выделения Elastic IP-адреса. Для экземпляров Amazon EC2 это идентификатор экземпляра EC2.

Балансировщик прикладного трафика может быть внутренним или внешним.

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

Вес, связанный с конечной точкой. При добавлении весов к конечным точкам вы настраиваете Global Accelerator на маршрутизацию трафика в соответствии с указанными пропорциями. Например, вы можете указать веса конечных точек 4, 5, 5 и 6 (сумма = 20). В результате 4/20 вашего трафика в среднем будет маршрутизироваться на первую конечную точку, 5/20 — на вторую и третью конечные точки, а 6/20 — на последнюю конечную точку. Дополнительные сведения см. в разделе «Веса конечных точек» в руководстве разработчика Global Accelerator.

HealthState -> (строка)

Состояние здоровья конечной точки.

HealthReason -> (строка)

Возвращает пустой результат.

ClientIPPreservationEnabled -> (булево значение)

Указывает, включена ли защита IP-адреса клиента для конечной точки. Значение равно true или false. Значение по умолчанию равно true для конечных точек балансировщика прикладного трафика.

Если значение равно true, IP-адрес клиента сохраняется в заголовке запроса X-Forwarded-For при перемещении трафика к приложениям на конечной точке, обращенной к ускорителю.

Защита IP-адреса клиента поддерживается в определенных регионах Amazon Web Services для конечных точек, которые являются балансировщиками прикладного трафика, экземплярами Amazon EC2 и балансировщиками сетевого трафика с группами безопасности. ВАЖНО: нельзя использовать защиту IP-адреса клиента с балансировщиками сетевого трафика с TLS-слушателями.

Дополнительные сведения см. в разделе «Сохранение IP-адресов клиентов в Global Accelerator» в руководстве разработчика Global Accelerator.

EndpointGroupArn -> (строка)

Идентификатор ресурса Amazon (ARN) группы конечных точек.

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

Spec-Zone.ru

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