查询智能购买组实例列表 - ListInstances

功能介绍

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

调试

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

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
ecs:launchTemplates:list	list	-	-	-	-

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	参数解释：实例状态。取值范围： ACTIVE、BUILD、ERROR、HARD_REBOOT、MIGRATING、REBOOT、REBUILD、RESIZE、REVERT_RESIZE、SHUTOFF、VERIFY_RESIZE 云服务器状态说明请参考云服务器状态。
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"
    }
}