[ aws . autoscaling ]
put-warm-pool
Описание
Создает или обновляет теплый пул для указанной группы автоматического масштабирования. Теплый пул — это пул предварительно инициализированных EC2-инстансов, который существует наряду с группой автоматического масштабирования. Всякий раз, когда ваше приложение нуждается в масштабировании, группа автоматического масштабирования может использовать теплый пул для достижения нового желаемого размера.
Этот оператор должен вызываться из региона, в котором была создана группа автоматического масштабирования.
Вы можете просмотреть инстансы в теплом пуле, используя API-вызов DescribeWarmPool. Если вы больше не используете теплый пул, вы можете удалить его, вызвав API DeleteWarmPool.
Дополнительную информацию см. в разделе Теплые пулы для Amazon EC2 Auto Scaling в руководстве пользователя Amazon EC2 Auto Scaling.
См. также: Документация API AWS
Синтаксис
put-warm-pool
--auto-scaling-group-name <value>
[--max-group-prepared-capacity <value>]
[--min-size <value>]
[--pool-state <value>]
[--instance-reuse-policy <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 (строка)
--max-group-prepared-capacity (целое число)
Указывает максимальное количество инстансов, которые разрешено разместить в теплом пуле или в любом состоянии, кроме Terminated для группы автоматического масштабирования. Это необязательное свойство. Указывайте его только в том случае, если вы не хотите, чтобы размер теплого пула определялся разницей между максимальной емкостью группы и ее желаемой емкостью.
Предупреждение
Если значение для MaxGroupPreparedCapacity не указано, Amazon EC2 Auto Scaling запускает и поддерживает разницу между максимальной емкостью группы и ее желаемой емкостью. Если вы укажете значение для MaxGroupPreparedCapacity, Amazon EC2 Auto Scaling использует разницу между MaxGroupPreparedCapacity и желаемой емкостью вместо этого.
Размер теплого пула динамический. Только когда MaxGroupPreparedCapacity и MinSize установлены в одно и то же значение, теплый пул имеет абсолютный размер.
Если желаемая емкость группы автоматического масштабирования выше, чем MaxGroupPreparedCapacity, емкость теплого пула равна 0, если вы не укажете значение для MinSize. Чтобы удалить ранее установленное значение, укажите свойство, но задайте значение -1.
--min-size (целое число)
--pool-state (строка)
Устанавливает состояние инстанса, в которое нужно перейти после завершения действий жизненного цикла. По умолчанию — Stopped.
Возможные значения:
StoppedRunningHibernated
--instance-reuse-policy (структура)
Указывает, могут ли инстансы в группе автоматического масштабирования возвращаться в теплый пул при уменьшении масштаба. По умолчанию инстансы в группе автоматического масштабирования завершаются при уменьшении масштаба.
ReuseOnScaleIn -> (булево)
Сокращенный синтаксис:
ReuseOnScaleIn=boolean
Синтаксис JSON:
{
"ReuseOnScaleIn": true|false
}
--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.
Для создания теплого пула
В следующем примере создается теплый пул для указанной группы автоматического масштабирования.
aws autoscaling put-warm-pool \
--auto-scaling-group-name my-asg \
--min-size 2
Эта команда не генерирует выходных данных. Если теплый пул уже существует, он будет обновлен.
Дополнительную информацию см. в разделе Теплые пулы для Amazon EC2 Auto Scaling в руководстве пользователя Amazon EC2 Auto Scaling.
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.