全部产品
Search
文档中心

云服务器 ECS:DescribeAutoProvisioningGroupInstances

更新时间:Sep 07, 2023

调用DescribeAutoProvisioningGroupInstances查询一个弹性供应组内的实例。

调试

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

请求参数

名称

类型

是否必选

示例值

描述

Action String DescribeAutoProvisioningGroupInstances

系统规定参数。取值:DescribeAutoProvisioningGroupInstances

RegionId String cn-hangzhou

弹性供应组所在地域的ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

PageNumber Integer 1

分页查询列表的页码。

起始值:1。

默认值:1。

PageSize Integer 10

分页查询时设置的每页行数。

最大值:100。

默认值:10。

AutoProvisioningGroupId String apg-uf6jel2bbl62wh13****

弹性供应组的ID。

返回数据

名称

类型

示例值

描述

PageSize Integer 10

每页行数。

RequestId String B48A12CD-1295-4A38-A8F0-0E92C937****

请求ID。

PageNumber Integer 1

页码。

TotalCount Integer 2

查询到的弹性供应组内实例的个数。

Instances Array of Instance

弹性供应组下所有实例的信息。

Instance
Status String Running

实例状态。

CreationTime String 2017-12-10T04:04Z

实例创建时间。

IsSpot Boolean true

是否为抢占式实例。

CPU Integer 2

实例的vCPU核数。

InstanceId String i-bp67acfmxazb4p****

实例ID。

NetworkType String vpc

实例的网络类型,可能值:

  • vpc:专有网络
  • classic:经典网络
InstanceType String ecs.g5.large

实例规格。

RegionId String cn-hangzhou

实例所属地域的ID。

IoOptimized Boolean true

是否为I/O优化型实例。

OsType String linux

实例的操作系统类型,可能值:

  • windows:操作系统类型为Windows。
  • linux:操作系统类型为Linux。
ZoneId String cn-hangzhou-g

实例所属可用区。

Memory Integer 1024

内存大小,单位MiB。

示例

请求示例

https://ecs.aliyuncs.com/?Action=DescribeAutoProvisioningGroupInstances
&AutoProvisioningGroupId=apg-uf6jel2bbl62wh13****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeAutoProvisioningGroupInstancesResponse>
    <PageNumber>1</PageNumber>
    <TotalCount>2</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-bp67acfmxazb4p****</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-bp67acfmxazb5p****</InstanceId>
            <CPU>2</CPU>
            <ZoneId>cn-shanghai-a</ZoneId>
            <InstanceType>ecs.g5.large</InstanceType>
        </Instance>
    </Instances>
</DescribeAutoProvisioningGroupInstancesResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "PageNumber" : 1,
  "TotalCount" : 2,
  "PageSize" : 2,
  "RequestId" : "A43735F7-30BD-4D89-AB8A-030EB24B****",
  "Instances" : {
    "Instance" : [ {
      "CreationTime" : "2019-06-17T15:25Z",
      "IoOptimized" : true,
      "OsType" : "linux",
      "NetworkType" : "vpc",
      "Status" : "Running",
      "Memory" : 8192,
      "RegionId" : "cn-shanghai",
      "InstanceId" : "i-bp67acfmxazb4p****",
      "CPU" : 2,
      "ZoneId" : "cn-shanghai-a",
      "InstanceType" : "ecs.g5.large"
    }, {
      "CreationTime" : "2019-06-17T15:25Z",
      "IoOptimized" : true,
      "OsType" : "linux",
      "NetworkType" : "vpc",
      "Status" : "Running",
      "Memory" : 8192,
      "RegionId" : "cn-shanghai",
      "InstanceId" : "i-bp67acfmxazb5p****",
      "CPU" : 2,
      "ZoneId" : "cn-shanghai-a",
      "InstanceType" : "ecs.g5.large"
    } ]
  }
}

错误码

HttpCode

错误码

错误信息

描述

400 MissingParamter.RegionId The regionId should not be null. 参数 RegionId 不得为空。

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