文档首页/弹性云服务器 ECS/API参考/API/智能购买组管理/查询智能购买组列表 - ListAutoLaunchGroups
更新时间：2026-03-19 GMT+08:00
查看PDF
分享

查询智能购买组列表 - ListAutoLaunchGroups

功能介绍

获取租户创建的所有的智能购买组。

调试

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

URI

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

参数说明请参见表1。
表1 路径参数

参数

是否必选

描述

domain_id

是

参数解释：

租户域ID。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

表2 查询参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释：

查询返回智能购买组的数量限制。

约束限制：

不涉及

取值范围：

1-1000

默认取值：

不涉及

marker

否

String

参数解释：

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

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

name

否

String

参数解释：

智能购买组名称。

约束限制：

不涉及

取值范围：

不涉及

默认取值：

不涉及

valid_since

否

String

参数解释：

请求开始时间，按照时间范围过滤。

约束限制：

按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

取值范围：

不涉及

默认取值：

不涉及

valid_until

否

String

参数解释：

请求结束时间，按照时间范围过滤。

约束限制：

按照ISO8601标准表示，并使用UTC +0时间，格式为yyyy-MM-ddTHH:mm:ssZ。

取值范围：

不涉及

默认取值：

不涉及

请求消息

无

响应消息

响应参数如表3所示。
表3 响应参数

参数

参数类型

描述

auto_launch_groups

Array of objects

参数解释：

智能购买组列表，详情请参见表4。

取值范围：

不涉及

page_info

Object

参数解释：

页标记。

取值范围：

不涉及

表4 auto_launch_groups参数信息

参数

参数类型

描述

id

String

参数解释：

智能购买组ID。

取值范围：

不涉及

name

String

参数解释：

智能购买组名称。

取值范围：

不涉及

type

String

参数解释：

请求类型。

取值范围：

  • request：一次性请求，仅在启动时交付实例集群，调度失败后不再重试。
  • maintain：持续供应请求，在启动时尝试交付实例集群，并监控容量，未达到目标容量则尝试继续创建ECS实例。

status

String

参数解释：

智能购买组的运行状态。

取值范围：

  • SUBMITTED：已提交
  • ACTIVE：运行中
  • DELETING：删除中
  • DELETED：已删除

task_state

String

参数解释：

智能购买组的任务状态。

取值范围：

  • HANDLING：购买中
  • FULFILLED：智能购买组已满配
  • ERROR：智能购买组异常

valid_since

String

参数解释：

开始时间。

取值范围：

不涉及

valid_until

String

参数解释：

结束时间。

取值范围：

不涉及

表5 page_info参数信息

参数

参数类型

描述

next_marker

String

参数解释：

返回下一页查询地址。

取值范围：

不涉及

请求示例

查询智能购买组列表。

GET https://{endpoint}/v2/{domain_id}/auto-launch-groups?limit=1

响应示例

{
    "auto_launch_groups": [
        {
            "id": "616fb98f-46ca-475e-917e-2563e5a8cd19",
            "name": "autoLaunchGroup1",
            "type": "maintain",
            "status": "ACTIVE",
            "task_state": "FULFILLED",
            "valid_since": "2022-11-04T15:58:13Z",
            "valid_until": "2022-11-06T15:58:13Z"
        }
    ],
    "page_info": {
        "next_marker": "616fb98f-46ca-475e-917e-2563e5a8cd19"
    }
}

返回值

请参考通用请求返回值。

错误码

请参考错误码。

相关文档