describe-traffic-mirror-filters
Описание
Описывает один или несколько фильтров Трафик-зеркала.
См. также: Документацию API AWS
describe-traffic-mirror-filters является постраничным запросом. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничный вывод, задав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничным выводом, аргумент --query должен извлечь данные из результатов следующих выражений запроса: TrafficMirrorFilters
Синтаксис
describe-traffic-mirror-filters
[--traffic-mirror-filter-ids <value>]
[--dry-run | --no-dry-run]
[--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]
Параметры
--traffic-mirror-filter-ids (список)
Идентификатор фильтра Трафик-зеркала.
(строка)
Синтаксис:
"string" "string" ...
--dry-run | --no-dry-run (логическое значение)
DryRunOperation . В противном случае — UnauthorizedOperation .--filters (список)
Один или несколько фильтров. Возможные значения:
-
description: Описание фильтра Трафик-зеркала. -
traffic-mirror-filter-id: Идентификатор фильтра Трафик-зеркала.
(структура)
Пара имя-значение фильтра, используемая для получения более конкретного списка результатов из операции 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 CLI.
--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 (строка)
Включить/отключить цветной вывод.
- включено
- выключено
- автоматически
--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-traffic-mirror-filters отображает детали всех ваших фильтров Трафик-зеркала.
aws ec2 describe-traffic-mirror-filters
Вывод:
{
"TrafficMirrorFilters": [
{
"TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE",
"IngressFilterRules": [
{
"TrafficMirrorFilterRuleId": "tmfr-0ca76e0e08EXAMPLE",
"TrafficMirrorFilterId": "tmf-0293f26e86EXAMPLE",
"TrafficDirection": "ingress",
"RuleNumber": 100,
"RuleAction": "accept",
"Protocol": 6,
"DestinationCidrBlock": "10.0.0.0/24",
"SourceCidrBlock": "10.0.0.0/24",
"Description": "TCP Rule"
}
],
"EgressFilterRules": [],
"NetworkServices": [],
"Description": "Example filter",
"Tags": []
}
]
}
Для получения дополнительной информации см. раздел Просмотр фильтров Трафик-зеркала в Руководстве по Трафик-зеркалу.
Вывод
TrafficMirrorFilters -> (список)
Информация об одном или нескольких фильтрах Трафик-зеркала.
(структура)
Описание фильтра Трафик-зеркала.
TrafficMirrorFilterId -> (строка)
IngressFilterRules -> (список)
Информация о правилах входящего трафика, связанных с фильтром Трафик-зеркала.
(структура)
Описание правила Трафик-зеркала.
TrafficMirrorFilterRuleId -> (строка)
TrafficMirrorFilterId -> (строка)
TrafficDirection -> (строка)
RuleNumber -> (целое число)
RuleAction -> (строка)
Protocol -> (целое число)
DestinationPortRange -> (структура)
Диапазон портов назначения, назначенный правилу Трафик-зеркала.
FromPort -> (целое число)
ToPort -> (целое число)
SourcePortRange -> (структура)
Диапазон портов источника, назначенный правилу Трафик-зеркала.
FromPort -> (целое число)
ToPort -> (целое число)
DestinationCidrBlock -> (строка)
SourceCidrBlock -> (строка)
Description -> (строка)
Tags -> (список)
Теги на правилах фильтрации Трафик-зеркала.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов регистрозависимы и принимают максимум 127 символов Юникода. Не должны начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: Значения тегов регистрозависимы и принимают максимум 256 символов Юникода.
EgressFilterRules -> (список)
Информация о правилах исходящего трафика, связанных с фильтром Трафик-зеркала.
(структура)
Описание правила Трафик-зеркала.
TrafficMirrorFilterRuleId -> (строка)
TrafficMirrorFilterId -> (строка)
TrafficDirection -> (строка)
RuleNumber -> (целое число)
RuleAction -> (строка)
Protocol -> (целое число)
DestinationPortRange -> (структура)
Диапазон портов назначения, назначенный правилу Трафик-зеркала.
FromPort -> (целое число)
ToPort -> (целое число)
SourcePortRange -> (структура)
Диапазон портов источника, назначенный правилу Трафик-зеркала.
FromPort -> (целое число)
ToPort -> (целое число)
DestinationCidrBlock -> (строка)
SourceCidrBlock -> (строка)
Description -> (строка)
Tags -> (список)
Теги на правилах фильтрации Трафик-зеркала.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов регистрозависимы и принимают максимум 127 символов Юникода. Не должны начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: Значения тегов регистрозависимы и принимают максимум 256 символов Юникода.
NetworkServices -> (список)
Трафик сетевой службы, связанный с фильтром Трафик-зеркала.
(строка)
Description -> (строка)
Tags -> (список)
Теги, назначенные фильтру Трафик-зеркала.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: Ключи тегов регистрозависимы и принимают максимум 127 символов Юникода. Не должны начинаться с aws: .
Value -> (строка)
Значение тега.
Ограничения: Значения тегов регистрозависимы и принимают максимум 256 символов Юникода.
NextToken -> (строка)
null, если больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.