更新时间：2026-09-01 GMT+08:00

查询项目成员 - ListProjectUsers

功能介绍

查询项目成员

调用方法

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
codeartsreq:member:list	List	-	codeartsreq:Model codeartsreq:ProjectId	-	-

URI

GET /v1/ipdprojectservice/projects/{project_id}/users

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	参数解释：项目32位ID，项目唯一标识。通过查询IPD项目列表获取，响应消息体中的id字段的值就是项目ID。约束限制：不涉及。取值范围： 32个字符，由英文字母和数字组成。默认取值：不涉及。

请求参数

无

响应参数

状态码：200

表2 响应Body参数
参数	参数类型	描述
status	String	参数解释：返回状态。取值范围： success：响应成功 error：响应失败
message	String	失败信息
result	Array of UserVO objects	用户信息列表

表3 UserVO
参数	参数类型	描述
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	请求失败的响应。例如无操作权限、项目不存在。

错误码

请参见错误码。

父主题： IPD项目管理