文档首页/ 流水线 CodeArts Pipeline/ API参考/ API/ 流水线管理/ 查询流水线的用户权限 - ShowPipelineUserPermission
更新时间:2026-09-24 GMT+08:00

查询流水线的用户权限 - ShowPipelineUserPermission

功能介绍

查询流水线的用户权限

调用方法

请参见如何调用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

响应体

错误码

请参见错误码。