describe-route-tables
Описание
Описывает ваши таблицы маршрутизации. По умолчанию описываются все ваши таблицы маршрутизации. В качестве альтернативы, вы можете указать конкретные идентификаторы таблиц маршрутизации или отфильтровать результаты, чтобы включить только таблицы маршрутизации, соответствующие определённым критериям.
Каждый подсеть в вашей VPC должен быть связан с таблицей маршрутизации. Если подсеть не явно связана ни с какой таблицей маршрутизации, она неявно связана с главной таблицей маршрутизации. Эта команда не возвращает идентификатор подсети для неявных ассоциаций.
Для получения более подробной информации, см. Таблицы маршрутизации в руководстве пользователя Amazon VPC.
См. также: Документация API AWS
describe-route-tables является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query в ответе, содержащем постраничную информацию, аргумент --query должен извлекать данные из результатов следующих выражений запроса: RouteTables
Синтаксис
describe-route-tables
[--dry-run | --no-dry-run]
[--route-table-ids <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--dry-run | --no-dry-run (boolean)
DryRunOperation. В противном случае — UnauthorizedOperation.--route-table-ids (список)
Идентификаторы таблиц маршрутизации.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Фильтры.
-
association.gateway-id- Идентификатор шлюза, участвующего в ассоциации. -
association.route-table-association-id- Идентификатор идентификатора ассоциации для таблицы маршрутизации. -
association.route-table-id- Идентификатор таблицы маршрутизации, участвующей в ассоциации. -
association.subnet-id- Идентификатор подсети, участвующей в ассоциации. -
association.main- Указывает, является ли таблица маршрутизации основной таблицей маршрутизации для VPC (true|false). Таблицы маршрутизации, у которых нет идентификатора ассоциации, не возвращаются в ответе. -
owner-id- Идентификатор учётной записи Amazon Web Services, владеющей таблицей маршрутизации. -
route-table-id- Идентификатор таблицы маршрутизации. -
route.destination-cidr-block- Диапазон CIDR IPv4, указанный в маршруте в таблице. -
route.destination-ipv6-cidr-block- Диапазон CIDR IPv6, указанный в маршруте в таблице маршрутизации. -
route.destination-prefix-list-id- Идентификатор (префикс) сервиса Amazon Web Services, указанный в маршруте в таблице. -
route.egress-only-internet-gateway-id- Идентификатор шлюза только для исходящего трафика Internet Gateway, указанного в маршруте в таблице маршрутизации. -
route.gateway-id- Идентификатор шлюза, указанного в маршруте в таблице. -
route.instance-id- Идентификатор экземпляра, указанного в маршруте в таблице. -
route.nat-gateway-id- Идентификатор NAT-шлюза. -
route.transit-gateway-id- Идентификатор транзитного шлюза. -
route.origin- Описание того, как был создан маршрут.CreateRouteTableуказывает, что маршрут был автоматически создан при создании таблицы маршрутизации;CreateRouteуказывает, что маршрут был вручную добавлен в таблицу маршрутизации;EnableVgwRoutePropagationуказывает, что маршрут был распространён путём распространения маршрутов. -
route.state- Состояние маршрута в таблице маршрутизации (active|blackhole). Состояние «чёрная дыра» указывает, что целевой объект маршрута недоступен (например, указанный шлюз не подключён к VPC, указанный NAT-экземпляр был завершён и т. д.). -
route.vpc-peering-connection-id- Идентификатор подключения VPC peering, указанный в маршруте в таблице. -
tag- Пара «ключ/значение» тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, которые имеют тег с ключомOwnerи значениемTeamA, укажитеtag:Ownerдля имени фильтра иTeamAдля значения фильтра. -
tag-key- Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, которым назначен тег с указанным ключом, независимо от значения тега. -
vpc-id- Идентификатор VPC для таблицы маршрутизации.
(структура)
Пара «имя фильтра/значение», используемая для возвращения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с AND, и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.
Для получения более подробной информации, см. Список и фильтрация с помощью командной строки и API в руководстве пользователя Amazon EC2.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с OR, и запрос возвращает все результаты, которые соответствуют любому из указанных значений.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет принята буквально. Это нельзя указывать вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания места начала постраничной обработки. Это NextToken из ранее усеченного ответа.
Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращённых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.
--max-items (целое число)
Общее количество элементов, которые должны быть возвращены в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Чтобы продолжить постраничную обработку, укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.
--generate-cli-skeleton (строка) Выводит каркас JSON в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, он проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный каркас JSON не стабилен между версиями AWS CLI, и нет гарантии обратной совместимости в сгенерированном каркасе JSON.
Глобальные параметры
--debug (boolean)
Включить отладку.
--endpoint-url (строка)
Переопределить URL по умолчанию команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную обработку. Если автоматическая постраничная обработка отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для использования при фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из вашего файла с данными учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отобразить версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--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 (boolean)
Отключить постраничный вывод.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, во всех примерах используются правила цитирования, подобные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной оболочки. См. раздел Использование кавычек с строками в Руководстве пользователя AWS CLI.
Для описания таблиц маршрутизации
Следующий пример получает подробную информацию о ваших таблицах маршрутизации
aws ec2 describe-route-tables
Вывод:
{
"RouteTables": [
{
"Associations": [
{
"Main": true,
"RouteTableAssociationId": "rtbassoc-0df3f54e06EXAMPLE",
"RouteTableId": "rtb-09ba434c1bEXAMPLE"
}
],
"PropagatingVgws": [],
"RouteTableId": "rtb-09ba434c1bEXAMPLE",
"Routes": [
{
"DestinationCidrBlock": "10.0.0.0/16",
"GatewayId": "local",
"Origin": "CreateRouteTable",
"State": "active"
},
{
"DestinationCidrBlock": "0.0.0.0/0",
"NatGatewayId": "nat-06c018cbd8EXAMPLE",
"Origin": "CreateRoute",
"State": "blackhole"
}
],
"Tags": [],
"VpcId": "vpc-0065acced4EXAMPLE",
"OwnerId": "111122223333"
},
{
"Associations": [
{
"Main": true,
"RouteTableAssociationId": "rtbassoc-9EXAMPLE",
"RouteTableId": "rtb-a1eec7de"
}
],
"PropagatingVgws": [],
"RouteTableId": "rtb-a1eec7de",
"Routes": [
{
"DestinationCidrBlock": "172.31.0.0/16",
"GatewayId": "local",
"Origin": "CreateRouteTable",
"State": "active"
},
{
"DestinationCidrBlock": "0.0.0.0/0",
"GatewayId": "igw-fEXAMPLE",
"Origin": "CreateRoute",
"State": "active"
}
],
"Tags": [],
"VpcId": "vpc-3EXAMPLE",
"OwnerId": "111122223333"
},
{
"Associations": [
{
"Main": false,
"RouteTableAssociationId": "rtbassoc-0b100c28b2EXAMPLE",
"RouteTableId": "rtb-07a98f76e5EXAMPLE",
"SubnetId": "subnet-0d3d002af8EXAMPLE"
}
],
"PropagatingVgws": [],
"RouteTableId": "rtb-07a98f76e5EXAMPLE",
"Routes": [
{
"DestinationCidrBlock": "10.0.0.0/16",
"GatewayId": "local",
"Origin": "CreateRouteTable",
"State": "active"
},
{
"DestinationCidrBlock": "0.0.0.0/0",
"GatewayId": "igw-06cf664d80EXAMPLE",
"Origin": "CreateRoute",
"State": "active"
}
],
"Tags": [],
"VpcId": "vpc-0065acced4EXAMPLE",
"OwnerId": "111122223333"
}
]
}
Дополнительную информацию см. в разделе Работа с таблицами маршрутизации в Руководстве пользователя AWS VPC.
Вывод
RouteTables -> (список)
Информация о таблицах маршрутизации.
(структура)
Описание таблицы маршрутизации.
Associations -> (список)
Связи между таблицей маршрутизации и вашими подсетями или шлюзами.
(структура)
Описание связи между таблицей маршрутизации и подсетью или шлюзом.
Main -> (логическое значение)
RouteTableAssociationId -> (строка)
RouteTableId -> (строка)
SubnetId -> (строка)
GatewayId -> (строка)
AssociationState -> (структура)
Состояние связи.
State -> (строка)
StatusMessage -> (строка)
PropagatingVgws -> (список)
Любой виртуальный частный шлюз (VGW), распространяющий маршруты.
(структура)
Описание виртуального частного шлюза, распространяющего маршрут.
GatewayId -> (строка)
RouteTableId -> (строка)
Routes -> (список)
Маршруты в таблице маршрутизации.
(структура)
Описание маршрута в таблице маршрутизации.
DestinationCidrBlock -> (строка)
DestinationIpv6CidrBlock -> (строка)
DestinationPrefixListId -> (строка)
EgressOnlyInternetGatewayId -> (строка)
GatewayId -> (строка)
InstanceId -> (строка)
InstanceOwnerId -> (строка)
NatGatewayId -> (строка)
TransitGatewayId -> (строка)
LocalGatewayId -> (строка)
CarrierGatewayId -> (строка)
NetworkInterfaceId -> (строка)
Origin -> (строка)
Описание способа создания маршрута.
-
CreateRouteTable- Маршрут был автоматически создан при создании таблицы маршрутизации. -
CreateRoute- Маршрут был вручную добавлен в таблицу маршрутизации. -
EnableVgwRoutePropagation- Маршрут был распространён путём распространения маршрутов.
State -> (строка)
blackhole указывает, что целевой объект маршрута недоступен (например, указанный шлюз не подключён к VPC или указанный экземпляр NAT был завершён).VpcPeeringConnectionId -> (строка)
CoreNetworkArn -> (строка)
Tags -> (список)
Присвоенные теги таблицы маршрутизации.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов чувствительны к регистру и поддерживают максимальную длину 127 символов Юникода. Не может начинаться с aws:.
Value -> (строка)
Значение тега.
Ограничения: Значения тегов чувствительны к регистру и поддерживают максимальную длину 256 символов Юникода.
VpcId -> (строка)
OwnerId -> (строка)
NextToken -> (строка)
null, когда больше элементов возвращать не нужно.
© Copyright 2025, Amazon Web Services. Created using Sphinx.