run-instances

Описание

Запускает указанное количество экземпляров с использованием AMI, для которого у вас есть разрешения.

Вы можете указать ряд опций или оставить значения по умолчанию. Применяются следующие правила:

Если вы не указываете идентификатор подсети, мы выбираем подсеть по умолчанию из вашей VPC по умолчанию. Если у вас нет VPC по умолчанию, вы должны указать идентификатор подсети в запросе.
Все экземпляры имеют сетевой интерфейс с основным частным IPv4-адресом. Если вы не указываете этот адрес, мы выбираем один из диапазона IPv4 вашей подсети.
Не все типы экземпляров поддерживают IPv6-адреса. Для получения дополнительной информации см. Типы экземпляров.
Если вы не указываете идентификатор группы безопасности, мы используем группу безопасности по умолчанию для VPC. Для получения дополнительной информации см. Группы безопасности.
Если для какого-либо из AMI прикреплен код продукта, на который пользователь не подписан, запрос завершается с ошибкой.

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

Для ускорения запуска экземпляров разбивайте большие запросы на более мелкие партии. Например, создайте пять отдельных запросов запуска для 100 экземпляров каждый вместо одного запроса запуска для 500 экземпляров.

RunInstances подвергается как ограничению скорости запросов, так и ограничению скорости ресурсов. Для получения дополнительной информации см. Ограничение скорости запросов.

Экземпляр готов к использованию, когда он находится в состоянии running. Вы можете проверить состояние своего экземпляра, используя DescribeInstances. Вы можете маркировать экземпляры и тома EBS во время запуска, после запуска или и то, и другое. Для получения дополнительной информации см. CreateTags и Маркировка ресурсов Amazon EC2.

Экземпляры Linux имеют доступ к открытому ключу пары ключей при загрузке. Вы можете использовать этот ключ для обеспечения безопасного доступа к экземпляру. Публичные образы Amazon EC2 используют эту функцию для обеспечения безопасного доступа без паролей. Для получения дополнительной информации см. Пары ключей.

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

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

Синтаксис

  run-instances
[--block-device-mappings <value>]
[--image-id <value>]
[--instance-type <value>]
[--ipv6-address-count <value>]
[--ipv6-addresses <value>]
[--kernel-id <value>]
[--key-name <value>]
[--monitoring <value>]
[--placement <value>]
[--ramdisk-id <value>]
[--security-group-ids <value>]
[--security-groups <value>]
[--subnet-id <value>]
[--user-data <value>]
[--elastic-gpu-specification <value>]
[--elastic-inference-accelerators <value>]
[--tag-specifications <value>]
[--launch-template <value>]
[--instance-market-options <value>]
[--credit-specification <value>]
[--cpu-options <value>]
[--capacity-reservation-specification <value>]
[--hibernation-options <value>]
[--license-specifications <value>]
[--metadata-options <value>]
[--enclave-options <value>]
[--private-dns-name-options <value>]
[--maintenance-options <value>]
[--disable-api-stop | --no-disable-api-stop]
[--enable-primary-ipv6 | --no-enable-primary-ipv6]
[--network-performance-options <value>]
[--operator <value>]
[--dry-run | --no-dry-run]
[--disable-api-termination | --enable-api-termination]
[--instance-initiated-shutdown-behavior <value>]
[--private-ip-address <value>]
[--client-token <value>]
[--additional-info <value>]
[--network-interfaces <value>]
[--iam-instance-profile <value>]
[--ebs-optimized | --no-ebs-optimized]
[--count <value>]
[--secondary-private-ip-addresses <value>]
[--secondary-private-ip-address-count <value>]
[--associate-public-ip-address | --no-associate-public-ip-address]
[--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]

Параметры

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

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

(структура)

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

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

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

DeleteOnTermination -> (булево)

Указывает, удаляется ли том EBS при завершении работы экземпляра. Для получения дополнительной информации см. Сохранение томов Amazon EBS при завершении работы экземпляра в Руководстве пользователя Amazon EC2.

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

Количество операций ввода-вывода в секунду (IOPS). Для томов gp3 , io1 и io2 это количество операций ввода-вывода в секунду (IOPS), которое зарезервировано для тома. Для томов gp2 это базовая производительность тома и скорость, с которой том накапливает кредиты ввода-вывода для увеличения производительности.

Ниже приведены поддерживаемые значения для каждого типа тома:

gp3 : 3000 - 16000 IOPS
io1 : 100 - 64000 IOPS
io2 : 100 - 256000 IOPS

Для томов io2 вы можете достичь до 256000 IOPS на экземплярах, построенных на базе Nitro System. На других экземплярах вы можете достичь производительности до 32000 IOPS.

Этот параметр необходим для томов io1 и io2. Значение по умолчанию для томов gp3 составляет 3000 IOPS.

SnapshotId -> (строка)

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

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

Размер тома в GiB. Вы должны указать либо идентификатор снимка, либо размер тома. Если вы указываете снимок, значение по умолчанию равно размеру снимка. Вы можете указать размер тома, равный или больший, чем размер снимка.

Ниже приведены поддерживаемые размеры для каждого типа тома:

gp2 и gp3 : 1 - 16384 GiB
io1 : 4 - 16384 GiB
io2 : 4 - 65536 GiB
st1 и sc1 : 125 - 16384 GiB
standard : 1 - 1024 GiB

VolumeType -> (строка)

Тип тома. Для получения дополнительной информации см. Типы томов Amazon EBS в Руководстве пользователя Amazon EBS.

KmsKeyId -> (строка)

Идентификатор (идентификатор ключа, псевдоним ключа, ARN ключа или ARN псевдонима) управляемого клиентом ключа KMS, используемого для шифрования EBS.

Этот параметр поддерживается только для объектов BlockDeviceMapping, вызываемых с помощью RunInstances , RequestSpotFleet и RequestSpotInstances .

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

Пропускная способность, поддерживаемая томом, в МБ/с.

Этот параметр действителен только для томов gp3.

Допустимый диапазон: минимальное значение 125. Максимальное значение 1000.

OutpostArn -> (строка)

ARN расположения Outpost, в котором хранится снимок.

Этот параметр не поддерживается при использовании CreateImage.

Encrypted -> (булево)

Указывает, изменяется ли состояние шифрования тома EBS при восстановлении из резервной копии снимка. Действие установки состояния шифрования в true зависит от происхождения тома (новый или из снимка), начального состояния шифрования, владения и от того, включено ли шифрование по умолчанию. Для получения дополнительной информации см. Шифрование Amazon EBS в Руководстве пользователя Amazon EBS.

В любом случае вы не можете удалить шифрование из зашифрованного тома.

Зашифрованные тома можно подключать только к экземплярам, поддерживающим шифрование Amazon EBS. Для получения дополнительной информации см. Поддерживаемые типы экземпляров.

Этот параметр не возвращается функцией DescribeImageAttribute.

Для CreateImage и RegisterImage возможность включения этого параметра и допустимые значения зависят от типа создаваемой вами карты блочных устройств.

Если вы создаете карту блочных устройств для нового (пустого) тома, вы можете включить этот параметр и указать либо true для зашифрованного тома, либо false для незашифрованного тома. Если вы опустите этот параметр, он по умолчанию будет false (незашифрованный).
Если вы создаете карту блочных устройств из существующего зашифрованного или незашифрованного снимка, вы должны опустить этот параметр. Если вы включите этот параметр, запрос завершится с ошибкой независимо от указанного вами значения.
Если вы создаете карту блочных устройств из существующего незашифрованного тома, вы можете включить этот параметр, но вы должны указать false . Если вы укажете true, запрос завершится с ошибкой. В этом случае мы рекомендуем опустить этот параметр.
Если вы создаете карту блочных устройств из существующего зашифрованного тома, вы можете включить этот параметр и указать либо true, либо false. Однако если вы укажете false, параметр игнорируется, и карта блочных устройств всегда будет зашифрована. В этом случае мы рекомендуем опустить этот параметр.

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

Указывает скорость инициализации тома Amazon EBS (скорость инициализации тома) в МБ/с, с которой должны загружаться блоки снимка из Amazon S3 на том. Это также известно как инициализация тома. Указание скорости инициализации тома гарантирует, что том будет инициализирован с предсказуемой и постоянной скоростью после создания.

Этот параметр поддерживается только для томов, созданных из снимков. Опустите этот параметр, если:

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

Примечание

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

Вы хотите создать том, который инициализируется со скоростью по умолчанию.

Для получения дополнительной информации см. Инициализация томов Amazon EBS в Руководстве пользователя Amazon EC2.

Этот параметр не поддерживается при использовании CreateImage.

Допустимый диапазон: 100 - 300 МБ/с

NoDevice -> (строка)

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

DeviceName -> (строка)

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

VirtualName -> (строка)

Виртуальное имя устройства (ephemeral N). Тома хранилища экземпляра нумеруются, начиная с 0. Тип экземпляра с 2 доступными томами хранилища экземпляра может указать сопоставления для ephemeral0 и ephemeral1. Количество доступных томов хранилища экземпляра зависит от типа экземпляра. После подключения к экземпляру вам необходимо смонтировать том.

Тома хранилища экземпляра NVMe автоматически перечисляются и получают имя устройства. Их включение в карту блочных устройств не имеет эффекта.

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

Краткая синтаксическая запись:

Ebs={DeleteOnTermination=boolean,Iops=integer,SnapshotId=string,VolumeSize=integer,VolumeType=string,KmsKeyId=string,Throughput=integer,OutpostArn=string,Encrypted=boolean,VolumeInitializationRate=integer},NoDevice=string,DeviceName=string,VirtualName=string ...

Синтаксис JSON:

[
  {
    "Ebs": {
      "DeleteOnTermination": true|false,
      "Iops": integer,
      "SnapshotId": "string",
      "VolumeSize": integer,
      "VolumeType": "standard"|"io1"|"io2"|"gp2"|"sc1"|"st1"|"gp3",
      "KmsKeyId": "string",
      "Throughput": integer,
      "OutpostArn": "string",
      "Encrypted": true|false,
      "VolumeInitializationRate": integer
    },
    "NoDevice": "string",
    "DeviceName": "string",
    "VirtualName": "string"
  }
  ...
]

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

Идентификатор AMI. Идентификатор AMI необходим для запуска экземпляра и должен быть указан здесь или в шаблоне запуска.

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

Тип экземпляра. Для получения дополнительной информации см. Типы экземпляров Amazon EC2 в Руководстве пользователя Amazon EC2.

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

a1.medium
a1.large
a1.xlarge
a1.2xlarge
a1.4xlarge
a1.metal
c1.medium
c1.xlarge
c3.large
c3.xlarge
c3.2xlarge
c3.4xlarge
c3.8xlarge
c4.large
c4.xlarge
c4.2xlarge
c4.4xlarge
c4.8xlarge
c5.large
c5.xlarge
c5.2xlarge
c5.4xlarge
c5.9xlarge
c5.12xlarge
c5.18xlarge
c5.24xlarge
c5.metal
c5a.large
c5a.xlarge
c5a.2xlarge
c5a.4xlarge
c5a.8xlarge
c5a.12xlarge
c5a.16xlarge
c5a.24xlarge
c5ad.large
c5ad.xlarge
c5ad.2xlarge
c5ad.4xlarge
c5ad.8xlarge
c5ad.12xlarge
c5ad.16xlarge
c5ad.24xlarge
c5d.large
c5d.xlarge
c5d.2xlarge
c5d.4xlarge
c5d.9xlarge
c5d.12xlarge
c5d.18xlarge
c5d.24xlarge
c5d.metal
c5n.large
c5n.xlarge
c5n.2xlarge
c5n.4xlarge
c5n.9xlarge
c5n.18xlarge
c5n.metal
c6g.medium
c6g.large
c6g.xlarge
c6g.2xlarge
c6g.4xlarge
c6g.8xlarge
c6g.12xlarge
c6g.16xlarge
c6g.metal
c6gd.medium
c6gd.large
c6gd.xlarge
c6gd.2xlarge
c6gd.4xlarge
c6gd.8xlarge
c6gd.12xlarge
c6gd.16xlarge
c6gd.metal
c6gn.medium
c6gn.large
c6gn.xlarge
c6gn.2xlarge
c6gn.4xlarge
c6gn.8xlarge
c6gn.12xlarge
c6gn.16xlarge
c6i.large
c6i.xlarge
c6i.2xlarge
c6i.4xlarge
c6i.8xlarge
c6i.12xlarge
c6i.16xlarge
c6i.24xlarge
c6i.32xlarge
c6i.metal
cc1.4xlarge
cc2.8xlarge
cg1.4xlarge
cr1.8xlarge
d2.xlarge
d2.2xlarge
d2.4xlarge
d2.8xlarge
d3.xlarge
d3.2xlarge
d3.4xlarge
d3.8xlarge
d3en.xlarge
d3en.2xlarge
d3en.4xlarge
d3en.6xlarge
d3en.8xlarge
d3en.12xlarge
dl1.24xlarge
f1.2xlarge
f1.4xlarge
f1.16xlarge
g2.2xlarge
g2.8xlarge
g3.4xlarge
g3.8xlarge
g3.16xlarge
g3s.xlarge
g4ad.xlarge
g4ad.2xlarge
g4ad.4xlarge
g4ad.8xlarge
g4ad.16xlarge
g4dn.xlarge
g4dn.2xlarge
g4dn.4xlarge
g4dn.8xlarge
g4dn.12xlarge
g4dn.16xlarge
g4dn.metal
g5.xlarge
g5.2xlarge
g5.4xlarge
g5.8xlarge
g5.12xlarge
g5.16xlarge
g5.24xlarge
g5.48xlarge
g5g.xlarge
g5g.2xlarge
g5g.4xlarge
g5g.8xlarge
g5g.16xlarge
g5g.metal
hi1.4xlarge
hpc6a.48xlarge
hs1.8xlarge
h1.2xlarge
h1.4xlarge
h1.8xlarge
h1.16xlarge
i2.xlarge
i2.2xlarge
i2.4xlarge
i2.8xlarge
i3.large
i3.xlarge
i3.2xlarge
i3.4xlarge
i3.8xlarge
i3.16xlarge
i3.metal
i3en.large
i3en.xlarge
i3en.2xlarge
i3en.3xlarge
i3en.6xlarge
i3en.12xlarge
i3en.24xlarge
i3en.metal
im4gn.large
im4gn.xlarge
im4gn.2xlarge
im4gn.4xlarge
im4gn.8xlarge
im4gn.16xlarge
inf1.xlarge
inf1.2xlarge
inf1.6xlarge
inf1.24xlarge
is4gen.medium
is4gen.large
is4gen.xlarge
is4gen.2xlarge
is4gen.4xlarge
is4gen.8xlarge
m1.small
m1.medium
m1.large
m1.xlarge
m2.xlarge
m2.2xlarge
m2.4xlarge
m3.medium
m3.large
m3.xlarge
m3.2xlarge
m4.large
m4.xlarge
m4.2xlarge
m4.4xlarge
m4.10xlarge
m4.16xlarge
m5.large
m5.xlarge
m5.2xlarge
m5.4xlarge
m5.8xlarge
m5.12xlarge
m5.16xlarge
m5.24xlarge
m5.metal
m5a.large
m5a.xlarge
m5a.2xlarge
m5a.4xlarge
m5a.8xlarge
m5a.12xlarge
m5a.16xlarge
m5a.24xlarge
m5ad.large
m5ad.xlarge
m5ad.2xlarge
m5ad.4xlarge
m5ad.8xlarge
m5ad.12xlarge
m5ad.16xlarge
m5ad.24xlarge
m5d.large
m5d.xlarge
m5d.2xlarge
m5d.4xlarge
m5d.8xlarge
m5d.12xlarge
m5d.16xlarge
m5d.24xlarge
m5d.metal
m5dn.large
m5dn.xlarge
m5dn.2xlarge
m5dn.4xlarge
m5dn.8xlarge
m5dn.12xlarge
m5dn.16xlarge
m5dn.24xlarge
m5dn.metal
m5n.large
m5n.xlarge
m5n.2xlarge
m5n.4xlarge
m5n.8xlarge
m5n.12xlarge
m5n.16xlarge
m5n.24xlarge
m5n.metal
m5zn.large
m5zn.xlarge
m5zn.2xlarge
m5zn.3xlarge
m5zn.6xlarge
m5zn.12xlarge
m5zn.metal
m6a.large
m6a.xlarge
m6a.2xlarge
m6a.4xlarge
m6a.8xlarge
m6a.12xlarge
m6a.16xlarge
m6a.24xlarge
m6a.32xlarge
m6a.48xlarge
m6g.metal
m6g.medium
m6g.large
m6g.xlarge
m6g.2xlarge
m6g.4xlarge
m6g.8xlarge
m6g.12xlarge
m6g.16xlarge
m6gd.metal
m6gd.medium
m6gd.large
m6gd.xlarge
m6gd.2xlarge
m6gd.4xlarge
m6gd.8xlarge
m6gd.12xlarge
m6gd.16xlarge
m6i.large
m6i.xlarge
m6i.2xlarge
m6i.4xlarge
m6i.8xlarge
m6i.12xlarge
m6i.16xlarge
m6i.24xlarge
m6i.32xlarge
m6i.metal
mac1.metal
p2.xlarge
p2.8xlarge
p2.16xlarge
p3.2xlarge
p3.8xlarge
p3.16xlarge
p3dn.24xlarge
p4d.24xlarge
r3.large
r3.xlarge
r3.2xlarge
r3.4xlarge
r3.8xlarge
r4.large
r4.xlarge
r4.2xlarge
r4.4xlarge
r4.8xlarge
r4.16xlarge
r5.large
r5.xlarge
r5.2xlarge
r5.4xlarge
r5.8xlarge
r5.12xlarge

r5.16xlarge
r5.24xlarge
r5.metal
r5a.large
r5a.xlarge
r5a.2xlarge
r5a.4xlarge
r5a.8xlarge
r5a.12xlarge
r5a.16xlarge
r5a.24xlarge
r5ad.large
r5ad.xlarge
r5ad.2xlarge
r5ad.4xlarge
r5ad.8xlarge
r5ad.12xlarge
r5ad.16xlarge
r5ad.24xlarge
r5b.large
r5b.xlarge
r5b.2xlarge
r5b.4xlarge
r5b.8xlarge
r5b.12xlarge
r5b.16xlarge
r5b.24xlarge
r5b.metal
r5d.large
r5d.xlarge
r5d.2xlarge
r5d.4xlarge
r5d.8xlarge
r5d.12xlarge
r5d.16xlarge
r5d.24xlarge
r5d.metal
r5dn.large
r5dn.xlarge
r5dn.2xlarge
r5dn.4xlarge
r5dn.8xlarge
r5dn.12xlarge
r5dn.16xlarge
r5dn.24xlarge
r5dn.metal
r5n.large
r5n.xlarge
r5n.2xlarge
r5n.4xlarge
r5n.8xlarge
r5n.12xlarge
r5n.16xlarge
r5n.24xlarge
r5n.metal
r6g.medium
r6g.large
r6g.xlarge
r6g.2xlarge
r6g.4xlarge
r6g.8xlarge
r6g.12xlarge
r6g.16xlarge
r6g.metal
r6gd.medium
r6gd.large
r6gd.xlarge
r6gd.2xlarge
r6gd.4xlarge
r6gd.8xlarge
r6gd.12xlarge
r6gd.16xlarge
r6gd.metal
r6i.large
r6i.xlarge
r6i.2xlarge
r6i.4xlarge
r6i.8xlarge
r6i.12xlarge
r6i.16xlarge
r6i.24xlarge
r6i.32xlarge
r6i.metal
t1.micro
t2.nano
t2.micro
t2.small
t2.medium
t2.large
t2.xlarge
t2.2xlarge
t3.nano
t3.micro
t3.small
t3.medium
t3.large
t3.xlarge
t3.2xlarge
t3a.nano
t3a.micro
t3a.small
t3a.medium
t3a.large
t3a.xlarge
t3a.2xlarge
t4g.nano
t4g.micro
t4g.small
t4g.medium
t4g.large
t4g.xlarge
t4g.2xlarge
u-6tb1.56xlarge
u-6tb1.112xlarge
u-9tb1.112xlarge
u-12tb1.112xlarge
u-6tb1.metal
u-9tb1.metal
u-12tb1.metal
u-18tb1.metal
u-24tb1.metal
vt1.3xlarge
vt1.6xlarge
vt1.24xlarge
x1.16xlarge
x1.32xlarge
x1e.xlarge
x1e.2xlarge
x1e.4xlarge
x1e.8xlarge
x1e.16xlarge
x1e.32xlarge
x2iezn.2xlarge
x2iezn.4xlarge
x2iezn.6xlarge
x2iezn.8xlarge
x2iezn.12xlarge
x2iezn.metal
x2gd.medium
x2gd.large
x2gd.xlarge
x2gd.2xlarge
x2gd.4xlarge
x2gd.8xlarge
x2gd.12xlarge
x2gd.16xlarge
x2gd.metal
z1d.large
z1d.xlarge
z1d.2xlarge
z1d.3xlarge
z1d.6xlarge
z1d.12xlarge
z1d.metal
x2idn.16xlarge
x2idn.24xlarge
x2idn.32xlarge
x2iedn.xlarge
x2iedn.2xlarge
x2iedn.4xlarge
x2iedn.8xlarge
x2iedn.16xlarge
x2iedn.24xlarge
x2iedn.32xlarge
c6a.large
c6a.xlarge
c6a.2xlarge
c6a.4xlarge
c6a.8xlarge
c6a.12xlarge
c6a.16xlarge
c6a.24xlarge
c6a.32xlarge
c6a.48xlarge
c6a.metal
m6a.metal
i4i.large
i4i.xlarge
i4i.2xlarge
i4i.4xlarge
i4i.8xlarge
i4i.16xlarge
i4i.32xlarge
i4i.metal
x2idn.metal
x2iedn.metal
c7g.medium
c7g.large
c7g.xlarge
c7g.2xlarge
c7g.4xlarge
c7g.8xlarge
c7g.12xlarge
c7g.16xlarge
mac2.metal
c6id.large
c6id.xlarge
c6id.2xlarge
c6id.4xlarge
c6id.8xlarge
c6id.12xlarge
c6id.16xlarge
c6id.24xlarge
c6id.32xlarge
c6id.metal
m6id.large
m6id.xlarge
m6id.2xlarge
m6id.4xlarge
m6id.8xlarge
m6id.12xlarge
m6id.16xlarge
m6id.24xlarge
m6id.32xlarge
m6id.metal
r6id.large
r6id.xlarge
r6id.2xlarge
r6id.4xlarge
r6id.8xlarge
r6id.12xlarge
r6id.16xlarge
r6id.24xlarge
r6id.32xlarge
r6id.metal
r6a.large
r6a.xlarge
r6a.2xlarge
r6a.4xlarge
r6a.8xlarge
r6a.12xlarge
r6a.16xlarge
r6a.24xlarge
r6a.32xlarge
r6a.48xlarge
r6a.metal
p4de.24xlarge
u-3tb1.56xlarge
u-18tb1.112xlarge
u-24tb1.112xlarge
trn1.2xlarge
trn1.32xlarge
hpc6id.32xlarge
c6in.large
c6in.xlarge
c6in.2xlarge
c6in.4xlarge
c6in.8xlarge
c6in.12xlarge
c6in.16xlarge
c6in.24xlarge
c6in.32xlarge
m6in.large
m6in.xlarge
m6in.2xlarge
m6in.4xlarge
m6in.8xlarge
m6in.12xlarge
m6in.16xlarge
m6in.24xlarge
m6in.32xlarge
m6idn.large
m6idn.xlarge
m6idn.2xlarge
m6idn.4xlarge
m6idn.8xlarge
m6idn.12xlarge
m6idn.16xlarge
m6idn.24xlarge
m6idn.32xlarge
r6in.large
r6in.xlarge
r6in.2xlarge
r6in.4xlarge
r6in.8xlarge
r6in.12xlarge
r6in.16xlarge
r6in.24xlarge
r6in.32xlarge
r6idn.large
r6idn.xlarge
r6idn.2xlarge
r6idn.4xlarge
r6idn.8xlarge
r6idn.12xlarge
r6idn.16xlarge
r6idn.24xlarge
r6idn.32xlarge
c7g.metal
m7g.medium
m7g.large
m7g.xlarge
m7g.2xlarge
m7g.4xlarge
m7g.8xlarge
m7g.12xlarge
m7g.16xlarge
m7g.metal
r7g.medium
r7g.large
r7g.xlarge
r7g.2xlarge
r7g.4xlarge
r7g.8xlarge
r7g.12xlarge
r7g.16xlarge
r7g.metal
c6in.metal
m6in.metal
m6idn.metal
r6in.metal
r6idn.metal
inf2.xlarge
inf2.8xlarge
inf2.24xlarge
inf2.48xlarge
trn1n.32xlarge
i4g.large
i4g.xlarge
i4g.2xlarge
i4g.4xlarge
i4g.8xlarge
i4g.16xlarge
hpc7g.4xlarge
hpc7g.8xlarge
hpc7g.16xlarge
c7gn.medium
c7gn.large
c7gn.xlarge

c7gn.2xlarge
c7gn.4xlarge
c7gn.8xlarge
c7gn.12xlarge
c7gn.16xlarge
p5.48xlarge
m7i.large
m7i.xlarge
m7i.2xlarge
m7i.4xlarge
m7i.8xlarge
m7i.12xlarge
m7i.16xlarge
m7i.24xlarge
m7i.48xlarge
m7i-flex.large
m7i-flex.xlarge
m7i-flex.2xlarge
m7i-flex.4xlarge
m7i-flex.8xlarge
m7a.medium
m7a.large
m7a.xlarge
m7a.2xlarge
m7a.4xlarge
m7a.8xlarge
m7a.12xlarge
m7a.16xlarge
m7a.24xlarge
m7a.32xlarge
m7a.48xlarge
m7a.metal-48xl
hpc7a.12xlarge
hpc7a.24xlarge
hpc7a.48xlarge
hpc7a.96xlarge
c7gd.medium
c7gd.large
c7gd.xlarge
c7gd.2xlarge
c7gd.4xlarge
c7gd.8xlarge
c7gd.12xlarge
c7gd.16xlarge
m7gd.medium
m7gd.large
m7gd.xlarge
m7gd.2xlarge
m7gd.4xlarge
m7gd.8xlarge
m7gd.12xlarge
m7gd.16xlarge
r7gd.medium
r7gd.large
r7gd.xlarge
r7gd.2xlarge
r7gd.4xlarge
r7gd.8xlarge
r7gd.12xlarge
r7gd.16xlarge
r7a.medium
r7a.large
r7a.xlarge
r7a.2xlarge
r7a.4xlarge
r7a.8xlarge
r7a.12xlarge
r7a.16xlarge
r7a.24xlarge
r7a.32xlarge
r7a.48xlarge
c7i.large
c7i.xlarge
c7i.2xlarge
c7i.4xlarge
c7i.8xlarge
c7i.12xlarge
c7i.16xlarge
c7i.24xlarge
c7i.48xlarge
mac2-m2pro.metal
r7iz.large
r7iz.xlarge
r7iz.2xlarge
r7iz.4xlarge
r7iz.8xlarge
r7iz.12xlarge
r7iz.16xlarge
r7iz.32xlarge
c7a.medium
c7a.large
c7a.xlarge
c7a.2xlarge
c7a.4xlarge
c7a.8xlarge
c7a.12xlarge
c7a.16xlarge
c7a.24xlarge
c7a.32xlarge
c7a.48xlarge
c7a.metal-48xl
r7a.metal-48xl
r7i.large
r7i.xlarge
r7i.2xlarge
r7i.4xlarge
r7i.8xlarge
r7i.12xlarge
r7i.16xlarge
r7i.24xlarge
r7i.48xlarge
dl2q.24xlarge
mac2-m2.metal
i4i.12xlarge
i4i.24xlarge
c7i.metal-24xl
c7i.metal-48xl
m7i.metal-24xl
m7i.metal-48xl
r7i.metal-24xl
r7i.metal-48xl
r7iz.metal-16xl
r7iz.metal-32xl
c7gd.metal
m7gd.metal
r7gd.metal
g6.xlarge
g6.2xlarge
g6.4xlarge
g6.8xlarge
g6.12xlarge
g6.16xlarge
g6.24xlarge
g6.48xlarge
gr6.4xlarge
gr6.8xlarge
c7i-flex.large
c7i-flex.xlarge
c7i-flex.2xlarge
c7i-flex.4xlarge
c7i-flex.8xlarge
u7i-12tb.224xlarge
u7in-16tb.224xlarge
u7in-24tb.224xlarge
u7in-32tb.224xlarge
u7ib-12tb.224xlarge
c7gn.metal
r8g.medium
r8g.large
r8g.xlarge
r8g.2xlarge
r8g.4xlarge
r8g.8xlarge
r8g.12xlarge
r8g.16xlarge
r8g.24xlarge
r8g.48xlarge
r8g.metal-24xl
r8g.metal-48xl
mac2-m1ultra.metal
g6e.xlarge
g6e.2xlarge
g6e.4xlarge
g6e.8xlarge
g6e.12xlarge
g6e.16xlarge
g6e.24xlarge
g6e.48xlarge
c8g.medium
c8g.large
c8g.xlarge
c8g.2xlarge
c8g.4xlarge
c8g.8xlarge
c8g.12xlarge
c8g.16xlarge
c8g.24xlarge
c8g.48xlarge
c8g.metal-24xl
c8g.metal-48xl
m8g.medium
m8g.large
m8g.xlarge
m8g.2xlarge
m8g.4xlarge
m8g.8xlarge
m8g.12xlarge
m8g.16xlarge
m8g.24xlarge
m8g.48xlarge
m8g.metal-24xl
m8g.metal-48xl
x8g.medium
x8g.large
x8g.xlarge
x8g.2xlarge
x8g.4xlarge
x8g.8xlarge
x8g.12xlarge
x8g.16xlarge
x8g.24xlarge
x8g.48xlarge
x8g.metal-24xl
x8g.metal-48xl
i7ie.large
i7ie.xlarge
i7ie.2xlarge
i7ie.3xlarge
i7ie.6xlarge
i7ie.12xlarge
i7ie.18xlarge
i7ie.24xlarge
i7ie.48xlarge
i8g.large
i8g.xlarge
i8g.2xlarge
i8g.4xlarge
i8g.8xlarge
i8g.12xlarge
i8g.16xlarge
i8g.24xlarge
i8g.metal-24xl
u7i-6tb.112xlarge
u7i-8tb.112xlarge
u7inh-32tb.480xlarge
p5e.48xlarge
p5en.48xlarge
f2.12xlarge
f2.48xlarge
trn2.48xlarge
c7i-flex.12xlarge
c7i-flex.16xlarge
m7i-flex.12xlarge
m7i-flex.16xlarge
i7ie.metal-24xl
i7ie.metal-48xl
i8g.48xlarge
c8gd.medium
c8gd.large
c8gd.xlarge
c8gd.2xlarge
c8gd.4xlarge
c8gd.8xlarge
c8gd.12xlarge
c8gd.16xlarge
c8gd.24xlarge
c8gd.48xlarge
c8gd.metal-24xl
c8gd.metal-48xl
i7i.large
i7i.xlarge
i7i.2xlarge
i7i.4xlarge
i7i.8xlarge
i7i.12xlarge
i7i.16xlarge
i7i.24xlarge
i7i.48xlarge
i7i.metal-24xl
i7i.metal-48xl
p6-b200.48xlarge
m8gd.medium
m8gd.large
m8gd.xlarge
m8gd.2xlarge
m8gd.4xlarge
m8gd.8xlarge
m8gd.12xlarge
m8gd.16xlarge
m8gd.24xlarge
m8gd.48xlarge
m8gd.metal-24xl
m8gd.metal-48xl
r8gd.medium
r8gd.large
r8gd.xlarge
r8gd.2xlarge
r8gd.4xlarge
r8gd.8xlarge
r8gd.12xlarge
r8gd.16xlarge
r8gd.24xlarge
r8gd.48xlarge
r8gd.metal-24xl
r8gd.metal-48xl

--ipv6-address-count (целое число)

Количество адресов IPv6, которые нужно связать с первичным сетевым интерфейсом. Amazon EC2 выбирает адреса IPv6 из диапазона вашей подсети. Вы не можете указать этот параметр и параметр назначения конкретных адресов IPv6 в одном запросе. Вы можете указать этот параметр, если вы указали минимальное количество экземпляров для запуска.

Вы не можете указать этот параметр и параметр сетевых интерфейсов в одном запросе.

--ipv6-addresses (список)

Адреса IPv6 из диапазона подсети, которые нужно связать с первичным сетевым интерфейсом. Вы не можете указать этот параметр и параметр назначения определённого количества адресов IPv6 в одном запросе. Вы не можете указать этот параметр, если вы указали минимальное количество экземпляров для запуска.

Вы не можете указать этот параметр и параметр сетевых интерфейсов в одном запросе.

(структура)

Описывает адрес IPv6.

Ipv6Address -> (строка)

Адрес IPv6.

IsPrimaryIpv6 -> (булево)

Определяет, является ли адрес IPv6, связанный с сетевым интерфейсом, первичным адресом IPv6. При включении адреса IPv6 GUA в качестве первичного адреса IPv6, первый адрес IPv6 GUA будет сделан первичным адресом IPv6, пока экземпляр не будет завершён или сетевой интерфейс не будет отсоединён. Для получения дополнительной информации см. RunInstances.

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

Ipv6Address=string,IsPrimaryIpv6=boolean ...

Синтаксис JSON:

[
  {
    "Ipv6Address": "string",
    "IsPrimaryIpv6": true|false
  }
  ...
]

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

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

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

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

--key-name (строка)

Имя пары ключей. Вы можете создать пару ключей с помощью CreateKeyPair или ImportKeyPair.

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

Если вы не укажете пару ключей, вы не сможете подключиться к экземпляру, если не выберете AMI, настроенный для другого способа входа.

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

Указывает, включено ли подробное мониторинг для экземпляра.

Enabled -> (булево)

Указывает, включено ли подробное мониторинг. В противном случае включен базовый мониторинг.

Сокращенная запись:

Enabled=boolean

Синтаксис JSON:

{
  "Enabled": true|false
}

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

Местоположение экземпляра.

Affinity -> (строка)

Настройка сродства для экземпляра на выделенном хосте.

Этот параметр не поддерживается для CreateFleet или ImportInstance.

GroupName -> (строка)

Имя группы размещения, в которой находится экземпляр. Если вы укажете GroupName , вы не можете указать GroupId .

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

Номер раздела, в котором находится экземпляр. Действительно только если стратегия размещения группы установлена в partition .

Этот параметр не поддерживается для CreateFleet.

HostId -> (строка)

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

Этот параметр не поддерживается для CreateFleet или ImportInstance.

Tenancy -> (строка)

Тип аренды экземпляра. Экземпляр с типом аренды dedicated работает на аппаратном обеспечении с однопользовательской арендой.

Этот параметр не поддерживается для CreateFleet . Тип аренды host не поддерживается для ImportInstance или для экземпляров T3, настроенных для опции кредитов процессора unlimited.

SpreadDomain -> (строка)

Зарезервировано для будущих целей.

HostResourceGroupArn -> (строка)

ARN группы ресурсов хоста, в которой необходимо запустить экземпляры.

Если вы указываете этот параметр, опустите параметр Tenancy или установите его в host .

Этот параметр не поддерживается для CreateFleet.

GroupId -> (строка)

Идентификатор группы размещения, в которой находится экземпляр. Если вы указываете GroupId , вы не можете указать GroupName .

AvailabilityZone -> (строка)

Доступная зона экземпляра.

Если не указано, доступная зона будет автоматически выбрана на основе критериев балансировки нагрузки для региона.

Этот параметр не поддерживается для CreateFleet.

Сокращенная запись:

Affinity=string,GroupName=string,PartitionNumber=integer,HostId=string,Tenancy=string,SpreadDomain=string,HostResourceGroupArn=string,GroupId=string,AvailabilityZone=string

Синтаксис JSON:

{
  "Affinity": "string",
  "GroupName": "string",
  "PartitionNumber": integer,
  "HostId": "string",
  "Tenancy": "default"|"dedicated"|"host",
  "SpreadDomain": "string",
  "HostResourceGroupArn": "string",
  "GroupId": "string",
  "AvailabilityZone": "string"
}

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

Идентификатор диска RAM для выбора. Некоторые ядра требуют дополнительных драйверов при запуске. Проверьте требования к ядру, чтобы узнать, нужно ли указывать диск RAM. Чтобы найти требования к ядру, перейдите в Amazon Web Services Resource Center и выполните поиск по идентификатору ядра.

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

--security-group-ids (список)

Идентификаторы групп безопасности. Вы можете создать группу безопасности с помощью CreateSecurityGroup.

Если вы указываете сетевой интерфейс, вы должны указать все группы безопасности как часть сетевого интерфейса, а не использовать этот параметр.

(строка)

Синтаксис:

"string" "string" ...

--security-groups (список)

[Внутрисетевой VPC] Имена групп безопасности.

По умолчанию: Amazon EC2 использует группу безопасности по умолчанию.

(строка)

Синтаксис:

"string" "string" ...

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

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

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

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

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

--elastic-gpu-specification (список)

Графический ускоритель Elastic GPU для ассоциации с экземпляром.

Примечание

Amazon Elastic Graphics достиг конца срока службы 8 января 2024 года.

(структура)

Примечание

Amazon Elastic Graphics достиг конца срока службы 8 января 2024 года.

Спецификация ускорителя Elastic Graphics.

Type -> (строка)

Тип ускорителя Elastic Graphics.

Сокращенная запись:

Type=string ...

Синтаксис JSON:

[
  {
    "Type": "string"
  }
  ...
]

--elastic-inference-accelerators (список)

Ускоритель Elastic Inference для ассоциации с экземпляром.

Примечание

Amazon Elastic Inference больше недоступен.

(структура)

Примечание

Amazon Elastic Inference больше недоступен.

Описание ускорителя Elastic Inference.

Type -> (строка)

Тип ускорителя Elastic Inference. Возможные значения: eia1.medium , eia1.large , eia1.xlarge , eia2.medium , eia2.large и eia2.xlarge.

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

Количество ускорителей Elastic Inference для подключения к экземпляру.

По умолчанию: 1

Сокращенная запись:

Type=string,Count=integer ...

Синтаксис JSON:

[
  {
    "Type": "string",
    "Count": integer
  }
  ...
]

--tag-specifications (список)

Теги для применения к ресурсам, созданным при запуске экземпляра.

Вы можете указать теги только для следующих ресурсов:

Экземпляры
Тома
Запросы на экземпляры Spot
Сетевые интерфейсы

Для добавления тегов к ресурсу после его создания см. CreateTags.

(структура)

Теги для применения к ресурсу при его создании. При указании тега необходимо указать тип ресурса, иначе запрос завершится ошибкой.

Примечание

Список Valid Values содержит все типы ресурсов, которые можно пометить тегами. Однако действие, которое вы используете, может не поддерживать все эти типы ресурсов. Если вы попытаетесь добавить теги к типу ресурса, который не поддерживается для используемого вами действия, вы получите ошибку.

ResourceType -> (строка)

Тип ресурса для добавления тега при создании.

Tags -> (список)

Теги для применения к ресурсу.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

Сокращенная запись:

ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...

Синтаксис JSON:

[
  {
    "ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
    "Tags": [
      {
        "Key": "string",
        "Value": "string"
      }
      ...
    ]
  }
  ...
]

--launch-template (структура)

Шаблон запуска. Любые дополнительные параметры, которые вы укажете для нового экземпляра, переопределяют соответствующие параметры, включенные в шаблон запуска.

LaunchTemplateId -> (строка)

Идентификатор шаблона запуска.

Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска, но не оба.

LaunchTemplateName -> (строка)

Имя шаблона запуска.

Вы должны указать либо идентификатор шаблона запуска, либо имя шаблона запуска, но не оба.

Version -> (строка)

Номер версии шаблона запуска, $Latest или $Default.

Значение $Latest использует последнюю версию шаблона запуска.

Значение $Default использует версию шаблона запуска по умолчанию.

По умолчанию: Версия шаблона запуска по умолчанию.

Сокращенная запись:

LaunchTemplateId=string,LaunchTemplateName=string,Version=string

Синтаксис JSON:

{
  "LaunchTemplateId": "string",
  "LaunchTemplateName": "string",
  "Version": "string"
}

--instance-market-options (структура)

Вариант рынка (покупки) для экземпляров.

Для RunInstances устойчивые запросы Spot Instance поддерживаются только при InstanceInterruptionBehavior установлены либо hibernate, либо stop.

MarketType -> (строка)

Тип рынка.

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

Параметры для Spot Instance.

MaxPrice -> (строка)

Максимальная почасовая цена, которую вы готовы заплатить за Spot Instance. Мы не рекомендуем использовать этот параметр, так как это может привести к увеличению перерывов. Если вы не укажете этот параметр, вы будете платить текущую цену Spot.

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

Если вы укажете максимальную цену, ваши Spot Instance будут прерываться чаще, чем если вы не укажете этот параметр.

Если вы укажете максимальную цену, она должна быть больше 0,001 USD. Указание значения ниже 0,001 USD приведет к сообщению об ошибке InvalidParameterValue.

SpotInstanceType -> (строка)

Тип запроса Spot Instance. Для RunInstances устойчивые запросы Spot Instance поддерживаются только при поведении прерывания экземпляра либо hibernate, либо stop.

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

Устарело.

ValidUntil -> (метка времени)

Конечная дата запроса в формате UTC (YYYY -MM -DD T*HH* :MM :SS Z). Поддерживается только для устойчивых запросов.

Для устойчивого запроса запрос остается активным до достижения даты и времени ValidUntil. В противном случае запрос остается активным до тех пор, пока вы его не отменяете.
Для одноразового запроса ValidUntil не поддерживается. Запрос остается активным до запуска всех экземпляров или пока вы не отменяете запрос.

InstanceInterruptionBehavior -> (строка)

Поведение при прерывании Spot Instance.

Если Configured (для ` HibernationOptions https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_HibernationOptionsRequest.html`__ ) установлен на true, параметр InstanceInterruptionBehavior автоматически устанавливается на hibernate. Если вы установите его на stop или terminate, получите ошибку.

Если Configured (для ` HibernationOptions https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_HibernationOptionsRequest.html`__ ) установлен на false или null, параметр InstanceInterruptionBehavior автоматически устанавливается на terminate. Вы также можете установить его на stop или hibernate.

Для получения дополнительной информации см. Поведение при прерывании в руководстве пользователя Amazon EC2.

Краткий синтаксис:

MarketType=string,SpotOptions={MaxPrice=string,SpotInstanceType=string,BlockDurationMinutes=integer,ValidUntil=timestamp,InstanceInterruptionBehavior=string}

Синтаксис JSON:

{
  "MarketType": "spot"|"capacity-block",
  "SpotOptions": {
    "MaxPrice": "string",
    "SpotInstanceType": "one-time"|"persistent",
    "BlockDurationMinutes": integer,
    "ValidUntil": timestamp,
    "InstanceInterruptionBehavior": "hibernate"|"stop"|"terminate"
  }
}

--credit-specification (структура)

Вариант кредита за использование ЦП для экземпляра с производительностью с возможностью увеличения. Допустимые значения — standard и unlimited. Чтобы изменить этот атрибут после запуска, используйте ModifyInstanceCreditSpecification. Для получения дополнительной информации см. Экземпляры с производительностью с возможностью увеличения в руководстве пользователя Amazon EC2.

По умолчанию: standard (экземпляры T2) или unlimited (экземпляры T3/T3a/T4g)

Для экземпляров T3 с арендой host поддерживается только standard.

CpuCredits -> (строка)

Вариант кредита за использование ЦП экземпляра T.

Допустимые значения: standard | unlimited

Краткий синтаксис:

CpuCredits=string

Синтаксис JSON:

{
  "CpuCredits": "string"
}

--cpu-options (структура)

Параметры ЦП для экземпляра. Для получения дополнительной информации см. Параметры оптимизации ЦП в руководстве пользователя Amazon EC2.

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

Количество ядер ЦП для экземпляра.

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

Количество потоков на ядро ЦП. Чтобы отключить многопоточность для экземпляра, укажите значение 1. В противном случае укажите значение по умолчанию 2.

AmdSevSnp -> (строка)

Указывает, включить ли экземпляр для AMD SEV-SNP. AMD SEV-SNP поддерживается только для типов экземпляров M6a, R6a и C6a. Для получения дополнительной информации см. AMD SEV-SNP.

Краткий синтаксис:

CoreCount=integer,ThreadsPerCore=integer,AmdSevSnp=string

Синтаксис JSON:

{
  "CoreCount": integer,
  "ThreadsPerCore": integer,
  "AmdSevSnp": "enabled"|"disabled"
}

--capacity-reservation-specification (структура)

Информация о целевом параметре резервирования емкости. Если вы не укажете этот параметр, предпочтение резервирования емкости экземпляра по умолчанию устанавливается на open, что позволяет ему запускаться в любом открытом резервировании емкости, имеющем соответствующие атрибуты (тип экземпляра, платформа, зона доступности и аренда).

CapacityReservationPreference -> (строка)

Указывает предпочтения экземпляра в отношении резервирования емкости. Возможные предпочтения включают:

capacity-reservations-only — Экземпляр будет запускаться только в резервировании емкости или группе резервирования емкости. Если емкость недоступна, запуск экземпляра завершится ошибкой.
open — Экземпляр может запускаться в любом open резервировании емкости, имеющем соответствующие атрибуты (тип экземпляра, платформа, зона доступности и аренда). Если емкость недоступна, экземпляр запускается как экземпляр по требованию.
none — Экземпляр не запускается в резервировании емкости, даже если оно доступно. Экземпляр запускается как экземпляр по требованию.

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

Информация о целевом резервировании емкости или группе резервирования емкости.

CapacityReservationId -> (строка)

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

CapacityReservationResourceGroupArn -> (строка)

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

Краткий синтаксис:

CapacityReservationPreference=string,CapacityReservationTarget={CapacityReservationId=string,CapacityReservationResourceGroupArn=string}

Синтаксис JSON:

{
  "CapacityReservationPreference": "capacity-reservations-only"|"open"|"none",
  "CapacityReservationTarget": {
    "CapacityReservationId": "string",
    "CapacityReservationResourceGroupArn": "string"
  }
}

--hibernation-options (структура)

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

Вы не можете включить гибернацию и Amazon Web Services Nitro Enclaves в одном экземпляре.

Configured -> (булево)

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

Для Spot Instance, если вы установили Configured на true, либо опустите параметр InstanceInterruptionBehavior (для ` SpotMarketOptions https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_SpotMarketOptions.html`__ ), либо установите его на hibernate. Когда Configured имеет значение true:

Если вы опустите InstanceInterruptionBehavior, оно по умолчанию устанавливается на hibernate.
Если вы установите InstanceInterruptionBehavior на значение отличное от hibernate, получите ошибку.

По умолчанию: false

Краткий синтаксис:

Configured=boolean

Синтаксис JSON:

{
  "Configured": true|false
}

--license-specifications (список)

Конфигурации лицензий.

(структура)

Описание конфигурации лицензии.

LicenseConfigurationArn -> (строка)

Amazon Resource Name (ARN) конфигурации лицензии.

Краткий синтаксис:

LicenseConfigurationArn=string ...

Синтаксис JSON:

[
  {
    "LicenseConfigurationArn": "string"
  }
  ...
]

--metadata-options (структура)

Параметры метаданных для экземпляра. Для получения дополнительной информации см. Метаданные экземпляра и данные пользователя.

HttpTokens -> (строка)

Указывает, требуется ли IMDSv2.

optional — IMDSv2 необязателен, что означает, что вы можете использовать либо IMDSv2, либо IMDSv1.
required — IMDSv2 обязателен, что означает, что IMDSv1 отключен, и вы должны использовать IMDSv2.

По умолчанию:

Если значение ImdsSupport для Amazon Machine Image (AMI) вашего экземпляра равно v2.0, а значение по умолчанию для учетной записи установлено на no-preference, значение по умолчанию — required.
Если значение ImdsSupport для Amazon Machine Image (AMI) вашего экземпляра равно v2.0, но значение по умолчанию для учетной записи установлено на V1 or V2, значение по умолчанию — optional.

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

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

Максимальное количество переходов, которые может совершить маркер метаданных.

Возможные значения: целые числа от 1 до 64

HttpEndpoint -> (строка)

Включает или отключает HTTP-точку входа метаданных для ваших экземпляров.

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

По умолчанию: enabled

HttpProtocolIpv6 -> (строка)

Включает или отключает IPv6-точку входа для службы метаданных экземпляра.

По умолчанию: disabled

InstanceMetadataTags -> (строка)

Установите значение enabled, чтобы разрешить доступ к меткам экземпляра из метаданных экземпляра. Установите значение disabled, чтобы отключить доступ к меткам экземпляра из метаданных экземпляра. Для получения дополнительной информации см. Работа с метками экземпляра с помощью метаданных экземпляра.

По умолчанию: disabled

Краткий синтаксис:

HttpTokens=string,HttpPutResponseHopLimit=integer,HttpEndpoint=string,HttpProtocolIpv6=string,InstanceMetadataTags=string

Синтаксис JSON:

{
  "HttpTokens": "optional"|"required",
  "HttpPutResponseHopLimit": integer,
  "HttpEndpoint": "disabled"|"enabled",
  "HttpProtocolIpv6": "disabled"|"enabled",
  "InstanceMetadataTags": "disabled"|"enabled"
}

--enclave-options (структура)

Указывает, включен ли экземпляр для Amazon Web Services Nitro Enclaves. Для получения дополнительной информации см. Что такое Amazon Web Services Nitro Enclaves? в руководстве пользователя Amazon Web Services Nitro Enclaves.

Вы не можете включить Amazon Web Services Nitro Enclaves и гибернацию в одном экземпляре.

Enabled -> (булево)

Чтобы включить экземпляр для Amazon Web Services Nitro Enclaves, установите этот параметр на true.

Краткий синтаксис:

Enabled=boolean

Синтаксис JSON:

{
  "Enabled": true|false
}

--private-dns-name-options (структура)

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

HostnameType -> (строка)

Тип имени хоста для экземпляров EC2. Для подсетей только IPv4 имя DNS экземпляра должно основываться на адресе IPv4 экземпляра. Для подсетей только IPv6 имя DNS экземпляра должно основываться на идентификаторе экземпляра. Для подсетей с двойной адресацией вы можете указать, использовать ли имена DNS адрес IPv4 экземпляра или идентификатор экземпляра.

EnableResourceNameDnsARecord -> (логическое значение)

Указывает, нужно ли отвечать на запросы DNS для имён хостов экземпляров с записями DNS A.

EnableResourceNameDnsAAAARecord -> (логическое значение)

Указывает, нужно ли отвечать на запросы DNS для имён хостов экземпляров с записями DNS AAAA.

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

HostnameType=string,EnableResourceNameDnsARecord=boolean,EnableResourceNameDnsAAAARecord=boolean

Синтаксис JSON:

{
  "HostnameType": "ip-name"|"resource-name",
  "EnableResourceNameDnsARecord": true|false,
  "EnableResourceNameDnsAAAARecord": true|false
}

--maintenance-options (структура)

Параметры обслуживания и восстановления экземпляра.

AutoRecovery -> (строка)

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

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

AutoRecovery=string

Синтаксис JSON:

{
  "AutoRecovery": "disabled"|"default"
}

--disable-api-stop | --no-disable-api-stop (логическое значение)

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

--enable-primary-ipv6 | --no-enable-primary-ipv6 (логическое значение)

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

--network-performance-options (структура)

Содержит параметры для параметров сетевой производительности экземпляра.

BandwidthWeighting -> (строка)

Укажите параметр весового распределения полосы пропускания, чтобы повысить базовые значения полосы пропускания соответствующего типа, как указано ниже:

default

Этот параметр использует стандартную конфигурацию полосы пропускания для вашего типа экземпляра.

vpc-1

Этот параметр повышает базовый уровень сетевой полосы пропускания и снижает базовый уровень полосы пропускания EBS.

ebs-1

Этот параметр повышает базовый уровень полосы пропускания EBS и снижает базовый уровень сетевой полосы пропускания.

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

BandwidthWeighting=string

Синтаксис JSON:

{
  "BandwidthWeighting": "default"|"vpc-1"|"ebs-1"
}

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

Зарезервировано для внутреннего использования.

Principal -> (строка)

Поставщик услуг, управляющий ресурсом.

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

Principal=string

Синтаксис JSON:

{
  "Principal": "string"
}

--dry-run | --no-dry-run (логическое значение)

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

--disable-api-termination | --enable-api-termination (логическое значение)

Указывает, включена ли защита от завершения для экземпляра. По умолчанию — false, что означает, что вы можете завершить экземпляр с помощью консоли Amazon EC2, командных инструментов или API. Вы можете включить защиту от завершения при запуске экземпляра, в то время как экземпляр работает или приостановлен.

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

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

По умолчанию: stop

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

stop
terminate

--private-ip-address (строка)

Первичный IPv4-адрес. Вы должны указать значение из диапазона IPv4-адресов подсети.

Только один частный IP-адрес может быть назначен первичным. Вы не можете указать этот параметр, если вы указали параметр назначения частного IP-адреса как первичного IP-адреса в спецификации сетевого интерфейса. Вы не можете указать этот параметр, если вы запускаете более одного экземпляра в запросе.

Вы не можете указать этот параметр и параметр сетевых интерфейсов в одном запросе.

--client-token (строка)

Уникальный, чувствительный к регистру идентификатор, который вы предоставляете, чтобы обеспечить идемпотентность запроса. Если вы не укажете маркер клиента, для запроса используется случайный сгенерированный маркер для обеспечения идемпотентности.

Дополнительную информацию см. в разделе Обеспечение идемпотентности.

Ограничения: максимальная длина 64 ASCII символа

--additional-info (строка)

Зарезервировано.

--network-interfaces (список)

Сеть интерфейсов для ассоциации с экземпляром.

(структура)

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

AssociatePublicIpAddress -> (boolean)

Указывает, следует ли назначить публичный IPv4-адрес экземпляру, запущенному в VPC. Публичный IP-адрес может быть назначен только сетевому интерфейсу eth0 и только новому сетевому интерфейсу, а не существующему. Вы не можете указать более одного сетевого интерфейса в запросе. Если запуск в подсети по умолчанию, значение по умолчанию равно true .

Amazon Web Services взимает плату за все публичные IPv4-адреса, включая публичные IPv4-адреса, связанные с работающими экземплярами и Elastic IP-адресами. Более подробную информацию см. на вкладке Публичный IPv4-адрес на странице цен Amazon VPC.

DeleteOnTermination -> (boolean)

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

Description -> (string)

Описание сетевого интерфейса. Применяется только при создании сетевого интерфейса при запуске экземпляра.

DeviceIndex -> (integer)

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

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

Groups -> (list)

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

(string)

Ipv6AddressCount -> (integer)

Количество IPv6-адресов для назначения сетевому интерфейсу. Amazon EC2 выбирает IPv6-адреса из диапазона подсети. Вы не можете указать этот параметр и параметр для назначения определенных IPv6-адресов в одном запросе. Вы можете указать этот параметр, если вы указали минимальное количество запускаемых экземпляров.

Ipv6Addresses -> (list)

IPv6-адреса для назначения сетевому интерфейсу. Вы не можете указать этот параметр и параметр для назначения количества IPv6-адресов в одном запросе. Вы не можете указать этот параметр, если вы указали минимальное количество запускаемых экземпляров.

(структура)

Описание IPv6-адреса.

Ipv6Address -> (string)

IPv6-адрес.

IsPrimaryIpv6 -> (boolean)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, основным IPv6-адресом. При включении IPv6-адреса GUA в качестве основного IPv6, первый IPv6 GUA будет сделан основным IPv6-адресом до тех пор, пока экземпляр не будет завершен или сетевой интерфейс не будет отсоединён. Более подробную информацию см. в RunInstances.

NetworkInterfaceId -> (string)

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

Если вы создаете флот Spot, опустите этот параметр, так как вы не можете указать идентификатор сетевого интерфейса в спецификации запуска.

PrivateIpAddress -> (string)

Приватный IPv4-адрес сетевого интерфейса. Применяется только при создании сетевого интерфейса при запуске экземпляра. Вы не можете указать этот параметр, если вы запускаете более одного экземпляра в запросе RunInstances.

PrivateIpAddresses -> (list)

Приватные IPv4-адреса для назначения сетевому интерфейсу. Только один приватный IPv4-адрес может быть назначен как основной. Вы не можете указать этот параметр, если вы запускаете более одного экземпляра в запросе RunInstances.

(структура)

Описание дополнительного приватного IPv4-адреса для сетевого интерфейса.

Primary -> (boolean)

Указывает, является ли приватный IPv4-адрес основным приватным IPv4-адресом. Только один IPv4-адрес может быть назначен как основной.

PrivateIpAddress -> (string)

Приватный IPv4-адрес.

SecondaryPrivateIpAddressCount -> (integer)

Количество дополнительных приватных IPv4-адресов. Вы не можете указать этот параметр и также указать дополнительный приватный IP-адрес, используя параметр PrivateIpAddress.

SubnetId -> (string)

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

AssociateCarrierIpAddress -> (boolean)

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

Вы можете назначить адрес оператора только сетевому интерфейсу, который находится в подсети в зоне Wavelength. Более подробную информацию об адресах оператора см. в Руководстве разработчика Amazon Web Services Wavelength в разделе "Адрес оператора".

InterfaceType -> (string)

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

Если вы укажите efa-only , не назначайте IP-адреса сетевому интерфейсу. Сети интерфейсов только EFA не поддерживают IP-адреса.

Допустимые значения: interface | efa | efa-only

NetworkCardIndex -> (integer)

Индекс сетевой карты. Некоторые типы экземпляров поддерживают несколько сетевых карт. Основной сетевой интерфейс должен быть назначен сетевому индексу карты 0. По умолчанию используется индекс сетевой карты 0.

Если вы используете RequestSpotInstances для создания экземпляров Spot, опустите этот параметр, так как вы не можете указать индекс сетевой карты при использовании этого API. Для указания индекса сетевой карты используйте RunInstances.

Ipv4Prefixes -> (list)

IPv4-делегированные префиксы, которые будут назначены сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv4PrefixCount.

(структура)

Описание параметра IPv4-префикса для сетевого интерфейса.

Ipv4Prefix -> (string)

IPv4-префикс. Дополнительную информацию см. в разделе «Назначение префиксов сетевым интерфейсам» в Руководстве пользователя Amazon EC2.

Ipv4PrefixCount -> (integer)

Количество IPv4-делегированных префиксов, которые будут автоматически назначены сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv4Prefix.

Ipv6Prefixes -> (list)

IPv6-делегированные префиксы, которые будут назначены сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv6PrefixCount.

(структура)

Описание параметра IPv6-префикса для сетевого интерфейса.

Ipv6Prefix -> (string)

IPv6-префикс.

Ipv6PrefixCount -> (integer)

Количество IPv6-делегированных префиксов, которые будут автоматически назначены сетевому интерфейсу. Вы не можете использовать этот параметр, если используете параметр Ipv6Prefix.

PrimaryIpv6 -> (boolean)

Основной IPv6-адрес сетевого интерфейса. При включении IPv6-адреса GUA в качестве основного IPv6, первый IPv6 GUA будет сделан основным IPv6-адресом до тех пор, пока экземпляр не будет завершен или сетевой интерфейс не будет отсоединён. Более подробную информацию об основных IPv6-адресах см. в RunInstances.

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

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

EnaSrdEnabled -> (boolean)

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

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

Содержит параметры ENA Express для UDP-сетевого трафика для сетевого интерфейса, подключенного к экземпляру.

EnaSrdUdpEnabled -> (boolean)

Указывает, использует ли UDP-трафик ENA Express для вашего экземпляра. Чтобы гарантировать, что UDP-трафик может использовать ENA Express при запуске экземпляра, вы также должны установить EnaSrdEnabled в EnaSrdSpecificationRequest на true .

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

Спецификация отслеживания подключений группы безопасности, которая позволяет установить таймаут для отслеживания подключений на сетевом интерфейсе Elastic. Более подробную информацию см. в Руководстве пользователя Amazon EC2 в разделе "Таймауты отслеживания подключений".

TcpEstablishedTimeout -> (integer)

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

UdpStreamTimeout -> (integer)

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

UdpTimeout -> (integer)

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

EnaQueueCount -> (integer)

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

--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.

Пример 1: Запуск экземпляра в подсети по умолчанию

Следующий run-instances пример запускает один экземпляр типа t2.micro в подсети по умолчанию для текущего региона и связывает его с подсетью по умолчанию для сети VPC по умолчанию для региона. Пара ключа необязательна, если вы не планируете подключаться к своему экземпляру с помощью SSH (Linux) или RDP (Windows).

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --key-name MyKeyPair

Вывод:

{
    "Instances": [
        {
            "AmiLaunchIndex": 0,
            "ImageId": "ami-0abcdef1234567890",
            "InstanceId": "i-1231231230abcdef0",
            "InstanceType": "t2.micro",
            "KeyName": "MyKeyPair",
            "LaunchTime": "2018-05-10T08:05:20.000Z",
            "Monitoring": {
                "State": "disabled"
            },
            "Placement": {
                "AvailabilityZone": "us-east-2a",
                "GroupName": "",
                "Tenancy": "default"
            },
            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
            "PrivateIpAddress": "10.0.0.157",
            "ProductCodes": [],
            "PublicDnsName": "",
            "State": {
                "Code": 0,
                "Name": "pending"
            },
            "StateTransitionReason": "",
            "SubnetId": "subnet-04a636d18e83cfacb",
            "VpcId": "vpc-1234567890abcdef0",
            "Architecture": "x86_64",
            "BlockDeviceMappings": [],
            "ClientToken": "",
            "EbsOptimized": false,
            "Hypervisor": "xen",
            "NetworkInterfaces": [
                {
                    "Attachment": {
                        "AttachTime": "2018-05-10T08:05:20.000Z",
                        "AttachmentId": "eni-attach-0e325c07e928a0405",
                        "DeleteOnTermination": true,
                        "DeviceIndex": 0,
                        "Status": "attaching"
                    },
                    "Description": "",
                    "Groups": [
                        {
                            "GroupName": "MySecurityGroup",
                            "GroupId": "sg-0598c7d356eba48d7"
                        }
                    ],
                    "Ipv6Addresses": [],
                    "MacAddress": "0a:ab:58:e0:67:e2",
                    "NetworkInterfaceId": "eni-0c0a29997760baee7",
                    "OwnerId": "123456789012",
                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                    "PrivateIpAddress": "10.0.0.157",
                    "PrivateIpAddresses": [
                        {
                            "Primary": true,
                            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                            "PrivateIpAddress": "10.0.0.157"
                        }
                    ],
                    "SourceDestCheck": true,
                    "Status": "in-use",
                    "SubnetId": "subnet-04a636d18e83cfacb",
                    "VpcId": "vpc-1234567890abcdef0",
                    "InterfaceType": "interface"
                }
            ],
            "RootDeviceName": "/dev/xvda",
            "RootDeviceType": "ebs",
            "SecurityGroups": [
                {
                    "GroupName": "MySecurityGroup",
                    "GroupId": "sg-0598c7d356eba48d7"
                }
            ],
            "SourceDestCheck": true,
            "StateReason": {
                "Code": "pending",
                "Message": "pending"
            },
            "Tags": [],
            "VirtualizationType": "hvm",
            "CpuOptions": {
                "CoreCount": 1,
                "ThreadsPerCore": 1
            },
            "CapacityReservationSpecification": {
                "CapacityReservationPreference": "open"
            },
            "MetadataOptions": {
                "State": "pending",
                "HttpTokens": "optional",
                "HttpPutResponseHopLimit": 1,
                "HttpEndpoint": "enabled"
            }
        }
    ],
    "OwnerId": "123456789012",
    "ReservationId": "r-02a3f596d91211712"
}

Пример 2: Запуск экземпляра в подсети, отличной от подсети по умолчанию, и добавление публичного IP-адреса

Следующий run-instances пример запрашивает публичный IP-адрес для экземпляра, который вы запускаете в подсети, отличной от подсети по умолчанию. Экземпляр связан со указанной группой безопасности.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --subnet-id subnet-08fc749671b2d077c \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --associate-public-ip-address \
    --key-name MyKeyPair

Пример выходных данных для run-instances см. в примере 1.

Пример 3: Запуск экземпляра с дополнительными томами

Следующий run-instances пример использует отображение блочных устройств, указанное в mapping.json, для подключения дополнительных томов при запуске. Отображение блочных устройств может указывать тома EBS, тома памяти экземпляра или и тома EBS, и тома памяти экземпляра.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --subnet-id subnet-08fc749671b2d077c \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --key-name MyKeyPair \
    --block-device-mappings file://mapping.json

Содержимое mapping.json. В этом примере добавляется /dev/sdh пустой том EBS размером 100 ГБ.

[
    {
        "DeviceName": "/dev/sdh",
        "Ebs": {
            "VolumeSize": 100
        }
    }
]

Содержимое mapping.json. В этом примере добавляется ephemeral1 как том памяти экземпляра.

[
    {
        "DeviceName": "/dev/sdc",
        "VirtualName": "ephemeral1"
    }
]

Пример выходных данных для run-instances см. в примере 1.

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

Пример 4: Запуск экземпляра и добавление тегов при создании

Следующий run-instances пример добавляет тег с ключом webserver и значением production к экземпляру. Команда также применяет тег с ключом cost-center и значением cc123 к любому тому EBS, который создаётся (в данном случае к системному тому).

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --tag-specifications 'ResourceType=instance,Tags=[{Key=webserver,Value=production}]' 'ResourceType=volume,Tags=[{Key=cost-center,Value=cc123}]'

Пример выходных данных для run-instances см. в примере 1.

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

Следующий run-instances пример передаёт данные пользователя в файле с именем my_script.txt, который содержит скрипт конфигурации для вашего экземпляра. Скрипт выполняется при запуске.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --user-data file://my_script.txt

Пример выходных данных для run-instances см. в примере 1.

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

Пример 6: Запуск экземпляра с производительностью с увеличением пропускной способности

Следующий run-instances пример запускает экземпляр t2.micro с опцией unlimited кредита. При запуске экземпляра T2, если вы не указываете --credit-specification, по умолчанию используется опция кредита standard. При запуске экземпляра T3 по умолчанию используется опция кредита unlimited.

aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --instance-type t2.micro \
    --count 1 \
    --subnet-id subnet-08fc749671b2d077c \
    --key-name MyKeyPair \
    --security-group-ids sg-0b0384b66d7d692f9 \
    --credit-specification CpuCredits=unlimited

Пример выходных данных для run-instances см. в примере 1.

Дополнительную информацию об экземплярах с производительностью с увеличением пропускной способности см. в разделе Экземпляры с производительностью с увеличением пропускной способности в Руководстве пользователя Amazon EC2.

Вывод

ReservationId -> (строка)

Идентификатор бронирования.

OwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, владеющей бронированием.

RequesterId -> (строка)

Идентификатор запрашивающего, который запустил экземпляры от вашего имени (например, Amazon Web Services Management Console или Auto Scaling).

Groups -> (список)

Не поддерживается.

(структура)

Описывает группу безопасности.

GroupId -> (строка)

Идентификатор группы безопасности.

GroupName -> (строка)

Имя группы безопасности.

Instances -> (список)

Экземпляры.

(структура)

Описывает экземпляр.

Architecture -> (строка)

Архитектура образа.

BlockDeviceMappings -> (список)

Любые записи отображения блочных устройств для экземпляра.

(структура)

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

DeviceName -> (строка)

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

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

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

AttachTime -> (метка времени)

Метка времени, когда началась привязка.

DeleteOnTermination -> (булево)

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

Status -> (строка)

Состояние привязки.

VolumeId -> (строка)

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

AssociatedResource -> (строка)

ARN задачи Amazon ECS или Fargate, к которой прикреплен том.

VolumeOwnerId -> (строка)

Идентификатор учетной записи Amazon Web Services, владеющей томом.

Этот параметр возвращается только для томов, прикрепленных к задачам Fargate.

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

Поставщик услуг, управляющий томом EBS.

Managed -> (булево)

Если true, ресурс управляется поставщиком услуг.

Principal -> (строка)

Если managed равно true, возвращается принцип. Принцип — это поставщик услуг, который управляет ресурсом.

ClientToken -> (строка)

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

EbsOptimized -> (булево)

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

EnaSupport -> (булево)

Указывает, включена ли расширенная сеть с ENA.

Hypervisor -> (строка)

Тип гипервизора экземпляра. Значение xen используется для гипервизоров Xen и Nitro.

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

Профиль экземпляра IAM, связанный с экземпляром, если применимо.

Arn -> (строка)

Amazon Resource Name (ARN) профиля экземпляра.

Id -> (строка)

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

InstanceLifecycle -> (строка)

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

ElasticGpuAssociations -> (список)

Устаревшее.

Примечание

Amazon Elastic Graphics вышел из эксплуатации 8 января 2024 года.

(структура)

Примечание

Amazon Elastic Graphics вышел из эксплуатации 8 января 2024 года.

Описывает связь между экземпляром и ускорителем Elastic Graphics.

ElasticGpuId -> (строка)

Идентификатор ускорителя Elastic Graphics.

ElasticGpuAssociationId -> (строка)

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

ElasticGpuAssociationState -> (строка)

Состояние связи между экземпляром и ускорителем Elastic Graphics.

ElasticGpuAssociationTime -> (строка)

Время ассоциации ускорителя Elastic Graphics с экземпляром.

ElasticInferenceAcceleratorAssociations -> (список)

Устаревшее.

Примечание

Amazon Elastic Inference больше недоступен.

(структура)

Примечание

Amazon Elastic Inference больше недоступен.

Описывает связь между экземпляром и ускорителем Elastic Inference.

ElasticInferenceAcceleratorArn -> (строка)

Amazon Resource Name (ARN) ускорителя Elastic Inference.

ElasticInferenceAcceleratorAssociationId -> (строка)

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

ElasticInferenceAcceleratorAssociationState -> (строка)

Состояние ускорителя Elastic Inference.

ElasticInferenceAcceleratorAssociationTime -> (метка времени)

Время ассоциации ускорителя Elastic Inference с экземпляром.

NetworkInterfaces -> (список)

Сетевые интерфейсы экземпляра.

(структура)

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

Ассоциация -> (структура)

Информация об ассоциации с Elastic IPv4, связанной с сетевым интерфейсом.

CarrierIp -> (строка)

IP-адрес поставщика услуг, связанный с сетевым интерфейсом.

CustomerOwnedIp -> (строка)

IP-адрес, принадлежащий клиенту, связанный с сетевым интерфейсом.

IpOwnerId -> (строка)

Идентификатор владельца Elastic IP-адреса.

PublicDnsName -> (строка)

Публичное имя DNS.

PublicIp -> (строка)

Публичный IP-адрес или Elastic IP-адрес, привязанный к сетевому интерфейсу.

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

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

AttachTime -> (метка времени)

Отметка времени начала присоединения.

AttachmentId -> (строка)

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

DeleteOnTermination -> (булево)

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

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

Индекс устройства на экземпляре для присоединения сетевого интерфейса.

Status -> (строка)

Состояние присоединения.

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

Индекс сетевой карты.

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

Содержит параметры ENA Express для сетевого интерфейса, подключённого к экземпляру.

EnaSrdEnabled -> (булево)

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

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

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

EnaSrdUdpEnabled -> (булево)

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

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

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

Description -> (строка)

Описание.

Groups -> (список)

Безопасные группы.

(структура)

Описание безопасной группы.

GroupId -> (строка)

Идентификатор безопасной группы.

GroupName -> (строка)

Название безопасной группы.

Ipv6Addresses -> (список)

IPv6-адреса, связанные с сетевым интерфейсом.

(структура)

Описание IPv6-адреса.

Ipv6Address -> (строка)

IPv6-адрес.

IsPrimaryIpv6 -> (булево)

Определяет, является ли IPv6-адрес, связанный с сетевым интерфейсом, основным IPv6-адресом. При включении IPv6-адреса GUA в качестве основного IPv6, первый IPv6 GUA будет назначен основным IPv6-адресом до завершения работы экземпляра или отключения сетевого интерфейса. Дополнительную информацию см. в разделе RunInstances.

MacAddress -> (строка)

MAC-адрес.

NetworkInterfaceId -> (строка)

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

OwnerId -> (строка)

Идентификатор учётной записи Amazon Web Services, создавшей сетевой интерфейс.

PrivateDnsName -> (строка)

Частное имя DNS.

PrivateIpAddress -> (строка)

IPv4-адрес сетевого интерфейса в подсети.

PrivateIpAddresses -> (список)

Частные IPv4-адреса, связанные с сетевым интерфейсом.

(структура)

Описание частного IPv4-адреса.

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

Информация об ассоциации с Elastic IP-адресом для сетевого интерфейса.

CarrierIp -> (строка)

IP-адрес поставщика услуг, связанный с сетевым интерфейсом.

CustomerOwnedIp -> (строка)

IP-адрес, принадлежащий клиенту, связанный с сетевым интерфейсом.

IpOwnerId -> (строка)

Идентификатор владельца Elastic IP-адреса.

PublicDnsName -> (строка)

Публичное имя DNS.

PublicIp -> (строка)

Публичный IP-адрес или Elastic IP-адрес, привязанный к сетевому интерфейсу.

Primary -> (булево)

Указывает, является ли этот IPv4-адрес основным частным IP-адресом сетевого интерфейса.

PrivateDnsName -> (строка)

Частное имя DNS для IPv4.

PrivateIpAddress -> (строка)

Частный IPv4-адрес сетевого интерфейса.

SourceDestCheck -> (булево)

Указывает, включена ли проверка источника/назначения.

Status -> (строка)

Состояние сетевого интерфейса.

SubnetId -> (строка)

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

VpcId -> (строка)

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

InterfaceType -> (строка)

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

Допустимые значения: interface | efa | efa-only | trunk

Ipv4Prefixes -> (список)

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

(структура)

Информация об IPv4-префиксе.

Ipv4Prefix -> (строка)

Один или несколько IPv4-префиксов, назначенных сетевому интерфейсу.

Ipv6Prefixes -> (список)

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

(структура)

Информация об IPv6-префиксе.

Ipv6Prefix -> (строка)

Один или несколько IPv6-префиксов, назначенных сетевому интерфейсу.

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

Настройка отслеживания подключений безопасной группы, позволяющая установить таймаут для отслеживания подключений на Elastic сетевом интерфейсе. Дополнительную информацию см. в разделе Таймауты отслеживания подключений в Руководстве пользователя Amazon EC2.

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

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

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

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

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

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

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

Провайдер услуг, управляющий сетевым интерфейсом.

Managed -> (булево)

Если true, ресурс управляется провайдером услуг.

Principal -> (строка)

Если managed равно true, то возвращается субъект. Субъектом является провайдер услуг, управляющий ресурсом.

OutpostArn -> (строка)

Amazon Resource Name (ARN) Outpost.

RootDeviceName -> (строка)

Имя устройства корневого тома (например, /dev/sda1).

RootDeviceType -> (строка)

Тип корневого устройства, используемого AMI. AMI может использовать том EBS или том хранилища экземпляра.

SecurityGroups -> (список)

Безопасные группы для экземпляра.

(структура)

Описание безопасной группы.

GroupId -> (строка)

Идентификатор безопасной группы.

GroupName -> (строка)

Название безопасной группы.

SourceDestCheck -> (булево)

Указывает, включена ли проверка источника/назначения.

SpotInstanceRequestId -> (строка)

Если запрос — запрос на Spot-экземпляр, ID запроса.

SriovNetSupport -> (строка)

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

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

Причина последнего перехода состояния.

Code -> (строка)

Код причины изменения состояния.

Message -> (строка)

Сообщение об изменении состояния.

Server.InsufficientInstanceCapacity : Недостаточно ресурсов для удовлетворения запроса запуска.
Server.InternalError : Внутренняя ошибка привела к завершению работы экземпляра во время запуска.
Server.ScheduledStop : Экземпляр был остановлен из-за запланированного вывода из эксплуатации.
Server.SpotInstanceShutdown : Экземпляр был остановлен, потому что количество запросов Spot с максимальной ценой, равной или большей, чем цена Spot, превысило доступную ёмкость или из-за повышения цены Spot.
Server.SpotInstanceTermination : Экземпляр был завершен, потому что количество запросов Spot с максимальной ценой, равной или большей, чем цена Spot, превысило доступную ёмкость или из-за повышения цены Spot.
Client.InstanceInitiatedShutdown : Экземпляр был выключен из операционной системы экземпляра.
Client.InstanceTerminated : Экземпляр был завершен или перезагружен во время создания AMI.
Client.InternalError : Ошибка клиента привела к завершению работы экземпляра во время запуска.
Client.InvalidSnapshot.NotFound : Указанный снимок не найден.
Client.UserInitiatedHibernate : На экземпляре инициировано приостановление работы.
Client.UserInitiatedShutdown : Экземпляр был выключен с помощью API Amazon EC2.
Client.VolumeLimitExceeded : Превышен лимит на количество томов EBS или общий объем хранилища. Уменьшите использование или запросите увеличение лимитов вашей учётной записи.

Tags -> (список)

Теги, назначенные экземпляру.

(структура)

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

Key -> (строка)

Ключ тега.

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

Value -> (строка)

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

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

VirtualizationType -> (строка)

Тип виртуализации экземпляра.

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

Параметры процессора для экземпляра.

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

Количество ядер процессора для экземпляра.

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

Количество потоков на ядро процессора.

AmdSevSnp -> (строка)

Указывает, включен ли экземпляр для AMD SEV-SNP. Дополнительную информацию см. в разделе AMD SEV-SNP.

CapacityReservationId -> (строка)

Идентификатор резервирования ёмкости.

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

Информация о параметре резервирования ресурсов.

CapacityReservationPreference -> (строка)

Описание предпочтений резервирования ресурсов для экземпляра. Возможные предпочтения включают:

open - Экземпляр может запускаться в любом open резервировании ресурсов, имеющем соответствующие атрибуты (тип экземпляра, платформа, зона доступности).
none - Экземпляр избегает запуска в резервировании ресурсов, даже если оно доступно. Экземпляр запускается в емкости On-Demand.

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

Информация о целевом резервировании ресурсов или группе резервирования ресурсов.

CapacityReservationId -> (строка)

Идентификатор целевого резервирования ресурсов.

CapacityReservationResourceGroupArn -> (строка)

ARN целевой группы резервирования ресурсов.

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

Указывает, включена ли функция гибернации для экземпляра.

Configured -> (булево)

Если true , ваш экземпляр включен для гибернации; в противном случае, гибернация не включена.

Licenses -> (список)

Настройки лицензий для экземпляра.

(структура)

Описание конфигурации лицензии.

LicenseConfigurationArn -> (строка)

Amazon Resource Name (ARN) конфигурации лицензии.

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

Параметры метаданных для экземпляра.

State -> (строка)

Состояние изменения параметров метаданных.

pending - Параметры метаданных обновляются, и экземпляр не готов обрабатывать трафик метаданных с новым выбором.

applied - Параметры метаданных успешно применены к экземпляру.

HttpTokens -> (строка)

Указывает, требуется ли IMDSv2.

optional - IMDSv2 необязательно, что означает, что вы можете использовать либо IMDSv2, либо IMDSv1.
required - IMDSv2 требуется, что означает, что IMDSv1 отключен, и вы должны использовать IMDSv2.

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

Максимальное количество хопов, которое может пройти маркер метаданных.

Возможные значения: целые числа от 1 до 64

HttpEndpoint -> (строка)

Указывает, включен или отключен HTTP-пункт метаданных на ваших экземплярах.

Если значение равно disabled , вы не можете получить доступ к метаданным вашего экземпляра.

HttpProtocolIpv6 -> (строка)

Указывает, включён или выключен IPv6-пункт метаданных сервиса для экземпляра.

По умолчанию: disabled

InstanceMetadataTags -> (строка)

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

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

Указывает, включены ли для экземпляра Amazon Web Services Nitro Enclaves.

Enabled -> (булево)

Если этот параметр установлен в true , экземпляр включен для Amazon Web Services Nitro Enclaves; в противном случае, для Amazon Web Services Nitro Enclaves он не включён.

BootMode -> (строка)

Режим загрузки, указанный AMI. Если значение равно uefi-preferred , AMI поддерживает как UEFI, так и Legacy BIOS. Параметр currentInstanceBootMode — это режим загрузки, который используется для загрузки экземпляра при запуске или запуске.

Примечание

Операционная система, содержащаяся в AMI, должна быть настроена для поддержки указанного режима загрузки.

Для получения дополнительной информации см. Режимы загрузки в руководстве пользователя Amazon EC2.

PlatformDetails -> (строка)

Значение платформы для экземпляра. Для получения дополнительной информации см. Поля информации о выставлении счетов AMI в руководстве пользователя Amazon EC2.

UsageOperation -> (строка)

Значение операции использования для экземпляра. Для получения дополнительной информации см. Поля информации о выставлении счетов AMI в руководстве пользователя Amazon EC2.

UsageOperationUpdateTime -> (отметка времени)

Время последнего обновления операции использования.

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

Параметры имени хоста экземпляра.

HostnameType -> (строка)

Тип имени хоста, который нужно назначить экземпляру.

EnableResourceNameDnsARecord -> (булево)

Указывает, следует ли отвечать на запросы DNS для имен хостов экземпляра с помощью записей DNS A.

EnableResourceNameDnsAAAARecord -> (булево)

Указывает, следует ли отвечать на запросы DNS для имен хостов экземпляра с помощью записей DNS AAAA.

Ipv6Address -> (строка)

Адрес IPv6, назначенный экземпляру.

TpmSupport -> (строка)

Если экземпляр настроен для поддержки NitroTPM, значение равно v2.0 . Для получения дополнительной информации см. NitroTPM в руководстве пользователя Amazon EC2.

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

Предоставляет информацию о параметрах восстановления и обслуживания вашего экземпляра.

AutoRecovery -> (строка)

Предоставляет информацию о текущем поведении автоматического восстановления вашего экземпляра.

RebootMigration -> (строка)

Указывает, следует ли попытаться выполнить миграцию перезагрузки во время пользовательской перезагрузки экземпляра, у которого есть запланированное событие system-reboot:

default - Amazon EC2 пытается мигрировать экземпляр на новое оборудование (миграция перезагрузки). При успешной миграции событие system-reboot удаляется. При неудачной миграции происходит перезагрузка на месте, и событие остаётся запланированным.
disabled - Amazon EC2 сохраняет экземпляр на том же оборудовании (перезагрузка на месте). Событие system-reboot остаётся запланированным.

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

CurrentInstanceBootMode -> (строка)

Режим загрузки, используемый для загрузки экземпляра при запуске или запуске. Для получения дополнительной информации см. Режимы загрузки в руководстве пользователя Amazon EC2.

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

Содержит настройки параметров производительности сети для вашего экземпляра.

BandwidthWeighting -> (строка)

При настройке балансировки пропускной способности вы можете увеличить базовую пропускную способность для сетевого трафика или EBS до 25%. Общая доступная базовая пропускная способность для вашего экземпляра остается неизменной. По умолчанию используется стандартная конфигурация пропускной способности для вашего типа экземпляра.

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

Поставщик услуг, управляющий экземпляром.

Managed -> (булево)

Если true , ресурс управляется поставщиком услуг.

Principal -> (строка)

Если managed равно true , то возвращается субъект. Субъект — это поставщик услуг, управляющий ресурсом.

InstanceId -> (строка)

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

ImageId -> (строка)

Идентификатор AMI, используемого для запуска экземпляра.

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

Текущее состояние экземпляра.

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

Состояние экземпляра как 16-битное беззнаковое целое число.

Высокий байт содержит все биты между 2^8 и (2^16)-1, что равно десятичным значениям от 256 до 65535. Эти числовые значения используются для внутренних целей и должны быть проигнорированы.

Низкий байт содержит все биты между 2^0 и (2^8)-1, что равно десятичным значениям от 0 до 255.

Допустимые значения для instance-state-code будут находиться в диапазоне низкого байта и таковыми являются:

0 : pending
16 : running
32 : shutting-down
48 : terminated
64 : stopping
80 : stopped

Вы можете проигнорировать значение высокого байта, обнулив все биты выше 2^8 или 256 в десятичной форме.

Name -> (строка)

Текущее состояние экземпляра.

PrivateDnsName -> (строка)

[Только IPv4] Частное имя DNS, назначенное экземпляру. Это имя DNS может использоваться только внутри сети Amazon EC2. Это имя недоступно, пока экземпляр не перейдет в состояние running.

Сервер DNS от Amazon разрешает предоставленные Amazon частные имена хостов DNS, если вы включили разрешение DNS и имена хостов DNS в вашей VPC. Если вы не используете сервер DNS от Amazon в своей VPC, ваши собственные серверы имен домена должны разрешать имя хоста соответствующим образом.

PublicDnsName -> (строка)

[Только IPv4] Публичное имя DNS, назначенное экземпляру. Это имя недоступно, пока экземпляр не перейдет в состояние running. Это имя доступно только если вы включили имена хостов DNS для вашей VPC.

StateTransitionReason -> (строка)

Причина последнего перехода состояния. Может быть пустой строкой.

KeyName -> (строка)

Имя пары ключей, если этот экземпляр был запущен с связанной парой ключей.

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

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

ProductCodes -> (список)

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

(структура)

Описание кода продукта.

ProductCodeId -> (строка)

Код продукта.

ProductCodeType -> (строка)

Тип кода продукта.

InstanceType -> (строка)

Тип экземпляра.

LaunchTime -> (отметка времени)

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

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

Место запуска экземпляра, если применимо.

Affinity -> (строка)

Настройка сродства для экземпляра на выделенном хосте.

Этот параметр не поддерживается для CreateFleet или ImportInstance.

GroupName -> (строка)

Имя группы размещения, в которой находится экземпляр. Если вы укажете GroupName, вы не можете указать GroupId.

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

Номер раздела, в котором находится экземпляр. Действительно только если стратегия размещения группы размещения установлена в partition.

Этот параметр не поддерживается для CreateFleet.

HostId -> (строка)

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

Этот параметр не поддерживается для CreateFleet или ImportInstance.

Tenancy -> (строка)

Домен экземпляра. Экземпляр с доменом dedicated работает на оборудовании с однопоточным доступом.

Этот параметр не поддерживается для CreateFleet. Домен host не поддерживается для ImportInstance или для экземпляров T3, настроенных для опции кредитов ЦП unlimited.

SpreadDomain -> (строка)

Зарезервировано для будущего использования.

HostResourceGroupArn -> (строка)

ARN группы ресурсов хоста, в которой необходимо запустить экземпляры.

Если вы указываете этот параметр, следует либо опустить параметр Tenancy, либо установить его в значение host.

Этот параметр не поддерживается для CreateFleet.

GroupId -> (строка)

Идентификатор группы размещения, в которой находится экземпляр. Если вы укажете GroupId, вы не можете указать GroupName.

AvailabilityZone -> (строка)

Зона доступности экземпляра.

Если не указано, зона доступности будет автоматически выбрана на основе критериев балансировки нагрузки для региона.

Этот параметр не поддерживается для CreateFleet.

KernelId -> (строка)

Ядро, связанное с этим экземпляром, если применимо.

RamdiskId -> (строка)

Диск ОЗУ, связанный с этим экземпляром, если применимо.

Platform -> (строка)

Платформа. Это значение равно windows для экземпляров Windows; в противном случае оно пустое.

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

Мониторинг экземпляра.

State -> (строка)

Указывает, включен ли подробный мониторинг. В противном случае включен базовый мониторинг.

SubnetId -> (строка)

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

VpcId -> (строка)

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

PrivateIpAddress -> (строка)

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

PublicIpAddress -> (строка)

Публичный IPv4-адрес или адрес оператора, назначенный экземпляру, если применимо.

Адрес оператора применяется только к экземпляру, запущенному в подсети, связанной с зоной Wavelength.