[ aws . globalaccelerator ]
создать-ускоритель-с-настраиваемой-маршрутизацией
Описание
Создает ускоритель с настраиваемой маршрутизацией. Ускоритель с настраиваемой маршрутизацией направляет трафик на один из, возможно, тысяч, узлов Amazon EC2, запущенных на одном или нескольких конечных пунктах подсетей виртуальных частных облаков (VPC).
Обратите внимание, что по умолчанию все целевые экземпляры EC2 в конечном пункте VPC не могут получать трафик. Чтобы разрешить всем целевым экземплярам получать трафик или указать отдельные сопоставления портов, которые могут получать трафик, см. операцию AllowCustomRoutingTraffic.
Предупреждение
Ускоритель Global Accelerator — это глобальная служба, поддерживающая конечные точки в нескольких регионах Amazon Web Services, но для создания, обновления или работы с ускорителями необходимо указать регион США Запад (Орегон). То есть, например, укажите--region us-west-2 в командах командной строки Amazon Web Services.См. также: Документация по API AWS
Синтаксис
create-custom-routing-accelerator
--name <value>
[--ip-address-type <value>]
[--ip-addresses <value>]
[--enabled | --no-enabled]
[--idempotency-token <value>]
[--tags <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]
Параметры
--name (строка)
--ip-address-type (строка)
Тип IP-адреса, который поддерживает ускоритель. Для ускорителя с настраиваемой маршрутизацией значение должно быть IPV4.
Возможные значения:
IPV4DUAL_STACK
--ip-addresses (список)
Необязательно, если вы добавили собственный пул IP-адресов в Global Accelerator (BYOIP), вы можете выбрать IP-адрес IPv4 из своего пула для использования в качестве статического IPv4-адреса ускорителя при создании ускорителя.
После добавления диапазона адресов в Amazon Web Services он появляется в вашем аккаунте как пул адресов. При создании ускорителя вы можете назначить ему один IPv4-адрес из вашего диапазона. Global Accelerator назначит вам второй статический IPv4-адрес из диапазона адресов Amazon. Если вы добавите два диапазона IPv4-адресов в Amazon Web Services, вы можете назначить один IPv4-адрес из каждого диапазона своему ускорителю. Это ограничение связано с тем, что Global Accelerator назначает каждый диапазон адресов в разные зоны сети для высокой доступности.
Вы можете указать один или два адреса, разделенных пробелом. Не включайте суффикс /32.
Обратите внимание, что вы не можете обновить IP-адреса для существующего ускорителя. Чтобы изменить их, необходимо создать новый ускоритель с новыми адресами.
Для получения дополнительной информации см. Применение собственных IP-адресов (BYOIP) в руководстве разработчика Global Accelerator.
(строка)
Синтаксис:
"string" "string" ...
--enabled | --no-enabled (логическое значение)
Указывает, включен ли ускоритель. Значение равно true или false. Значение по умолчанию — true.
Если значение установлено в true, ускоритель не может быть удален. Если значение установлено в false, ускоритель может быть удален.
--idempotency-token (строка)
--tags (список)
Создает теги для ускорителя.
Для получения дополнительной информации см. Тегирование в Global Accelerator в руководстве разработчика Global Accelerator.
(структура)
Сложный тип, содержащий Tag ключ и Tag значение.
Ключ -> (строка)
Tag ключ.Значение -> (строка)
Tag значение.Сокращенный синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--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
- текст
- таблица
- 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 (логическое значение)
Автоматически запрашивает параметры ввода командной строки.
--no-cli-auto-prompt (логическое значение)
Отключает автоматический запрос параметров ввода командной строки.
Примеры
Примечание
Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, во всех примерах используются правила цитирования типа Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.
Для создания ускорителя с настраиваемой маршрутизацией
Следующий create-custom-routing-accelerator пример создает ускоритель с настраиваемой маршрутизацией с тегами Name и Project.
aws globalaccelerator create-custom-routing-accelerator \
--name ExampleCustomRoutingAccelerator \
--tags Key="Name",Value="Example Name" Key="Project",Value="Example Project" \
--ip-addresses 192.0.2.250 198.51.100.52
Вывод:
{
"Accelerator": {
"AcceleratorArn": "arn:aws:globalaccelerator::012345678901:accelerator/1234abcd-abcd-1234-abcd-1234abcdefgh",
"IpAddressType": "IPV4",
"Name": "ExampleCustomRoutingAccelerator",
"Enabled": true,
"Status": "IN_PROGRESS",
"IpSets": [
{
"IpAddresses": [
"192.0.2.250",
"198.51.100.52"
],
"IpFamily": "IPv4"
}
],
"DnsName":"a1234567890abcdef.awsglobalaccelerator.com",
"CreatedTime": 1542394847.0,
"LastModifiedTime": 1542394847.0
}
}
Дополнительные сведения см. в разделе Ускорители с настраиваемой маршрутизацией в AWS Global Accelerator в руководстве разработчика Global Accelerator.
Вывод
Ускоритель -> (структура)
Созданный ускоритель.
AcceleratorArn -> (строка)
Имя -> (строка)
IpAddressType -> (строка)
Включено -> (логическое)
Указывает, включен ли ускоритель. Значение равно true или false. Значение по умолчанию равно true.
Если значение установлено в true, ускоритель нельзя удалить. Если установлено в false, ускоритель можно удалить.
IpSets -> (список)
Статические IP-адреса, которые Global Accelerator ассоциирует с ускорителем.
(структура)
Сложная структура для набора IP-адресов для ускорителя.
IpFamily -> (строка)
IpAddresses -> (список)
Массив IP-адресов в наборе IP-адресов. Набор IP-адресов может содержать не более двух IP-адресов.
(строка)
IpAddressFamily -> (строка)
DnsName -> (строка)
Имя доменной системы (DNS), созданное Global Accelerator, которое указывает на статические IPv4-адреса ускорителя.
Конвенция именования для имени DNS следующая: строчная буква a, за которой следует 16-разрядная случайная шестнадцатеричная строка, за которой следует .awsglobalaccelerator.com. Например: a1234567890abcdef.awsglobalaccelerator.com.
Если у вас есть ускоритель с двойной стековой адресацией, у вас также есть второе имя DNS, DualStackDnsName , которое указывает как на запись A, так и на запись AAAA для всех четырёх статических адресов ускорителя: два IPv4-адреса и два IPv6-адреса.
Дополнительную информацию о имени DNS по умолчанию см. в разделе Поддержка адресации DNS в Global Accelerator в Руководстве разработчика Global Accelerator.
Состояние -> (строка)
CreatedTime -> (временная метка)
LastModifiedTime -> (временная метка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.