文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 查询流水线的用户权限
更新时间：2025-10-11 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询流水线的用户权限

功能介绍

查询流水线的用户权限

调用方法

请参见如何调用API。

URI

GET /v5/{project_id}/api/pipeline-permissions/{pipeline_id}/user-permission

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID，获取方式请参见获取项目ID。

约束限制：

不涉及。

取值范围：

32位字符，由数字和字母组成。

默认取值：

不涉及。

pipeline_id

是

String

参数解释：

流水线ID，可以通过查询流水线列表接口获取，其中pipelines.pipelineId即为流水线ID。

约束限制：

不涉及。

取值范围：

32位字符，由数字和字母组成。

默认取值：

不涉及。
表2 Query参数

参数

是否必选

参数类型

描述

subject

否

String

参数解释：

用户名称模糊查询。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

limit

是

Long

参数解释：

每次查询的条目数量。

约束限制：

不涉及。

取值范围：

大于等于0。

默认取值：

不涉及。

offset

是

Long

参数解释：

偏移量，表示从此偏移量开始查询。

约束限制：

不涉及。

取值范围：

大于等于0。

默认取值：

不涉及。

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

offset

Integer

参数解释：

偏移量，表示从此偏移量开始查询。

取值范围：

offset大于等于0。

limit

Integer

参数解释：

每次查询的条目数量。

取值范围：

大于等于0。

total

Integer

参数解释：

可查询总数。

取值范围：

不涉及。

users

Array of users objects

参数解释：

用户权限详情列表。

取值范围：

不涉及。
表5 users

参数

参数类型

描述

pipeline_id

String

参数解释：

流水线ID。

取值范围：

不涉及。

role_id

Integer

参数解释：

角色ID。

取值范围：

不涉及。

role_name

String

参数解释：

角色名称。

取值范围：

不涉及。

operation_query

Boolean

参数解释：

查询权限。

取值范围：

不涉及。

operation_execute

Boolean

参数解释：

执行权限。

取值范围：

不涉及。

operation_update

Boolean

参数解释：

编辑权限。

取值范围：

不涉及。

operation_delete

Boolean

参数解释：

删除权限。

取值范围：

不涉及。

operation_authorize

Boolean

参数解释：

编辑流水线权限配置权限。

取值范围：

不涉及。

user_id

String

参数解释：

用户ID。

取值范围：

不涉及。

user_name

String

参数解释：

用户名称。

取值范围：

不涉及。

domain_name

String

参数解释：

租户名称。

取值范围：

不涉及。

nick_name

String

参数解释：

昵称。

取值范围：

不涉及。

remark_name

String

参数解释：

备注名称。

取值范围：

不涉及。

tags

String

参数解释：

标签。

取值范围：

不涉及。

请求示例

GET https://(endpoint)/v5/e2e18230a85d4d6ab0b56cb6d2246c18/api/pipeline-permissions/0747d5a7099e45f69dc1d099945909a9/user-permission?subject=&limit=10&offset=0

响应示例

状态码：200

响应体

{
  "offset" : 0,
  "limit" : 10,
  "total" : 1,
  "users" : [ {
    "pipeline_id" : "0747d5a7099e45f69dc1d099945909a9",
    "role_id" : 1,
    "role_name" : "流水线创建者",
    "operation_query" : true,
    "operation_execute" : true,
    "operation_update" : true,
    "operation_delete" : true,
    "operation_authorize" : false,
    "user_id" : "123456",
    "user_name" : "p_t123",
    "domain_name" : "1234546",
    "nick_name" : "n23456",
    "remark_name" : null,
    "tags" : null
  } ]
}

状态码

状态码

描述

200

响应体

错误码

请参见错误码。

父主题： 流水线管理

相关文档