Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

изменить-сессию-трафик-микро

Описание

Изменяет сессию трафика-микро.

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

Синтаксис

  modify-traffic-mirror-session
--traffic-mirror-session-id <value>
[--traffic-mirror-target-id <value>]
[--traffic-mirror-filter-id <value>]
[--packet-length <value>]
[--session-number <value>]
[--virtual-network-id <value>]
[--description <value>]
[--remove-fields <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-session-id (строка)

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

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

Целевой объект трафика-микро. Целевой объект должен находиться в той же VPC, что и источник, или иметь соединение VPC-перинга с источником.

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

Идентификатор фильтра трафика-микро.

--packet-length (целое число)

Количество байтов в каждом пакете для зеркального отображения. Это байты после заголовка VXLAN. Для зеркального отображения подмножества задайте значение длины (в байтах) для зеркального отображения. Например, если вы зададите это значение равным 100, то первые 100 байтов, соответствующие критериям фильтра, будут скопированы в целевой объект. Не указывайте этот параметр, если вы хотите отобразить весь пакет.

Для сессий с целевыми объектами зеркального отображения трафика балансировщика сетевой нагрузки (NLB) значение по умолчанию PacketLength будет установлено в 8500. Допустимые значения — от 1 до 8500. Установка PacketLength больше 8500 приведет к ошибочному ответу.

--session-number (целое число)

Номер сессии определяет порядок обработки сессий, когда интерфейс используется несколькими сессиями. Первая сессия с соответствующим фильтром — это та, которая отображает пакеты.

Допустимые значения — от 1 до 32766.

--virtual-network-id (целое число)

Идентификатор виртуальной сети сессии трафика-микро.

--description (строка)

Описание, которое нужно присвоить сессии трафика-микро.

--remove-fields (список)

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

При удалении свойства из сессии трафика-микро свойство устанавливается в значение по умолчанию.

(строка)

Синтаксис:

"string" "string" ...

Where valid values are:
  packet-length
  description
  virtual-network-id

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

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

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

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

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

Примеры

Примечание

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

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

Для изменения сессии трафика-микро

Следующий modify-traffic-mirror-session пример изменяет описание сессии трафика-микро и количество пакетов для зеркального отображения.

aws ec2 modify-traffic-mirror-session \
    --description "Change packet length" \
    --traffic-mirror-session-id tms-08a33b1214EXAMPLE \
    --remove-fields "packet-length"

Вывод:

{
    "TrafficMirrorSession": {
        "TrafficMirrorSessionId": "tms-08a33b1214EXAMPLE",
        "TrafficMirrorTargetId": "tmt-07f75d8feeEXAMPLE",
        "TrafficMirrorFilterId": "tmf-04812ff784EXAMPLE",
        "NetworkInterfaceId": "eni-070203f901EXAMPLE",
        "OwnerId": "111122223333",
        "SessionNumber": 1,
        "VirtualNetworkId": 7159709,
        "Description": "Change packet length",
        "Tags": []
    }
}

Дополнительную информацию см. в разделе Изменение сессии трафика-микро в Руководстве по зеркальному отображению трафика.

Вывод

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

Информация о сессии трафика-микро.

TrafficMirrorSessionId -> (строка)

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

TrafficMirrorTargetId -> (строка)

Идентификатор целевого объекта трафика-микро.

TrafficMirrorFilterId -> (строка)

Идентификатор фильтра трафика-микро.

NetworkInterfaceId -> (строка)

Идентификатор сетевого интерфейса сессии трафика-микро.

OwnerId -> (строка)

Идентификатор учетной записи владельца сессии трафика-микро.

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

Количество байтов в каждом пакете для зеркального отображения. Это байты после заголовка VXLAN. Для зеркального отображения подмножества задайте значение длины (в байтах) для зеркального отображения. Например, если вы зададите это значение равным 100, то первые 100 байтов, соответствующие критериям фильтра, будут скопированы в целевой объект. Не указывайте этот параметр, если вы хотите отобразить весь пакет.

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

Номер сессии определяет порядок обработки сессий, когда интерфейс используется несколькими сессиями. Первая сессия с соответствующим фильтром — это та, которая отображает пакеты.

Допустимые значения — от 1 до 32766.

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

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

Description -> (строка)

Описание сессии трафика-микро.

Tags -> (список)

Теги, назначенные сессии трафика-микро.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

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

Spec-Zone.ru

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