Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

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 -> (целое число)

Количество операций ввода-вывода в секунду (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 -> (строка)

Amazon Resource Name (ARN).

Name -> (строка)

Имя.

ImageId -> (строка)

Идентификатор Amazon Machine Image (AMI).

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 -> (целое число)

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

Ipv6Addresses -> (список)

Конкретные IPv6-адреса из диапазона подсети.

(структура)

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

Ipv6Address -> (строка)

IPv6-адрес.

NetworkInterfaceId -> (строка)

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

PrivateIpAddress -> (строка)

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

PrivateIpAddressConfigs -> (список)

Частные IPv4-адреса.

(структура)

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

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

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

PrivateIpAddress -> (строка)

IPv4-адрес.

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

Количество вторичных частных IPv4-адресов.

SubnetId -> (строка)

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

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

Информация о размещении.

AvailabilityZone -> (строка)

Зона доступности.

GroupName -> (строка)

Имя группы размещения.

RamdiskId -> (строка)

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

SecurityGroupIds -> (список)

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

(строка)

SubnetId -> (строка)

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

UserData -> (строка)

Кодированные в base64 данные пользователя.

Синтаксис 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.

Spec-Zone.ru

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