# 查询智能购买组列表 - ListAutoLaunchGroups
#### 功能介绍
获取租户创建的所有的智能购买组。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=CMS&api=ListAutoLaunchGroups)中调试该接口。
#### 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           | **参数解释：** 页标记。 **取值范围：** 不涉及                                                                     |
   
 表4auto_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 | **参数解释：** 结束时间。 **取值范围：** 不涉及                                                                                                                                                                                                                                                                                                                                                    |
   
表5page_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"
    }
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-ecs/ecs_07_0002.html)。