Spec-Zone.ru › AWS CLI v2

[ aws . application-autoscaling ]

put-scheduled-action

Описание

Создаёт или обновляет запланированное действие для масштабируемой цели Application Auto Scaling.

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

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

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

Для получения дополнительной информации см. Масштабирование по расписанию в руководстве пользователя Application Auto Scaling.

Примечание

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

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

Синтаксис

  put-scheduled-action
--service-namespace <value>
[--schedule <value>]
[--timezone <value>]
--scheduled-action-name <value>
--resource-id <value>
--scalable-dimension <value>
[--start-time <value>]
[--end-time <value>]
[--scalable-target-action <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]

Параметры

--service-namespace (строка)

Пространство имен службы Amazon Web Services, предоставляющей ресурс. Для ресурса, предоставляемого собственным приложением или службой, используйте custom-resource вместо.

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

  • ecs
  • elasticmapreduce
  • ec2
  • appstream
  • dynamodb
  • rds
  • sagemaker
  • custom-resource
  • comprehend
  • lambda
  • cassandra
  • kafka
  • elasticache
  • neptune
  • workspaces

--schedule (строка)

Расписание для этого действия. Поддерживаются следующие форматы:

  • Выражения At - “at(*yyyy* -*mm* -*dd* T*hh* :*mm* :*ss* ) “
  • Выражения Rate - “rate(*value*  *unit* ) “
  • Выражения Cron - “cron(*fields* ) “

Выражения At удобны для однократных расписаний. Выражения Cron удобны для задач, которые выполняются периодически в указанную дату и время, а выражения rate удобны для задач, которые выполняются в регулярном интервале.

Выражения At и cron по умолчанию используют всемирное координированное время (UTC).

Формат cron состоит из шести полей, разделенных пробелами: [Минуты] [Часы] [День_месяца] [Месяц] [День_недели] [Год].

Для выражений Rate, значение — положительное целое число, а единица — minute | minutes | hour | hours | day | days .

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

--timezone (строка)

Указывает часовой пояс, используемый при установке запланированного действия с помощью выражений at или cron. Если часовой пояс не указан, по умолчанию используется UTC.

Допустимые значения — канонические имена часовых поясов IANA, поддерживаемые Joda-Time (например, Etc/GMT+9 или Pacific/Tahiti ). Дополнительную информацию см. на сайте https://www.joda.org/joda-time/timezones.html .

--scheduled-action-name (строка)

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

--resource-id (строка)

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

  • Служба ECS — тип ресурса service, а уникальный идентификатор — имя кластера и имя службы. Пример: service/my-cluster/my-service .
  • Spot Fleet — тип ресурса spot-fleet-request, а уникальный идентификатор — идентификатор запроса Spot Fleet. Пример: spot-fleet-request/sfr-73fbd2ce-aa30-494c-8788-1cee4EXAMPLE .
  • Кластер EMR — тип ресурса instancegroup, а уникальный идентификатор — идентификатор кластера и идентификатор группы экземпляров. Пример: instancegroup/j-2EEZNYKUA1NTV/ig-1791Y4E1L8YI0 .
  • Флот AppStream 2.0 — тип ресурса fleet, а уникальный идентификатор — имя флота. Пример: fleet/sample-fleet .
  • Таблица DynamoDB — тип ресурса table, а уникальный идентификатор — имя таблицы. Пример: table/my-table .
  • Глобальный вторичный индекс DynamoDB — тип ресурса index, а уникальный идентификатор — имя индекса. Пример: table/my-table/index/my-table-index .
  • Кластер Aurora DB — тип ресурса cluster, а уникальный идентификатор — имя кластера. Пример: cluster:my-db-cluster .
  • Вариант варианта конечной точки SageMaker — тип ресурса variant, а уникальный идентификатор — идентификатор ресурса. Пример: endpoint/my-end-point/variant/KMeansClustering .
  • Пользовательские ресурсы не поддерживаются с типом ресурса. Этот параметр должен указывать OutputValue из шаблона CloudFormation стека, используемого для доступа к ресурсам. Уникальный идентификатор определяется поставщиком службы. Дополнительная информация доступна в нашем репозитории GitHub.
  • Конечная точка классификации документов Amazon Comprehend — тип ресурса и уникальный идентификатор указываются с помощью ARN конечной точки. Пример: arn:aws:comprehend:us-west-2:123456789012:document-classifier-endpoint/EXAMPLE .
  • Конечная точка распознавания сущностей Amazon Comprehend — тип ресурса и уникальный идентификатор указываются с помощью ARN конечной точки. Пример: arn:aws:comprehend:us-west-2:123456789012:entity-recognizer-endpoint/EXAMPLE .
  • Резервированная одновременность Lambda — тип ресурса function, а уникальный идентификатор — имя функции с суффиксом версии функции или имени псевдонима, который не является $LATEST . Пример: function:my-function:prod или function:my-function:1 .
  • Таблица Amazon Keyspaces — тип ресурса table, а уникальный идентификатор — имя таблицы. Пример: keyspace/mykeyspace/table/mytable .
  • Кластер Amazon MSK — тип ресурса и уникальный идентификатор указываются с помощью ARN кластера. Пример: arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5 .
  • Группа реплик Amazon ElastiCache — тип ресурса replication-group, а уникальный идентификатор — имя группы реплик. Пример: replication-group/mycluster .
  • Кластер кэша Amazon ElastiCache — тип ресурса cache-cluster, а уникальный идентификатор — имя кластера кэша. Пример: cache-cluster/mycluster .
  • Кластер Neptune — тип ресурса cluster, а уникальный идентификатор — имя кластера. Пример: cluster:mycluster .
  • Серверная конечная точка SageMaker — тип ресурса variant, а уникальный идентификатор — идентификатор ресурса. Пример: endpoint/my-end-point/variant/KMeansClustering .
  • Компонент вывода SageMaker — тип ресурса inference-component, а уникальный идентификатор — идентификатор ресурса. Пример: inference-component/my-inference-component .
  • Пул WorkSpaces — тип ресурса workspacespool, а уникальный идентификатор — идентификатор пула. Пример: workspacespool/wspool-123456 .

--scalable-dimension (строка)

Масштабируемое измерение. Эта строка состоит из пространства имен службы, типа ресурса и свойства масштабирования.

  • ecs:service:DesiredCount — количество задач службы ECS.
  • elasticmapreduce:instancegroup:InstanceCount — количество экземпляров группы экземпляров EMR.
  • ec2:spot-fleet-request:TargetCapacity — целевая емкость Spot Fleet.
  • appstream:fleet:DesiredCapacity — емкость флота AppStream 2.0.
  • dynamodb:table:ReadCapacityUnits — емкость предварительно выделенных чтений для таблицы DynamoDB.
  • dynamodb:table:WriteCapacityUnits — емкость предварительно выделенных записей для таблицы DynamoDB.
  • dynamodb:index:ReadCapacityUnits — емкость предварительно выделенных чтений для глобального вторичного индекса DynamoDB.
  • dynamodb:index:WriteCapacityUnits — емкость предварительно выделенных записей для глобального вторичного индекса DynamoDB.
  • rds:cluster:ReadReplicaCount — количество Aurora Replicas в кластере Aurora DB. Доступно для Aurora MySQL-совместимого издания и Aurora PostgreSQL-совместимого издания.
  • sagemaker:variant:DesiredInstanceCount — количество экземпляров EC2 для варианта конечной точки модели SageMaker.
  • custom-resource:ResourceType:Property — масштабируемое измерение для пользовательского ресурса, предоставляемого собственным приложением или службой.
  • comprehend:document-classifier-endpoint:DesiredInferenceUnits — количество блоков вывода для конечной точки классификации документов Amazon Comprehend.
  • comprehend:entity-recognizer-endpoint:DesiredInferenceUnits — количество блоков вывода для конечной точки распознавания сущностей Amazon Comprehend.
  • lambda:function:ProvisionedConcurrency — резервированная одновременность для функции Lambda.
  • cassandra:table:ReadCapacityUnits — резервированная емкость чтений для таблицы Amazon Keyspaces.
  • cassandra:table:WriteCapacityUnits — резервированная емкость записей для таблицы Amazon Keyspaces.
  • kafka:broker-storage:VolumeSize — размер предварительно выделенного тома (в GiB) для брокеров в кластере Amazon MSK.
  • elasticache:cache-cluster:Nodes — количество узлов для кластера кэша Amazon ElastiCache.
  • elasticache:replication-group:NodeGroups — количество групп узлов для группы реплик Amazon ElastiCache.
  • elasticache:replication-group:Replicas — количество реплик на группу узлов для группы реплик Amazon ElastiCache.
  • neptune:cluster:ReadReplicaCount — количество читаемых реплик в кластере Amazon Neptune DB.
  • sagemaker:variant:DesiredProvisionedConcurrency — резервированная одновременность для серверной конечной точки SageMaker.
  • sagemaker:inference-component:DesiredCopyCount — количество копий через конечную точку для компонента вывода SageMaker.
  • workspaces:workspacespool:DesiredUserSessions — количество пользовательских сеансов для WorkSpaces в пуле.

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

  • ecs:service:DesiredCount
  • ec2:spot-fleet-request:TargetCapacity
  • elasticmapreduce:instancegroup:InstanceCount
  • appstream:fleet:DesiredCapacity
  • dynamodb:table:ReadCapacityUnits
  • dynamodb:table:WriteCapacityUnits
  • dynamodb:index:ReadCapacityUnits
  • dynamodb:index:WriteCapacityUnits
  • rds:cluster:ReadReplicaCount
  • sagemaker:variant:DesiredInstanceCount
  • custom-resource:ResourceType:Property
  • comprehend:document-classifier-endpoint:DesiredInferenceUnits
  • comprehend:entity-recognizer-endpoint:DesiredInferenceUnits
  • lambda:function:ProvisionedConcurrency
  • cassandra:table:ReadCapacityUnits
  • cassandra:table:WriteCapacityUnits
  • kafka:broker-storage:VolumeSize
  • elasticache:cache-cluster:Nodes
  • elasticache:replication-group:NodeGroups
  • elasticache:replication-group:Replicas
  • neptune:cluster:ReadReplicaCount
  • sagemaker:variant:DesiredProvisionedConcurrency
  • sagemaker:inference-component:DesiredCopyCount
  • workspaces:workspacespool:DesiredUserSessions

--start-time (метка времени)

Дата и время начала этого запланированного действия в формате UTC.

--end-time (метка времени)

Дата и время окончания повторяющегося расписания в формате UTC.

--scalable-target-action (структура)

Новые минимальная и максимальная емкости. Можно задать оба значения или только одно. В назначенное время, если текущая емкость ниже минимальной, Application Auto Scaling масштабируется до минимальной емкости. Если текущая емкость превышает максимальную, Application Auto Scaling масштабируется до максимальной емкости.

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

Минимальная емкость.

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

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

Максимальная емкость.

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

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

MinCapacity=integer,MaxCapacity=integer

Синтаксис JSON:

{
  "MinCapacity": integer,
  "MaxCapacity": 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.

Для добавления запланированного действия в таблицу DynamoDB

В этом примере добавляется запланированное действие в таблицу DynamoDB с именем TestTable для масштабирования по повторяющемуся расписанию. В соответствии с указанным расписанием (каждый день в 12:15 по UTC), если текущая емкость ниже значения, указанного для MinCapacity, Application Auto Scaling масштабируется до значения, указанного MinCapacity.

Команда:

aws application-autoscaling put-scheduled-action --service-namespace dynamodb --scheduled-action-name my-recurring-action --schedule "cron(15 12 * * ? *)" --resource-id table/TestTable --scalable-dimension dynamodb:table:WriteCapacityUnits --scalable-target-action MinCapacity=6

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

Вывод

Нет

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API