describe-scaling-policies

Описание

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

Вы можете фильтровать результаты, используя ResourceId , ScalableDimension и PolicyNames.

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

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

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

Синтаксис

  describe-scaling-policies
[--policy-names <value>]
--service-namespace <value>
[--resource-id <value>]
[--scalable-dimension <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--policy-names (список)

Имена управляющих политик масштабирования для описания.

(строка)

Синтаксис:

"string" "string" ...

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

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

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

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

--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 в кластере 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 - Установленный объем (в ГБ) для брокеров в кластере 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

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

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

Токен, указывающий, где начать постраничный вывод. Это NextToken из ранее усечённого ответа.

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

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

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

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

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

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

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

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

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

--debug (boolean)

Включить отладовую запись журнала.

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

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

base64
raw-in-base64-out

--no-cli-pager (boolean)

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

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Для описания политик масштабирования

В этом примере команды описываются политики масштабирования для пространства имен сервиса ecs.

Команда:

aws application-autoscaling describe-scaling-policies --service-namespace ecs

Вывод:

{
    "ScalingPolicies": [
        {
            "PolicyName": "web-app-cpu-gt-75",
            "ScalableDimension": "ecs:service:DesiredCount",
            "ResourceId": "service/default/web-app",
            "CreationTime": 1462561899.23,
            "StepScalingPolicyConfiguration": {
                "Cooldown": 60,
                "StepAdjustments": [
                    {
                        "ScalingAdjustment": 200,
                        "MetricIntervalLowerBound": 0.0
                    }
                ],
                "AdjustmentType": "PercentChangeInCapacity"
            },
            "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-gt-75",
            "PolicyType": "StepScaling",
            "Alarms": [
                {
                    "AlarmName": "web-app-cpu-gt-75",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-gt-75"
                }
            ],
            "ServiceNamespace": "ecs"
        },
        {
            "PolicyName": "web-app-cpu-lt-25",
            "ScalableDimension": "ecs:service:DesiredCount",
            "ResourceId": "service/default/web-app",
            "CreationTime": 1462562575.099,
            "StepScalingPolicyConfiguration": {
                "Cooldown": 1,
                "StepAdjustments": [
                    {
                        "ScalingAdjustment": -50,
                        "MetricIntervalUpperBound": 0.0
                    }
                ],
                "AdjustmentType": "PercentChangeInCapacity"
            },
            "PolicyARN": "arn:aws:autoscaling:us-west-2:012345678910:scalingPolicy:6d8972f3-efc8-437c-92d1-6270f29a66e7:resource/ecs/service/default/web-app:policyName/web-app-cpu-lt-25",
            "PolicyType": "StepScaling",
            "Alarms": [
                {
                    "AlarmName": "web-app-cpu-lt-25",
                    "AlarmARN": "arn:aws:cloudwatch:us-west-2:012345678910:alarm:web-app-cpu-lt-25"
                }
            ],
            "ServiceNamespace": "ecs"
        }
    ]
}

Вывод

ScalingPolicies -> (список)

Информация о политиках масштабирования.

(структура)

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

Дополнительную информацию о настройке политик масштабирования для определенного сервиса см. в Руководстве пользователя Application Auto Scaling в разделе Amazon Web Services-сервисы, которые можно использовать с Application Auto Scaling.

PolicyARN -> (строка)

Amazon Resource Name (ARN) политики масштабирования.

PolicyName -> (строка)

Имя политики масштабирования.

ServiceNamespace -> (строка)

Пространство имен Amazon Web Services-сервиса, предоставляющего ресурс, или custom-resource.

ResourceId -> (строка)

Сервис 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.

ScalableDimension -> (строка)

Изменяемая размерность. Эта строка состоит из пространства имен сервиса, типа ресурса и свойства масштабирования.

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 в кластере 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 — Предопределенный размер тома (в ГБ) для брокеров в кластере 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 в группе.

PolicyType -> (строка)

Тип политики масштабирования.

Поддерживаются следующие типы политик:

TargetTrackingScaling —Не поддерживается для Amazon EMR

StepScaling —Не поддерживается для DynamoDB, Amazon Comprehend, Lambda, Amazon Keyspaces, Amazon MSK, Amazon ElastiCache или Neptune.

PredictiveScaling —Поддерживается только для Amazon ECS

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

Политика масштабирования шагами.

AdjustmentType -> (строка)

Определяет, как интерпретируется значение ScalingAdjustment в StepAdjustment (например, абсолютное число или процент). Допустимые значения: ChangeInCapacity, ExactCapacity и PercentChangeInCapacity.

AdjustmentType требуется при добавлении новой конфигурации политики масштабирования шагами.

StepAdjustments -> (список)

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

Для добавления новой конфигурации политики масштабирования шагами требуется как минимум одна настройка шага.

(структура)

Представляет настройку шага для StepScalingPolicyConfiguration. Описывает настройку, основанную на разнице между значением агрегированного метрики CloudWatch и порогом превышения, определённым для сигнала тревоги.

Рассмотрим примеры, предположим, что у вас есть сигнал тревоги с порогом превышения 50:

Чтобы инициировать настройку, когда метрика больше или равна 50 и меньше 60, укажите нижнюю границу 0 и верхнюю границу 10.
Чтобы инициировать настройку, когда метрика больше 40 и меньше или равна 50, укажите нижнюю границу -10 и верхнюю границу 0.

Существуют некоторые правила для настроек шагов вашей политики:

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

MetricIntervalLowerBound -> (число с плавающей точкой)

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

MetricIntervalUpperBound -> (число с плавающей точкой)

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

Верхняя граница должна быть больше нижней.

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

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

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

Минимальное значение масштабирования при типе настройки PercentChangeInCapacity. Например, предположим, что вы создаёте политику масштабирования шагами для масштабирования службы Amazon ECS на 25 процентов, и вы указываете MinAdjustmentMagnitude в 2. Если служба имеет 4 задачи, и выполняется политика масштабирования, 25 процентов от 4 - это 1. Однако, так как вы указали MinAdjustmentMagnitude в 2, Application Auto Scaling масштабирует службу на 2 задачи.

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

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

MetricAggregationType -> (строка)

Тип агрегирования для метрик CloudWatch. Допустимые значения: Minimum, Maximum и Average. Если тип агрегирования равен null, значение обрабатывается как Average.

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

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

TargetValue -> (double)

Целевое значение метрики. Хотя это свойство принимает числа типа Double, оно не будет принимать значения, которые слишком малы или слишком велики. Значения должны находиться в диапазоне от -2^360 до 2^360. Значение должно быть допустимым числом в зависимости от выбранной метрики. Например, если метрика — это использование ЦП, то целевое значение — это процентное значение, которое представляет, сколько ЦП можно использовать перед масштабированием.

Примечание

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

PredefinedMetricSpecification -> (structure)

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

PredefinedMetricType -> (string)

Тип метрики. Тип метрики ALBRequestCountPerTarget применяется только к Spot Fleets и службам ECS.

ResourceLabel -> (string)

Идентифицирует ресурс, связанный с типом метрики. Вы не можете указать метку ресурса, если тип метрики не ALBRequestCountPerTarget, и нет группы целевых объектов, прикреплённой к Spot Fleet или службе ECS.

Вы создаёте метку ресурса, добавляя конечную часть ARN балансировщика нагрузки и конечную часть ARN группы целевых объектов в одно значение, разделённое слеш (/). Формат метки ресурса:

app/my-alb/778d41231b141a0f/targetgroup/my-alb-target-group/943f017f100becff .

Где:

app/<load-balancer-name>/<load-balancer-id> — это конечная часть ARN балансировщика нагрузки
targetgroup/<target-group-name>/<target-group-id> — это конечная часть ARN группы целевых объектов.

Чтобы найти ARN для балансировщика приложений, используйте операцию API DescribeLoadBalancers. Чтобы найти ARN для группы целевых объектов, используйте операцию API DescribeTargetGroups.

CustomizedMetricSpecification -> (structure)

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

MetricName -> (string)

Имя метрики. Чтобы получить точное имя метрики, пространство имён и измерения, просмотрите объект Metric, возвращённый вызовом ListMetrics.

Namespace -> (string)

Пространство имён метрики.

Dimensions -> (list)

Измерения метрики.

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

(structure)

Описывает имена и значения измерений, связанные с метрикой.

Name -> (string)

Имя измерения.

Value -> (string)

Значение измерения.

Statistic -> (string)

Статистика метрики.

Unit -> (string)

Единица измерения метрики. Полный список поддерживаемых единиц измерения CloudWatch см. в типе данных MetricDatum в Справочнике по API Amazon CloudWatch.

Metrics -> (list)

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

(structure)

Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение над значениями возвращаемых статистических данных метрики для создания новой временной последовательности. Временная последовательность — это последовательность точек данных, каждая из которых связана со временем.

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

Expression -> (string)

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

Условие: внутри каждого объекта TargetTrackingMetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Id -> (string)

Короткое имя, которое идентифицирует результаты объекта в ответе. Это имя должно быть уникальным среди всех объектов MetricDataQuery, указанных для одной политики масштабирования. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может использоваться как переменная в математическом выражении. Допустимые символы — буквы, цифры и символы нижнего подчеркивания. Первый символ должен быть строчной буквой.

Label -> (string)

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

MetricStat -> (structure)

Информация о возвращаемых данных метрики.

Условие: внутри каждого объекта MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

Metric -> (structure)

Информация о метрике CloudWatch для возврата, включая имя метрики, пространство имён и измерения. Чтобы получить точное имя метрики, пространство имён и измерения, просмотрите объект Metric, возвращаемый вызовом ListMetrics.

Dimensions -> (list)

Измерения метрики. Список доступных измерений см. в документации Amazon Web Services, доступной из таблицы в сервисах Amazon Web Services, которые публикуют метрики CloudWatch в Руководстве пользователя Amazon CloudWatch.

(structure)

Описание измерения метрики.

Name -> (string)

Имя измерения.

Value -> (string)

Значение измерения.

MetricName -> (string)

Имя метрики.

Namespace -> (string)

Пространство имён метрики. Дополнительную информацию см. в таблице в сервисах Amazon Web Services, которые публикуют метрики CloudWatch в Руководстве пользователя Amazon CloudWatch.

Stat -> (string)

Статистика для возврата. Она может включать любые статистические данные CloudWatch или расширенные статистические данные. Список допустимых значений см. в таблице Статистики в Руководстве пользователя Amazon CloudWatch.

Наиболее часто используемая метрика для масштабирования — Average.

Unit -> (string)

Единица измерения для возвращаемых точек данных. Полный список поддерживаемых единиц измерения CloudWatch см. в типе данных MetricDatum в Справочнике по API Amazon CloudWatch.

ReturnData -> (boolean)

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

Если вы используете математические выражения, укажите true только для конечного математического выражения, на котором основано указание метрики. Вы должны указать false для ReturnData всех других метрик и выражений, используемых в описании метрики.

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

ScaleOutCooldown -> (integer)

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

ScaleInCooldown -> (integer)

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

DisableScaleIn -> (boolean)

Указывает, отключено ли масштабирование в соответствии с политикой масштабирования по целевому значению. Если значение — true, масштабирование отключено, и политика масштабирования по целевому значению не будет удалять емкость из масштабируемой цели. В противном случае масштабирование включено, и политика масштабирования по целевому значению может удалять емкость из масштабируемой цели. Значение по умолчанию — false.

PredictiveScalingPolicyConfiguration -> (structure)

Конфигурация политики прогнозирующего масштабирования.

MetricSpecifications -> (список)

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

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

(структура)

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

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

TargetValue -> (двойное)

Указывает целевое использование.

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

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

PredefinedMetricType -> (строка)

Указывает, какие метрики использовать. Для каждого типа метрики существуют два разных типа метрик: одна — метрика нагрузки, а другая — метрика масштабирования.

ResourceLabel -> (строка)

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

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

Спецификация предопределенной метрики масштабирования.

PredefinedMetricType -> (строка)

Тип метрики.

ResourceLabel -> (строка)

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

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

Спецификация предопределенной метрики нагрузки.

PredefinedMetricType -> (строка)

Тип метрики.

ResourceLabel -> (строка)

Метка, которая однозначно идентифицирует целевую группу.

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

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

MetricDataQueries -> (список)

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

(структура)

Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение над значениями возвращаемой статистической информации метрики для создания новой временной серии. Временная серия — это последовательность точек данных, каждая из которых связана со временем.

Id -> (строка)

Короткое имя, которое идентифицирует результаты объекта в ответе. Это имя должно быть уникальным среди всех MetricDataQuery объектов, указанных для одной политики масштабирования. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении. Допустимые символы — буквы, цифры и знаки подчеркивания. Первый символ должен быть строчной буквой.

Expression -> (строка)

Математическое выражение, которое нужно выполнить над возвращаемыми данными, если этот объект выполняет математическое выражение. Это выражение может использовать Id других метрик для ссылки на эти метрики и также может использовать Id других выражений для использования результата этих выражений.

Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Информация о данных метрики для возврата.

Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Метрика CloudWatch для возврата, включая имя метрики, пространство имен и измерения. Чтобы получить точное имя метрики, пространство имен и измерения, просмотрите объект Metric, возвращаемый вызовом ListMetrics.

Dimensions -> (список)

Описывает измерения метрики.

(структура)

Описывает измерение метрики.

Name -> (строка)

Имя измерения.

Value -> (строка)

Значение измерения.

MetricName -> (строка)

Имя метрики.

Namespace -> (строка)

Пространство имен метрики.

Stat -> (строка)

Статистика для возврата. Она может включать любую статистику CloudWatch или расширенную статистику. Список допустимых значений см. в таблице Статистики в Руководстве пользователя Amazon CloudWatch.

Наиболее часто используемые метрики для прогнозирующего масштабирования — Average и Sum.

Unit -> (строка)

Единица измерения для возвращаемых точек данных. Полный список единиц измерения, поддерживаемых CloudWatch, см. в типе данных MetricDatum в Справочнике по API Amazon CloudWatch.

Label -> (строка)

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

ReturnData -> (булево)

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

Если вы используете математические выражения, укажите true для этого значения только для конечного математического выражения, на котором основана спецификация метрики. Вы должны указать false для ReturnData всех других метрик и выражений, используемых в спецификации метрики.

Если вы получаете только метрики и не выполняете никаких математических выражений, не указывайте ничего для ReturnData. Это устанавливает его по умолчанию (true).

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

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

MetricDataQueries -> (список)

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

(структура)

Данные метрики для возврата. Также определяет, возвращает ли этот вызов данные только для одной метрики или выполняет ли он математическое выражение над значениями возвращаемой статистической информации метрики для создания новой временной серии. Временная серия — это последовательность точек данных, каждая из которых связана со временем.

Id -> (строка)

Expression -> (строка)

Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Информация о данных метрики для возврата.

Условие: В каждом объекте MetricDataQuery вы должны указать либо Expression, либо MetricStat, но не оба.

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

Dimensions -> (список)

Описывает измерения метрики.

(структура)

Описывает измерение метрики.

Name -> (строка)

Имя измерения.

Value -> (строка)

Значение измерения.

MetricName -> (строка)

Имя метрики.

Namespace -> (строка)

Пространство имен метрики.

Stat -> (строка)

Наиболее часто используемые метрики для прогнозирующего масштабирования — Average и Sum.

Unit -> (строка)

Label -> (строка)

ReturnData -> (булево)

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

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

Спецификация настраиваемого метрического показателя производительности.

MetricDataQueries -> (список)

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

(структура)

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

Id -> (строка)

Короткое имя, которое идентифицирует результаты объекта в ответе. Это имя должно быть уникальным среди всех MetricDataQuery объектов, указанных для одной политики масштабирования. Если вы выполняете математические выражения над этим набором данных, это имя представляет эти данные и может служить переменной в математическом выражении. Допустимые символы — буквы, цифры и знаки подчёркивания. Первый символ должен быть строчной буквой.

Expression -> (строка)

Условие: в каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

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

Информация о данных метрики, которые нужно вернуть.

Условие: в каждом объекте MetricDataQuery необходимо указать либо Expression, либо MetricStat, но не оба.

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

Метрика CloudWatch, которую нужно вернуть, включая имя метрики, пространство имён и измерения. Для получения точного имени метрики, пространства имён и измерений просмотрите объект метрики, возвращаемый вызовом ListMetrics.

Dimensions -> (список)

Описание измерений метрики.

(структура)

Описание измерения метрики.

Name -> (строка)

Имя измерения.

Value -> (строка)

Значение измерения.

MetricName -> (строка)

Имя метрики.

Namespace -> (строка)

Пространство имён метрики.

Stat -> (строка)

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

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

Unit -> (строка)

Единица измерения для возвращаемых точек данных. Полный список единиц измерения, поддерживаемых CloudWatch, см. в типе данных MetricDatum в справочнике Amazon CloudWatch API.

Label -> (строка)

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

ReturnData -> (булево)

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

Если вы получаете только метрики и не выполняете математических выражений, не указывайте ничего для ReturnData. Это устанавливает его значение по умолчанию (true).

Mode -> (строка)

Режим прогнозного масштабирования. По умолчанию устанавливается в значение ForecastOnly, если не указано другое.

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

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

Значение должно быть меньше продолжительности интервала прогнозирования 3600 секунд (60 минут). По умолчанию устанавливается в 300 секунд, если не указано другое.

MaxCapacityBreachBehavior -> (строка)

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

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

Размер буфера ёмкости, который следует использовать, когда прогнозируемая ёмкость близка к максимальной ёмкости или превышает её. Значение указывается в процентах относительно прогнозируемой ёмкости. Например, если буфер равен 10, это означает 10-процентный буфер, так что, если прогнозируемая ёмкость равна 50, а максимальная ёмкость — 40, то эффективная максимальная ёмкость равна 55.

Требуется, если свойство MaxCapacityBreachBehavior установлено в значение IncreaseMaxCapacity, и не может использоваться в противном случае.

Alarms -> (список)

Связанные с политикой масштабирования оповещения CloudWatch.

(структура)

Представляет связанное с политикой масштабирования оповещение CloudWatch.

AlarmName -> (строка)

Имя оповещения.

AlarmARN -> (строка)

Amazon Resource Name (ARN) оповещения.

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

Метка времени Unix для момента создания политики масштабирования.

NextToken -> (строка)

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

END_OF_DOCUMENT_MARKER