获取资源池列表 - ListResourcePoolsv4

功能介绍

获取资源池列表

调用方法

请参见如何调用API。

URI

GET /v4/{project_id}/resource-pools

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释: 项目UUID，项目唯一标识，固定长度32位字符（字母和数字）。获取方式请参见获取项目ID 约束限制: 不涉及取值范围: 项目uuid应符合如下规则：长度等于32位，包含大小写字母、数字默认取值: 不涉及

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	参数解释：用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。约束限制：必传。取值范围：字符串长度不少于1，不超过10万。默认取值：不涉及。

响应参数

状态码：200

表3 响应Body参数
参数	参数类型	描述
total	Integer	参数解释符合条件的所有记录数取值范围起始记录数大于实际总条数时，值为0，分页请求才有此值
value	Array of ResourcePoolVo objects	参数解释本次查询的记录结果取值范围实际的数据类型：单个对象，集合或 NULL
reason	String	参数解释业务失败的提示内容取值范围不涉及
page_size	Integer	参数解释每页展示条数取值范围不涉及
page_no	Integer	参数解释页码取值范围不涉及
has_more	Boolean	参数解释是否有更多取值范围不涉及

表4 ResourcePoolVo
参数	参数类型	描述
id	String	参数解释资源池ID 取值范围不涉及
name	String	参数解释资源池名称取值范围不涉及
type	String	参数解释: 资源池类型取值范围: VM，虚拟机。 DOCKER，容器。
selected	String	参数解释是否选中取值范围不涉及
active_state	String	参数解释资源池状态取值范围不涉及

状态码：400

表5 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：401

表6 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：404

表7 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

状态码：500

表8 响应Body参数
参数	参数类型	描述
code	String	参数解释: 业务失败的错误码取值范围: 不涉及
reason	String	参数解释: 业务失败的提示内容取值范围: 不涉及

请求示例

GET https://{endpoint}/v4/90f8dc52eb7b4c47b853c661152ca62d/resource-pools

响应示例

状态码：200

{
  "value" : [ {
    "id" : "DEFAULT",
    "name" : "DEFAULT",
    "type" : "DEFAULT",
    "selected" : "true",
    "active_state" : "DEFAULT"
  } ]
}