Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

Поиск маршрутов в шлюзе транзитной связи

Описание

Ищет маршруты в указанной таблице маршрутизации шлюза транзитной связи.

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

Синтаксис

  search-transit-gateway-routes
--transit-gateway-route-table-id <value>
--filters <value>
[--max-results <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

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

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

--filters (список)

Один или несколько фильтров. Возможные значения:

  • attachment.transit-gateway-attachment-id - Идентификатор подключения шлюза транзитной связи.
  • attachment.resource-id - Идентификатор ресурса подключения шлюза транзитной связи.
  • attachment.resource-type - Тип ресурса подключения. Допустимые значения: vpc | vpn | direct-connect-gateway | peering | connect .
  • prefix-list-id - Идентификатор списка префиксов.
  • route-search.exact-match - Точное совпадение указанного фильтра.
  • route-search.longest-prefix-match - Самый длинный совпадающий префикс маршрута.
  • route-search.subnet-of-match - Маршруты с подсетью, соответствующей указанному фильтру CIDR.
  • route-search.supernet-of-match - Маршруты с CIDR, включающим CIDR фильтра. Например, если у вас есть маршруты 10.0.1.0/29 и 10.0.1.0/31 в таблице маршрутизации, и вы указываете supernet-of-match как 10.0.1.0/30, то результат вернёт 10.0.1.0/29.
  • state - Состояние маршрута (active | blackhole ).
  • type - Тип маршрута (propagated | static ).

(структура)

Пара имя-значение фильтра, используемая для возвращения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как метки, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, они объединяются с помощью AND , и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Для получения более подробной информации см. Список и фильтрация с помощью командной строки и API в руководстве пользователя Amazon EC2.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, они объединяются с помощью OR , и запрос возвращает все результаты, соответствующие любому из указанных значений.

(строка)

Сокращенный синтаксис:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--max-results (целое число)

Максимальное количество маршрутов для возврата. Если значение не указано, по умолчанию используется 1000.

--dry-run | --no-dry-run (логическое значение)

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

--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 (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Для поиска маршрутов в указанной таблице маршрутизации шлюза транзитной связи

Следующий пример search-transit-gateway-routes возвращает все маршруты типа static в указанной таблице маршрутизации.

aws ec2 search-transit-gateway-routes \
    --transit-gateway-route-table-id tgw-rtb-0a823edbdeEXAMPLE \
    --filters "Name=type,Values=static"

Вывод:

{
    "Routes": [
        {
            "DestinationCidrBlock": "10.0.2.0/24",
            "TransitGatewayAttachments": [
                {
                    "ResourceId": "vpc-4EXAMPLE",
                    "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
                    "ResourceType": "vpc"
                }
            ],
            "Type": "static",
            "State": "active"
        },
        {
            "DestinationCidrBlock": "10.1.0.0/24",
            "TransitGatewayAttachments": [
                {
                    "ResourceId": "vpc-4EXAMPLE",
                    "TransitGatewayAttachmentId": "tgw-attach-09b52ccdb5EXAMPLE",
                    "ResourceType": "vpc"
                }
            ],
            "Type": "static",
            "State": "active"
        }
    ],
    "AdditionalRoutesAvailable": false
}

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

Вывод

Маршруты -> (список)

Информация о маршрутах.

(структура)

Описание маршрута для таблицы маршрутизации шлюза транзитной связи.

DestinationCidrBlock -> (строка)

CIDR-блок, используемый для сопоставления пунктов назначения.

PrefixListId -> (строка)

Идентификатор списка префиксов, используемого для сопоставления пунктов назначения.

TransitGatewayRouteTableAnnouncementId -> (строка)

Идентификатор объявления маршрута таблицы маршрутизации шлюза транзитной связи.

TransitGatewayAttachments -> (список)

Подключения.

(структура)

Описание подключения маршрута.

ResourceId -> (строка)

Идентификатор ресурса.

TransitGatewayAttachmentId -> (строка)

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

ResourceType -> (строка)

Тип ресурса. Обратите внимание, что тип ресурса tgw-peering устарел.

Тип -> (строка)

Тип маршрута.

Состояние -> (строка)

Состояние маршрута.

AdditionalRoutesAvailable -> (логическое значение)

Указывает, доступны ли дополнительные маршруты.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API