start-instance-refresh

Описание

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

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

При успехе запрос содержит уникальный идентификатор, который можно использовать для отслеживания хода обновления экземпляров. Для запроса его состояния вызовите API DescribeInstanceRefreshes. Для описания уже выполненных обновлений экземпляров вызовите API DescribeInstanceRefreshes. Для отмены обновления экземпляров, которое выполняется в данный момент, используйте API CancelInstanceRefresh.

Обновление экземпляров может завершиться неудачей по нескольким причинам, таким как сбои запуска EC2, неправильно настроенные проверки состояния или игнорирование/разрешение завершения экземпляров, находящихся в состоянии Standby или защищенных от уменьшения масштаба. Вы можете отслеживать сбои запусков EC2 с помощью операций масштабирования. Для поиска операций масштабирования вызовите API DescribeScalingActivities.

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

См. также: AWS API Documentation

Синтаксис

  start-instance-refresh
--auto-scaling-group-name <value>
[--strategy <value>]
[--desired-configuration <value>]
[--preferences <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 (строка)

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

--strategy (строка)

Стратегия, используемая для обновления экземпляров. Единственное допустимое значение — Rolling.

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

Rolling

--desired-configuration (структура)

Желаемая конфигурация. Например, желаемая конфигурация может указать новый шаблон запуска или новую версию текущего шаблона запуска.

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

Примечание

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

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

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

LaunchTemplateId -> (строка)

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

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

LaunchTemplateName -> (строка)

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

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

Version -> (строка)

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

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

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

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

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

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

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

InstanceType -> (строка)

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

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

WeightedCapacity -> (строка)

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

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

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

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

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

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

Можно указать до 20 шаблонов запуска на одну группу автоматического масштабирования. Шаблоны запуска, указанные в переопределениях и в определении 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 -> (структура)

Минимальное и максимальное количество 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), которую вы укажете в своем шаблоне запуска.

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

(string)

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

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

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

Min -> (double)

Минимум памяти в GiB.

Max -> (double)

Максимум памяти в GiB.

ExcludedInstanceTypes -> (список)

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

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

Примечание

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

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

(string)

InstanceGenerations -> (список)

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

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

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

(string)

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

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

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

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

Примечание

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

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

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

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

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

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

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

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

LocalStorage -> (string)

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

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

LocalStorageTypes -> (список)

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

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

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

(string)

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

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

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

Min -> (double)

Минимум хранилища в ГБ.

Max -> (double)

Максимум хранилища в ГБ.

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

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

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

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

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

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

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

AcceleratorTypes -> (список)

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

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

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

(string)

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 -> (структура)

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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

prioritized

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

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

Минимальное количество емкости группы Auto Scaling, которое должно быть обеспечено экземплярами 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. Это некорректное значение для групп Auto Scaling, которые указывают 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

JSON Синтаксис:

{
  "LaunchTemplate": {
    "LaunchTemplateId": "string",
    "LaunchTemplateName": "string",
    "Version": "string"
  },
  "MixedInstancesPolicy": {
    "LaunchTemplate": {
      "LaunchTemplateSpecification": {
        "LaunchTemplateId": "string",
        "LaunchTemplateName": "string",
        "Version": "string"
      },
      "Overrides": [
        {
          "InstanceType": "string",
          "WeightedCapacity": "string",
          "LaunchTemplateSpecification": {
            "LaunchTemplateId": "string",
            "LaunchTemplateName": "string",
            "Version": "string"
          },
          "InstanceRequirements": {
            "VCpuCount": {
              "Min": integer,
              "Max": integer
            },
            "MemoryMiB": {
              "Min": integer,
              "Max": integer
            },
            "CpuManufacturers": ["intel"|"amd"|"amazon-web-services", ...],
            "MemoryGiBPerVCpu": {
              "Min": double,
              "Max": double
            },
            "ExcludedInstanceTypes": ["string", ...],
            "InstanceGenerations": ["current"|"previous", ...],
            "SpotMaxPricePercentageOverLowestPrice": integer,
            "MaxSpotPriceAsPercentageOfOptimalOnDemandPrice": integer,
            "OnDemandMaxPricePercentageOverLowestPrice": integer,
            "BareMetal": "included"|"excluded"|"required",
            "BurstablePerformance": "included"|"excluded"|"required",
            "RequireHibernateSupport": true|false,
            "NetworkInterfaceCount": {
              "Min": integer,
              "Max": integer
            },
            "LocalStorage": "included"|"excluded"|"required",
            "LocalStorageTypes": ["hdd"|"ssd", ...],
            "TotalLocalStorageGB": {
              "Min": double,
              "Max": double
            },
            "BaselineEbsBandwidthMbps": {
              "Min": integer,
              "Max": integer
            },
            "AcceleratorTypes": ["gpu"|"fpga"|"inference", ...],
            "AcceleratorCount": {
              "Min": integer,
              "Max": integer
            },
            "AcceleratorManufacturers": ["nvidia"|"amd"|"amazon-web-services"|"xilinx", ...],
            "AcceleratorNames": ["a100"|"v100"|"k80"|"t4"|"m60"|"radeon-pro-v520"|"vu9p", ...],
            "AcceleratorTotalMemoryMiB": {
              "Min": integer,
              "Max": integer
            },
            "NetworkBandwidthGbps": {
              "Min": double,
              "Max": double
            },
            "AllowedInstanceTypes": ["string", ...],
            "BaselinePerformanceFactors": {
              "Cpu": {
                "References": [
                  {
                    "InstanceFamily": "string"
                  }
                  ...
                ]
              }
            }
          }
        }
        ...
      ]
    },
    "InstancesDistribution": {
      "OnDemandAllocationStrategy": "string",
      "OnDemandBaseCapacity": integer,
      "OnDemandPercentageAboveBaseCapacity": integer,
      "SpotAllocationStrategy": "string",
      "SpotInstancePools": integer,
      "SpotMaxPrice": "string"
    }
  }
}

--preferences (структура)

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

Автоматическое откат
Точки сохранения
Сигнализации CloudWatch
Пропуск совпадения
Время выпечки

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

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

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

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

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

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

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

CheckpointPercentages -> (список)

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

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

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

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

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

SkipMatching -> (булево)

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

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

AutoRollback -> (булево)

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

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

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

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

ScaleInProtectedInstances -> (строка)

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

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

Refresh

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

Ignore

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

Wait (по умолчанию)

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

StandbyInstances -> (строка)

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

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

Terminate

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

Ignore

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

Wait (по умолчанию)

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

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

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

Alarms -> (список)

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

(строка)

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

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

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

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

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

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

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

MinHealthyPercentage=integer,InstanceWarmup=integer,CheckpointPercentages=integer,integer,CheckpointDelay=integer,SkipMatching=boolean,AutoRollback=boolean,ScaleInProtectedInstances=string,StandbyInstances=string,AlarmSpecification={Alarms=[string,string]},MaxHealthyPercentage=integer,BakeTime=integer

Синтаксис JSON:

{
  "MinHealthyPercentage": integer,
  "InstanceWarmup": integer,
  "CheckpointPercentages": [integer, ...],
  "CheckpointDelay": integer,
  "SkipMatching": true|false,
  "AutoRollback": true|false,
  "ScaleInProtectedInstances": "Refresh"|"Ignore"|"Wait",
  "StandbyInstances": "Terminate"|"Ignore"|"Wait",
  "AlarmSpecification": {
    "Alarms": ["string", ...]
  },
  "MaxHealthyPercentage": integer,
  "BakeTime": integer
}

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

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

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

--debug (булево)

Включить отладочный журнал.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (булево)

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

--no-paginate (булево)

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

--output (строка)

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

json
текст
таблица
yaml
yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

включить
выключить
автоматически

--no-sign-request (булево)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

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

base64
raw-in-base64-out

--no-cli-pager (булево)

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

--cli-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Примеры

Примечание

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

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

Пример 1: Запуск обновления экземпляра с помощью параметров командной строки

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

aws autoscaling start-instance-refresh \
    --auto-scaling-group-name my-asg \
    --preferences '{"InstanceWarmup": 60, "MinHealthyPercentage": 50}'

Вывод:

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

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

Пример 2: Запуск обновления экземпляра с помощью JSON-файла

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

aws autoscaling start-instance-refresh \
    --cli-input-json file://config.json

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

{
    "AutoScalingGroupName": "my-asg",
    "DesiredConfiguration": {
        "LaunchTemplate": {
            "LaunchTemplateId": "lt-068f72b729example",
            "Version": "$Default"
        }
    },
    "Preferences": {
        "InstanceWarmup": 60,
        "MinHealthyPercentage": 50,
        "AutoRollback": true,
        "ScaleInProtectedInstances": Ignore,
        "StandbyInstances": Terminate
    }
}

Вывод:

{
    "InstanceRefreshId": "08b91cf7-8fa6-48af-b6a6-d227f40f1b9b"
}

Вывод

InstanceRefreshId -> (строка)

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