更新时间:2025-09-18 GMT+08:00

获得资源池的绑定用户列表

功能介绍

获得资源池的绑定用户列表。

调用方法

请参见如何调用API。

URI

GET /v2/{project_id}/clusters/{cluster_id}/workload/queues/{queue_name}/users

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释:

项目ID。获取方法请参见获取项目ID。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

cluster_id

是

String

参数解释:

集群ID。获取方法请参见获取集群ID。

约束限制:

必须是有效的dws集群ID。

取值范围:

36位UUID。

默认取值:

不涉及。

queue_name

是

String

参数解释:

资源池名称。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

参数解释:

分页单页大小。

约束限制:

不涉及。

取值范围:

大于0。

默认取值:

10

offset

否

Integer

参数解释:

分页偏移量,从0开始,页数减1。

约束限制:

不涉及。

取值范围:

大于等于0。

默认取值:

0

请求参数

无

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

workload_res_code

Integer

参数解释:

结果状态码。

取值范围:

不涉及。

workload_res_str

String

参数解释:

结果描述。

取值范围:

不涉及。

queue_name

String

参数解释:

队列名称。

取值范围:

不涉及。

user_list

Array of WorkloadQueueUser objects

参数解释:

队列用户列表。

取值范围:

不涉及。

count

Integer

参数解释:

总数量。

取值范围:

不涉及。

表4 WorkloadQueueUser

参数

参数类型

描述

user_name

String

参数解释:

用户名。

取值范围:

不涉及。

occupy_resource_list

Array of OccupyResource objects

参数解释:

执行计划阶段。

取值范围:

不涉及。

exec_result

Integer

参数解释:

执行结果。

取值范围:

不涉及。

exec_log

String

参数解释:

执行日志。

取值范围:

不涉及。

表5 OccupyResource

参数

参数类型

描述

resource_name

String

参数解释:

资源项名称。

取值范围:

不涉及。

resource_value

Integer

参数解释:

资源属性数值。

取值范围:

不涉及。

value_unit

String

参数解释:

资源属性单位。

取值范围:

不涉及。

resource_description

String

参数解释:

资源附加描述。

取值范围:

不涉及。

请求示例

GET https://{Endpoint}/v2/89cd04f168b84af6be287f71730fdb4b/clusters/e59d6b86-9072-46eb-a996-13f8b44994c1/workload/queues/resource1/users

响应示例

状态码:200

获得资源池的绑定用户列表成功。

{
  "queue_name" : "rs1",
  "user_list" : [ {
    "user_name" : "user_batch",
    "occupy_resource_list" : [ {
      "resource_name" : "memory_used",
      "resource_value" : 0,
      "value_unit" : "M",
      "resource_description" : ""
    } ]
  } ],
  "count" : 1
}

状态码

状态码

描述

200

获得资源池的绑定用户列表成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。