
# 查询决策人/评审专家角色用户 - ListIpdReviewApproverOrReviewer
#### 功能介绍
查询决策人/评审专家角色用户列表
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v1/ipdprojectservice/projects/{project_id}/user/role
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 |
   
表2Query参数 
| 参数                | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| user_type         | 否    | String | **参数解释**： 用户类型。 **约束限制**： 传参非reviewer，默认为approver。 **取值范围**： approver（审批人） reviewer（评审专家） **默认取值**： approver                                        |
| target_project_id | 否    | String | **参数解释**： 目标项目ID，若有传值则替换project_id参数值，项目的32位UUID，项目唯一标识，通过查询项目列表接口获取，响应消息体中的project_id字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。                                                         |
| review_id         | 否    | String | **参数解释**： 评审单ID，用于判断当前用户列表是否需要跨项目查询，评审单唯一标识，通过[查询评审单列表](https://support.huaweicloud.com/api-projectman/ListIpdReviewForms.html)接口获取，响应消息体中的id字段的值就是评审单ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数      | 参数类型                                                               | 描述             |
|:---|:---|:---|
| status  | String                                                             | 响应状态           |
| message | String                                                             | 响应错误信息         |
| result  | [result] object | 决策人/评审专家角色用户列表 |
   
 表4result 
| 参数    | 参数类型                                                                       | 描述   |
|:---|:---|:---|
| users | Array of [users] objects | 用户列表 |
   
 表5users 
| 参数          | 参数类型   | 描述     |
|:---|:---|:---|
| user_id     | String | 用户ID   |
| user_num_id | String | 用户数字id |
| user_name   | String | 用户名称   |
| domain_id   | String | 租户id   |
| domain_name | String | 租户名称   |
| nick_name   | String | 昵称     |
| role_id     | String | 角色id   |
| role_name   | String | 角色名称   |
| role_code   | String | 角色编码   |
   
**状态码：400**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                       |
|:---|:---|:---|
| error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。                   |
| error_msg  | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 |
   
#### 请求示例
```
GET https://{endpoint}/v1/ipdprojectservice/projects/b811b0bef58b479d9b5e4ab856b349ab/user/role?user_type=approver&review_id=&target_project_id=
```
#### 响应示例
**状态码：200**
ok
```
{
  "status" : "success",
  "message" : null,
  "result" : {
    "users" : [ {
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_num_id" : null,
      "user_name" : "devcloud_devcloud_01",
      "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
      "domain_name" : null,
      "nick_name" : "张三丰1",
      "role_id" : "0c4370789ec246bb9f5480077e1119d5",
      "role_name" : "项目经理",
      "role_code" : "Project manager"
    }, {
      "user_id" : "a360371833bf4c558f796fd707b44daf",
      "user_num_id" : null,
      "user_name" : "devcloud_devcloud_01",
      "domain_id" : "4e919d73499648e3b0292cd3cbef806a",
      "domain_name" : null,
      "nick_name" : "张三丰1",
      "role_id" : "0438be11ed284528ae79c8afd054ecf1",
      "role_name" : "项目管理员",
      "role_code" : "project_admin"
    } ]
  }
}
```
**状态码：400**
请求失败的响应。例如无操作权限、项目不存在。
```
{
  "error_code" : "PM.02174103",
  "error_msg" : "无操作权限"
}
```
#### 状态码
| 状态码 | 描述                     |
|:---|:---|
| 200 | ok                     |
| 400 | 请求失败的响应。例如无操作权限、项目不存在。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。
