create-launch-configuration

Описание

Создаёт конфигурацию запуска.

Если вы превысите максимальное количество конфигураций запуска, вызов завершится неудачей. Для получения этой информации вызовите API DescribeAccountLimits. Сведения об обновлении этого ограничения см. в разделе Квоты для Amazon EC2 Auto Scaling в руководстве пользователя Amazon EC2 Auto Scaling.

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

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

Синтаксис

  create-launch-configuration
--launch-configuration-name <value>
[--image-id <value>]
[--key-name <value>]
[--security-groups <value>]
[--classic-link-vpc-id <value>]
[--classic-link-vpc-security-groups <value>]
[--user-data <value>]
[--instance-id <value>]
[--instance-type <value>]
[--kernel-id <value>]
[--ramdisk-id <value>]
[--block-device-mappings <value>]
[--instance-monitoring <value>]
[--spot-price <value>]
[--iam-instance-profile <value>]
[--ebs-optimized | --no-ebs-optimized]
[--associate-public-ip-address | --no-associate-public-ip-address]
[--placement-tenancy <value>]
[--metadata-options <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]

Параметры

--launch-configuration-name (строка)

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

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

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

Синтаксис:

"string" "string" ...

--classic-link-vpc-id (строка)

--classic-link-vpc-security-groups (список)

Синтаксис:

"string" "string" ...

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

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

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

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

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

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

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

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

Синтаксис JSON:

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

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

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

Enabled=boolean

Синтаксис JSON:

{
  "Enabled": true|false
}

--spot-price (строка)

--iam-instance-profile (строка)

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

--associate-public-ip-address | --no-associate-public-ip-address (логическое значение)

--placement-tenancy (строка)

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

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

HttpTokens=string,HttpPutResponseHopLimit=integer,HttpEndpoint=string

Синтаксис JSON:

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

--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
• текст
• таблица
• yaml
• yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• вкл
• выкл
• авто

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

Примеры

Пример 1: Создание конфигурации запуска

В этом примере создается простая конфигурация запуска.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Создание конфигурации запуска» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 2: Создание конфигурации запуска с группой безопасности, парой ключей и скриптом подготовки

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

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --security-groups sg-eb2af88example \
    --key-name my-key-pair \
    --user-data file://myuserdata.txt

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Создание конфигурации запуска» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 3: Создание конфигурации запуска с ролью IAM

В этом примере создается конфигурация запуска с именем профиля экземпляра роли IAM.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --iam-instance-profile my-autoscaling-role

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Роль IAM для приложений, работающих на экземплярах Amazon EC2» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 4: Создание конфигурации запуска с включенным подробным мониторингом

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

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --instance-monitoring Enabled=true

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Настройка мониторинга для экземпляров Auto Scaling» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 5: Создание конфигурации запуска, запускающей экземпляры Spot

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

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --spot-price "0.50"

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Запрос экземпляров Spot» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 6: Создание конфигурации запуска, используя экземпляр EC2

В этом примере создается конфигурация запуска на основе атрибутов существующего экземпляра. Она перезаписывает параметры размещения и наличие публичного IP-адреса, включив опции --placement-tenancy и --no-associate-public-ip-address.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc-from-instance \
    --instance-id i-0123a456700123456 \
    --instance-type m5.large \
    --no-associate-public-ip-address \
    --placement-tenancy dedicated

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «Создание конфигурации запуска, используя экземпляр EC2» в руководстве пользователя Amazon EC2 Auto Scaling.

Пример 7: Создание конфигурации запуска с отображением блочных устройств для тома Amazon EBS

В этом примере создается конфигурация запуска с отображением блочных устройств для тома Amazon EBS gp3 с именем устройства /dev/sdh и размером 20.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdh","Ebs":{"VolumeSize":20,"VolumeType":"gp3"}}]'

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «EBS» в справочнике по API Amazon EC2 Auto Scaling.

Справочная информация о синтаксисе для цитирования значений параметров в формате JSON — в разделе «Использование кавычек со строками в AWS CLI» в руководстве пользователя AWS Command Line Interface.

Пример 8: Создание конфигурации запуска с отображением блочных устройств для тома хранилища экземпляра

В этом примере создается конфигурация запуска с ephemeral1 как томом хранилища экземпляра с именем устройства /dev/sdc.

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdc","VirtualName":"ephemeral1"}]'

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «BlockDeviceMapping» в справочнике по API Amazon EC2 Auto Scaling.

Справочная информация о синтаксисе для цитирования значений параметров в формате JSON — в разделе «Использование кавычек со строками в AWS CLI» в руководстве пользователя AWS Command Line Interface.

Пример 9: Создание конфигурации запуска и подавление присоединения блочного устройства при запуске

В этом примере создается конфигурация запуска, подавляющая присоединение блочного устройства, указанного в отображении блочных устройств AMI (например, /dev/sdf).

aws autoscaling create-launch-configuration \
    --launch-configuration-name my-lc \
    --image-id ami-04d5cc9b88example \
    --instance-type m5.large \
    --block-device-mappings '[{"DeviceName":"/dev/sdf","NoDevice":""}]'

Эта команда не выводит никакой информации.

Дополнительную информацию см. в разделе «BlockDeviceMapping» в справочнике по API Amazon EC2 Auto Scaling.

Справочная информация о синтаксисе для цитирования значений параметров в формате JSON — в разделе «Использование кавычек со строками в AWS CLI» в руководстве пользователя AWS Command Line Interface.

Вывод

Нет