DescribeElasticStrength - 查询伸缩组的弹性强度 - 弹性伸缩

伸缩组配置的有效性很大程度决定了扩容过程的成功率。弹性伸缩通过弹性强度描述伸缩配置的有效性，让配置的优良程度量化，帮助用户针对性的优化伸缩配置。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用背景高亮的方式表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作	访问级别	资源类型	条件关键字	关联操作
ess:DescribeElasticStrength	get	全部资源 *	无	无

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	伸缩组所属地域的 ID。	cn-qingdao
ScalingGroupId	string	否	伸缩组的 ID。	asg-bp18p2yfxow2dloq****
InstanceTypes	array	否	ECS 实例的实例规格的集合。传入时，覆盖伸缩配置中的实例规格。
	string	否	ECS 实例规格。	ecs.g6.large
PriorityStrategy	string	否	后付费实例的抢占策略。传入时覆盖伸缩组配置的抢占策略，取值范围： NoSpot：普通的按量付费实例。 SpotWithPriceLimit：设置上限价格的抢占式实例。 SpotAsPriceGo：系统自动出价，跟随当前市场实际价格。默认值：NoSpot。	NoSpot
SystemDiskCategories	array	否	多个系统盘类型。传入时，覆盖伸缩配置中的系统盘类型。取值范围： cloud：普通云盘。 cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。 cloud_essd：ESSD 云盘。
	string	否	系统盘的多磁盘类型。取值范围： cloud：普通云盘。 cloud_efficiency：高效云盘。 cloud_ssd：SSD 云盘。 cloud_essd：ESSD 云盘。	cloud
ScalingGroupIds	array	否	批量查询时的查询伸缩组的 ID 列表。
	string	否	伸缩组的 ID。	asg-bp14wlu85wrpchm0****

返回参数

名称	类型	描述	示例值
	object	Schema of Response
RequestId	string	请求 ID。	73469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalStrength	double	伸缩组的弹性强度。每个实例规格+可用区的组合根据供应情况得分为 0 到 1 分，其中 0 分代表弹性强度低，1 分代表弹性强度高。所有实例规格+可用区的组合的得分总和为伸缩组的弹性强度。	1.5
ResourcePools	array<object>	查询单个伸缩组时的弹性强度。
ResourcePool	object
Strength	double	资源池的弹性强度。	0.6
InstanceType	string	资源池的实例规格。	ecs.c7t.xlarge
ZoneId	string	资源池的可用区 ID。	cn-hangzhou-g
VSwitchIds	array	资源池的可用区中的交换机。
VSwitchId	string	交换机 ID。	vsw-2ze0uc933kantv******
Code	string	弹性强度为 0 时的原因（错误码）。	IMG_NOT_SUPPORTED
Msg	string	弹性强度为 0 时的原因（错误描述）。	The instanceType does not support the image in the configuration.
ElasticStrengthModels	array<object>	批量查询伸缩组时的弹性强度。
ElasticStrengthModel	object
ScalingGroupId	string	伸缩组 ID。	asg-wz98mnj7nblv9gc****
TotalStrength	double	当前伸缩组的弹性强度。每个实例规格+可用区的组合根据供应情况得分为 0 到 1 分，其中 0 分代表弹性强度低，1 分代表弹性强度高。所有实例规格+可用区的组合的得分总和为伸缩组的弹性强度。	1.5
ResourcePools	array<object>	每个资源池的弹性强度信息。
ResourcePool	object
InstanceType	string	资源池的实例规格。	ecs.r7.large
Strength	double	资源池的弹性强度。	0.6
ZoneId	string	资源池的可用区 ID。	cn-hangzhou-g
VSwitchIds	array	资源池的可用区中的交换机。
VSwitchId	string	交换机 ID。	vsw-2ze6e8p4******
Code	string	弹性强度为 0 时的原因（错误码）。	InstanceTypesOrDiskTypesNotSupported
Msg	string	弹性强度为 0 时的原因（错误描述）。	The instanceTypes or diskTypes are not supported.

示例

正常返回示例

JSON格式

{
  "RequestId": "73469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "TotalStrength": 1.5,
  "ResourcePools": [
    {
      "Strength": 0.6,
      "InstanceType": "ecs.c7t.xlarge",
      "ZoneId": "cn-hangzhou-g",
      "VSwitchIds": [
        "vsw-2ze0uc933kantv******"
      ],
      "Code": "IMG_NOT_SUPPORTED",
      "Msg": "The instanceType does not support the image in the configuration."
    }
  ],
  "ElasticStrengthModels": [
    {
      "ScalingGroupId": "asg-wz98mnj7nblv9gc****",
      "TotalStrength": 1.5,
      "ResourcePools": [
        {
          "InstanceType": "ecs.r7.large",
          "Strength": 0.6,
          "ZoneId": "cn-hangzhou-g",
          "VSwitchIds": [
            "vsw-2ze6e8p4******"
          ],
          "Code": "InstanceTypesOrDiskTypesNotSupported",
          "Msg": "The instanceTypes or diskTypes are not supported."
        }
      ]
    }
  ]
}

错误码

访问错误中心查看更多错误码。