更新时间: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

服务不可用。