
# 查询项目成员 - ListProjectUsers
#### 功能介绍
查询项目成员
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。
#### 授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-projectman/projectman_03_Permission.html)。
| 授权项                     | 访问级别 | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                            | 别名 | 依赖的授权项 |
|:---|:---|:---|:---|:---|:---|
| codeartsreq:member:list | List | -           | - codeartsreq:Model   - codeartsreq:ProjectId    | -  | -      |
   
#### URI
GET /v1/ipdprojectservice/projects/{project_id}/users
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释**： 项目32位ID，项目唯一标识。通过[查询IPD项目列表](https://support.huaweicloud.com/api-projectman/ShowIpdProjectList.html)获取，响应消息体中的**id**字段的值就是项目ID。 **约束限制**： 不涉及。 **取值范围**： 32个字符，由英文字母和数字组成。 **默认取值**： 不涉及。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数      | 参数类型                                                          | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| status  | String                                                        | **参数解释**： 返回状态。 **取值范围**： - success：响应成功   - error：响应失败    |
| message | String                                                        | 失败信息                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| result  | Array of [UserVO] objects | 用户信息列表                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表3UserVO 
| 参数          | 参数类型    | 描述                                                                                                                                                              |
|:---|:---|:---|
| user_id     | String  | **参数解释**： 用户ID。 **取值范围**： 不涉及。                      |
| user_num_id | Integer | **参数解释**： 用户短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**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                          |
|:---|:---|:---|
| error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。                   |
| error_msg  | String | **参数解释**： 错误描述，对error_code的补充解释。 **取值范围**： 不涉及。 |
   
#### 请求示例
查询项目ID为7a165263bedc4f589b017d909d04a067的项目成员
```
GET https://{endpoint}/v1/ipdprojectservice/projects/7a165263bedc4f589b017d909d04a067/users
```
#### 响应示例
**状态码：200**
成功响应
```
{
  "status" : "success",
  "message" : "",
  "result" : [ {
    "user_id" : "a71eed54261e4c9888f34dfbb777d423",
    "user_num_id" : null,
    "user_name" : "testUser1",
    "domain_id" : "aae03ca0d6814951980945b6eeca56cd",
    "domain_name" : null,
    "nick_name" : "",
    "role_id" : "3013fa41bf734685af16afe49d21240a",
    "role_name" : "开发人员",
    "role_code" : "Developer"
  }, {
    "user_id" : "c2d89e38a64a466f8f945f595df4402d",
    "user_num_id" : null,
    "user_name" : "ForTest",
    "domain_id" : "aae03ca0d6814951980945b6eeca56cd",
    "domain_name" : null,
    "nick_name" : "ForTestForTest",
    "role_id" : "6806b0e509054db593f4f98eb4d8cf64,a4691fdc09484b8ab1e4e2b86de4fe76",
    "role_name" : "项目经理,项目管理员",
    "role_code" : "Project manager,project_admin"
  } ]
}
```
**状态码：400**
请求失败的响应。例如无操作权限、项目不存在。
```
{
  "error_code" : "PM.02174103",
  "error_msg" : "无操作权限"
}
```
#### 状态码
| 状态码 | 描述                     |
|:---|:---|
| 200 | 成功响应                   |
| 400 | 请求失败的响应。例如无操作权限、项目不存在。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。
