DescribeAutoProvisioningGroupInstances
调用DescribeAutoProvisioningGroupInstances查询指定弹性供应组下的实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
AutoProvisioningGroupId | String | 是 | apg-uf6jel2bbl62wh13**** |
弹性供应组的ID。 |
RegionId | String | 是 | cn-hangzhou |
弹性供应组所在地域的ID。 |
Action | String | 否 | DescribeAutoProvisioningGroupInstances |
系统规定参数,取值:DescribeAutoProvisioningGroupInstances。 |
PageNumber | Integer | 否 | 1 |
实例状态列表的页码。起始值:1,默认值:1。 |
PageSize | Integer | 否 | 10 |
分页查询时设置的每页行数。最大值:100,默认值:10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Instances |
弹性供应组下所有实例的信息。 |
||
CPU | Integer | 2 |
实例的vCPU核数。 |
CreationTime | String | 2017-12-10T04:04Z |
实例创建时间。 |
InstanceId | String | i-instanc**** |
实例ID。 |
InstanceType | String | ecs.g5.large |
实例规格。 |
IoOptimized | Boolean | true |
是否为I/O优化型实例。 |
IsSpot | Boolean | true |
是否为抢占式实例。 |
Memory | Integer | 1024 |
内存大小,单位MiB。 |
NetworkType | String | vpc |
实例的网络类型,取值范围:
|
OsType | String | linux |
实例的操作系统类型,取值范围:
|
RegionId | String | cn-hangzhou |
实例所属地域的ID。 |
Status | String | Running |
实例状态。 |
ZoneId | String | cn-hangzhou-g |
实例所属可用区。 |
PageNumber | Integer | 1 |
实例状态列表的页码。 |
PageSize | Integer | 10 |
分页查询时设置的每页行数。 |
RequestId | String | B48A12CD-1295-4A38-A8F0-0E92C937**** |
请求ID。 |
TotalCount | Integer | 10 |
查询到的弹性供应组内实例的个数。 |
示例
请求示例
http(s)://ecs.aliyuncs.com/?Action=DescribeAutoProvisioningGroupInstances
$AutoProvisioningGroupId=apg-uf6jel2bbl62wh13****
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<DescribeAutoProvisioningGroupInstancesResponse>
<PageNumber>1</PageNumber>
<TotalCount>100</TotalCount>
<PageSize>2</PageSize>
<RequestId>A43735F7-30BD-4D89-AB8A-030EB24B****</RequestId>
<Instances>
<Instance>
<CreationTime>2019-06-17T15:25Z</CreationTime>
<IoOptimized>true</IoOptimized>
<OsType>linux</OsType>
<NetworkType>vpc</NetworkType>
<Status>Running</Status>
<Memory>8192</Memory>
<RegionId>cn-shanghai</RegionId>
<InstanceId>i-uf64neea72piruk0****</InstanceId>
<CPU>2</CPU>
<ZoneId>cn-shanghai-a</ZoneId>
<InstanceType>ecs.g5.large</InstanceType>
</Instance>
<Instance>
<CreationTime>2019-06-17T15:25Z</CreationTime>
<IoOptimized>true</IoOptimized>
<OsType>linux</OsType>
<NetworkType>vpc</NetworkType>
<Status>Running</Status>
<Memory>8192</Memory>
<RegionId>cn-shanghai</RegionId>
<InstanceId>i-uf64neea72piruk0****</InstanceId>
<CPU>2</CPU>
<ZoneId>cn-shanghai-a</ZoneId>
<InstanceType>ecs.g5.large</InstanceType>
</Instance>
</Instances>
</DescribeAutoProvisioningGroupInstancesResponse>
JSON
格式
{
"PageNumber":1,
"TotalCount":100,
"PageSize":2,
"RequestId":"A43735F7-30BD-4D89-AB8A-030EB24B****",
"Instances":{
"Instance":[
{
"IoOptimized":true,
"CreationTime":"2019-06-17T15:25Z",
"Status":"Running",
"NetworkType":"vpc",
"OsType":"linux",
"Memory":8192,
"InstanceId":"i-uf64neea72piruk0****",
"RegionId":"cn-shanghai",
"CPU":2,
"ZoneId":"cn-shanghai-a",
"InstanceType":"ecs.g5.large"
},
{
"IoOptimized":true,
"CreationTime":"2019-06-17T15:25Z",
"Status":"Running",
"NetworkType":"vpc",
"OsType":"linux",
"Memory":8192,
"InstanceId":"i-uf64neea72piruk0****",
"RegionId":"cn-shanghai",
"CPU":2,
"ZoneId":"cn-shanghai-a",
"InstanceType":"ecs.g5.large"
}
]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
403 | Forbidden.RAM | User not authorized to operate on the specified resource, or this API doesn't support RAM. | 子账号鉴权不通过。 |
400 | MissingParamter.RegionId | The regionId should not be null. | 参数 RegionId 不得为空。 |
访问错误中心查看更多错误码。
版权声明
本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。
评论