изменение-атрибута-инстанса

Описание

Изменяет указанный атрибут указанного экземпляра. Вы можете указать только один атрибут за раз.

Примечание: Использование этого действия для изменения групп безопасности, связанных с виртуальной сетевой картой (ENI), подключенной к экземпляру, может привести к ошибке, если экземпляр имеет более одной ENI. Чтобы изменить группы безопасности, связанные с ENI, подключенной к экземпляру, имеющему несколько ENI, рекомендуется использовать действие ModifyNetworkInterfaceAttribute.

Для изменения некоторых атрибутов экземпляр должен быть остановлен. Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Изменение остановленного экземпляра».

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

Синтаксис

  modify-instance-attribute
[--source-dest-check | --no-source-dest-check]
[--disable-api-stop | --no-disable-api-stop]
[--dry-run | --no-dry-run]
--instance-id <value>
[--attribute <value>]
[--value <value>]
[--block-device-mappings <value>]
[--disable-api-termination | --no-disable-api-termination]
[--instance-type <value>]
[--kernel <value>]
[--ramdisk <value>]
[--user-data <value>]
[--instance-initiated-shutdown-behavior <value>]
[--groups <value>]
[--ebs-optimized | --no-ebs-optimized]
[--sriov-net-support <value>]
[--ena-support | --no-ena-support]
[--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]

Параметры

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

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

Значение -> (булево)

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

--disable-api-stop | --no-disable-api-stop (структура)

Указывает, разрешена ли защита от остановки экземпляра. Дополнительную информацию см. в разделе «Включение защиты от остановки для вашего экземпляра».

Значение -> (булево)

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

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

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

--instance-id (строка)

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

--attribute (строка)

Имя атрибута, который необходимо изменить.

Примечание

При изменении типа экземпляра: если исходный тип экземпляра настроен для настраиваемой пропускной способности, а желаемый тип экземпляра не поддерживает настраиваемую пропускную способность, сначала установите существующую конфигурацию пропускной способности в значение default с помощью операции ModifyInstanceNetworkPerformanceOptions.

Предупреждение

Возможные значения:

instanceType
kernel
ramdisk
userData
disableApiTermination
instanceInitiatedShutdownBehavior
rootDeviceName
blockDeviceMapping
productCodes
sourceDestCheck
groupSet
ebsOptimized
sriovNetSupport
enaSupport
enclaveOptions
disableApiStop

--value (строка)

Новое значение для атрибута. Используйте только с атрибутами kernel , ramdisk , userData , disableApiTermination или instanceInitiatedShutdownBehavior.

--block-device-mappings (список)

Изменяет атрибут DeleteOnTermination для томов, которые в настоящее время подключены. Том должен принадлежать вызывающей стороне. Если для DeleteOnTermination не указано значение, по умолчанию используется значение true, и том удаляется при завершении работы экземпляра. Вы не можете изменить атрибут DeleteOnTermination для томов, подключенных к задачам Fargate.

Чтобы добавить тома хранилища экземпляра в экземпляр на основе Amazon EBS, необходимо добавить их при запуске экземпляра. Дополнительную информацию см. в руководстве пользователя Amazon EC2 в разделе «Обновление отображения устройства блочных устройств при запуске экземпляра».

(структура)

Описание записи отображения устройства блочного устройства.

DeviceName -> (строка)

Имя устройства (например, /dev/sdh или xvdh).

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

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

VolumeId -> (строка)

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

DeleteOnTermination -> (булево)

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

VirtualName -> (строка)

Имя виртуального устройства.

NoDevice -> (строка)

Препятствует включению указанного устройства, включенного в отображение устройства блочного устройства.

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

DeviceName=string,Ebs={VolumeId=string,DeleteOnTermination=boolean},VirtualName=string,NoDevice=string ...

Синтаксис JSON:

[
  {
    "DeviceName": "string",
    "Ebs": {
      "VolumeId": "string",
      "DeleteOnTermination": true|false
    },
    "VirtualName": "string",
    "NoDevice": "string"
  }
  ...
]

--disable-api-termination | --no-disable-api-termination (структура)

Включает или отключает защиту от завершения работы для экземпляра. Если значение равно true , вы не можете завершить работу экземпляра с помощью консоли Amazon EC2, командной строки или API. Защиту от завершения работы нельзя включить для Spot-экземпляров.

Значение -> (булево)

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

--instance-type (структура)

Изменяет тип экземпляра на указанное значение. Дополнительную информацию см. в разделе «Типы экземпляров» в руководстве пользователя Amazon EC2. Если тип экземпляра недействителен, возвращается ошибка InvalidInstanceAttributeValue.

Значение -> (строка)

Значение атрибута. Регистр важен.

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

Изменяет ядро экземпляра на указанное значение. Рекомендуется использовать PV-GRUB вместо ядер и дисков RAM. Дополнительную информацию см. в разделе PV-GRUB.

Значение -> (строка)

Значение атрибута. Регистр важен.

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

Изменяет RAM-диск экземпляра на указанное значение. Рекомендуется использовать PV-GRUB вместо ядер и дисков RAM. Дополнительную информацию см. в разделе PV-GRUB.

Значение -> (строка)

Значение атрибута. Регистр важен.

--user-data (структура)

Изменяет пользовательские данные экземпляра на указанное значение. Данные пользователя должны быть закодированы в base64. В зависимости от используемого инструмента или SDK кодирование в base64 может выполняться за вас. Дополнительную информацию см. в разделе «Работа с пользовательскими данными экземпляра».

Значение -> (двоичные данные)

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

Value=blob

Синтаксис JSON:

{
  "Value": blob
}

--instance-initiated-shutdown-behavior (структура)

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

Значение -> (строка)

Значение атрибута. Регистр важен.

--groups (список)

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

(строка)

Синтаксис:

"string" "string" ...

--ebs-optimized | --no-ebs-optimized (структура)

Указывает, оптимизирован ли экземпляр для ввода-вывода Amazon EBS. Эта оптимизация предоставляет выделенную пропускную способность для Amazon EBS и оптимизированную конфигурационную стопку для обеспечения оптимальной производительности ввода-вывода EBS. Эта оптимизация недоступна для всех типов экземпляров. При использовании оптимизированного экземпляра EBS применяются дополнительные платы за использование.

Значение -> (булево)

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

--sriov-net-support (структура)

Установите значение simple, чтобы включить расширенную сеть с интерфейсом Intel 82599 Virtual Function для экземпляра.

В настоящее время нет способа отключить расширенную сеть с интерфейсом Intel 82599 Virtual Function.

Этот параметр поддерживается только для экземпляров HVM. Указание этого параметра с экземпляром PV может сделать его недоступным.

Значение -> (строка)

Значение атрибута. Регистр важен.

--ena-support | --no-ena-support (структура)

Установите значение true, чтобы включить расширенную сеть с ENA для экземпляра.

Значение -> (булево)

Значение атрибута. Допустимые значения — 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 (boolean)

Включить отладку логов.

--endpoint-url (string)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования для вывода команд.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

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

--region (string)

Регион для использования. Переопределяет параметры из конфигурации/окружения.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить вывод в цвете.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.

--ca-bundle (string)

Файл с сертификатами CA для проверки SSL-сертификатов. Переопределяет параметры из конфигурации/окружения.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-connect-timeout (int)

Максимальное время соединения сокета в секундах. Если значение установлено в 0, соединение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию — 60 секунд.

--cli-binary-format (string)

Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (boolean)

Отключить вывод в paginator для вывода.

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Пример 1: Изменение типа экземпляра

Следующий modify-instance-attribute пример изменяет тип экземпляра указанного экземпляра. Экземпляр должен быть в состоянии stopped.

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --instance-type "{\"Value\": \"m1.small\"}"

Эта команда не выводит ничего.

Пример 2: Включение расширенной сети на экземпляре

Следующий modify-instance-attribute пример включает расширенную сеть для указанного экземпляра. Экземпляр должен быть в состоянии stopped.

aws ec2 modify-instance-attribute \
    --instance-id i-1234567890abcdef0 \
    --sriov-net-support simple

Эта команда не выводит ничего.

Пример 3: Изменение атрибута sourceDestCheck

Следующий modify-instance-attribute пример устанавливает атрибут sourceDestCheck указанного экземпляра в значение true. Экземпляр должен находиться в VPC.

aws ec2 modify-instance-attribute --instance-id i-1234567890abcdef0 --source-dest-check "{\"Value\": true}"

Эта команда не выводит ничего.

Пример 4: Изменение атрибута deleteOnTermination системного тома

Следующий modify-instance-attribute пример устанавливает атрибут deleteOnTermination для корневого тома указанного экземпляра Amazon EBS в значение false. По умолчанию этот атрибут true для корневого тома.

Команда:

aws ec2 modify-instance-attribute \
  --instance-id i-1234567890abcdef0 \
  --block-device-mappings "[{\"DeviceName\": \"/dev/sda1\",\"Ebs\":{\"DeleteOnTermination\":false}}]"

Эта команда не выводит ничего.

Пример 5: Изменение пользовательских данных, прикрепленных к экземпляру

Следующий modify-instance-attribute пример добавляет содержимое файла UserData.txt в качестве UserData для указанного экземпляра.

Содержимое исходного файла UserData.txt:

#!/bin/bash
yum update -y
service httpd start
chkconfig httpd on

Содержимое файла должно быть закодировано в base64. Первая команда преобразует текстовый файл в base64 и сохраняет его в новый файл.

Версия команды для Linux/macOS:

base64 UserData.txt > UserData.base64.txt

Эта команда не выводит ничего.

Версия команды для Windows:

certutil -encode UserData.txt tmp.b64 && findstr /v /c:- tmp.b64 > UserData.base64.txt

Вывод:

Input Length = 67
Output Length = 152
CertUtil: -encode command completed successfully.

Теперь вы можете использовать этот файл в команде CLI, которая следует за этим:

aws ec2 modify-instance-attribute \
    --instance-id=i-09b5a14dbca622e76 \
    --attribute userData --value fileb://UserData.base64.txt

Эта команда не выводит ничего.

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

Вывод

Нет