/ 弹性云服务器 ecs/ api参考/ api/ 智能购买组管理/ 查询智能购买组列表
更新时间：2023-07-06 gmt 08:00
查看pdf

查询智能购买组列表-九游平台

功能介绍

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

调试

您可以在中调试该接口。

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

请求类型。

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"
    }
}

返回值

请参考通用请求返回值。

错误码

请参考。

父主题： 智能购买组管理

相关文档

网站地图