文档首页/ 需求管理 CodeArts Req/ API参考/ API/ 项目成员/ 获取指定项目的成员用户列表
更新时间:2024-03-07 GMT+08:00
分享

获取指定项目的成员用户列表

功能介绍

获取项目成员列表

调用方法

请参见如何调用API

URI

GET /v4/projects/{project_id}/members

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

devcloud项目的32位id

最小长度:32

最大长度:32

表2 Query参数

参数

是否必选

参数类型

描述

offset

Integer

分页索引,偏移量,offset是limit的整数倍,limit=10,offset=0,10,20...

最小值:0

最大值:10000

缺省值:0

limit

Integer

每页显示的数量,每页最多显示100条

最小值:1

最大值:100

缺省值:100

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:10

最大长度:32768

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

members

Array of members objects

项目成员列表

total

Integer

总数

表5 members

参数

参数类型

描述

domain_id

String

租户id

最小长度:32

最大长度:32

domain_name

String

租户名

user_id

String

用户id

user_name

String

用户名

user_num_id

Integer

创建人numId

role_id

Integer

成员角色, -1 项目创建者, 3 项目经理, 4 开发人员, 5 测试经理, 6 测试人员, 7 参与者, 8 浏览者, 9 运维经理

nick_name

String

用户昵称

role_name

String

用户角色

user_type

String

用户类型, User iam用户, Federation 联邦账号,

forbidden

Integer

是否是禁用账号,1 禁用账号, 0非禁用账号

状态码: 400

表6 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

状态码: 401

表7 响应Body参数

参数

参数类型

描述

error_msg

String

错误描述

error_code

String

错误码

请求示例

Get https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/members

Get https://{endpoint}/v4/projects/e2da96a5d2c845e284f0ad47f8ca8cb1/members

响应示例

状态码: 200

OK

{
  "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

错误码

请参见错误码

相关文档