文档首页/ 弹性云服务器 ECS/ API参考/ API/ 智能购买组管理/ 查询智能购买组实例列表
更新时间:2023-07-06 GMT+08:00
分享

查询智能购买组实例列表

功能介绍

获取智能购买组创建的实例信息。

调试

您可以在API Explorer中调试该接口。

URI

GET /v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}/instances

参数说明请参见表1
表1 参数说明

参数

是否必选

描述

domain_id

租户域ID。

auto_launch_group_id

智能购买组ID。

表2 查询参数

参数

是否必选

参数类型

描述

limit

Integer

查询返回实例的数量限制。

取值范围:1-1000。

marker

String

取值为上一页数据的最后一条记录的唯一标识。

请求消息

响应消息

响应参数如表3所示。

表3 响应参数

参数

参数类型

描述

instances

Array of objects

实例列表,详情请参见表4

page_info

Object

页标记。

表4 instances参数信息

参数

参数类型

描述

name

String

实例名称。

id

String

实例ID。

availability_zone_id

String

可用区ID。

flavor_id

String

实例规格。

status

String

实例状态。

sell_mode

String

销售模型。

  • spot:竞价实例
  • onDemand:按需实例
表5 page_info参数信息

参数

参数类型

描述

next_marker

String

返回下一页查询地址。

请求示例

查询指定的智能购买组创建的实例列表。

GET https://{endpoint}/v2/{domain_id}/auto-launch-groups/{auto_launch_group_id}/instances

响应示例

{
    "instances": [
        {
            "id": "5bbcc3c4-1da2-4437-a48a-66f15b1b13f9",
            "name": "server1",
            "availability_zone_id": "az1",
            "flavor_id": "s3.large.2",
            "status": "ACTIVE",
            "sell_mode": "onDemand"
         }
    ],
    "page_info": {
        "next_marker": "616fb98f-46ca-475e-917e-2563e5a8cd19"
    }
}

返回值

请参考通用请求返回值

错误码

请参考错误码

相关文档