Изменить маршрут

Описание

Заменяет существующий маршрут в таблице маршрутизации в VPC.

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

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

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

Синтаксис

  replace-route
[--destination-prefix-list-id <value>]
[--vpc-endpoint-id <value>]
[--local-target | --no-local-target]
[--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 (строка)

Идентификатор VPC-эндпоинта. Поддерживается только для эндпоинтов Gateway Load Balancer.

--local-target | --no-local-target (булево)

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

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

Идентификатор шлюза транзитной сети.

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

Идентификатор локального шлюза.

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

[Только IPv4 трафик] Идентификатор шлюза оператора связи.

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

Amazon Resource Name (ARN) основной сети.

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

Проверяет наличие необходимых разрешений для действия, не отправляя фактический запрос, и возвращает ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

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

Идентификатор таблицы маршрутизации.

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

Блок IPv4 CIDR адресов, используемый для сопоставления назначения. Предоставляемое значение должно совпадать с CIDR существующего маршрута в таблице.

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

Идентификатор шлюза Интернета или виртуального частного шлюза.

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

Блок IPv6 CIDR адресов, используемый для сопоставления назначения. Предоставляемое значение должно совпадать с CIDR существующего маршрута в таблице.

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

[Только IPv6 трафик] Идентификатор шлюза Интернета только для исходящего трафика.

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

Идентификатор NAT-инстанса в вашей VPC.

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

Идентификатор сетевого интерфейса.

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

Идентификатор подключения VPC peering.

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

[Только IPv4 трафик] Идентификатор NAT-шлюза.

--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-auto-prompt (булево)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

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

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

Для изменения маршрута

В этом примере заменяется указанный маршрут в указанной таблице маршрутизации. Новый маршрут соответствует указанному CIDR и направляет трафик на указанный виртуальный частный шлюз. Если команда выполнена успешно, вывод не возвращается.

Команда:

aws ec2 replace-route --route-table-id rtb-22574640 --destination-cidr-block 10.0.0.0/16 --gateway-id vgw-9a4cacf3

Вывод

Нет