run-scheduled-instances
Описание
Запускает указанные запланированные экземпляры.
Прежде чем запустить запланированный экземпляр, необходимо его приобрести и получить идентификатор, используя PurchaseScheduledInstances .
Запускать запланированный экземпляр необходимо в течение запланированного периода. Вы не можете остановить или перезапустить запланированный экземпляр, но можете его завершить по мере необходимости. Если вы завершите запланированный экземпляр до окончания текущего запланированного периода, вы можете запустить его снова через несколько минут.
См. также: Документацию API AWS
Синтаксис
run-scheduled-instances
[--client-token <value>]
[--dry-run | --no-dry-run]
[--instance-count <value>]
--launch-specification <value>
--scheduled-instance-id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]
Параметры
--client-token (строка)
--dry-run | --no-dry-run (логическое значение)
DryRunOperation . В противном случае — UnauthorizedOperation .--instance-count (целое число)
Количество экземпляров.
По умолчанию: 1
--launch-specification (структура)
Параметры запуска. Необходимо соответствие типу экземпляра, зоне доступности, сети и платформе приобретенного расписания.
BlockDeviceMappings -> (список)
Элементы отображения блочных устройств.
(структура)
Описание отображения блочного устройства для запланированного экземпляра.
DeviceName -> (строка)
/dev/sdh или xvdh ).Ebs -> (структура)
Параметры для автоматической настройки томов EBS при запуске экземпляра.
DeleteOnTermination -> (логическое значение)
Encrypted -> (логическое значение)
Iops -> (целое число)
gp3 , io1 или io2 тома.SnapshotId -> (строка)
VolumeSize -> (целое число)
Размер тома в GiB.
По умолчанию: Если том создается из моментального снимка и размер тома не указан, используется размер снимка.
VolumeType -> (строка)
Тип тома.
По умолчанию: gp2
NoDevice -> (строка)
VirtualName -> (строка)
Виртуальное имя устройства (ephemeral N). Тома памяти экземпляра нумеруются, начиная с 0. Тип экземпляра с двумя доступными томами памяти экземпляра может указывать отображения для ephemeral0 и ephemeral1 . Количество доступных томов памяти экземпляра зависит от типа экземпляра. После подключения к экземпляру необходимо смонтировать том.
Ограничения: Для экземпляров M3 необходимо указать тома памяти экземпляра в отображении блочных устройств для экземпляра. При запуске экземпляра M3 мы игнорируем любые тома памяти экземпляра, указанные в отображении блочных устройств для AMI.
EbsOptimized -> (логическое значение)
Указывает, оптимизированы ли экземпляры для операций ввода-вывода EBS. Эта оптимизация обеспечивает выделенную пропускную способность для Amazon EBS и оптимизированный стек конфигурации для обеспечения оптимальной производительности операций ввода-вывода EBS. Эта оптимизация не доступна для всех типов экземпляров. При использовании экземпляра с оптимизацией EBS применяются дополнительные сборы.
По умолчанию: false
IamInstanceProfile -> (структура)
Профиль экземпляра IAM.
Arn -> (строка)
Name -> (строка)
ImageId -> (строка)
InstanceType -> (строка)
KernelId -> (строка)
KeyName -> (строка)
Monitoring -> (структура)
Включить или отключить мониторинг для экземпляров.
Enabled -> (логическое значение)
NetworkInterfaces -> (список)
Сетевые интерфейсы.
(структура)
Описание сетевого интерфейса для запланированного экземпляра.
AssociatePublicIpAddress -> (логическое значение)
Указывает, следует ли назначить публичный IPv4-адрес экземплярам, запущенным в VPC. Публичный IPv4-адрес может быть назначен только сетевому интерфейсу eth0 и только новому сетевому интерфейсу, а не существующему. Вы не можете указать более одного сетевого интерфейса в запросе. При запуске в подсети по умолчанию значение по умолчанию — true .
Amazon Web Services взимает плату за все публичные IPv4-адреса, включая публичные IPv4-адреса, связанные с работающими экземплярами и Elastic IP-адресами. Дополнительную информацию см. на странице цен Amazon VPC на вкладке Public IPv4 Address .
DeleteOnTermination -> (логическое значение)
Description -> (строка)
DeviceIndex -> (целое число)
Groups -> (список)
Идентификаторы сетевых групп.
(строка)
Ipv6AddressCount -> (целое число)
Ipv6Addresses -> (список)
Конкретные IPv6-адреса из диапазона подсети.
(структура)
Описание IPv6-адреса.
Ipv6Address -> (строка)
NetworkInterfaceId -> (строка)
PrivateIpAddress -> (строка)
PrivateIpAddressConfigs -> (список)
Частные IPv4-адреса.
(структура)
Описание частного IPv4-адреса для запланированного экземпляра.
Primary -> (логическое значение)
PrivateIpAddress -> (строка)
SecondaryPrivateIpAddressCount -> (целое число)
SubnetId -> (строка)
Placement -> (структура)
Информация о размещении.
AvailabilityZone -> (строка)
GroupName -> (строка)
RamdiskId -> (строка)
SecurityGroupIds -> (список)
Идентификаторы сетевых групп.
(строка)
SubnetId -> (строка)
UserData -> (строка)
Синтаксис JSON:
{
"BlockDeviceMappings": [
{
"DeviceName": "string",
"Ebs": {
"DeleteOnTermination": true|false,
"Encrypted": true|false,
"Iops": integer,
"SnapshotId": "string",
"VolumeSize": integer,
"VolumeType": "string"
},
"NoDevice": "string",
"VirtualName": "string"
}
...
],
"EbsOptimized": true|false,
"IamInstanceProfile": {
"Arn": "string",
"Name": "string"
},
"ImageId": "string",
"InstanceType": "string",
"KernelId": "string",
"KeyName": "string",
"Monitoring": {
"Enabled": true|false
},
"NetworkInterfaces": [
{
"AssociatePublicIpAddress": true|false,
"DeleteOnTermination": true|false,
"Description": "string",
"DeviceIndex": integer,
"Groups": ["string", ...],
"Ipv6AddressCount": integer,
"Ipv6Addresses": [
{
"Ipv6Address": "string"
}
...
],
"NetworkInterfaceId": "string",
"PrivateIpAddress": "string",
"PrivateIpAddressConfigs": [
{
"Primary": true|false,
"PrivateIpAddress": "string"
}
...
],
"SecondaryPrivateIpAddressCount": integer,
"SubnetId": "string"
}
...
],
"Placement": {
"AvailabilityZone": "string",
"GroupName": "string"
},
"RamdiskId": "string",
"SecurityGroupIds": ["string", ...],
"SubnetId": "string",
"UserData": "string"
}
--scheduled-instance-id (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения перепишут значения, предоставленные JSON. Передача произвольных двоичных данных с помощью предоставленного значения JSON невозможна, так как строка будет взята буквально. Это значение не может быть указано вместе с --cli-input-yaml.
--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если указано без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если указано значение output, выполняется валидация входных данных команды и возвращается пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.
Общие параметры
--debug (boolean)
Включить отладку регистрации.
--endpoint-url (string)
Переопределить адрес по умолчанию команды заданным адресом.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверяет SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определенный профиль из файла аутентификации.
--region (string)
Регион для использования. Переопределяет параметры конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/выключить вывод цвета.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Кредиты не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет параметры конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде закодированной в base64 строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, отображающего двоичный блок fileb:// всегда будет обрабатываться как двоичный и использовать содержимое файла напрямую, независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.
- base64
- raw-in-base64-out
--no-cli-pager (boolean)
Отключить пейджер cli для вывода.
--cli-auto-prompt (boolean)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве «Начало работы» в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила кавычек типа Unix. Эти примеры необходимо адаптировать к правилам кавычек вашей оболочки. Подробнее см. «Использование кавычек с строками» в руководстве пользователя AWS CLI.
Запуск запланированной инстанции
В этом примере запускается указанная запланированная инстанция в VPC.
Команда:
aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json
Launch-specification.json:
{
"ImageId": "ami-12345678",
"KeyName": "my-key-pair",
"InstanceType": "c4.large",
"NetworkInterfaces": [
{
"DeviceIndex": 0,
"SubnetId": "subnet-12345678",
"AssociatePublicIpAddress": true,
"Groups": ["sg-12345678"]
}
],
"IamInstanceProfile": {
"Name": "my-iam-role"
}
}
Вывод:
{
"InstanceIdSet": [
"i-1234567890abcdef0"
]
}
В этом примере запускается указанная запланированная инстанция в EC2-Classic.
Команда:
aws ec2 run-scheduled-instances --scheduled-instance-id sci-1234-1234-1234-1234-123456789012 --instance-count 1 --launch-specification file://launch-specification.json
Launch-specification.json:
{
"ImageId": "ami-12345678",
"KeyName": "my-key-pair",
"SecurityGroupIds": ["sg-12345678"],
"InstanceType": "c4.large",
"Placement": {
"AvailabilityZone": "us-west-2b"
}
"IamInstanceProfile": {
"Name": "my-iam-role"
}
}
Вывод:
{
"InstanceIdSet": [
"i-1234567890abcdef0"
]
}
Вывод
InstanceIdSet -> (список)
Идентификаторы только что запущенных инстанций.
(строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.