[ 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 (строка)
--endpoint-group-region (строка)
--endpoint-configurations (список)
Список объектов конечных точек.
(структура)
Сложная структура для конечных точек. Ресурс должен быть валидным и активным при добавлении его в качестве конечной точки.
EndpointId -> (строка)
Идентификатор конечной точки. Если конечная точка является балансировщиком сетевой нагрузки или балансировщиком приложений, это Amazon Resource Name (ARN) ресурса. Если конечная точка — это IP-адрес Elastic IP, это идентификатор выделения Elastic IP-адреса. Для экземпляров Amazon EC2 это идентификатор экземпляра EC2. Ресурс должен быть валидным и активным при добавлении его в качестве конечной точки.
Для конечных точек между аккаунтами это должен быть ARN ресурса.
Weight -> (целое число)
ClientIPPreservationEnabled -> (логическое значение)
Указывает, включена ли защита адресов клиента для конечной точки. Значение — true или false. Значение по умолчанию — true для конечных точек балансировщиков приложений.
Если значение установлено в true, адрес IP клиента сохраняется в заголовке запроса X-Forwarded-For при перемещении трафика к приложениям на конечной точке, обращенной к ускорителю.
Сохранение адресов IP клиента поддерживается в определенных регионах Amazon Web Services для конечных точек, которые являются балансировщиками приложений, экземплярами Amazon EC2 и балансировщиками сетевой нагрузки с группами безопасности. ВАЖНО: сохранение адресов IP клиентов не может использоваться с балансировщиками сетевой нагрузки с TLS-слушателями.
Дополнительную информацию см. в разделе «Сохранение адресов IP клиентов в Global Accelerator» в руководстве разработчика Global Accelerator.
AttachmentArn -> (строка)
Сокращенный синтаксис:
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 (целое число)
--health-check-protocol (строка)
Протокол, который Global Accelerator использует для проверки состояния конечных точек, входящих в эту группу конечных точек. Значение по умолчанию — TCP.
Возможные значения:
TCPHTTPHTTPS
--health-check-path (строка)
--health-check-interval-seconds (целое число)
--threshold-count (целое число)
--idempotency-token (строка)
--port-overrides (список)
Переопределяйте определенные порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в эту группу конечных точек. Например, вы можете создать переопределение порта, в котором слушатель получает трафик пользователя на портах 80 и 443, но ваш ускоритель маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.
Дополнительную информацию см. в разделе «Переопределение портов слушателя» в руководстве разработчика Global Accelerator.
(структура)
Переопределяйте определенные порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в группу конечных точек. Например, вы можете создать переопределение порта, в котором слушатель получает трафик пользователя на портах 80 и 443, но ваш ускоритель маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.
Дополнительную информацию см. в разделе «Переопределение портов слушателя» в руководстве разработчика Global Accelerator.
ListenerPort -> (целое число)
EndpointPort -> (целое число)
Сокращенный синтаксис:
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 -> (строка)
EndpointGroupRegion -> (строка)
EndpointDescriptions -> (список)
Список объектов конечных точек.
(структура)
Сложная структура для конечной точки. Каждая группа конечных точек может содержать одну или несколько конечных точек, таких как балансировщики нагрузки.
EndpointId -> (строка)
Идентификатор конечной точки. Если конечная точка является балансировщиком сети или балансировщиком приложений, это Идентификатор ресурса Amazon (ARN) ресурса. Если конечная точка является адресом Elastic IP, это идентификатор выделения адреса Elastic IP. Для экземпляров Amazon EC2 это идентификатор экземпляра EC2.
Балансировщик приложений может быть внутренним или внешним.
Weight -> (целое число)
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 -> (строка)
HealthCheckPath -> (строка)
HealthCheckIntervalSeconds -> (целое число)
ThresholdCount -> (целое число)
PortOverrides -> (список)
Позволяет переопределять порты назначения, используемые для маршрутизации трафика на конечную точку. Использование переопределения порта позволяет отображать список внешних портов назначения (на которые пользователи отправляют трафик) на список внутренних портов назначения, на которых должна получать трафик конечная точка приложения.
(структура)
Переопределяет определённые порты слушателя, используемые для маршрутизации трафика к конечным точкам, входящим в группу конечных точек. Например, можно создать переопределение порта, в котором слушатель получает трафик пользователя по портам 80 и 443, но ваш акселератор маршрутизирует этот трафик на порты 1080 и 1443 соответственно на конечных точках.
Дополнительную информацию см. в разделе «Переопределение портов слушателей» в Руководстве разработчика Global Accelerator.
ListenerPort -> (целое число)
EndpointPort -> (целое число)
© Copyright 2025, Amazon Web Services. Created using Sphinx.