# 查询暖池内实例信息 - ListWarmPoolInstances #### 功能介绍 查询伸缩组暖池内实例信息。 #### 约束限制 本接口支持的区域包括：亚太-雅加达、拉美-圣保罗一。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/AS/doc?api=ListWarmPoolInstances)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-as/as_07_0200.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | as:scalingGroup:listWarmPoolInstances | list | scalingGroup\* | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_0934.html#section2) | - | - | #### URI GET /autoscaling-api/{project_id}/scaling-groups/{scaling_group_id}/warm-pool-instances 表1参数说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释：** 项目ID。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-as/as_04_0106.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | scaling_group_id | 是 | String | **参数解释：** 伸缩组ID。获取方式请参见[查询弹性伸缩组列表 - ListScalingGroups](https://support.huaweicloud.com/api-as/as_06_0102.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | | limit | 否 | String | **参数解释：** 查询记录每页的条数。 **约束限制：** 不涉及 **取值范围：** 0-100，只能为整数。 **默认取值：** 20 | | marker | 否 | String | **参数解释：** 查询暖池实例的分页marker。取值为上一页数据的最后一条记录的唯一标识。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 | #### 请求参数 无 #### 请求示例 查询伸缩组5bc3aa02-b83e-454c-aba1-4d2095c68f8b暖池内实例信息。 ``` GET https://{Endpoint}/autoscaling-api/{project_id}/scaling-groups/5bc3aa02-b83e-454c-aba1-4d2095c68f8b/warm-pool-instances ``` #### 响应参数 表2响应参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | page_info | 否 | [page_info] object | **参数解释：** 分页信息。具体请参考[表3 page_info字段数据结构说明]。 | | warm_pool_instances | 否 | Array of [warm_pool_instances] objects | **参数解释：** 暖池实例列表。具体请参考[表4] | 表3page_info字段数据结构说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | next_marker | 否 | String | **参数解释：** 下一页的marker。 **取值范围：** 不涉及 | 表4warm_pool_instances字段数据结构说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | id | 否 | String | **参数解释：** 暖池实例ID。 **取值范围：** 不涉及 | | instance_id | 否 | String | **参数解释：** 对应的虚拟机ID。 **取值范围：** 不涉及 | | name | 否 | String | **参数解释：** 暖池实例的名称。 **取值范围：** 不涉及 | | status | 否 | String | **参数解释：** 暖池实例的状态。 **取值范围：** - ACTIVE：正常 - CLOSING：关闭中 - CLOSED：关闭 | #### 响应示例 ``` { "page_info": { "next_marker": "xxxx" }, "warm_pool_instances": [ { "id": "xxxx", "instance_id": "xxxxx", "name": "xxxx", "status": "ACTIVE" } ] } ``` #### 返回值 - 正常 200 - 异常 | 返回值 | 说明 | |:---|:---| | 400 Bad Request | 服务器未能处理请求。 | | 401 Unauthorized | 被请求的页面需要用户名和密码。 | | 403 Forbidden | 对被请求的页面访问禁止。 | | 404 Not Found | 服务器无法找到被请求的页面。 | | 405 Method Not Allowed | 请求中指定的方法不被允许。 | | 406 Not Acceptable | 服务器生成的响应无法被客户端所接受。 | | 407 Proxy Authentication Required | 用户必须首先使用代理服务器进行验证，这样请求才会被处理。 | | 408 Request Timeout | 请求超出了服务器的等待时间。 | | 409 Conflict | 由于冲突，请求无法被完成。 | | 500 Internal Server Error | 请求未完成。服务异常。 | | 501 Not Implemented | 请求未完成。服务器不支持所请求的功能。 | | 502 Bad Gateway | 请求未完成。服务器从上游服务器收到一个无效的响应。 | | 503 Service Unavailable | 请求未完成。系统暂时异常。 | | 504 Gateway Timeout | 网关超时。 | #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-as/as_07_0102.html)。