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

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

调试

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

授权信息

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

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

请求参数

名称类型必填描述示例值
RegionIdstring

伸缩组所属地域的 ID。

cn-qingdao
ScalingGroupIdstring

伸缩组的 ID。

asg-bp18p2yfxow2dloq****
InstanceTypesarray

ECS 实例的实例规格的集合。 传入时,覆盖伸缩配置中的实例规格。

string

ECS 实例规格。

ecs.g6.large
PriorityStrategystring

后付费实例的抢占策略。传入时覆盖伸缩组配置的抢占策略,取值范围:

  • NoSpot:普通的按量付费实例。
  • SpotWithPriceLimit:设置上限价格的抢占式实例。
  • SpotAsPriceGo:系统自动出价,跟随当前市场实际价格。

默认值:NoSpot。

NoSpot
SystemDiskCategoriesarray

多个系统盘类型。 传入时,覆盖伸缩配置中的系统盘类型。取值范围:

  • cloud:普通云盘。
  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD 云盘。
  • cloud_essd:ESSD 云盘。
string

系统盘的多磁盘类型。取值范围:

  • cloud:普通云盘。
  • cloud_efficiency:高效云盘。
  • cloud_ssd:SSD 云盘。
  • cloud_essd:ESSD 云盘。
cloud
ScalingGroupIdsarray

批量查询时的查询伸缩组的 ID 列表。

string

伸缩组的 ID。

asg-bp14wlu85wrpchm0****

返回参数

名称类型描述示例值
object

Schema of Response

RequestIdstring

请求 ID。

73469C7-AA6F-4DC5-B3DB-A3DC0DE3****
TotalStrengthdouble

伸缩组的弹性强度。每个实例规格+可用区的组合根据供应情况得分为 0 到 1 分,其中 0 分代表弹性强度低,1 分代表弹性强度高。所有实例规格+可用区的组合的得分总和为伸缩组的弹性强度。

1.5
ResourcePoolsarray<object>

查询单个伸缩组时的弹性强度。

ResourcePoolobject
Strengthdouble

资源池的弹性强度。

0.6
InstanceTypestring

资源池的实例规格。

ecs.c7t.xlarge
ZoneIdstring

资源池的可用区 ID。

cn-hangzhou-g
VSwitchIdsarray

资源池的可用区中的交换机。

VSwitchIdstring

交换机 ID。

vsw-2ze0uc933kantv******
Codestring

弹性强度为 0 时的原因(错误码)。

IMG_NOT_SUPPORTED
Msgstring

弹性强度为 0 时的原因(错误描述)。

The instanceType does not support the image in the configuration.
ElasticStrengthModelsarray<object>

批量查询伸缩组时的弹性强度。

ElasticStrengthModelobject
ScalingGroupIdstring

伸缩组 ID。

asg-wz98mnj7nblv9gc****
TotalStrengthdouble

当前伸缩组的弹性强度。每个实例规格+可用区的组合根据供应情况得分为 0 到 1 分,其中 0 分代表弹性强度低,1 分代表弹性强度高。所有实例规格+可用区的组合的得分总和为伸缩组的弹性强度。

1.5
ResourcePoolsarray<object>

每个资源池的弹性强度信息。

ResourcePoolobject
InstanceTypestring

资源池的实例规格。

ecs.r7.large
Strengthdouble

资源池的弹性强度。

0.6
ZoneIdstring

资源池的可用区 ID。

cn-hangzhou-g
VSwitchIdsarray

资源池的可用区中的交换机。

VSwitchIdstring

交换机 ID。

vsw-2ze6e8p4******
Codestring

弹性强度为 0 时的原因(错误码)。

InstanceTypesOrDiskTypesNotSupported
Msgstring

弹性强度为 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."
        }
      ]
    }
  ]
}

错误码

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