调用DescribeScalingConfigurations查询现有的伸缩配置。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeScalingConfigurations

系统规定参数,取值:DescribeScalingConfigurations。

RegionId String cn-qingdao

伸缩配置所属伸缩组的地域ID。

PageNumber Integer 1

伸缩配置列表的页码。起始值:1。

默认值:1 。

PageSize Integer 50

分页查询时设置的每页行数。最大值:50。

默认值:10。

ScalingGroupId String asg-bp17pelvl720x3v7****

伸缩组的ID,您可以查询该伸缩组下所有的伸缩配置。

ScalingConfigurationId.1 String asc-bp17pelvl720x5ub****

ScalingConfigurationId.N为待查询伸缩配置的ID,N的取值范围:1~10。查询结果包括生效和失效的伸缩配置,并通过返回参数LifecycleState进行标识。

ScalingConfigurationName.1 String c1908dd1-690f-4c9b-ab73-350f1f06****

ScalingConfigurationName.N为待查询伸缩配置的名称,N的取值范围:1~10。查询结果会忽略失效的伸缩配置名称,并且不报错。

返回数据

名称 类型 示例值 描述
TotalCount Integer 1

伸缩配置的总数。

PageNumber Integer 1

当前页码。

PageSize Integer 50

每页行数。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

请求ID。

ScalingConfigurations Array

伸缩配置信息的集合。

ScalingConfigurationId String asc-bp1ezrfgoyn5kijl****

伸缩配置的ID。

ScalingConfigurationName String c1908dd1-690f-4c9b-ab73-350f1f06****

伸缩配置的名称。

ScalingGroupId String sg-280ih****

伸缩配置所属伸缩组的ID。

InstanceName String fortest

ECS实例的名称。

ImageId String centos6u5_64_20G_aliaegis_20140703.vhd

镜像文件ID,自动创建实例时使用的镜像资源。

ImageName String centos6u5_64_20G_aliaegis_20140703.vhd

镜像文件名称。

HostName String LocalHost

云服务器的主机名。

InstanceType String ecs.t1.xsmall

ECS实例的实例规格。

Cpu Integer 2

vCPU个数。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。
Memory Integer 16

内存大小。

同时指定CPU和Memory可以定义实例规格范围,例如,CPU=2且Memory=16可以定义配置为2 vCPU和16 GiB的所有实例规格。弹性伸缩会结合IO优化、可用区等因素确定可用实例规格集合,并根据价格排序为您创建价格最低的实例。

说明 该区间配置效果仅在成本优化模式下且伸缩配置未设置实例规格时生效。
InstanceGeneration String ecs-3

ECS实例的系列。

SecurityGroupId String sg-bp18kz60mefs****

ECS实例所属的安全组的ID,同一个安全组内的ECS实例可以互相访问。

IoOptimized String none

是否为I/O优化实例。可能值:

  • none:非I/O优化。
  • optimized:I/O优化。
InternetChargeType String PayByTraffic

网络计费类型,取值范围:

  • PayByBandwidth:按带宽计费。此时InternetMaxBandwidthOut即为所选的固定带宽值。
  • PayByTraffic:按流量计费。此时InternetMaxBandwidthOut只是一个带宽上限,计费以实际产生的网络流量为依据。
InternetMaxBandwidthIn Integer 200

公网入带宽最大值,单位为Mbps (Mega bit per second),取值范围:1~200。

InternetMaxBandwidthOut Integer 0

公网出带宽最大值,单位为Mbps (Mega bit per second),取值范围:

  • 按带宽计费:0~100,如果您没有指定该参数,则出带宽将自动被设置为0Mbps。
  • 按流量计费:0~100,如果您没有指定该参数,则会出现报错。
SystemDiskCategory String cloud

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

  • cloud:普通云盘
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • ephemeral_ssd:本地SSD盘
  • cloud_essd:ESSD云盘
SystemDiskSize Integer 100

系统盘的磁盘大小。

SystemDiskName String cloud_ssdSystem

系统盘的名称。

SystemDiskDescription String FinanceDept

系统盘的描述。

SystemDiskAutoSnapshotPolicyId String sp-bp12m37ccmxvbmi5****

系统盘使用的自动快照策略ID。

LifecycleState String Active

伸缩配置在伸缩组中的状态,取值范围:

  • Active:生效状态。伸缩组会使用处于生效状态的伸缩配置自动创建ECS实例。
  • Inacitve:失效状态。处于失效状态的伸缩配置存在于伸缩组中,但伸缩组不会使用此类伸缩配置自动创建ECS实例。
CreationTime String 2014-08-14T10:58Z

伸缩配置的创建时间。

LoadBalancerWeight Integer 1

后端服务器的权重,取值范围:1~100。

UserData String echo hello ecs!

ECS实例的自定义数据。

KeyPairName String fortest

登录ECS实例时使用的密钥对的名称。

RamRoleName String RamRoleTest

ECS实例的RAM角色名称。RAM角色名称由RAM提供和维护,您可调用ListRoles查询可用的RAM角色。创建RAM角色的方法请参见CreateRole

DeploymentSetId String ds-bp1frxuzdg87zh4p****

ECS实例所属的部署集的ID。

SecurityEnhancementStrategy String Active

是否开启安全加固。取值范围:

  • Active:启用安全加固,只对公共镜像生效。
  • Deactive:不启用安全加固,对所有镜像类型生效。
SpotStrategy String NoSpot

后付费实例的抢占策略。取值范围:

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

是否使用镜像预设的密码。

ResourceGroupId String rg-resourcegroupid1

ECS实例所属资源组的ID。

HpcClusterId String hpc-clusterid

ECS实例所属的EHPC集群的ID。

InstanceDescription String FinaceDept

ECS实例的描述。

Ipv6AddressCount Integer 1

为弹性网卡指定随机生成的IPv6地址数量。

DataDisks Array

数据盘信息的集合。

Size Integer 200

数据盘的磁盘大小,内存单位为GiB。取值范围:

  • cloud:5~2000
  • cloud_efficiency:20~32768
  • cloud_ssd:20~32768
  • cloud_essd:20~32768
  • ephemeral_ssd:5~800
Category String cloud

数据盘的磁盘种类,取值范围:

  • cloud:普通云盘。随实例创建的普通云盘的DeleteWithInstance属性为true。
  • cloud_efficiency:高效云盘
  • cloud_ssd:SSD云盘
  • ephemeral_ssd:本地SSD盘
  • cloud_essd:ESSD云盘
SnapshotId String s-23f2i****

创建数据盘使用的快照ID。

Device String /dev/xvdb

数据盘的挂载点。

DeleteWithInstance Boolean true

数据盘是否随实例释放,取值范围:

  • true:释放实例时,该磁盘随实例一起释放。
  • false:释放实例时,该磁盘保留不释放。
Encrypted String false

数据盘是否加密,取值范围:

  • true:加密
  • false:不加密
KMSKeyId String 0e478b7a-4262-4802-b8cb-00d3fb40****

数据盘对应的KMS密钥的ID。

DiskName String cloud_ssdData

数据盘的名称。

Description String FinanceDept

数据盘的描述。

AutoSnapshotPolicyId String sp-bp19nq9enxqkomib****

数据盘使用的自动快照策略ID。

Tags Array

标签信息的集合。

Key String binary

标签键。

Value String alterTable

标签值。

SpotPriceLimit Array

抢占式实例信息的集合。

InstanceType String ecs.t1.xsmall

抢占式实例的实例规格。

PriceLimit Float 0.125

抢占式实例对应的出价。

InstanceTypes List ecs.t1.xsmall

ECS实例的实例规格的集合。

SecurityGroupIds List sg-bp18kz60mefs****

ECS实例所属的多个安全组的ID,同一个安全组内的ECS实例可以互相访问。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeScalingConfigurations
&RegionId=cn-qingdao
&<公共请求参数>

正常返回示例

XML 格式

<DescribeScalingConfigurationsResponse>
      <RequestId>804F240A-8D3E-40A1-BD68-6B333DEA2CA8</RequestId>
      <TotalCount>1</TotalCount>
      <PageNumber>1</PageNumber>
      <PageSize>50</PageSize>
      <ScalingConfigurations>
            <ScalingConfiguration>
                  <CreationTime>2014-08-14T10:58Z</CreationTime>
                  <ImageId>centos6u5_64_20G_aliaegis_20140703.vhd</ImageId>
                  <InstanceType>ecs.t1.xsmall</InstanceType>
                  <InternetChargeType>PayByTraffic</InternetChargeType>
                  <InternetMaxBandwidthIn>200</InternetMaxBandwidthIn>
                  <InternetMaxBandwidthOut>0</InternetMaxBandwidthOut>
                  <LifecycleState>Active</LifecycleState>
                  <ScalingConfigurationId>asc-bp1ezrfgoyn5kijl****</ScalingConfigurationId>
                  <ScalingConfigurationName>c1908dd1-690f-4c9b-ab73-350f1f06****</ScalingConfigurationName>
                  <ScalingGroupId>sg-280ih****</ScalingGroupId>
                  <SecurityGroupId>sg-bp18kz60mefs****</SecurityGroupId>
                  <SystemDiskCategory>cloud</SystemDiskCategory>
                  <DataDisks>
                        <DataDisk>
                              <Size>200</Size>
                              <Category>cloud</Category>
                              <SnapshotId>s-280s7****</SnapshotId>
                              <Device>/dev/xvdb</Device>
                        </DataDisk>
                  </DataDisks>
            </ScalingConfiguration>
      </ScalingConfigurations>
</DescribeScalingConfigurationsResponse>

JSON 格式

{
    "RequestId": "804F240A-8D3E-40A1-BD68-6B333DEA2CA8",
    "TotalCount": "1",
    "PageNumber": "1",
    "PageSize": "50",
    "ScalingConfigurations": {
        "ScalingConfiguration": {
            "CreationTime": "2014-08-14T10:58Z",
            "ImageId": "centos6u5_64_20G_aliaegis_20140703.vhd",
            "InstanceType": "ecs.t1.xsmall",
            "InternetChargeType": "PayByTraffic",
            "InternetMaxBandwidthIn": "200",
            "InternetMaxBandwidthOut": "0",
            "LifecycleState": "Active",
            "ScalingConfigurationId": "asc-bp1ezrfgoyn5kijl****",
            "ScalingConfigurationName": "c1908dd1-690f-4c9b-ab73-350f1f06****",
            "ScalingGroupId": "sg-280ih****",
            "SecurityGroupId": "sg-bp18kz60mefs****",
            "SystemDiskCategory": "cloud",
            "DataDisks": {
                "DataDisk": {
                    "Size": "200",
                    "Category": "cloud",
                    "SnapshotId": "s-280s7****",
                    "Device": "/dev/xvdb"
                }
            }
        }
    }
}

错误码

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