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

查询用户权限

功能介绍

查询用户在项目下的角色及权限。

调用方法

请参见如何调用API

URI

GET /v5/user/{project_id}/privileges

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,可以从调用API处获取,也可以从控制台获取。获取方式请参考获取项目ID

约束限制:

不涉及。

取值范围:

只能由英文字母、数字组成,且长度为32个字符。

默认取值:

不涉及。

请求参数

响应参数

状态码:200

表2 响应Body参数

参数

参数类型

描述

status

String

参数解释:

请求成功、请求失败的状态。

取值范围:

success: 请求成功。

error: 请求失败。

trace_id

String

参数解释:

请求ID,当前请求唯一标识。

取值范围:

数字及中划线(-)组成的字符串。

result

result object

参数解释:

请求返回的结果,角色及权限信息。

取值范围:

不涉及。

表3 result

参数

参数类型

描述

operations

String

参数解释:

操作权限的列表。

取值范围:

英文字符串,使用英文逗号分隔。

operations_index

Array of integers

参数解释:

操作权限的序列号。

取值范围:

数字。

role_id

String

参数解释:

角色ID。

取值范围:

32位英文、数字随机字符串。

role_name

String

参数解释:

角色的英文名称。

取值范围:

Project manager,Product manager,Test manager,Operation manager,System engineer,Committer,Developer,Tester,Participant,Viewer及自定义角色的英文名称。

role_chinese_name

String

参数解释:

角色的中文名称。

取值范围:

项目经理,产品经理,测试经理,运维经理,系统工程师,Committer,开发人员,测试人员,参与者,浏览者及自定义角色。

project_id

String

参数解释:

项目ID。

取值范围:

32位英文、数字随机字符串。

area_service_id

String

参数解释:

地域服务ID。

取值范围:

32位英文、数字随机字符串。

granted_object_path

String

参数解释:

授权对象路径。

取值范围:

英文、数字、斜线(/)、星号(*)字符串

granted_object_type_id

String

参数解释:

授权对象类型ID。

取值范围:

32位英文、数字随机字符串。

请求示例

https://{endpoint}/cloudartifact/v3/user/6666669620d743eca6a57881a0f006fd/privileges

响应示例

状态码:200

请求成功。

{
  "status" : "success",
  "trace_id" : "143006-1700618253925-55",
  "result" : {
    "operations" : "editRepository,restore,physicdelete,clearall",
    "operations_index" : [ 2, 4, 5, 7 ],
    "role_id" : "ca9615b14a794146ad1ff3ad9ba79666,",
    "role_name" : "Developer,",
    "role_chinese_name" : "开发人员,",
    "project_id" : "bef3419620d743eca6a57881a0f00666,",
    "area_service_id" : "c0ec24a435a640728b07785d882cf666,",
    "granted_object_path" : "/xxxx/aaa/bbb/*,",
    "granted_object_type_id" : "f9fa2e8207254e14a7a0b1fa99ce9666"
  }
}

状态码

状态码

描述

200

请求成功。

错误码

请参见错误码

相关文档