[ aws . application-autoscaling ]
Получение информации о масштабируемых целях
Описание
Получает информацию о масштабируемых целях в указанном пространстве имён.
Вы можете фильтровать результаты, используя ResourceIds и ScalableDimension .
См. также: Документацию API AWS
describe-scalable-targets — это операция с постраничной выборкой. Для получения всего набора результатов могут потребоваться несколько вызовов API. Вы можете отключить постраничную выборку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной выборкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: ScalableTargets
Синтаксис
describe-scalable-targets
--service-namespace <value>
[--resource-ids <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]
Параметры
--service-namespace (строка)
Пространство имён службы Amazon Web Services, предоставляющей ресурс. Для ресурса, предоставляемого собственным приложением или службой, используйте custom-resource.
Возможные значения:
ecselasticmapreduceec2appstreamdynamodbrdssagemakercustom-resourcecomprehendlambdacassandrakafkaelasticacheneptuneworkspaces
--resource-ids (список)
Идентификатор ресурса, связанного с масштабируемой целью. Эта строка состоит из типа ресурса и уникального идентификатора.
- Сервис 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.
(строка)
Синтаксис:
"string" "string" ...
--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— размер предопределённого объёма (в 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:DesiredCountec2:spot-fleet-request:TargetCapacityelasticmapreduce:instancegroup:InstanceCountappstream:fleet:DesiredCapacitydynamodb:table:ReadCapacityUnitsdynamodb:table:WriteCapacityUnitsdynamodb:index:ReadCapacityUnitsdynamodb:index:WriteCapacityUnitsrds:cluster:ReadReplicaCountsagemaker:variant:DesiredInstanceCountcustom-resource:ResourceType:Propertycomprehend:document-classifier-endpoint:DesiredInferenceUnitscomprehend:entity-recognizer-endpoint:DesiredInferenceUnitslambda:function:ProvisionedConcurrencycassandra:table:ReadCapacityUnitscassandra:table:WriteCapacityUnitskafka:broker-storage:VolumeSizeelasticache:cache-cluster:Nodeselasticache:replication-group:NodeGroupselasticache:replication-group:Replicasneptune:cluster:ReadReplicaCountsagemaker:variant:DesiredProvisionedConcurrencysagemaker:inference-component:DesiredCopyCountworkspaces: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)
Переопределить адрес по умолчанию команды указанным адресом.
--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, относящегося к двоичному блоку, 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.
Для описания масштабируемых целей
Следующий describe-scalable-targets пример описывает масштабируемые цели для ecs сервисного пространства.
aws application-autoscaling describe-scalable-targets \
--service-namespace ecs
Вывод:
{
"ScalableTargets": [
{
"ServiceNamespace": "ecs",
"ScalableDimension": "ecs:service:DesiredCount",
"ResourceId": "service/default/web-app",
"MinCapacity": 1,
"MaxCapacity": 10,
"RoleARN": "arn:aws:iam::123456789012:role/aws-service-role/ecs.application-autoscaling.amazonaws.com/AWSServiceRoleForApplicationAutoScaling_ECSService",
"CreationTime": 1462558906.199,
"SuspendedState": {
"DynamicScalingOutSuspended": false,
"ScheduledScalingSuspended": false,
"DynamicScalingInSuspended": false
},
"ScalableTargetARN": "arn:aws:application-autoscaling:us-west-2:123456789012:scalable-target/1234abcd56ab78cd901ef1234567890ab123"
}
]
}
Для получения дополнительной информации см. AWS-сервисы, которые можно использовать с Application Auto Scaling в Руководстве пользователя Application Auto Scaling.
Вывод
ScalableTargets -> (список)
Масштабируемые цели, соответствующие параметрам запроса.
(структура)
Представляет масштабируемую цель.
ServiceNamespace -> (строка)
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 в пуле.
MinCapacity -> (целое число)
MaxCapacity -> (целое число)
PredictedCapacity -> (целое число)
RoleARN -> (строка)
CreationTime -> (временная метка)
SuspendedState -> (структура)
Указывает, приостановлены ли действия масштабирования для масштабируемой цели.
DynamicScalingInSuspended -> (булево)
true, если вы не хотите, чтобы Application Auto Scaling удалял ёмкость при срабатывании политики масштабирования. По умолчанию — false .DynamicScalingOutSuspended -> (булево)
true, если вы не хотите, чтобы Application Auto Scaling добавлял ёмкость при срабатывании политики масштабирования. По умолчанию — false .ScheduledScalingSuspended -> (булево)
true, если вы не хотите, чтобы Application Auto Scaling добавлял или удалял ёмкость, инициируя запланированные действия. По умолчанию — false .ScalableTargetARN -> (строка)
NextToken -> (строка)
null, если больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.