Spec-Zone.ru › AWS CLI v2

[ aws . opsworks ]

create-instance

Описание

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

Требуемые разрешения: для использования этого действия пользователь IAM должен иметь уровень разрешений «Управление» для стека или прикреплённую политику, которая явно предоставляет разрешения. Дополнительную информацию о разрешениях пользователей см. в разделе Управление разрешениями пользователей.

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

Синтаксис

  create-instance
--stack-id <value>
--layer-ids <value>
--instance-type <value>
[--auto-scaling-type <value>]
[--hostname <value>]
[--os <value>]
[--ami-id <value>]
[--ssh-key-name <value>]
[--availability-zone <value>]
[--virtualization-type <value>]
[--subnet-id <value>]
[--architecture <value>]
[--root-device-type <value>]
[--block-device-mappings <value>]
[--install-updates-on-boot | --no-install-updates-on-boot]
[--ebs-optimized | --no-ebs-optimized]
[--agent-version <value>]
[--tenancy <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]

Параметры

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

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

--layer-ids (список)

Массив, содержащий идентификаторы слоёв экземпляра.

(строка)

Синтаксис:

"string" "string" ...

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

Тип экземпляра, например, t2.micro. Список поддерживаемых типов экземпляров можно открыть в консоли, выбрать Экземпляры и + Экземпляр. В списке Размер отображаются поддерживаемые типы. Дополнительную информацию см. в разделе Семейства и типы экземпляров. Значения параметров для указания различных типов приведены в столбце Имя API таблицы Доступные типы экземпляров.

--auto-scaling-type (строка)

Для экземпляров, основанных на нагрузке или времени, тип. Стеки Windows могут использовать только экземпляры, основанные на времени.

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

  • load
  • timer

--hostname (строка)

Имя хоста экземпляра. Ниже приведены ограничения на длину имени хоста экземпляра.

  • Экземпляры на базе Linux: 63 символа
  • Экземпляры на базе Windows: 15 символов

--os (строка)

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

  • Поддерживаемая операционная система Linux: версия Amazon Linux, такая как Amazon Linux 2 , Amazon Linux 2018.03 , Amazon Linux 2017.09 , Amazon Linux 2017.03 , Amazon Linux 2016.09 , Amazon Linux 2016.03 , Amazon Linux 2015.09 или Amazon Linux 2015.03 .
  • Поддерживаемая операционная система Ubuntu, например Ubuntu 18.04 LTS , Ubuntu 16.04 LTS , Ubuntu 14.04 LTS или Ubuntu 12.04 LTS .
  • CentOS Linux 7
  • Red Hat Enterprise Linux 7
  • Поддерживаемая операционная система Windows, например, Microsoft Windows Server 2012 R2 Base , Microsoft Windows Server 2012 R2 with SQL Server Express , Microsoft Windows Server 2012 R2 with SQL Server Standard или Microsoft Windows Server 2012 R2 with SQL Server Web .
  • Пользовательская AMI: Custom .

Не все операционные системы поддерживаются во всех версиях Chef. Дополнительную информацию о поддерживаемых операционных системах см. в разделе Операционные системы стеков OpsWorks.

По умолчанию используется текущая версия Amazon Linux. Если вы установите этот параметр на значение Custom, вы должны использовать параметр AmiId действия CreateInstance для указания пользовательской AMI, которую вы хотите использовать. Маппинг блочных устройств не поддерживается, если значение равно Custom. Дополнительную информацию о том, как использовать пользовательские AMI с OpsWorks Stacks, см. в разделе Использование пользовательских AMI.

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

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

Примечание

Если вы указываете пользовательскую AMI, вы должны установить Os на значение Custom.

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

Имя пары ключей Amazon EC2 экземпляра.

--availability-zone (строка)

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

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

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

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

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

--architecture (строка)

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

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

  • x86_64
  • i386

--root-device-type (строка)

Тип корневого устройства экземпляра. Дополнительную информацию см. в разделе Хранилище корневого устройства.

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

  • ebs
  • instance-store

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

Массив объектов BlockDeviceMapping, которые определяют блочные устройства экземпляра. Дополнительную информацию см. в разделе Маппинг блочных устройств. Обратите внимание, что маппинг блочных устройств не поддерживается для пользовательских AMI.

(структура)

Описывает маппинг блочных устройств. Этот тип данных непосредственно отображается на тип данных Amazon EC2 BlockDeviceMapping.

DeviceName -> (строка)

Имя устройства, экспонируемое для экземпляра, например, /dev/sdh. Для корневого устройства можно использовать явное имя устройства, или установить этот параметр на значение ROOT_DEVICE и OpsWorks Stacks предоставит правильное имя устройства.

NoDevice -> (строка)

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

VirtualName -> (строка)

Виртуальное имя устройства. Дополнительную информацию см. в разделе BlockDeviceMapping.

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

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

SnapshotId -> (строка)

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

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

Количество операций ввода-вывода в секунду (IOPS), которые поддерживает томовой. Дополнительную информацию см. в разделе EbsBlockDevice.

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

Размер томового в GiB. Дополнительную информацию см. в разделе EbsBlockDevice.

VolumeType -> (строка)

Тип томового. gp2 для томовых общего назначения (SSD), io1 для томовых с предварительно заданными IOPS (SSD), st1 для томовых с оптимизацией пропускной способности (HDD), sc1 для томовых холодного типа HDD и standard для магнитных томовых.

Если вы указываете тип томового io1, вы также должны указать значение атрибута Iops. Максимальное отношение заданных IOPS к запрошенному размеру томового (в GiB) равно 50:1. Amazon Web Services использует размер томового по умолчанию (в GiB), указанный в атрибутах AMI, для установки IOPS на 50 × (размер томового).

DeleteOnTermination -> (булево)

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

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

DeviceName=string,NoDevice=string,VirtualName=string,Ebs={SnapshotId=string,Iops=integer,VolumeSize=integer,VolumeType=string,DeleteOnTermination=boolean} ...

JSON-синтаксис:

[
  {
    "DeviceName": "string",
    "NoDevice": "string",
    "VirtualName": "string",
    "Ebs": {
      "SnapshotId": "string",
      "Iops": integer,
      "VolumeSize": integer,
      "VolumeType": "gp2"|"io1"|"standard",
      "DeleteOnTermination": true|false
    }
  }
  ...
]

--install-updates-on-boot | --no-install-updates-on-boot (булево)

Установка операционной системы и пакетов обновлений при загрузке экземпляра. Значение по умолчанию — true. Чтобы управлять установкой обновлений, установите это значение в false. После этого вы должны обновить экземпляры вручную, используя команду CreateDeployment для запуска стека update_dependencies или вручную выполняя yum (Amazon Linux) или apt-get (Ubuntu) на экземплярах.

Примечание

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

--ebs-optimized | --no-ebs-optimized (булево)

Создание оптимизированного экземпляра Amazon EBS.

--agent-version (строка)

Версия агента OpsWorks Stacks по умолчанию. У вас есть следующие варианты:

  • INHERIT - Использование значения версии агента по умолчанию стека.
  • version_number - Использование указанной версии агента. Это значение переопределяет значение по умолчанию стека. Чтобы обновить версию агента, измените конфигурацию экземпляра и укажите новую версию. OpsWorks Stacks установит эту версию на экземпляре.

Значение по умолчанию — INHERIT. Чтобы указать версию агента, вы должны использовать полное значение версии, а не сокращенное, показанное в консоли. Для получения списка доступных версий агентов вызовите DescribeAgentVersions. AgentVersion не может быть установлен на Chef 12.2.

--tenancy (строка)

Опция аренды экземпляра. По умолчанию аренда не используется или, если экземпляр работает в VPC, настройки аренды наследуются от VPC. Допустимые значения для этого параметра: dedicated, default или host. Поскольку изменения настроек аренды связаны с расходами, мы рекомендуем изучить варианты аренды перед выбором их для ваших экземпляров. Дополнительную информацию о выделенных хостах см. в разделе Обзор выделенных хостов и Amazon EC2 Dedicated Hosts. Дополнительную информацию о выделенных экземплярах см. в разделах Выделенные экземпляры и Amazon EC2 Dedicated Instances.

--cli-input-json | --cli-input-yaml (строка) Чтение аргументов из предоставленной JSON-строки. JSON-строка следует формату, предоставленному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, предоставленные в JSON. Невозможно передать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет принята буквально. Этот параметр не может быть указан совместно с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено значение без значения или со значением input, выводится пример JSON-ввода, который может использоваться в качестве аргумента для --cli-input-json. Аналогично, если предоставлено значение yaml-input, будет напечатан пример YAML-ввода, который может использоваться с --cli-input-yaml. При предоставлении значения output, входные данные команды будут проверены, и будет возвращён пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Общие параметры

--debug (boolean)

Включить отладку регистрации.

--endpoint-url (string)

Заменить стандартный URL команды на указанный URL.

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

  • json
  • text
  • table
  • yaml
  • yaml-stream

--query (string)

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

--profile (string)

Использовать определённый профиль из файла с вашими учетными данными.

--region (string)

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

--version (string)

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

--color (string)

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

  • on
  • off
  • auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображающего двоичный блок fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла напрямую, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

  • base64
  • raw-in-base64-out

--no-cli-pager (boolean)

Отключить пагинатор CLI для вывода.

--cli-auto-prompt (boolean)

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

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

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

Примеры

Примечание

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

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

Создание экземпляра

Следующая create-instance команда создает экземпляр Amazon Linux m1.large с именем myinstance1 в указанном стеке. Экземпляр назначается одному слою.

aws opsworks --region us-east-1 create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --hostname myinstance1 --instance-type m1.large --os "Amazon Linux"

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

Вывод:

{
  "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}

Дополнительная информация

Дополнительную информацию см. в разделе Добавление экземпляра в слой в Руководстве пользователя AWS OpsWorks.

Вывод

InstanceId -> (строка)

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

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

Spec-Zone.ru

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