# 获取指定项目的成员用户列表 - ListProjectMembersV4 #### 功能介绍 获取项目成员列表。 #### 调用方法 请参见[如何调用API](https://support.huaweicloud.com/api-projectman/projectman_api_1002.html)。 #### 授权信息 当前API调用无需身份策略权限。 #### URI GET /v4/projects/{project_id}/members 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目的32位UUID，项目唯一标识，通过[查询项目列表接口](https://support.huaweicloud.com/api-projectman/ListProjectsV4.html)获取，响应消息体中的**project_id**字段的值就是项目ID。 **约束限制**： 32个字符，由英文字母和数字组成。 **取值范围：** 不涉及。 **默认取值**： 不涉及。 | 表2Query参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | limit | 是 | Integer | **参数解释：** 分页大小。 **约束限制：** 不涉及。 **取值范围：** 1-1000。 **默认取值：** 10 | | offset | 是 | Integer | **参数解释：** 分页起始，从0开始，为limit整数倍，默认为0。 **约束限制：** 不涉及。 **取值范围：** 0-10000。 **默认取值：** 缺省值：0 | #### 请求参数 无 #### 响应参数 **状态码：200** 表3响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | members | Array of [members] objects | **参数解释：** 项目成员列表。 | | total | Integer | **参数解释：** 总数。 **取值范围：** 不涉及。 | 表4members | 参数 | 参数类型 | 描述 | |:---|:---|:---| | domain_id | String | **参数解释：** 租户ID。 **取值范围：** 不涉及。 | | domain_name | String | **参数解释：** 租户名。 **取值范围：** 不涉及。 | | user_id | String | **参数解释：** 用户ID。用户在系统中的唯一编号。 **取值范围：** 不涉及。 | | user_name | String | **参数解释：** 用户名。 **取值范围：** 不涉及。 | | user_num_id | Integer | **参数解释：** 创建人numId。用户int类型的编号，有部分删除接口需要。 **取值范围：** 不涉及。 | | role_id | Integer | **参数解释：** 成员角色id，取值范围枚举值中的key。 **取值范围：** -1（ 项目创建者）; 3 （项目经理）; 4（ 开发人员）; 5 （测试经理）; 6（ 测试人员）; 7 （参与者）; 8 （浏览者）; 9 （运维经理）。 | | nick_name | String | **参数解释：** 用户昵称。 **取值范围：** 不涉及。 | | role_name | String | **参数解释：** 用户角色，取值范围枚举值中的value。 **取值范围：** 项目创建者、项目经理、 开发人员、测试经理、测试人员、参与者、浏览者、运维经理等。 | | user_type | String | **参数解释：** 用户类型。 **取值范围：** - User：iam用户 - Federation：联邦账号 | | forbidden | Integer | **参数解释：** 是否是禁用账号。 **取值范围：** 1 禁用账号， 0非禁用账号。 | **状态码：400** 表5响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | **状态码：401** 表6响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | error_code | String | **参数解释**： 错误码。 **取值范围**： 不涉及。 | | error_msg | String | **参数解释**： 错误描述。 **取值范围**： 不涉及。 | | request_id | String | **参数解释**： 请求的ID，系统自动生成。 **取值范围**： 不涉及。 | #### 请求示例 获取项目成员列表 ``` GET https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/members?limit=2&offset=0 GET https://{endpoint}/v4/projects/ac069b11a3524163ad6348953e2fe93e/members?limit=2&offset=0 ``` #### 响应示例 **状态码：200** ``` { "members" : [ { "domain_id" : "4e919d73499648e3b0292cd3cbef806a", "domain_name" : "demo_user_name", "user_id" : "a360371833bf4c558f796fd707b44daf", "user_name" : "demo_user_name", "user_num_id" : 4097, "role_id" : 7, "nick_name" : "name", "role_name" : "项目创建者", "user_type" : "User", "forbidden" : 0 } ], "total" : 1 } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 200 | OK | | 400 | Bad Request | | 401 | Unauthorized | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-projectman/ErrorCode.html)。