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

查询流水线的用户权限

功能介绍

查询流水线的用户权限

调用方法

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

默认取值

不涉及。

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

offset

Integer

参数解释

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

取值范围

offset大于等于0。

limit

Integer

参数解释

每次查询的条目数量。

取值范围

大于等于0。

total

Integer

参数解释

可查询总数。

取值范围

不涉及。

users

Array of users objects

参数解释

用户权限详情列表。

取值范围

不涉及。

表4 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

响应体

错误码

请参见错误码