создать-группу-автомасштабирования

Описание

Создаёт группу автоматического масштабирования с указанным именем и атрибутами.

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

Если вы новичок в Amazon EC2 Auto Scaling, ознакомьтесь с вводными руководствами в разделе Начало работы с Amazon EC2 Auto Scaling в руководстве пользователя Amazon EC2 Auto Scaling.

Каждая группа автоматического масштабирования имеет три свойства размера (DesiredCapacity , MaxSize и MinSize ). Обычно вы устанавливаете эти размеры, основываясь на определённом количестве экземпляров. Однако, если вы настроите политику смешанных экземпляров, определяющую веса для типов экземпляров, вы должны указать эти размеры с теми же единицами, что и используемые для взвешивания экземпляров.

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

Синтаксис

  create-auto-scaling-group
--auto-scaling-group-name <value>
[--launch-configuration-name <value>]
[--launch-template <value>]
[--mixed-instances-policy <value>]
[--instance-id <value>]
--min-size <value>
--max-size <value>
[--desired-capacity <value>]
[--default-cooldown <value>]
[--availability-zones <value>]
[--load-balancer-names <value>]
[--target-group-arns <value>]
[--health-check-type <value>]
[--health-check-grace-period <value>]
[--placement-group <value>]
[--vpc-zone-identifier <value>]
[--termination-policies <value>]
[--new-instances-protected-from-scale-in | --no-new-instances-protected-from-scale-in]
[--capacity-rebalance | --no-capacity-rebalance]
[--lifecycle-hook-specification-list <value>]
[--tags <value>]
[--service-linked-role-arn <value>]
[--max-instance-lifetime <value>]
[--context <value>]
[--desired-capacity-type <value>]
[--default-instance-warmup <value>]
[--traffic-sources <value>]
[--instance-maintenance-policy <value>]
[--availability-zone-distribution <value>]
[--availability-zone-impairment-policy <value>]
[--skip-zonal-shift-validation | --no-skip-zonal-shift-validation]
[--capacity-reservation-specification <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]

Параметры

--auto-scaling-group-name (строка)

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

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

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

LaunchTemplateId=string,LaunchTemplateName=string,Version=string

Синтаксис JSON:

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

--mixed-instances-policy (структура)

--desired-capacity (целое число)

--default-cooldown (целое число)

--availability-zones (список)

Синтаксис:

"string" "string" ...

--load-balancer-names (список)

Синтаксис:

"string" "string" ...

--target-group-arns (список)

Синтаксис:

"string" "string" ...

--health-check-type (строка)

--health-check-grace-period (целое число)

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

--vpc-zone-identifier (строка)

--termination-policies (список)

Синтаксис:

"string" "string" ...

--new-instances-protected-from-scale-in | --no-new-instances-protected-from-scale-in (логическое значение)

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

--lifecycle-hook-specification-list (список)

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

LifecycleHookName=string,LifecycleTransition=string,NotificationMetadata=string,HeartbeatTimeout=integer,DefaultResult=string,NotificationTargetARN=string,RoleARN=string ...

Синтаксис JSON:

[
  {
    "LifecycleHookName": "string",
    "LifecycleTransition": "string",
    "NotificationMetadata": "string",
    "HeartbeatTimeout": integer,
    "DefaultResult": "string",
    "NotificationTargetARN": "string",
    "RoleARN": "string"
  }
  ...
]

--tags (список)

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

ResourceId=string,ResourceType=string,Key=string,Value=string,PropagateAtLaunch=boolean ...

Синтаксис JSON:

[
  {
    "ResourceId": "string",
    "ResourceType": "string",
    "Key": "string",
    "Value": "string",
    "PropagateAtLaunch": true|false
  }
  ...
]

--service-linked-role-arn (строка)

--max-instance-lifetime (целое число)

--context (строка)

--desired-capacity-type (строка)

--default-instance-warmup (целое число)

--traffic-sources (список)

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

Identifier=string,Type=string ...

Синтаксис JSON:

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

--instance-maintenance-policy (структура)

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

MinHealthyPercentage=integer,MaxHealthyPercentage=integer

Синтаксис JSON:

{
  "MinHealthyPercentage": integer,
  "MaxHealthyPercentage": integer
}

--availability-zone-distribution (структура)

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

CapacityDistributionStrategy=string

Синтаксис JSON:

{
  "CapacityDistributionStrategy": "balanced-only"|"balanced-best-effort"
}

--availability-zone-impairment-policy (структура)

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

ZonalShiftEnabled=boolean,ImpairedZoneHealthCheckBehavior=string

Синтаксис JSON:

{
  "ZonalShiftEnabled": true|false,
  "ImpairedZoneHealthCheckBehavior": "ReplaceUnhealthy"|"IgnoreUnhealthy"
}

--skip-zonal-shift-validation | --no-skip-zonal-shift-validation (логическое значение)

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

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

CapacityReservationPreference=string,CapacityReservationTarget={CapacityReservationIds=[string,string],CapacityReservationResourceGroupArns=[string,string]}

Синтаксис JSON:

{
  "CapacityReservationPreference": "capacity-reservations-only"|"capacity-reservations-first"|"none"|"default",
  "CapacityReservationTarget": {
    "CapacityReservationIds": ["string", ...],
    "CapacityReservationResourceGroupArns": ["string", ...]
  }
}

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

Примеры

Пример 1: Создание группы автоматического масштабирования

Следующий create-auto-scaling-group пример создает группу автоматического масштабирования в подсетях в нескольких зонах доступности в регионе. Экземпляры запускаются с установленной по умолчанию версией указанной шаблона запуска. Обратите внимание, что для большинства других настроек, таких как политики завершения и конфигурация проверки работоспособности, используются значения по умолчанию.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12 \
    --min-size 1 \
    --max-size 5 \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Группы автоматического масштабирования в Руководстве пользователя Amazon EC2 Auto Scaling.

Пример 2: Подключение балансировщика приложения, сетевого балансировщика или балансировщика шлюза

В этом примере указывается ARN целевой группы для балансировщика, поддерживающего ожидаемый трафик. Тип проверки работоспособности задан ELB, чтобы при сообщении Elastic Load Balancing о неработоспособности экземпляра группа автоматического масштабирования заменяла его. Команда также определяет период ожидания проверки работоспособности в 600 секундах. Этот период ожидания помогает предотвратить преждевременное завершение работы недавно запущенных экземпляров.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12 \
    --target-group-arns arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/943f017f100becff \
    --health-check-type ELB \
    --health-check-grace-period 600 \
    --min-size 1 \
    --max-size 5 \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделах Elastic Load Balancing и Amazon EC2 Auto Scaling в Руководстве пользователя Amazon EC2 Auto Scaling.

Пример 3: Указание группы размещения и использование последней версии шаблона запуска

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

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-template LaunchTemplateId=lt-1234567890abcde12,Version='$Latest' \
    --min-size 1 \
    --max-size 5 \
    --desired-capacity 3 \
    --placement-group my-placement-group \
    --vpc-zone-identifier "subnet-6194ea3b"

Эта команда не генерирует вывод.

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

Пример 4: Указание группы автоматического масштабирования для одного экземпляра и использование определенной версии шаблона запуска

В этом примере создается группа автоматического масштабирования с минимальной и максимальной емкостью, установленной на 1, чтобы гарантировать запуск одного экземпляра. В команде также указана версия v1 шаблона запуска, в котором указан идентификатор существующего ENI. Когда вы используете шаблон запуска, который указывает на существующий ENI для eth0, вы должны указать зону доступности для группы автоматического масштабирования, которая соответствует сетевому интерфейсу, не указывая также идентификатор подсети в запросе.

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg-single-instance \
    --launch-template LaunchTemplateName=my-template-for-auto-scaling,Version='1' \
    --min-size 1 \
    --max-size 1 \
    --availability-zones us-west-2a

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Группы автоматического масштабирования в Руководстве пользователя Amazon EC2 Auto Scaling.

Пример 5: Указание другой политики завершения

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

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg \
    --launch-configuration-name my-lc \
    --min-size 1 \
    --max-size 5 \
    --termination-policies "OldestInstance" \
    --tags "ResourceId=my-asg,ResourceType=auto-scaling-group,Key=Role,Value=WebServer,PropagateAtLaunch=true" \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Эта команда не генерирует вывод.

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

Пример 6: Указание цикла жизненного цикла запуска

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

aws autoscaling create-auto-scaling-group \
    --cli-input-json file://~/config.json

Содержимое файла config.json:

{
    "AutoScalingGroupName": "my-asg",
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-1234567890abcde12"
    },
    "LifecycleHookSpecificationList": [{
        "LifecycleHookName": "my-launch-hook",
        "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
        "NotificationTargetARN": "arn:aws:sqs:us-west-2:123456789012:my-sqs-queue",
        "RoleARN": "arn:aws:iam::123456789012:role/my-notification-role",
        "NotificationMetadata": "SQS message metadata",
        "HeartbeatTimeout": 4800,
        "DefaultResult": "ABANDON"
    }],
    "MinSize": 1,
    "MaxSize": 5,
    "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
    "Tags": [{
        "ResourceType": "auto-scaling-group",
        "ResourceId": "my-asg",
        "PropagateAtLaunch": true,
        "Value": "test",
        "Key": "environment"
    }]
}

Эта команда не генерирует вывод.

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

Пример 7: Указание цикла жизненного цикла завершения

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

aws autoscaling create-auto-scaling-group \
    --cli-input-json file://~/config.json

Содержимое файла config.json:

{
    "AutoScalingGroupName": "my-asg",
    "LaunchTemplate": {
        "LaunchTemplateId": "lt-1234567890abcde12"
    },
    "LifecycleHookSpecificationList": [{
        "LifecycleHookName": "my-termination-hook",
        "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
        "HeartbeatTimeout": 120,
        "DefaultResult": "CONTINUE"
    }],
    "MinSize": 1,
    "MaxSize": 5,
    "TargetGroupARNs": [
        "arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/73e2d6bc24d8a067"
    ],
    "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"
}

Эта команда не генерирует вывод.

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

Пример 8: Указание пользовательской политики завершения

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

aws autoscaling create-auto-scaling-group \
    --auto-scaling-group-name my-asg-single-instance \
    --launch-template LaunchTemplateName=my-template-for-auto-scaling \
    --min-size 1 \
    --max-size 5 \
    --termination-policies "arn:aws:lambda:us-west-2:123456789012:function:HelloFunction:prod" \
    --vpc-zone-identifier "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782"

Эта команда не генерирует вывод.

Дополнительную информацию см. в разделе Создание пользовательской политики завершения с помощью Lambda в Руководстве пользователя Amazon EC2 Auto Scaling.

Вывод

Нет