# 查询用户权限 - ShowUserPrivilegesV5
#### 功能介绍
查询用户在项目下的角色及权限，如创建仓库、编辑仓库、上传、下载、导入和导出等权限。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-cloudartifact/CloudArtifact_api_0008.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-cloudartifact/Permission.html)。
| 授权项                              | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| codeartsartifact:repository:list | List | -           | -   | -  | -      |
   
#### URI
GET /v5/user/{project_id}/privileges
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目id，可以从调用API处获取，也可以从控制台获取。获取方式请参考[获取项目id](https://support.huaweicloud.com/api-cloudartifact/CloudArtifact_api_0015.html)。 **约束限制**： 不涉及。 **取值范围**： 只能由英文字母、数字组成，且长度为32个字符。 **默认取值**： 不涉及。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| x-auth-token | 是    | String | **参数解释**: 用户token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值），调用详情请参考章节。 **约束限制**: 不涉及。 **取值范围**: 字符串长度为1-100000。 **默认取值**: 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型                                                    | 描述                                                                                                                                                                                                                            |
|:---|:---|:---|
| status   | String                                                  | **参数解释**： 请求成功、请求失败的状态。 **取值范围**： success: 请求成功。 error: 请求失败。 |
| trace_id | String                                                  | **参数解释**： 请求ID，当前请求唯一标识。 **取值范围**： 数字及中划线(-)组成的字符串。                                                   |
| result   | [result] object | **参数解释**： 请求返回的结果，角色及权限信息。 **取值范围**： 不涉及。                                                             |
   
 表4result 
| 参数                     | 参数类型              | 描述                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| 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://artifact.example-1.com/v5/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 | 请求成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cloudartifact/ErrorCode.html)。