Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

modify-traffic-mirror-filter-network-services

Описание

Разрешает или ограничивает отражение сетевых служб.

По умолчанию сетевые службы Amazon DNS не подходят для Трафика Mirror. Используйте AddNetworkServices, чтобы добавить сетевые службы в фильтр Трафика Mirror. После добавления сетевой службы в фильтр Трафика Mirror все трафик, относящийся к этой сетевой службе, будет отражён. Если вы больше не хотите отражать сетевые службы, используйте RemoveNetworkServices, чтобы удалить сетевые службы из фильтра Трафика Mirror.

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

Синтаксис

  modify-traffic-mirror-filter-network-services
--traffic-mirror-filter-id <value>
[--add-network-services <value>]
[--remove-network-services <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]

Параметры

--traffic-mirror-filter-id (строка)

Идентификатор фильтра Трафика Mirror.

--add-network-services (список)

Сеть, например Amazon DNS, которую вы хотите отразить.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  amazon-dns

--remove-network-services (список)

Сеть, например Amazon DNS, которую вы больше не хотите отражать.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  amazon-dns

--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
  • 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 для вывода.

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

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

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

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

Примеры

Примечание

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

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

Чтобы добавить сетевые службы в фильтр Трафика Mirror

В следующем modify-traffic-mirror-filter-network-services примере добавляются сетевые службы Amazon DNS к указанному фильтру.

aws ec2 modify-traffic-mirror-filter-network-services \
    --traffic-mirror-filter-id tmf-04812ff784EXAMPLE \
    --add-network-service amazon-dns

Вывод:

{
    "TrafficMirrorFilter": {
        "Tags": [
            {
                "Key": "Name",
                "Value": "Production"
            }
        ],
        "EgressFilterRules": [],
        "NetworkServices": [
            "amazon-dns"
        ],
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "IngressFilterRules": [
            {
                "SourceCidrBlock": "0.0.0.0/0",
                "RuleNumber": 1,
                "DestinationCidrBlock": "0.0.0.0/0",
                "Description": "TCP Rule",
                "Protocol": 6,
                "TrafficDirection": "ingress",
                "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
                "RuleAction": "accept",
                "TrafficMirrorFilterRuleId": "tmf-04812ff784EXAMPLE"
            }
        ]
    }
}

Для получения дополнительной информации см. Modify Traffic Mirror Filter Network Services в Руководстве по AWS Traffic Mirroring.

Вывод

TrafficMirrorFilter -> (структура)

Фильтр зеркалирования трафика, с которым связан сетевой сервис.

TrafficMirrorFilterId -> (строка)

Идентификатор фильтра зеркалирования трафика.

IngressFilterRules -> (список)

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

(структура)

Описание правила зеркалирования трафика.

TrafficMirrorFilterRuleId -> (строка)

Идентификатор правила зеркалирования трафика.

TrafficMirrorFilterId -> (строка)

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

TrafficDirection -> (строка)

Направление трафика, назначенное правилу зеркалирования трафика.

RuleNumber -> (целое число)

Номер правила зеркалирования трафика.

RuleAction -> (строка)

Действие, назначенное правилу зеркалирования трафика.

Protocol -> (целое число)

Протокол, назначенный правилу зеркалирования трафика.

DestinationPortRange -> (структура)

Диапазон портов назначения, назначенный правилу зеркалирования трафика.

FromPort -> (целое число)

Начало диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

ToPort -> (целое число)

Конец диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

SourcePortRange -> (структура)

Диапазон портов источника, назначенный правилу зеркалирования трафика.

FromPort -> (целое число)

Начало диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

ToPort -> (целое число)

Конец диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

DestinationCidrBlock -> (строка)

Блок CIDR назначения, назначенный правилу зеркалирования трафика.

SourceCidrBlock -> (строка)

Блок CIDR источника, назначенный правилу зеркалирования трафика.

Description -> (строка)

Описание правила зеркалирования трафика.

Tags -> (список)

Теги правил фильтрации зеркалирования трафика.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Value -> (строка)

Значение тега.

Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.

EgressFilterRules -> (список)

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

(структура)

Описание правила зеркалирования трафика.

TrafficMirrorFilterRuleId -> (строка)

Идентификатор правила зеркалирования трафика.

TrafficMirrorFilterId -> (строка)

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

TrafficDirection -> (строка)

Направление трафика, назначенное правилу зеркалирования трафика.

RuleNumber -> (целое число)

Номер правила зеркалирования трафика.

RuleAction -> (строка)

Действие, назначенное правилу зеркалирования трафика.

Protocol -> (целое число)

Протокол, назначенный правилу зеркалирования трафика.

DestinationPortRange -> (структура)

Диапазон портов назначения, назначенный правилу зеркалирования трафика.

FromPort -> (целое число)

Начало диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

ToPort -> (целое число)

Конец диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

SourcePortRange -> (структура)

Диапазон портов источника, назначенный правилу зеркалирования трафика.

FromPort -> (целое число)

Начало диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

ToPort -> (целое число)

Конец диапазона портов зеркалирования трафика. Применяется к протоколам TCP и UDP.

DestinationCidrBlock -> (строка)

Блок CIDR назначения, назначенный правилу зеркалирования трафика.

SourceCidrBlock -> (строка)

Блок CIDR источника, назначенный правилу зеркалирования трафика.

Description -> (строка)

Описание правила зеркалирования трафика.

Tags -> (список)

Теги правил фильтрации зеркалирования трафика.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Value -> (строка)

Значение тега.

Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.

NetworkServices -> (список)

Сетевой трафик сервисов, связанных с фильтром зеркалирования трафика.

(строка)

Description -> (строка)

Описание фильтра зеркалирования трафика.

Tags -> (список)

Назначенные теги фильтра зеркалирования трафика.

(структура)

Описание тега.

Key -> (строка)

Ключ тега.

Ограничения: Ключи тегов чувствительны к регистру и принимают максимум 127 символов Юникода. Не может начинаться с aws: .

Value -> (строка)

Значение тега.

Ограничения: Значения тегов чувствительны к регистру и принимают максимум 256 символов Юникода.

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

Spec-Zone.ru

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