You need to enable JavaScript to run this app.
文档中心
弹性伸缩

弹性伸缩

复制全文
下载 pdf
实例管理
DescribeScalingInstances - 查询伸缩组内ECS实例列表
复制全文
下载 pdf
DescribeScalingInstances - 查询伸缩组内ECS实例列表
查询弹性伸缩组中的实例信息。​
调试​
API Explorer
您可以通过 API Explorer 在线发起调用,无需关注签名生成过程,快速获取调用结果。
​
请求参数​
下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。​
Action string 必选 示例值:DescribeScalingInstances​
要执行的操作,取值:DescribeScalingInstances。​
​
Version string 必选 示例值:2020-01-01​
API的版本,取值:2020-01-01。​
​
ScalingGroupId string 可选 示例值:scg-ybmssdnnhn5pkgyd****​
伸缩组ID。您可以调用DescribeScalingGroups查询伸缩组ID。​
​
CreationType string 可选 示例值:AutoCreated​
实例的创建方式,取值:​
  • AutoCreated:由伸缩组根据实例配置自动创建的实例。​
  • Attached:由您手动添加到伸缩组中的实例。​
​
InstanceIds.N string[] 可选 示例值:i-ybmike5l70l8j1ha****​
实例ID列表。您可以调用DescribeInstances接口查询实例ID。​
  • 参数 - N:表示伸缩组的序号,取值1 ~ 20。​
多个实例ID之间用&分隔。​
​
PageNumber integer 可选 示例值:1​
列表的页码,默认值为1。​
​
PageSize integer 可选 示例值:10​
分页查询时每页的行数,取值范围1~100。默认值:10。​
​
ScalingConfigurationId string 可选 示例值:scc-ybmt16auaugh9zfy****​
伸缩配置ID。您可以调用DescribeScalingConfigurations接口查询伸缩配置ID。​
​
Status string 可选 示例值:InService​
实例状态,取值:​
  • Init 初始化。​
  • Pending 加入中。​
  • Pending:Wait 加入挂起中。​
  • InService 服务中。​
  • Error 错误。​
  • Removing 移出中。​
  • Removing:Wait 移出挂起中。​
  • Stopped 停用中。​
  • Protected 保护中。​
  • Standby:备用中。​
​
​
​
返回参数​
下方仅列出本接口特有的返回参数。更多信息请参见返回结构。​
PageNumber integer 示例值:1​
当前页数。​
​
PageSize integer 示例值:10​
当前分页的行数。​
​
ScalingInstances object[] 示例值:--​
符合条件的实例信息。​
CreatedTime string 示例值:2022-04-02T16:00:00Z​
实例加入伸缩组的时间,精确到秒。​
​
InstanceId string 示例值:i-ybmike5l70l8j1ha****​
实例ID。​
​
ScalingConfigurationId string 示例值:scc-ybmt16auaugh9zfy****​
伸缩配置ID。​
​
ScalingGroupId string 示例值:scg-ybmssdnnhn5pkgyd****​
实例所属伸缩组ID。​
​
ScalingPolicyId string 示例值:sp-ybmvamf8uql8j1fl****​
伸缩规则ID。仅通过伸缩规则自动创建的实例有返回值。​
​
Entrusted boolean 示例值:true​
添加实例到伸缩组时,是否将实例托管给伸缩组,取值:​
  • true:将实例托管给伸缩组。​
  • false:未将实例托管给伸缩组。​
​
ZoneId string 示例值:cn-beijing-a​
实例所属的可用区ID。​
​
Status string 示例值:InService​
实例状态。取值:​
  • Init 初始化。​
  • Pending 加入中。​
  • Pending:Wait 加入挂起中。​
  • InService 服务中。​
  • Error 错误。​
  • Removing 移出中。​
  • Removing:Wait 移出挂起中。​
  • Stopped 停用中。​
  • Protected 保护中。​
​
LaunchTemplateId string 示例值:lt-yc5kwj1di33uw1qj****​
实例启动模板ID。​
​
CreationType string 示例值:AutoCreated​
实例的创建方式。取值:​
  • AutoCreated:根据伸缩配置自动创建的实例。​
  • Attached:由您手动添加到伸缩组中的实例。​
​
LaunchTemplateVersion string 示例值:Default​
实例启动模板的版本。取值:​
  • Default:始终使用模板默认版本。​
  • Latest:始终使用模板最新版本。​
  • 其他取值:模板的某个版本号。​
说明​
本参数仅当LaunchTemplateId参数存在取值时生有效。​
​
​
TotalCount integer 示例值:20​
符合条件的实例总数。​
​
​
​
请求示例​
​
GET /?Action=DescribeScalingInstances&Version=2020-01-01 HTTP/1.1​
Host: auto-scaling.cn-beijing.volcengineapi.com​
X-Date: 20240507T112629Z​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20240507/cn-beijing/auto_scaling/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
​
​
返回示例​
​
{​
"ResponseMetadata": {​
"RequestId": "20240507192632154165224230E09C6E",​
"Version": "2020-01-01",​
"Service": "auto_scaling",​
"Region": "cn-beijing"​
},​
"Result": {​
"PageNumber": 1,​
"PageSize": 10,​
"ScalingInstances": [​
{​
"CreatedTime": "2022-04-02T16:00:00Z",​
"InstanceId": "i-ybmike5l70l8j1ha****",​
"ScalingConfigurationId": "scc-ybmt16auaugh9zfy****",​
"ScalingGroupId": "scg-ybmssdnnhn5pkgyd****",​
"ScalingPolicyId": "sp-ybmvamf8uql8j1fl****",​
"CreationType": "AutoCreated",​
"Entrusted": true,​
"ZoneId": "cn-beijing-a",​
"Status": "InService",​
"LaunchTemplateId": "lt-yc5kwj1di33uw1qj****",​
"LaunchTemplateVersion": "Default"​
}​
],​
"TotalCount": 20​
}​
}​
​
错误码​
下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。​
​
状态码​
错误码​
错误信息​
说明​
400​
InvalidInstanceIds.Malformed​
The specified amount of InstanceIds is malformed.​
指定的实例ID数量超出限制。​
400​
InvalidInstanceStatus​
The specified Status is unsupported.​
指定的实例状态不支持。​
400​
InvalidInstanceCreationType​
The specified CreationType is unsupported.​
指定的实例创建方式不支持。​
500​
InternalError​
An internal error has occurred.​
内部错误,请重试。如果多次尝试失败,请提交工单。​
​
​
最近更新时间:2025.08.27 19:18:33
这个页面对您有帮助吗?
有用
有用
无用
无用