describe-instance-refreshes

Описание

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

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

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

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

Синтаксис

  describe-instance-refreshes
--auto-scaling-group-name <value>
[--instance-refresh-ids <value>]
[--next-token <value>]
[--max-records <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 (строка)

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

--instance-refresh-ids (список)

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

(строка)

Синтаксис:

"string" "string" ...

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

Маркер для получения следующего набора элементов. (Этот маркер вы получили из предыдущего вызова.)

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

Максимальное количество элементов, возвращаемых в этом вызове. Значение по умолчанию — 50, максимальное значение — 100.

--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
text
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

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

Для описания обновлений экземпляров

Следующий describe-instance-refreshes пример возвращает описание всех запросов обновления экземпляров для указанной группы Auto Scaling, включая сообщение о состоянии и (если доступно) причину состояния.

aws autoscaling describe-instance-refreshes \
    --auto-scaling-group-name my-asg

Вывод:

{
    "InstanceRefreshes": [
        {
            "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b",
            "AutoScalingGroupName": "my-asg",
            "Status": "InProgress",
            "StatusReason": "Waiting for instances to warm up before continuing. For example: 0e69cc3f05f825f4f is warming up.",
            "EndTime": "2023-03-23T16:42:55Z",
            "PercentageComplete": 0,
            "InstancesToUpdate": 0,
    "Preferences": {
                "MinHealthyPercentage": 100,
                "InstanceWarmup": 300,
                "CheckpointPercentages": [
                    50
                ],
                "CheckpointDelay": 3600,
                "SkipMatching": false,
                "AutoRollback": true,
                "ScaleInProtectedInstances": "Ignore",
                "StandbyInstances": "Ignore"
            }
        },
        {
            "InstanceRefreshId": "dd7728d0-5bc4-4575-96a3-1b2c52bf8bb1",
            "AutoScalingGroupName": "my-asg",
            "Status": "Successful",
            "EndTime": "2022-06-02T16:53:37Z",
            "PercentageComplete": 100,
            "InstancesToUpdate": 0,
    "Preferences": {
                "MinHealthyPercentage": 90,
                "InstanceWarmup": 300,
                "SkipMatching": true,
                "AutoRollback": true,
                "ScaleInProtectedInstances": "Ignore",
                "StandbyInstances": "Ignore"
            }
        }
    ]
}

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

Вывод

InstanceRefreshes -> (список)

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

(структура)

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

InstanceRefreshId -> (строка)

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

AutoScalingGroupName -> (строка)

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

Статус -> (строка)

Текущий статус операции перезапуска экземпляра:

Pending - Запрос создан, но перезапуск экземпляра еще не начался.
InProgress - Перезапуск экземпляра выполняется.
Successful - Перезапуск экземпляра выполнен успешно.
Failed - Перезапуск экземпляра завершился неудачно. Для устранения неполадок используйте причину состояния и действия по масштабированию.
Cancelling - Перезапуск экземпляра в процессе отмены.
Cancelled - Перезапуск экземпляра отменен.
RollbackInProgress - Перезапуск экземпляра выполняется в режиме отката.
RollbackFailed - Откат завершился неудачно. Для устранения неполадок используйте причину состояния и действия по масштабированию.
RollbackSuccessful - Откат завершен успешно.
Baking - Ожидание указанного времени выдержки после завершения обновления экземпляров при перезапуске экземпляра.

StatusReason -> (строка)

Объяснение, присвоенное конкретному статусу этой операции.

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

Дата и время начала перезапуска экземпляра.

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

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

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

Процент завершенности перезапуска экземпляра. Для каждого замещения экземпляра Amazon EC2 Auto Scaling отслеживает состояние работоспособности экземпляра и время разогрева. Когда состояние работоспособности экземпляра меняется на «работоспособный», и указанное время разогрева проходит, экземпляр считается обновленным и добавляется к проценту завершенности.

Примечание

PercentageComplete не включает экземпляры, которые были заменены во время отката. Это значение постепенно возвращается к нулю во время отката.

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

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

Примечание

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

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

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

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

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

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

Процент экземпляров в группе автоматического масштабирования, которые были заменены. Для каждого замещения экземпляра Amazon EC2 Auto Scaling отслеживает состояние работоспособности экземпляра и время разогрева. Когда состояние работоспособности экземпляра меняется на «работоспособный», и указанное время разогрева проходит, экземпляр считается обновленным и добавляется к проценту завершенности.

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

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

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

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

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

Процент экземпляров в теплом пуле, которые были заменены. Для каждого замещения экземпляра Amazon EC2 Auto Scaling отслеживает состояние работоспособности экземпляра и время разогрева. Когда состояние работоспособности экземпляра меняется на «работоспособный», и указанное время разогрева проходит, экземпляр считается обновленным и добавляется к проценту завершенности.

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

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

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

Параметры перезапуска экземпляра.

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

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

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

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

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

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

Если этот параметр не указан, время разогрева экземпляра по умолчанию соответствует значению параметра DefaultInstanceWarmup, если он определен (что рекомендуется во всех случаях), или параметру HealthCheckGracePeriod в противном случае.

CheckpointPercentages -> (список)

(Необязательно) Значения порогов для каждого контрольного пункта в порядке возрастания. Каждое число должно быть уникальным. Чтобы заменить все экземпляры в группе автоматического масштабирования, последнее число в массиве должно быть 100.

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

(целое число)

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

(Необязательно) Количество времени в секундах, которое следует подождать после контрольного пункта, прежде чем продолжить. Этот параметр необязателен, но если вы укажете его значение, вы также должны указать значение для CheckpointPercentages. Если вы укажете значение для CheckpointPercentages, а не для CheckpointDelay, то значение CheckpointDelay по умолчанию будет равно 3600 (1 час).

SkipMatching -> (булево)

(Необязательно) Указывает, включено ли отключение совпадений. Если включено (true), Amazon EC2 Auto Scaling пропускает замену экземпляров, соответствующих желаемой конфигурации. Если желаемая конфигурация не указана, пропускаются замены экземпляров, имеющих тот же шаблон запуска и типы экземпляров, которые использовала группа автоматического масштабирования до начала перезапуска экземпляра. По умолчанию значение равно false.

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

AutoRollback -> (булево)

(Необязательно) Указывает, следует ли откатить группу автоматического масштабирования к ее предыдущей конфигурации в случае неудачи перезапуска экземпляра или если будет достигнуто пороговое значение сигнализации CloudWatch. По умолчанию значение равно false.

Откат не поддерживается в следующих случаях:

Желаемая конфигурация для перезапуска экземпляра не указана.
Группа автоматического масштабирования имеет шаблон запуска, который использует параметр Amazon Web Services Systems Manager вместо ID AMI для параметра ImageId.
Группа автоматического масштабирования использует версию шаблона запуска $Latest или $Default.

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

ScaleInProtectedInstances -> (строка)

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

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

Перезапуск

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

Игнорирование

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

Ожидание (по умолчанию)

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

StandbyInstances -> (строка)

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

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

Завершить

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

Игнорирование

Amazon EC2 Auto Scaling игнорирует экземпляры, которые находятся в состоянии Standby, и продолжает замену экземпляров, которые находятся в состоянии InService.

Ожидание (по умолчанию)

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

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

(Необязательно) Указание сигнализации CloudWatch. Сигнализации CloudWatch могут использоваться для выявления любых проблем и завершения операции в случае достижения порогового значения сигнализации.

Alarms -> (список)

Названия одной или нескольких сигнализаций CloudWatch для мониторинга перезапуска экземпляра. Вы можете указать до 10 сигнализаций.

(строка)

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

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

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

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

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

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

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

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

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

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

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.

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

Используйте эту структуру для запуска нескольких типов экземпляров и экземпляров On-Demand и Spot в одном группе Auto Scaling.

Политика смешанных экземпляров содержит информацию, которую Amazon EC2 Auto Scaling может использовать для запуска экземпляров и оптимизации затрат. Дополнительную информацию см. в руководстве пользователя Amazon EC2 Auto Scaling.

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

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

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

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

LaunchTemplateId -> (строка)

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

LaunchTemplateName -> (строка)

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

Version -> (строка)

Overrides -> (список)

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

(структура)

Используйте эту структуру, чтобы позволить 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 -> (строка)

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

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

WeightedCapacity -> (строка)

Если вы предоставите список типов экземпляров для использования, вы можете указать количество единиц емкости, предоставляемых каждым типом экземпляра в терминах виртуальных процессоров, памяти, хранилища, пропускной способности или других характеристик относительной производительности. При запуске экземпляра 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 -> (структура)

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

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

LaunchTemplateId -> (строка)

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

LaunchTemplateName -> (строка)

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

Version -> (строка)

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

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

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

Примечание

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

VCpuCount -> (structure)

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

Min -> (integer)

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

Max -> (integer)

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

MemoryMiB -> (structure)

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

Min -> (integer)

Минимальное значение памяти в МиБ.

Max -> (integer)

Максимальное значение памяти в МиБ.

CpuManufacturers -> (list)

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

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

Примечание

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

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

(string)

MemoryGiBPerVCpu -> (structure)

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

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

Min -> (double)

Минимальное значение памяти в ГиБ.

Max -> (double)

Максимальное значение памяти в ГиБ.

ExcludedInstanceTypes -> (list)

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

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

Примечание

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

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

(string)

InstanceGenerations -> (list)

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

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

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

(string)

SpotMaxPricePercentageOverLowestPrice -> (integer)

[Защита цены] Пороговое значение защиты цены для спотовых экземпляров в процентах выше идентифицированной спотовой цены. Идентифицированная спотовая цена — это цена самого дешевого типа экземпляра 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 автоматически применит оптимальную защиту цены, чтобы последовательно выбирать из широкого спектра типов экземпляров. Чтобы указать отсутствие порогового значения защиты цены для спотовых экземпляров, что означает, что вы хотите учитывать все типы экземпляров, соответствующие вашим атрибутам, включите один из этих параметров и укажите высокое значение, например 999999 .

MaxSpotPriceAsPercentageOfOptimalOnDemandPrice -> (integer)

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

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

Примечание

OnDemandMaxPricePercentageOverLowestPrice -> (integer)

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

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

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

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

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

BareMetal -> (string)

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

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

BurstablePerformance -> (string)

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

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

RequireHibernateSupport -> (boolean)

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

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

NetworkInterfaceCount -> (structure)

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

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

Min -> (integer)

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

Max -> (integer)

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

LocalStorage -> (string)

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

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

LocalStorageTypes -> (list)

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

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

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

(string)

TotalLocalStorageGB -> (structure)

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

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

Min -> (double)

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

Max -> (double)

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

BaselineEbsBandwidthMbps -> (structure)

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

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

Min -> (integer)

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

Max -> (integer)

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

AcceleratorTypes -> (list)

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

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

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

(string)

AcceleratorCount -> (structure)

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

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

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

Min -> (integer)

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

Max -> (integer)

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

Производители ускорителей -> (список)

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

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

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

(строка)

Названия ускорителей -> (список)

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

Для типов экземпляров с графическими процессорами 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 .

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

(строка)

Общий объём памяти ускорителей в Мбайт -> (структура)

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

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

Мин -> (целое число)

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

Макс -> (целое число)

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

Пропускная способность сети в Гбит/с -> (структура)

Минимальное и максимальное значение пропускной способности сети в гигабитах в секунду (Гбит/с).

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

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

Минимальное значение пропускной способности сети в Гбит/с.

Макс -> (вещественное число)

Максимальное значение пропускной способности сети в Гбит/с.

Допустимые типы экземпляров -> (список)

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

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

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

Примечание

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

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

(строка)

Базовые факторы производительности -> (структура)

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

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

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

Ссылки -> (список)

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

Примечание

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

(структура)

Примечание

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

СемействоЭкземпляров -> (строка)

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

Примечание

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

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

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 возвращает пустой ответ.

Распределение экземпляров -> (структура)

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

СтратегияРаспределенияOnDemand -> (строка)

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

Вот допустимые значения:

lowest-price

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

prioritized

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

БазовыйОбъёмOnDemand -> (целое число)

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

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

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

ДоляOnDemandВышеБазового -> (целое число)

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

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

СтратегияРаспределенияSpot -> (строка)

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

Вот допустимые значения:

capacity-optimized

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

capacity-optimized-prioritized

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

lowest-price

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

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

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

ПулыSpot -> (целое число)

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

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

МаксимальнаяЦенаSpot -> (строка)

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

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

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

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

Подробная информация о возврате -> (структура)

Подробности отката.

RollbackReason -> (строка)

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

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

Дата и время начала отката.

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

Указывает значение PercentageComplete в момент начала отката.

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

Указывает значение InstancesToUpdate в момент начала отката.

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

Отчет о ходе замены экземпляров в группе Auto Scaling с тёплым пулом. Включает отдельные данные для экземпляров в тёплом пуле и экземпляров в группе Auto Scaling (живой пул).

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

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

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

Процент экземпляров в группе Auto Scaling, которые были заменены. Для каждой замены экземпляра Amazon EC2 Auto Scaling отслеживает состояние работоспособности экземпляра и время прогрева. Когда состояние работоспособности экземпляра изменится на «работоспособный», и пройдёт указанное время прогрева, экземпляр считается обновлённым и добавляется к проценту завершённости.

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

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

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

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

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

Процент экземпляров в тёплом пуле, которые были заменены. Для каждой замены экземпляра Amazon EC2 Auto Scaling отслеживает состояние работоспособности экземпляра и время прогрева. Когда состояние работоспособности экземпляра изменится на «работоспособный», и пройдёт указанное время прогрева, экземпляр считается обновлённым и добавляется к проценту завершённости.

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

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

NextToken -> (строка)

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

END_OF_DOCUMENT_MARKER