Spec-Zone.ru › AWS CLI v2

[ aws . globalaccelerator ]

create-endpoint-group

Описание

Создайте группу конечных точек для указанного слушателя. Группа конечных точек — это набор конечных точек в одном регионе Amazon Web Services. Ресурс должен быть валидным и активным при добавлении его в качестве конечной точки.

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

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

Синтаксис

  create-endpoint-group
--listener-arn <value>
--endpoint-group-region <value>
[--endpoint-configurations <value>]
[--traffic-dial-percentage <value>]
[--health-check-port <value>]
[--health-check-protocol <value>]
[--health-check-path <value>]
[--health-check-interval-seconds <value>]
[--threshold-count <value>]
[--idempotency-token <value>]
[--port-overrides <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]

Параметры

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

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

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

Регион Amazon Web Services, в котором расположена группа конечных точек. Слушатель может содержать только одну группу конечных точек в определенном регионе.

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

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

(структура)

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

EndpointId -> (строка)

Идентификатор конечной точки. Если конечная точка является балансировщиком сетевой нагрузки или балансировщиком приложений, это Amazon Resource Name (ARN) ресурса. Если конечная точка — это IP-адрес 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 -> (логическое значение)

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

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

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

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

AttachmentArn -> (строка)

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

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

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

Синтаксис JSON:

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

--traffic-dial-percentage (число с плавающей запятой)

Процент трафика, отправляемого в регион Amazon Web Services. Дополнительный трафик распределяется по другим группам конечных точек для данного слушателя.

Используйте этот параметр для увеличения (набора) или уменьшения (сброса) трафика в определенный регион. Процент применяется к трафику, который в противном случае был бы маршрутизирован в регион на основе оптимальной маршрутизации.

Значение по умолчанию — 100.

--health-check-port (целое число)

Порт, который Global Accelerator использует для проверки состояния конечных точек, входящих в эту группу конечных точек. Порт по умолчанию — порт слушателя, с которым связана эта группа конечных точек. Если порт слушателя представляет собой список портов, Global Accelerator использует первый порт в списке.

--health-check-protocol (строка)

Протокол, который Global Accelerator использует для проверки состояния конечных точек, входящих в эту группу конечных точек. Значение по умолчанию — TCP.

Возможные значения:

  • TCP
  • HTTP
  • HTTPS

--health-check-path (строка)

Если протокол — HTTP/S, то это задает путь, который является назначением целей проверки работоспособности. Значение по умолчанию — слеш (/).

--health-check-interval-seconds (целое число)

Время — 10 секунд или 30 секунд — между каждой проверкой работоспособности конечной точки. Значение по умолчанию — 30.

--threshold-count (целое число)

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

--idempotency-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы гарантировать идемпотентность — то есть уникальность — запроса.

--port-overrides (список)

Переопределяйте определенные порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в эту группу конечных точек. Например, вы можете создать переопределение порта, в котором слушатель получает трафик пользователя на портах 80 и 443, но ваш ускоритель маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.

Дополнительную информацию см. в разделе «Переопределение портов слушателя» в руководстве разработчика Global Accelerator.

(структура)

Переопределяйте определенные порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в группу конечных точек. Например, вы можете создать переопределение порта, в котором слушатель получает трафик пользователя на портах 80 и 443, но ваш ускоритель маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.

Дополнительную информацию см. в разделе «Переопределение портов слушателя» в руководстве разработчика Global Accelerator.

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

Порт слушателя, который вы хотите сопоставить с определенным портом конечной точки. Это порт, на который трафик пользователя поступает в Global Accelerator.

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

Порт конечной точки, к которому вы хотите сопоставить порт слушателя. Это порт на конечной точке, например, балансировщике приложений или экземпляре Amazon EC2.

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

ListenerPort=integer,EndpointPort=integer ...

Синтаксис JSON:

[
  {
    "ListenerPort": integer,
    "EndpointPort": integer
  }
  ...
]

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

Примеры

Примечание

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

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

Чтобы создать группу конечных точек

Следующий create-endpoint-group пример создает группу конечных точек с одной конечной точкой.

aws globalaccelerator create-endpoint-group \
    --listener-arn arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz \
    --endpoint-group-region us-east-1 \
    --endpoint-configurations EndpointId=i-1234567890abcdef0,Weight=128

Вывод:

{
    "EndpointGroup": {
        "TrafficDialPercentage": 100.0,
        "EndpointDescriptions": [
            {
                "Weight": 128,
                "EndpointId": "i-1234567890abcdef0"
            }
        ],
        "EndpointGroupArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh/listener/0123vxyz/endpoint-group/098765zyxwvu",
        "EndpointGroupRegion": "us-east-1"
    }
}

Дополнительную информацию см. в разделе «Группы конечных точек в AWS Global Accelerator» в Руководстве разработчика AWS Global Accelerator.

Вывод

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

Информация о созданной группе конечных точек.

EndpointGroupArn -> (строка)

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

EndpointGroupRegion -> (строка)

Регион Amazon Web Services, в котором расположена группа конечных точек.

EndpointDescriptions -> (список)

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

(структура)

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

EndpointId -> (строка)

Идентификатор конечной точки. Если конечная точка является балансировщиком сети или балансировщиком приложений, это Идентификатор ресурса Amazon (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 -> (булево)

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

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

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

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

TrafficDialPercentage -> (вещественное число)

Процент трафика, направляемого в регион Amazon Web Services. Дополнительный трафик распределяется по другим группам конечных точек для данного слушателя.

Это действие позволяет увеличить (настроить) или уменьшить (снизить) трафик в определенный регион. Процент применяется к трафику, который в противном случае был бы направлен в регион на основе оптимальной маршрутизации.

Значение по умолчанию — 100.

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

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

По умолчанию используется порт слушателя, с которым связана эта группа конечных точек. Если порт слушателя является списком, Global Accelerator использует первый указанный порт из списка портов.

HealthCheckProtocol -> (строка)

Протокол, используемый Global Accelerator для проверки работоспособности конечных точек, входящих в состав данной группы конечных точек. Значение по умолчанию — TCP.

HealthCheckPath -> (строка)

Если протокол — HTTP/S, это значение задаёт путь запроса, используемый Global Accelerator для проверки работоспособности конечных точек. По умолчанию это символ косой черты (/).

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

Время (10 секунд или 30 секунд) между проверками работоспособности каждой конечной точки. Значение по умолчанию — 30.

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

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

PortOverrides -> (список)

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

(структура)

Переопределяет определённые порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в группу конечных точек. Например, можно создать переопределение порта, в котором слушатель получает трафик пользователя по портам 80 и 443, но ваш акселератор маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.

Дополнительную информацию см. в разделе «Переопределение портов слушателей» в Руководстве разработчика Global Accelerator.

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

Порт слушателя, который нужно отобразить на определенный порт конечной точки. Это порт, на который трафик пользователя приходит в Global Accelerator.

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

Порт конечной точки, на который должен отобразиться порт слушателя. Это порт на конечной точке, такой как балансировщик приложений или экземпляр Amazon EC2.

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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