describe-auto-scaling-groups

Описание

Получает информацию о группах автоматического масштабирования в аккаунте и регионе.

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

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

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

describe-auto-scaling-groups является постраничной операцией. Для получения всего набора результатов могут быть вызваны несколько API-вызовов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе на постраничный запрос, аргумент --query должен извлекать данные из результатов следующих выражений запроса: AutoScalingGroups

Синтаксис

  describe-auto-scaling-groups
[--auto-scaling-group-names <value>]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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-names (список)

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

Если вы опустите это свойство, будут описаны все группы автоматического масштабирования.

(строка)

Синтаксис:

"string" "string" ...

--filters (список)

Один или несколько фильтров для ограничения результатов на основе определенных тегов.

(структура)

Описание фильтра, используемого для возвращения более конкретного списка результатов из операции describe.

Если вы указываете несколько фильтров, фильтры автоматически объединяются логически с AND , и запрос возвращает только результаты, которые соответствуют всем указанным фильтрам.

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

Имя -> (строка)

Имя фильтра.

Допустимые значения для Name зависят от того, какую операцию API вы используете с фильтром (DescribeAutoScalingGroups или DescribeTags).

DescribeAutoScalingGroups

Допустимые значения для Name включают следующие:

tag-key - Принимает ключи тегов. Результаты содержат только информацию о группах автоматического масштабирования, связанных с этими ключами тегов.
tag-value - Принимает значения тегов. Результаты содержат только информацию о группах автоматического масштабирования, связанных с этими значениями тегов.
tag:<key> - Принимает сочетание ключ/значение тега. Используйте ключ тега в имени фильтра, а значение тега - в качестве значения фильтра. Результаты содержат только информацию о группах автоматического масштабирования, связанных с указанным сочетанием ключ/значение.

DescribeTags

Допустимые значения для Name включают следующие:

auto-scaling-group - Принимает имена групп автоматического масштабирования. Результаты содержат только информацию о тегах, связанных с этими группами автоматического масштабирования.
key - Принимает ключи тегов. Результаты содержат только информацию о тегах, связанных с этими ключами тегов.
value - Принимает значения тегов. Результаты содержат только информацию о тегах, связанных с этими значениями тегов.
propagate-at-launch - Принимает логическое значение, указывающее, распространяются ли теги на экземпляры при запуске. Результаты содержат только информацию о тегах, связанных с указанным логическим значением.

Значения -> (список)

Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.

Если вы указываете несколько значений для фильтра, значения автоматически объединяются логически с OR , и запрос возвращает все результаты, которые соответствуют любому из указанных значений. Например, укажите «tag:environment» для имени фильтра и «production,development» для значений фильтра, чтобы найти группы автоматического масштабирования с тегом «environment=production» или «environment=development».

(строка)

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

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

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

--starting-token (строка)

Маркер для указания места начала постраничной обработки. Это NextToken из ранее усечённого ответа.

Примеры использования см. в раздела Pagination в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-службы.

Примеры использования см. в разделе Pagination в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно вне AWS CLI.

Примеры использования см. в разделе Pagination в Руководстве пользователя AWS Command Line Interface.

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

Глобальные параметры

--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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Пример 1: Чтобы описать указанную группу Auto Scaling

В этом примере описывается указанная группа Auto Scaling.

aws autoscaling describe-auto-scaling-groups \
    --auto-scaling-group-names my-asg

Вывод:

{
    "AutoScalingGroups": [
        {
            "AutoScalingGroupName": "my-asg",
            "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg",
            "LaunchTemplate": {
                "LaunchTemplateName": "my-launch-template",
                "Version": "1",
                "LaunchTemplateId": "lt-1234567890abcde12"
            },
            "MinSize": 0,
            "MaxSize": 1,
            "DesiredCapacity": 1,
            "DefaultCooldown": 300,
            "AvailabilityZones": [
                "us-west-2a",
                "us-west-2b",
                "us-west-2c"
            ],
            "LoadBalancerNames": [],
            "TargetGroupARNs": [],
            "HealthCheckType": "EC2",
            "HealthCheckGracePeriod": 0,
            "Instances": [
                {
                    "InstanceId": "i-06905f55584de02da",
                    "InstanceType": "t2.micro",
                    "AvailabilityZone": "us-west-2a",
                    "HealthStatus": "Healthy",
                    "LifecycleState": "InService",
                    "ProtectedFromScaleIn": false,
                    "LaunchTemplate": {
                        "LaunchTemplateName": "my-launch-template",
                        "Version": "1",
                        "LaunchTemplateId": "lt-1234567890abcde12"
                    }
                }
            ],
            "CreatedTime": "2023-10-28T02:39:22.152Z",
            "SuspendedProcesses": [],
            "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
            "EnabledMetrics": [],
            "Tags": [],
            "TerminationPolicies": [
                "Default"
            ],
            "NewInstancesProtectedFromScaleIn": false,
            "ServiceLinkedRoleARN":"arn",
            "TrafficSources": []
        }
    ]
}

Пример 2: Чтобы описать первые 100 указанных групп Auto Scaling

В этом примере описываются указанные группы Auto Scaling. Это позволяет указать до 100 имен групп.

aws autoscaling describe-auto-scaling-groups \
    --max-items 100 \
    --auto-scaling-group-names "group1" "group2" "group3" "group4"

См. пример 1 для примера вывода.

Пример 3: Чтобы описать группу Auto Scaling в указанном регионе

В этом примере описываются группы Auto Scaling в указанном регионе, максимум до 75 групп.

aws autoscaling describe-auto-scaling-groups \
    --max-items 75 \
    --region us-east-1

См. пример 1 для примера вывода.

Пример 4: Чтобы описать указанное количество групп Auto Scaling

Чтобы вернуть определенное количество групп Auto Scaling, используйте параметр --max-items.

aws autoscaling describe-auto-scaling-groups \
    --max-items 1

См. пример 1 для примера вывода.

Если вывод включает поле NextToken, имеется больше групп. Чтобы получить дополнительные группы, используйте значение этого поля с параметром --starting-token в последующем вызове следующим образом.

aws autoscaling describe-auto-scaling-groups \
    --starting-token Z3M3LMPEXAMPLE

См. пример 1 для примера вывода.

Пример 5: Чтобы описать группы Auto Scaling, которые используют конфигурации запуска

В этом примере используется параметр --query для описания групп Auto Scaling, которые используют конфигурации запуска.

aws autoscaling describe-auto-scaling-groups \
    --query 'AutoScalingGroups[?LaunchConfigurationName!=`null`]'

Вывод:

[
    {
        "AutoScalingGroupName": "my-asg",
        "AutoScalingGroupARN": "arn:aws:autoscaling:us-west-2:123456789012:autoScalingGroup:930d940e-891e-4781-a11a-7b0acd480f03:autoScalingGroupName/my-asg",
        "LaunchConfigurationName": "my-lc",
        "MinSize": 0,
        "MaxSize": 1,
        "DesiredCapacity": 1,
        "DefaultCooldown": 300,
        "AvailabilityZones": [
            "us-west-2a",
            "us-west-2b",
            "us-west-2c"
        ],
        "LoadBalancerNames": [],
        "TargetGroupARNs": [],
        "HealthCheckType": "EC2",
        "HealthCheckGracePeriod": 0,
        "Instances": [
            {
                "InstanceId": "i-088c57934a6449037",
                "InstanceType": "t2.micro",
                "AvailabilityZone": "us-west-2c",
                "HealthStatus": "Healthy",
                "LifecycleState": "InService",
                "LaunchConfigurationName": "my-lc",
                "ProtectedFromScaleIn": false
            }
        ],
        "CreatedTime": "2023-10-28T02:39:22.152Z",
        "SuspendedProcesses": [],
        "VPCZoneIdentifier": "subnet-5ea0c127,subnet-6194ea3b,subnet-c934b782",
        "EnabledMetrics": [],
        "Tags": [],
        "TerminationPolicies": [
            "Default"
        ],
        "NewInstancesProtectedFromScaleIn": false,
        "ServiceLinkedRoleARN":"arn",
        "TrafficSources": []
    }
]

Для получения дополнительной информации см. Фильтрация вывода AWS CLI в Руководстве пользователя интерфейса командной строки AWS.

Вывод

AutoScalingGroups -> (list)

Группы.

(structure)

Описывает группу Auto Scaling.

AutoScalingGroupName -> (string)

Имя группы Auto Scaling.

AutoScalingGroupARN -> (string)

Имя ресурса Amazon (ARN) группы Auto Scaling.

LaunchConfigurationName -> (string)

Имя связанной конфигурации запуска.

LaunchTemplate -> (structure)

Шаблон запуска для группы.

LaunchTemplateId -> (string)

Идентификатор шаблона запуска. Чтобы получить идентификатор шаблона, используйте операцию API Amazon EC2 DescribeLaunchTemplates. Новые шаблоны запуска можно создать с помощью API Amazon EC2 CreateLaunchTemplate.

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

LaunchTemplateName -> (string)

Имя шаблона запуска. Чтобы получить имя шаблона, используйте операцию API Amazon EC2 DescribeLaunchTemplates. Новые шаблоны запуска можно создать с помощью API Amazon EC2 CreateLaunchTemplate.

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

Version -> (string)

Номер версии, $Latest или $Default. Чтобы получить номер версии, используйте операцию API Amazon EC2 DescribeLaunchTemplateVersions. Новые версии шаблонов запуска можно создать с помощью API Amazon EC2 CreateLaunchTemplateVersion. Если значение $Latest, Amazon EC2 Auto Scaling выбирает последнюю версию шаблона запуска при запуске экземпляров. Если значение $Default, Amazon EC2 Auto Scaling выбирает версию шаблона запуска по умолчанию при запуске экземпляров. Значение по умолчанию — $Default.

MixedInstancesPolicy -> (structure)

Политика смешанных экземпляров для группы.

LaunchTemplate -> (structure)

Один или несколько шаблонов запуска и типы экземпляров (переопределения), которые используются для запуска экземпляров EC2 для удовлетворения требований к ресурсам по запросу и Spot.

LaunchTemplateSpecification -> (structure)

Шаблон запуска.

LaunchTemplateId -> (string)

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

LaunchTemplateName -> (string)

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

Version -> (string)

Overrides -> (list)

Все свойства, которые вы указываете, переопределяют те же свойства в шаблоне запуска.

(structure)

Используйте эту структуру, чтобы разрешить Amazon EC2 Auto Scaling выполнять следующие действия, когда у группы Auto Scaling есть политика смешанных экземпляров:

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

Укажите типы экземпляров, которые вы хотите использовать, или вместо этого определите требования к экземплярам и позвольте Amazon EC2 Auto Scaling предоставить доступные типы экземпляров, соответствующие вашим требованиям. Это может предоставить Amazon EC2 Auto Scaling более широкий выбор типов экземпляров для выбора при выполнении требований к Spot- и On-Demand-ресурсам. Вы можете просмотреть, какие типы экземпляров соответствуют требованиям, прежде чем применять эти требования к группе Auto Scaling.

После определения требований к экземплярам вам не нужно постоянно обновлять эти параметры, чтобы автоматически получать новые типы экземпляров EC2. Amazon EC2 Auto Scaling использует требования к экземплярам группы Auto Scaling, чтобы определить, можно ли использовать новый тип экземпляра EC2.

InstanceType -> (string)

Тип экземпляра, например m3.xlarge. Необходимо указать тип экземпляра, который поддерживается в вашем запрошенном регионе и зонах доступности. Дополнительные сведения см. в разделе Типы экземпляров в Руководстве пользователя Amazon EC2 для экземпляров Linux .

Можно указать до 40 типов экземпляров на группу Auto Scaling.

WeightedCapacity -> (string)

Если вы предоставляете список типов экземпляров для использования, можно указать количество единиц ресурсов, предоставляемых каждым типом экземпляра, с точки зрения виртуальных ЦП, памяти, хранилища, пропускной способности или другой относительной характеристики производительности. Когда запускается экземпляр Spot или On-Demand, единицы ресурсов учитываются в желаемой мощности. Amazon EC2 Auto Scaling запускает экземпляры до тех пор, пока желаемая мощность не будет полностью удовлетворена, даже если это приведет к перерасходу. Например, если осталось две единицы для удовлетворения мощности, а Amazon EC2 Auto Scaling может запустить только экземпляр с WeightedCapacity пятью единицами, экземпляр запускается, и желаемая мощность превышена на три единицы. Дополнительные сведения см. в разделе Настройка группы Auto Scaling для использования весов экземпляров в Руководстве пользователя Amazon EC2 Auto Scaling . Значение должно быть в диапазоне от 1 до 999.

Если вы укажете значение WeightedCapacity для одного типа экземпляра, необходимо указать значение WeightedCapacity для всех остальных.

Предупреждение

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

LaunchTemplateSpecification -> (structure)

Предоставляет шаблон запуска для указанного типа экземпляра или набора требований к экземплярам. Например, некоторым типам экземпляров может потребоваться шаблон запуска с другим AMI. Если не указано, Amazon EC2 Auto Scaling использует шаблон запуска, указанный в определении LaunchTemplate. Дополнительные сведения см. в разделе Указание другого шаблона запуска для типа экземпляра в Руководстве пользователя Amazon EC2 Auto Scaling .

Можно указать до 20 шаблонов запуска на группу Auto Scaling. Шаблоны запуска, указанные в переопределениях и в определении LaunchTemplate, учитываются в этом ограничении.

LaunchTemplateId -> (string)

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

LaunchTemplateName -> (string)

Условно: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

Version -> (string)

InstanceRequirements -> (structure)

Требования к экземплярам. Amazon EC2 Auto Scaling использует указанные вами требования для определения типов экземпляров. Затем он использует ваши стратегии распределения On-Demand и Spot для запуска экземпляров из этих типов.

Вы можете указать до четырёх наборов требований к экземплярам на группу Auto Scaling. Это полезно для предоставления экземпляров из различных Amazon Machine Images (AMI) в одной группе Auto Scaling. Для этого создайте AMI и создайте новую шаблон запуска для каждого AMI. Затем создайте совместимый набор требований к экземплярам для каждого шаблона запуска.

Примечание

Если вы укажете InstanceRequirements, вы не можете указать InstanceType.

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

Минимальное и максимальное количество vCPU для типа экземпляра.

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

Минимальное количество vCPU.

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

Максимальное количество vCPU.

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

Минимальный и максимальный размер памяти экземпляра для типа экземпляра в MiB.

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

Минимальный размер памяти в MiB.

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

Максимальный размер памяти в MiB.

CpuManufacturers -> (список)

Список производителей процессоров, которые нужно включить.

Для типов экземпляров с процессорами Intel укажите intel.
Для типов экземпляров с процессорами AMD укажите amd.
Для типов экземпляров с процессорами Amazon Web Services укажите amazon-web-services.

Примечание

Не путайте производителя аппаратного обеспечения процессора с архитектурой аппаратного обеспечения процессора. Экземпляры будут запускаться с совместимой архитектурой процессора на основе Amazon Machine Image (AMI), которую вы указываете в своём шаблоне запуска.

По умолчанию: любой производитель

(строка)

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

Минимальное и максимальное количество памяти на vCPU для типа экземпляра в GiB.

По умолчанию: нет минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный объём памяти в GiB.

Max -> (вещественное число)

Максимальный объём памяти в GiB.

ExcludedInstanceTypes -> (список)

Типы экземпляров, которые нужно исключить. Вы можете использовать строки с одной или несколькими подстановочными знаками, представленными звёздочкой (*), чтобы исключить семейство, тип, размер или поколение экземпляров. Ниже приведены примеры: m5.8xlarge, c5*.*, m5a.*, r*, *3*.

Например, если вы укажете c5*, вы исключаете всё семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.*, Amazon EC2 Auto Scaling исключит все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете ExcludedInstanceTypes, вы не можете указать AllowedInstanceTypes.

По умолчанию: нет исключённых типов экземпляров

(строка)

InstanceGenerations -> (список)

Указывает, включены ли экземпляры текущего или предыдущего поколения.

Для типов экземпляров текущего поколения укажите current. Текущее поколение включает типы экземпляров EC2, которые в настоящее время рекомендуются к использованию. Как правило, это последние две-три версии в каждом семействе экземпляров. Дополнительную информацию см. в разделе Типы экземпляров в Руководстве пользователя Amazon EC2 для Linux-экземпляров.
Для типов экземпляров предыдущего поколения укажите previous.

По умолчанию: любые типы текущего или предыдущего поколения

(строка)

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

[Защита от цен] Пороговое значение цены для Spot-экземпляров в процентах выше, чем указанная цена Spot. Указанная цена Spot — это цена самого низкого типа экземпляра текущего поколения C, M или R с заданными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то указанная цена взята либо с самого низкого типа экземпляров текущего поколения, либо, в крайнем случае, с самого низкого типа экземпляров предыдущего поколения, соответствующих вашим атрибутам. При выборе Amazon EC2 Auto Scaling типов экземпляров с заданными атрибутами типы экземпляров, цена которых превышает указанный порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 Auto Scaling интерпретирует как процент.

Если вы установите DesiredCapacityType в vcpu или memory-mib, порог защиты от цен будет основан на цене за vCPU или за память, а не на цене за экземпляр.

Примечание

Можно указать только один из SpotMaxPricePercentageOverLowestPrice или MaxSpotPriceAsPercentageOfOptimalOnDemandPrice. Если ни один из них не указан, Amazon EC2 Auto Scaling автоматически применит оптимальную защиту от цен, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порога защиты от цен для Spot-экземпляров, то есть вы хотите рассмотреть все типы экземпляров, которые соответствуют вашим атрибутам, укажите один из этих параметров и установите высокое значение, например, 999999.

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

[Защита от цен] Пороговое значение цены для Spot-экземпляров в процентах от указанной цены On-Demand. Указанная цена On-Demand — это цена самого низкого типа экземпляра текущего поколения C, M или R с заданными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то указанная цена взята либо с самого низкого типа экземпляров текущего поколения, либо, в крайнем случае, с самого низкого типа экземпляров предыдущего поколения, соответствующих вашим атрибутам. При выборе Amazon EC2 Auto Scaling типов экземпляров с заданными атрибутами типы экземпляров, цена которых превышает указанный порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 Auto Scaling интерпретирует как процент.

Примечание

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

[Защита от цен] Пороговое значение цены для On-Demand-экземпляров в процентах выше, чем указанная цена On-Demand. Указанная цена On-Demand — это цена самого низкого типа экземпляра текущего поколения C, M или R с заданными вами атрибутами. Если ни один тип экземпляра текущего поколения C, M или R не соответствует вашим атрибутам, то указанная цена взята либо с самого низкого типа экземпляров текущего поколения, либо, в крайнем случае, с самого низкого типа экземпляров предыдущего поколения, соответствующих вашим атрибутам. При выборе Amazon EC2 Auto Scaling типов экземпляров с заданными атрибутами типы экземпляров, цена которых превышает указанный порог, будут исключены.

Параметр принимает целое число, которое Amazon EC2 Auto Scaling интерпретирует как процент.

Для отключения защиты от цен укажите высокое значение, например, 999999.

Если вы установите DesiredCapacityType в vcpu или memory-mib, порог защиты от цен будет применяться на основе цены за vCPU или за память, а не на цене за экземпляр.

По умолчанию: 20

BareMetal -> (строка)

Указывает, включены ли, исключены или необходимы типы экземпляров bare metal.

По умолчанию: excluded

BurstablePerformance -> (строка)

Указывает, включены ли, исключены или необходимы типы экземпляров с возможностью увеличения производительности. Дополнительную информацию см. в разделе Экземпляры с возможностью увеличения производительности в Руководстве пользователя Amazon EC2 для Linux-экземпляров.

По умолчанию: excluded

RequireHibernateSupport -> (логическое)

Указывает, должны ли типы экземпляров обеспечивать поддержку приостановки On-Demand-экземпляров.

По умолчанию: false

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

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

По умолчанию: нет минимальных или максимальных ограничений

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

Минимальное количество сетевых интерфейсов.

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

Максимальное количество сетевых интерфейсов.

LocalStorage -> (строка)

Указывает, включены ли, исключены или необходимы типы экземпляров с томами локального хранилища. Дополнительную информацию см. в разделе Локальное хранилище Amazon EC2 в Руководстве пользователя Amazon EC2 для Linux-экземпляров.

По умолчанию: included

LocalStorageTypes -> (список)

Указывает тип локального хранилища, который требуется.

Для типов экземпляров с жёстким диском (HDD) укажите hdd.
Для типов экземпляров с твердотельным накопителем (SSD) укажите ssd.

По умолчанию: любой тип локального хранилища

(строка)

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

Минимальный и максимальный общий размер локального хранилища для типа экземпляра в ГБ.

По умолчанию: нет минимальных или максимальных ограничений

Min -> (вещественное число)

Минимальный размер хранилища в ГБ.

Max -> (вещественное число)

Максимальный размер хранилища в ГБ.

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

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

По умолчанию: нет минимальных или максимальных ограничений

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

Минимальное значение в Мбит/с.

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

Максимальное значение в Мбит/с.

AcceleratorTypes -> (список)

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

Для типов экземпляров с ускорителями GPU укажите gpu.
Для типов экземпляров с ускорителями FPGA укажите fpga.
Для типов экземпляров с ускорителями вывода укажите inference.

По умолчанию: любой тип ускорителя

(строка)

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

Минимальное и максимальное количество ускорителей (GPU, FPGA или чипов Amazon Web Services Inferentia) для типа экземпляра.

Чтобы исключить типы экземпляров с поддержкой ускорителей, установите Max в 0.

По умолчанию: нет минимальных или максимальных ограничений

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

Минимальное значение.

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

Максимальное значение.

AcceleratorManufacturers -> (список)

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

Для типов экземпляров с устройствами NVIDIA укажите nvidia .
Для типов экземпляров с устройствами AMD укажите amd .
Для типов экземпляров с устройствами Amazon Web Services укажите amazon-web-services .
Для типов экземпляров с устройствами Xilinx укажите xilinx .

По умолчанию: Любой производитель

(строка)

AcceleratorNames -> (список)

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

Для типов экземпляров с графическими процессорами NVIDIA A100 укажите a100 .
Для типов экземпляров с графическими процессорами NVIDIA V100 укажите v100 .
Для типов экземпляров с графическими процессорами NVIDIA K80 укажите k80 .
Для типов экземпляров с графическими процессорами NVIDIA T4 укажите t4 .
Для типов экземпляров с графическими процессорами NVIDIA M60 укажите m60 .
Для типов экземпляров с графическими процессорами AMD Radeon Pro V520 укажите radeon-pro-v520 .
Для типов экземпляров с FPGA Xilinx VU9P укажите vu9p .

По умолчанию: Любой ускоритель

(строка)

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

Минимальный и максимальный объём памяти для ускорителей на типе экземпляра в MiB.

По умолчанию: Нет минимальных или максимальных ограничений

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

Минимальный объём памяти в MiB.

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

Максимальный объём памяти в MiB.

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

Минимальный и максимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

По умолчанию: Нет минимальных или максимальных ограничений

Min -> (двойное число)

Минимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

Max -> (двойное число)

Максимальный объём пропускной способности сети в гигабитах в секунду (Gbps).

AllowedInstanceTypes -> (список)

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

Вы можете использовать строки с одной или несколькими подстановками, представленными звёздочкой (* ), чтобы разрешить тип, размер или поколение экземпляра. Примеры: m5.8xlarge , c5*.* , m5a.* , r* , *3* .

Например, если вы укажете c5* , Amazon EC2 Auto Scaling позволит использовать всю семейство экземпляров C5, которое включает все типы экземпляров C5a и C5n. Если вы укажете m5a.* , Amazon EC2 Auto Scaling позволит использовать все типы экземпляров M5a, но не типы экземпляров M5n.

Примечание

Если вы укажете AllowedInstanceTypes , вы не можете указать ExcludedInstanceTypes .

По умолчанию: Все типы экземпляров

(строка)

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

Базовые факторы производительности для требований к экземплярам.

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

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

References -> (список)

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

Примечание

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

(структура)

Примечание

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

InstanceFamily -> (строка)

Семейство экземпляров для использования в качестве базовой ссылки.

Примечание

Убедитесь, что вы указали правильное значение для семейства экземпляров. Семейство экземпляров — это всё до точки (.) в имени типа экземпляра. Например, в экземпляре c6i.large , семейство экземпляров — c6i , а не c6 . Более подробную информацию см. в документации Amazon EC2 по именованию типов экземпляров Amazon EC2 Instance Types.

Следующие типы экземпляров не поддерживаются для защиты производительности.

c1
g3| g3s
hpc7g
m1| m2
mac1 | mac2 | mac2-m1ultra | mac2-m2 | mac2-m2pro
p3dn | p4d | p5
t1
u-12tb1 | u-18tb1 | u-24tb1 | u-3tb1 | u-6tb1 | u-9tb1 | u7i-12tb | u7in-16tb | u7in-24tb | u7in-32tb

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

Если вы укажете неподдерживаемое семейство экземпляров в качестве значения для базовой производительности, API вернёт пустой ответ.

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

Распределение экземпляров.

OnDemandAllocationStrategy -> (строка)

Стратегия распределения, применяемая к вашим экземплярам On-Demand при их запуске. Возможные типы экземпляров определяются переопределениями шаблонов запуска, которые вы указываете.

Список допустимых значений:

lowest-price

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

prioritized

Вы устанавливаете порядок типов экземпляров для переопределений шаблонов запуска от высшего к низшему приоритету (от первого к последнему в списке). Amazon EC2 Auto Scaling запускает типы экземпляров с высшим приоритетом в первую очередь. Если все ваши объёмы On-Demand не могут быть удовлетворены с помощью типа экземпляра с высшим приоритетом, то Amazon EC2 Auto Scaling запускает оставшиеся объёмы с использованием типа экземпляра со вторым приоритетом и так далее. Это значение по умолчанию для групп автомасштабирования, которые не указывают InstanceRequirements и не могут использоваться для групп, которые это делают.

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

Минимальный объём ёмкости группы автомасштабирования, который должен быть обеспечен экземплярами On-Demand. Эта базовая часть запускается первой по мере масштабирования вашей группы.

Это число имеет ту же единицу измерения, что и желаемая ёмкость группы. Если вы измените единицу измерения по умолчанию (количество экземпляров), указав значения весовой ёмкости в вашем списке переопределений шаблонов запуска или изменив значение по умолчанию для типа желаемой ёмкости группы, вы должны указать это число с использованием той же единицы измерения.

По умолчанию: 0

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

Управляет процентами экземпляров On-Demand и Spot-экземпляров для вашей дополнительной ёмкости сверх OnDemandBaseCapacity . Выражается числом (например, 20 означает 20% экземпляров On-Demand, 80% экземпляров Spot). Если установлено значение 100, используются только экземпляры On-Demand.

По умолчанию: 100

SpotAllocationStrategy -> (строка)

Стратегия распределения, применяемая к вашим Spot-экземплярам при их запуске. Возможные типы экземпляров определяются переопределениями шаблонов запуска, которые вы указываете.

Список допустимых значений:

capacity-optimized

Запрашивает Spot-экземпляры, используя пулы, оптимально выбранные на основе доступной ёмкости Spot. Эта стратегия имеет наименьший риск прерывания. Чтобы дать определённым типам экземпляров больше шансов на запуск в первую очередь, используйте capacity-optimized-prioritized .

capacity-optimized-prioritized

Вы устанавливаете порядок типов экземпляров для переопределений шаблонов запуска от высшего к низшему приоритету (от первого к последнему в списке). Amazon EC2 Auto Scaling учитывает приоритеты типов экземпляров на основе наилучших усилий, но оптимизирует ёмкость в первую очередь. Обратите внимание, что если стратегия распределения On-Demand установлена в prioritized , применяется тот же приоритет при удовлетворении ёмкости On-Demand. Это недопустимое значение для групп автомасштабирования, которые указывают InstanceRequirements .

lowest-price

Запрашивает Spot-экземпляры, используя пулы с самой низкой ценой в зоне доступности, по количеству пулов Spot, которое вы указываете для свойства SpotInstancePools . Для обеспечения выполнения вашей желаемой ёмкости вы можете получить Spot-экземпляры из нескольких пулов. Это значение по умолчанию, но может привести к высоким показателям прерываний, так как эта стратегия учитывает только цену экземпляра, а не доступную ёмкость.

price-capacity-optimized (рекомендуется)

Стратегия оптимизации цены и ёмкости рассматривает как цену, так и ёмкость для выбора пулов Spot-экземпляров, которые наименее склонны к прерываниям и имеют самую низкую возможную цену.

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

Количество пулов Spot-экземпляров, по которым распределяются ваши Spot-экземпляры. Пулы Spot определяются из различных типов экземпляров в переопределениях. Допустимо только при SpotAllocationStrategy, равном lowest-price. Значение должно быть в диапазоне от 1 до 20.

По умолчанию: 2

SpotMaxPrice -> (строка)

Максимальная цена за час использования Spot-экземпляра, которую вы готовы заплатить. Если ваша максимальная цена ниже цены Spot для выбранных типов экземпляров, ваши Spot-экземпляры не запускаются. Не рекомендуется указывать максимальную цену, так как это может привести к увеличению прерываний. При запуске Spot-экземпляров вы платите текущую цену Spot. Чтобы удалить ранее заданную максимальную цену, укажите свойство, но задайте пустую строку ("") для значения.

Предупреждение

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

Допустимый диапазон: минимальное значение 0,001

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

Минимальный размер группы.

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

Максимальный размер группы.

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

Желаемый размер группы.

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

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

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

Продолжительность периода охлаждения по умолчанию в секундах.

AvailabilityZones -> (список)

Одна или несколько зон доступности для группы.

(строка)

LoadBalancerNames -> (список)

Один или несколько балансировщиков нагрузки, связанных с группой.

(строка)

TargetGroupARNs -> (список)

Имена Amazon Resource Names (ARN) целевых групп для вашего балансировщика нагрузки.

(строка)

HealthCheckType -> (строка)

Строка с одним или несколькими типами проверок состояния, разделёнными запятыми.

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

Продолжительность периода льготы проверки состояния, в секундах.

Instances -> (список)

Экземпляры EC2, связанные с группой.

(структура)

Описание экземпляра EC2.

InstanceId -> (строка)

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

InstanceType -> (строка)

Тип экземпляра экземпляра EC2.

AvailabilityZone -> (строка)

Зона доступности, в которой работает экземпляр.

LifecycleState -> (строка)

Описание текущего состояния жизненного цикла. Состояние Quarantined не используется. Дополнительные сведения см. в руководстве пользователя Amazon EC2 Auto Scaling.

HealthStatus -> (строка)

Последнее состояние работоспособности экземпляра. Healthy означает, что экземпляр работоспособен и должен оставаться в службе. Unhealthy означает, что экземпляр неисправен, и Amazon EC2 Auto Scaling должен его закрыть и заменить.

LaunchConfigurationName -> (строка)

Конфигурация запуска, связанная с экземпляром.

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

Шаблон запуска для экземпляра.

LaunchTemplateId -> (строка)

Идентификатор шаблона запуска. Чтобы получить идентификатор шаблона, используйте операцию Amazon EC2 DescribeLaunchTemplates. Новые шаблоны запуска можно создавать с помощью операции Amazon EC2 CreateLaunchTemplate.

Условие: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

LaunchTemplateName -> (строка)

Имя шаблона запуска. Чтобы получить имя шаблона, используйте операцию Amazon EC2 DescribeLaunchTemplates. Новые шаблоны запуска можно создавать с помощью операции Amazon EC2 CreateLaunchTemplate.

Условие: необходимо указать либо LaunchTemplateId, либо LaunchTemplateName.

Version -> (строка)

Номер версии, $Latest или $Default. Чтобы получить номер версии, используйте операцию Amazon EC2 DescribeLaunchTemplateVersions. Новые версии шаблонов запуска можно создавать с помощью операции Amazon EC2 CreateLaunchTemplateVersion. Если значение равно $Latest, Amazon EC2 Auto Scaling выбирает последнюю версию шаблона запуска при запуске экземпляров. Если значение равно $Default, Amazon EC2 Auto Scaling выбирает версию шаблона запуска по умолчанию при запуске экземпляров. Значение по умолчанию — $Default.

ProtectedFromScaleIn -> (булево)

Указывает, защищен ли экземпляр от завершения работы Amazon EC2 Auto Scaling при масштабировании.

WeightedCapacity -> (строка)

Количество единиц емкости, предоставляемых экземпляром на основе его типа экземпляра.

Допустимый диапазон: минимальное значение 1, максимальное значение 999.

CreatedTime -> (метка времени)

Дата и время создания группы.

SuspendedProcesses -> (список)

Подвешенные процессы, связанные с группой.

(структура)

Описание процесса автоматического масштабирования, который был приостановлен.

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

ProcessName -> (строка)

Имя приостановленного процесса.

SuspensionReason -> (строка)

Причина приостановки процесса.

PlacementGroup -> (строка)

Имя группы размещения, в которую следует запускать экземпляры, если таковая имеется.

VPCZoneIdentifier -> (строка)

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

EnabledMetrics -> (список)

Включенные метрики для группы.

(структура)

Описание включенной метрики группы автоматического масштабирования.

Metric -> (строка)

Одна из следующих метрик:

GroupMinSize
GroupMaxSize
GroupDesiredCapacity
GroupInServiceInstances
GroupPendingInstances
GroupStandbyInstances
GroupTerminatingInstances
GroupTotalInstances
GroupInServiceCapacity
GroupPendingCapacity
GroupStandbyCapacity
GroupTerminatingCapacity
GroupTotalCapacity
WarmPoolDesiredCapacity
WarmPoolWarmedCapacity
WarmPoolPendingCapacity
WarmPoolTerminatingCapacity
WarmPoolTotalCapacity
GroupAndWarmPoolDesiredCapacity
GroupAndWarmPoolTotalCapacity

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

Granularity -> (строка)

Точность метрики. Единственное допустимое значение — 1Minute.

Status -> (строка)

Текущее состояние группы во время выполнения операции DeleteAutoScalingGroup.

Tags -> (список)

Теги группы.

(структура)

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

ResourceId -> (строка)

Название группы.

ResourceType -> (строка)

Тип ресурса. Поддерживается только значение auto-scaling-group.

Key -> (строка)

Ключ тега.

Value -> (строка)

Значение тега.

PropagateAtLaunch -> (булево)

Определяет, добавляется ли тег к новым экземплярам при их запуске в группе.

TerminationPolicies -> (список)

Политики завершения работы для группы.

(строка)

NewInstancesProtectedFromScaleIn -> (булево)

Указывает, защищены ли недавно запущенные экземпляры от закрытия Amazon EC2 Auto Scaling при масштабировании.

ServiceLinkedRoleARN -> (строка)

Идентификатор ресурса Amazon (ARN) роли, связанной с службой, которую группа автоматического масштабирования использует для вызова других служб Amazon Web Services от вашего имени.

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

Максимальное время, в секундах, которое экземпляр может находиться в службе.

Допустимый диапазон: минимальное значение 0.

CapacityRebalance -> (булево)

Указывает, включен ли баланс емкости.

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

Группа подготовки экземпляров для группы.

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

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

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

Минимальное количество экземпляров для поддержания в группе подготовки.

PoolState -> (строка)

Состояние экземпляра, в которое следует перейти после завершения действий жизненного цикла.

Status -> (строка)

Состояние группы подготовки, помеченной для удаления.

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

Политика повторного использования экземпляров.

ReuseOnScaleIn -> (булево)

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

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

Текущий размер группы подготовки.

Context -> (строка)

Зарезервировано.

DesiredCapacityType -> (строка)

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

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

Продолжительность предварительной подготовки экземпляра по умолчанию, в секундах.

TrafficSources -> (список)

Источники трафика, связанные с этой группой автоматического масштабирования.

(структура)

Данные идентификации источника трафика.

Identifier -> (строка)

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

Для балансировщиков нагрузки приложений, шлюзовых балансировщиков нагрузки, сетевых балансировщиков нагрузки и VPC Lattice это будет имя ресурса Amazon (ARN) группы целевых узлов в этой учетной записи и регионе. Для балансировщиков нагрузки Classic это будет имя балансировщика нагрузки Classic в этой учетной записи и регионе.

Например:

ARN балансировщика нагрузки приложений: arn:aws:elasticloadbalancing:us-west-2:123456789012:targetgroup/my-targets/1234567890123456
Имя балансировщика нагрузки Classic: my-classic-load-balancer
ARN VPC Lattice: arn:aws:vpc-lattice:us-west-2:123456789012:targetgroup/tg-1234567890123456

Чтобы получить ARN группы целевых узлов для балансировщика нагрузки приложений, шлюзового балансировщика нагрузки или сетевого балансировщика нагрузки или имя балансировщика нагрузки Classic, используйте операции Elastic Load Balancing DescribeTargetGroups и DescribeLoadBalancers.

Чтобы получить ARN группы целевых узлов для VPC Lattice, используйте операцию VPC Lattice GetTargetGroup.

Type -> (строка)

Предоставляет дополнительный контекст для значения Identifier.

Следующие значения являются допустимыми:

elb, если Identifier — это имя балансировщика нагрузки Classic.
elbv2, если Identifier — это ARN группы целевых узлов балансировщика нагрузки приложений, шлюзового балансировщика нагрузки или сетевого балансировщика нагрузки.
vpc-lattice, если Identifier — это ARN группы целевых узлов VPC Lattice.

Требуется, если идентификатор — имя балансировщика нагрузки Classic.

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

Политика обслуживания экземпляров.

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

Указывает нижний порог в процентах от требуемой емкости группы автоматического масштабирования. Он представляет собой минимальный процент группы, который необходимо поддерживать в рабочем, исправном и готовом к использованию состоянии, чтобы обеспечить рабочую нагрузку при замене экземпляров. Диапазон значений составляет от 0 до 100. Чтобы очистить ранее заданное значение, укажите значение -1.

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

Указывает верхний порог в процентах от требуемой емкости группы автоматического масштабирования. Он представляет собой максимальный процент группы, который может находиться в рабочем и исправном состоянии или в состоянии ожидания, чтобы обеспечить рабочую нагрузку при замене экземпляров. Диапазон значений составляет от 100 до 200. Чтобы очистить ранее заданное значение, укажите значение -1.

Необходимо указать как MinHealthyPercentage, так и MaxHealthyPercentage, а разница между ними не может быть больше 100. Большой диапазон увеличивает количество экземпляров, которые могут быть заменены одновременно.

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

Распределение емкости экземпляров по зонам доступности.

CapacityDistributionStrategy -> (строка)

Если запуски завершаются сбоем в зоне доступности, доступны следующие стратегии. По умолчанию используется balanced-best-effort.

balanced-only — Если запуски завершаются сбоем в зоне доступности, автоматическое масштабирование будет продолжать попытки запуска в неисправной зоне, чтобы сохранить сбалансированное распределение.
balanced-best-effort — Если запуски завершаются сбоем в зоне доступности, автоматическое масштабирование попытается запустить экземпляры в другой исправной зоне доступности.

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

Политика отказа зоны доступности.

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

Если true , включите сдвиг зон для вашей группы автоматического масштабирования.

ImpairedZoneHealthCheckBehavior -> (строка)

Указывает поведение проверки состояния для зоны доступности с отказами в активном сдвиге зон. Если вы выберите Replace unhealthy, экземпляры, которые выглядят нездоровыми, будут заменены во всех зонах доступности. Если вы выберите Ignore unhealthy, экземпляры не будут заменены в зоне доступности с активным сдвигом зон. Дополнительную информацию см. в разделе «Сдвиг зон группы автоматического масштабирования» в Руководстве пользователя Amazon EC2 Auto Scaling.

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

Спецификация резервирования емкости.

CapacityReservationPreference -> (строка)

Предпочтение резервирования емкости. Доступны следующие варианты:

capacity-reservations-only - Автоматическое масштабирование будет запускать экземпляры только в резервировании емкости или группе ресурсов резервирования емкости. Если емкость недоступна, экземпляры не будут запущены.
capacity-reservations-first - Автоматическое масштабирование будет пытаться запустить экземпляры сначала в резервировании емкости или группе ресурсов резервирования емкости. Если емкость недоступна, экземпляры будут работать в емкости On-Demand.
none - Автоматическое масштабирование не будет запускать экземпляры в резервировании емкости. Экземпляры будут работать в емкости On-Demand.
default - Автоматическое масштабирование использует предпочтение резервирования емкости из вашей шаблона запуска или открытого резервирования емкости.

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

Описание целевого резервирования емкости или группы ресурсов резервирования емкости.

CapacityReservationIds -> (список)

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

(строка)

CapacityReservationResourceGroupArns -> (список)

ARN групп ресурсов резервирования емкости для запуска экземпляров.

(строка)

NextToken -> (строка)

Строка, указывающая, что ответ содержит больше элементов, чем может быть возвращено в одном ответе. Для получения дополнительных элементов укажите эту строку для значения NextToken при запросе следующего набора элементов. Это значение равно null, когда больше элементов возвращать не нужно.

END_OF_DOCUMENT_MARKER