создание-маршрута

Описание

Создаёт маршрут в таблице маршрутизации внутри VPC.

Вы должны указать либо блок CIDR назначения, либо идентификатор списка префиксов. Вы также должны указать ровно один из ресурсов из списка параметров.

При определении способа маршрутизации трафика мы используем маршрут с наиболее точным соответствием. Например, трафик предназначен для IPv4-адреса 192.0.2.3, а таблица маршрутизации включает следующие два IPv4-маршрута:

• 192.0.2.0/24 (маршрутизируется в некоторый целевой ресурс A)
• 192.0.2.0/28 (маршрутизируется в некоторый целевой ресурс B)

Оба маршрута применимы к трафику, предназначенному для 192.0.2.3. Однако второй маршрут в списке охватывает меньшее количество IP-адресов и, следовательно, является более специфичным, поэтому мы используем этот маршрут для определения места назначения трафика.

Дополнительную информацию о таблицах маршрутизации см. в Руководстве пользователя Amazon VPC.

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

Синтаксис

  create-route
[--destination-prefix-list-id <value>]
[--vpc-endpoint-id <value>]
[--transit-gateway-id <value>]
[--local-gateway-id <value>]
[--carrier-gateway-id <value>]
[--core-network-arn <value>]
[--dry-run | --no-dry-run]
--route-table-id <value>
[--destination-cidr-block <value>]
[--gateway-id <value>]
[--destination-ipv6-cidr-block <value>]
[--egress-only-internet-gateway-id <value>]
[--instance-id <value>]
[--network-interface-id <value>]
[--vpc-peering-connection-id <value>]
[--nat-gateway-id <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]

Параметры

--destination-prefix-list-id (строка)

--vpc-endpoint-id (строка)

--transit-gateway-id (строка)

--local-gateway-id (строка)

--carrier-gateway-id (строка)

--core-network-arn (строка)

--dry-run | --no-dry-run (булево)

--route-table-id (строка)

--destination-cidr-block (строка)

--gateway-id (строка)

--destination-ipv6-cidr-block (строка)

--egress-only-internet-gateway-id (строка)

--instance-id (строка)

--network-interface-id (строка)

--vpc-peering-connection-id (строка)

--nat-gateway-id (строка)

--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 версии 1, и двоичные значения должны передаваться буквально. При предоставлении содержимого файла, соответствующего двоичному блоку, 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.

Примеры

Для создания маршрута

В этом примере создается маршрут для указанной таблицы маршрутизации. Маршрут соответствует всему IPv4-трафику (0.0.0.0/0) и маршрутизирует его на указанный шлюз Интернет. Если команда выполнена успешно, вывод не возвращается.

Команда:

aws ec2 create-route --route-table-id rtb-22574640 --destination-cidr-block 0.0.0.0/0 --gateway-id igw-c0a643a9

Эта команда создает маршрут в таблице маршрутизации rtb-g8ff4ea2. Маршрут соответствует трафику для блока IPv4 CIDR 10.0.0.0/16 и маршрутизирует его к соединению VPC-peer, pcx-111aaa22. Этот маршрут позволяет направить трафик в VPC-партнера в VPC-соединении. Если команда выполнена успешно, вывод не возвращается.

Команда:

aws ec2 create-route --route-table-id rtb-g8ff4ea2 --destination-cidr-block 10.0.0.0/16 --vpc-peering-connection-id pcx-1a2b3c4d

В этом примере создается маршрут в указанной таблице маршрутизации, который соответствует всему IPv6-трафику (::/0) и маршрутизирует его на указанный шлюз выхода в Интернет.

Команда:

aws ec2 create-route --route-table-id rtb-dce620b8 --destination-ipv6-cidr-block ::/0 --egress-only-internet-gateway-id eigw-01eadbd45ecd7943f

Вывод

Возврат -> (булево)