Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

modify-network-interface-attribute

Описание

Изменяет указанный атрибут сетевого интерфейса. Вы можете указать только один атрибут за раз. Вы можете использовать эту операцию для присоединения и отсоединения групп безопасности от существующего экземпляра EC2.

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

Синтаксис

  modify-network-interface-attribute
[--ena-srd-specification <value>]
[--enable-primary-ipv6 | --no-enable-primary-ipv6]
[--connection-tracking-specification <value>]
[--associate-public-ip-address | --no-associate-public-ip-address]
[--dry-run | --no-dry-run]
--network-interface-id <value>
[--description <value>]
[--source-dest-check | --no-source-dest-check]
[--groups <value>]
[--attachment <value>]
[--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]

Параметры

--ena-srd-specification (структура)

Обновляет конфигурацию ENA Express для сетевого интерфейса, подключенного к экземпляру.

EnaSrdEnabled -> (булево)

Указывает, включен ли ENA Express для сетевого интерфейса.

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

Настраивает ENA Express для UDP-сетевого трафика.

EnaSrdUdpEnabled -> (булево)

Указывает, использует ли UDP-трафик к экземпляру и от экземпляра ENA Express. Для указания этого параметра необходимо сначала включить ENA Express.

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

EnaSrdEnabled=boolean,EnaSrdUdpSpecification={EnaSrdUdpEnabled=boolean}

Синтаксис JSON:

{
  "EnaSrdEnabled": true|false,
  "EnaSrdUdpSpecification": {
    "EnaSrdUdpEnabled": true|false
  }
}

--enable-primary-ipv6 | --no-enable-primary-ipv6 (булево)

Если вы изменяете сетевой интерфейс в подсети с двойной адресацией или только IPv6, у вас есть возможность назначить основной IPv6-адрес. Основной IPv6-адрес — это IPv6-адрес GUA, связанный с ENI, для которого вы включили использование основного IPv6-адреса. Используйте этот параметр, если экземпляр, к которому будет подключен этот ENI, полагается на то, что его IPv6-адрес не изменится. Amazon Web Services автоматически назначит IPv6-адрес, связанный с ENI, подключенным к вашему экземпляру, в качестве основного IPv6-адреса. После включения IPv6-адреса GUA в качестве основного IPv6 его нельзя отключить. При включении IPv6-адреса GUA в качестве основного IPv6 первого IPv6 GUA будет назначен в качестве основного IPv6-адреса до тех пор, пока экземпляр не будет завершен или сетевой интерфейс не будет отключен. Если у вас несколько IPv6-адресов, связанных с ENI, подключенным к вашему экземпляру, и вы включите основной IPv6-адрес, первый IPv6-адрес GUA, связанный с ENI, станет основным IPv6-адресом.

--connection-tracking-specification (структура)

Спецификация отслеживания подключений.

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

Тайм-аут (в секундах) для неактивных TCP-соединений в установленном состоянии. Мин.: 60 секунд. Макс.: 432000 секунд (5 дней). По умолчанию: 432000 секунд. Рекомендуется: меньше 432000 секунд.

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

Тайм-аут (в секундах) для неактивных UDP-потоков, классифицированных как потоки, которые видели более одной транзакции запрос-ответ. Мин.: 60 секунд. Макс.: 180 секунд (3 минуты). По умолчанию: 180 секунд.

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

Тайм-аут (в секундах) для неактивных UDP-потоков, которые видели трафик только в одном направлении или в одной транзакции запрос-ответ. Мин.: 30 секунд. Макс.: 60 секунд. По умолчанию: 30 секунд.

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

TcpEstablishedTimeout=integer,UdpStreamTimeout=integer,UdpTimeout=integer

Синтаксис JSON:

{
  "TcpEstablishedTimeout": integer,
  "UdpStreamTimeout": integer,
  "UdpTimeout": integer
}

--associate-public-ip-address | --no-associate-public-ip-address (булево)

Указывает, нужно ли назначить публичный IPv4-адрес сетевому интерфейсу. Этот параметр можно включить для любого сетевого интерфейса, но он будет применен только к первичному сетевому интерфейсу (eth0).

--dry-run | --no-dry-run (булево)

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

--network-interface-id (строка)

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

--description (структура)

Описание сетевого интерфейса.

Value -> (строка)

Значение атрибута. Значение чувствительно к регистру.

--source-dest-check | --no-source-dest-check (структура)

Включение или отключение проверок источника/назначения, которые гарантируют, что экземпляр является источником или местом назначения любого трафика, который он получает. Если значение — true, проверки источника/назначения включены; в противном случае — отключены. Значение по умолчанию — true. Необходимо отключить проверки источника/назначения, если экземпляр выполняет такие службы, как трансляция сетевых адресов, маршрутизация или брандмауэры.

Value -> (булево)

Значение атрибута. Допустимые значения — true или false.

--groups (список)

Изменяет группы безопасности для сетевого интерфейса. Новый набор указанных вами групп заменяет текущий набор. Вы должны указать как минимум одну группу, даже если это только группа безопасности по умолчанию в VPC. Вам необходимо указать ID группы безопасности, а не ее имя.

(строка)

Синтаксис:

"string" "string" ...

--attachment (структура)

Информация о подключении интерфейса. Если изменяется атрибут delete on termination, необходимо указать ID подключения интерфейса.

DefaultEnaQueueCount -> (булево)

По умолчанию количество очередей ENA.

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

Количество очередей ENA, которые нужно создать с экземпляром.

AttachmentId -> (строка)

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

DeleteOnTermination -> (булево)

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

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

DefaultEnaQueueCount=boolean,EnaQueueCount=integer,AttachmentId=string,DeleteOnTermination=boolean

Синтаксис JSON:

{
  "DefaultEnaQueueCount": true|false,
  "EnaQueueCount": integer,
  "AttachmentId": "string",
  "DeleteOnTermination": true|false
}

--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
  • таблица
  • 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.

Для изменения атрибута подключения сетевого интерфейса

Эта команда изменяет атрибут attachment указанного сетевого интерфейса.

Команда:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --attachment AttachmentId=eni-attach-43348162,DeleteOnTermination=false

Для изменения атрибута описания сетевого интерфейса

Эта команда изменяет атрибут description указанного сетевого интерфейса.

Команда:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --description "My description"

Для изменения атрибута набора групп сетевого интерфейса

Эта команда изменяет атрибут groupSet указанного сетевого интерфейса.

Команда:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --groups sg-903004f8 sg-1a2b3c4d

Для изменения атрибута проверки источника/назначения сетевого интерфейса

Эта команда изменяет атрибут sourceDestCheck указанного сетевого интерфейса.

Команда:

aws ec2 modify-network-interface-attribute --network-interface-id eni-686ea200 --no-source-dest-check

Вывод

Нет

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

Spec-Zone.ru

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