describe-network-insights-paths
Описание
Описывает один или несколько ваших путей.
См. также: Документация AWS API
describe-network-insights-paths является постраничной операцией. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе со постраничным выводом, аргумент --query должен извлекать данные из результатов следующих выражений запроса: NetworkInsightsPaths
Синтаксис
describe-network-insights-paths
[--network-insights-path-ids <value>]
[--filters <value>]
[--dry-run | --no-dry-run]
[--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]
Параметры
--network-insights-path-ids (список)
Идентификаторы путей.
(строка)
Синтаксис:
"string" "string" ...
--filters (список)
Фильтры. Доступные значения:
- destination - Идентификатор ресурса.
- filter-at-source.source-address - Источник IPv4-адрес в источнике.
- filter-at-source.source-port-range - Диапазон портов источника в источнике.
- filter-at-source.destination-address - Целевой IPv4-адрес в источнике.
- filter-at-source.destination-port-range - Диапазон портов назначения в источнике.
- filter-at-destination.source-address - Источник IPv4-адрес в пункте назначения.
- filter-at-destination.source-port-range - Диапазон портов источника в пункте назначения.
- filter-at-destination.destination-address - Целевой IPv4-адрес в пункте назначения.
- filter-at-destination.destination-port-range - Диапазон портов назначения в пункте назначения.
- protocol - Протокол.
- source - Идентификатор ресурса.
(структура)
Пара имя-значение фильтра, используемый для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как теги, атрибуты или идентификаторы.
Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.
Для получения дополнительной информации, см. Список и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2.
Name -> (строка)
Values -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, значения объединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--dry-run | --no-dry-run (логическое значение)
DryRunOperation. В противном случае это UnauthorizedOperation.--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 (логическое значение)
Включает отладочную запись журнала.
--endpoint-url (строка)
Переопределяет URL по умолчанию команды указанным URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого подключения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение по умолчанию проверки сертификатов SSL.
--no-paginate (логическое значение)
Отключает автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI сделает только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определённого профиля из файла ключей.
--region (строка)
Используемый регион. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- on
- off
- auto
--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 User Guide.
За исключением случаев, когда указано иначе, во всех примерах используются правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для описания пути
Следующий describe-network-insights-paths пример описывает указанный путь.
aws ec2 describe-network-insights-paths \
--network-insights-path-ids nip-0b26f224f1d131fa8
Вывод:
{
"NetworkInsightsPaths": [
{
"NetworkInsightsPathId": "nip-0b26f224f1d131fa8",
"NetworkInsightsPathArn": "arn:aws:ec2:us-east-1:123456789012:network-insights-path/nip-0b26f224f1d131fa8",
"CreatedDate": "2021-01-20T22:43:46.933Z",
"Source": "igw-0797cccdc9d73b0e5",
"Destination": "i-0495d385ad28331c7",
"Protocol": "tcp"
}
]
}
Дополнительную информацию см. в разделе Начало работы с AWS CLI в Руководстве по Reachability Analyzer.
Вывод
NetworkInsightsPaths -> (список)
Информация о путях.
(структура)
Описание пути.
NetworkInsightsPathId -> (строка)
NetworkInsightsPathArn -> (строка)
CreatedDate -> (метка времени)
Source -> (строка)
Destination -> (строка)
SourceArn -> (строка)
DestinationArn -> (строка)
SourceIp -> (строка)
DestinationIp -> (строка)
Protocol -> (строка)
DestinationPort -> (целое число)
Tags -> (список)
Теги, связанные с путем.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не могут начинаться с aws:.
Value -> (строка)
Значение тега.
Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.
FilterAtSource -> (структура)
Ограничивает анализ путями сети, которые соответствуют определенным фильтрам в источнике.
SourceAddress -> (строка)
SourcePortRange -> (структура)
Диапазон портов источника.
FromPort -> (целое число)
ToPort -> (целое число)
DestinationAddress -> (строка)
DestinationPortRange -> (структура)
Диапазон портов пункта назначения.
FromPort -> (целое число)
ToPort -> (целое число)
FilterAtDestination -> (структура)
Ограничивает анализ путями сети, которые соответствуют определенным фильтрам в пункте назначения.
SourceAddress -> (строка)
SourcePortRange -> (структура)
Диапазон портов источника.
FromPort -> (целое число)
ToPort -> (целое число)
DestinationAddress -> (строка)
DestinationPortRange -> (структура)
Диапазон портов пункта назначения.
FromPort -> (целое число)
ToPort -> (целое число)
NextToken -> (строка)
null, когда больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.