- 角色
- 限制
- 列出群组或项目的所有成员
- 列出群组或项目中包括继承和邀请成员在内的所有成员
- 获取群组或项目成员
- 获取群组或项目中包括继承和邀请成员在内的成员
- 列出群组中所有计费成员
- 列出群组中计费成员的成员资格
- 从群组中移除计费成员
- 更改群组中用户的成员资格状态
- 向群组或项目添加成员
- 编辑群组或项目成员
- 移除群组或项目成员
- 通过群组成员申请
- 通过群组的所有成员申请
- 列出群组及其子群组和项目的成员申请
- 授予群组访问项目的权限
群组和项目成员 API
created_by
字段引入于极狐GitLab 14.10。
角色
Git 分配给用户或群组的角色在 Gitlab::Access
模块被定义为 access_level
。
- 无访问权限(
0
) - 最小访问权限(
5
)(引入于 13.5) - 访客(
10
) - 报告者(
20
) - 开发者(
30
) - 维护者(
40
) - 拥有者(
50
)(对 14.9 及更高版本中的项目有效)
50
(拥有者)的 access_level
。
在 14.8 及更高版本中,私有命名空间中的项目拥有 40
(维护者)的 access_level
。限制
group_saml_identity
参数仅对 SSO 启用的群组拥有者可见。
列出群组或项目的所有成员
获取经过身份验证的用户可见的群组或项目成员的列表。仅返回直接成员,不返回祖先群组的继承成员。
这个功能使用分页参数 page
和 per_page
限制用户列表。
GET /groups/:id/members
GET /projects/:id/members
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组路径 |
query
| string | no | 查询成员的查询字符串 |
user_ids
| array of integers | no | 根据特定用户 ID 过滤结果 |
skip_users
| array of integers | no | 从结果中过滤跳过的用户 |
show_seat_info
| boolean | no | 显示用户的席位信息 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members"
响应示例:
[
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-09-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 30,
"group_saml_identity": null
},
{
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-09-22T14:13:35Z",
"created_by": {
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 30,
"email": "john@example.com",
"group_saml_identity": {
"extern_uid":"ABC-1234567890",
"provider": "group_saml",
"saml_provider_id": 10
}
}
]
列出群组或项目中包括继承和邀请成员在内的所有成员
获取经过身份验证的用户可以查看的群组或项目成员的列表,包括继承的成员、受邀用户和祖先群组的权限。
如果用户是该群组或项目的成员,并且也是一个或多个祖先群组的成员,仅返回其具有最高 access_level
的成员资格,其代表了用户的有效权限。
如果出现以下任一情况,则返回受邀群组的成员:
- 受邀群组是公开的。
- 请求者也是受邀群组的成员。
该函数采用分页参数 page
和 per_page
限制用户列表。
GET /groups/:id/members/all
GET /projects/:id/members/all
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组或项目路径 |
query
| string | no | 查询成员的查询串 |
user_ids
| array of integers | no | 根据特定用户 ID 过滤结果 |
show_seat_info
| boolean | no | 显示用户席位信息 |
state
| string | no | 根据成员状态过滤结果:awaiting 或 active
|
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/all"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members/all"
响应示例:
[
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-09-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 30,
"group_saml_identity": null
},
{
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-09-22T14:13:35Z",
"created_by": {
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 30,
"email": "john@example.com",
"group_saml_identity": {
"extern_uid":"ABC-1234567890",
"provider": "group_saml",
"saml_provider_id": 10
}
},
{
"id": 3,
"username": "foo_bar",
"name": "Foo bar",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-11-22T14:13:35Z",
"access_level": 30,
"group_saml_identity": null
}
]
获取群组或项目成员
获取群组或项目成员。仅返回直接成员,不返回祖先群组的继承成员。
GET /groups/:id/members/:user_id
GET /projects/:id/members/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组信息 |
user_id
| integer | yes | 成员的用户 ID |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members/:user_id"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"access_level": 30,
"email": "john@example.com",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": null,
"group_saml_identity": null
}
获取群组或项目中包括继承和邀请成员在内的成员
引入于极狐GitLab 12.4。
获取群组或项目成员,包括通过祖先群组继承或邀请的成员。详情请参见列出所有继承成员的端点。
GET /groups/:id/members/all/:user_id
GET /projects/:id/members/all/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组路径 |
user_id
| integer | yes | 成员的用户 ID |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/all/:user_id"
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members/all/:user_id"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"access_level": 30,
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"email": "john@example.com",
"expires_at": null,
"group_saml_identity": null
}
列出群组中所有计费成员
引入于极狐GitLab 13.5。
获取计费成员的列表。该列表包括子群组和项目中的成员。
此 API 端点仅适用于顶级群组,不适用于子群组。
该函数采用分页参数 page
和 per_page
限制用户列表。
search
和 sort
参数允许您按名称搜索计费群组成员并分别对结果进行排序。
GET /groups/:id/billable_members
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
search
| string | no | 按名称、用户名或公共电子邮件搜索群组成员的查询字符串 |
sort
| string | no | 包含指定排序参数和顺序的参数的查询字符串。请参阅下面支持的值 |
include_awaiting_members
| boolean | no | 是否包含待审批成员 |
sort
参数支持的值为:
值 | 描述 |
---|---|
access_level_asc
| 访问级别,升序 |
access_level_desc
| 访问级别,降序 |
last_joined
| 最新加入 |
name_asc
| 名称,升序 |
name_desc
| 名称,降序 |
oldest_joined
| 最早加入 |
oldest_sign_in
| 最早登录 |
recent_sign_in
| 最新登录 |
last_activity_on_asc
| 最新活动日期,升序 |
last_activity_on_desc
| 最新活动日期,降序 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/billable_members"
响应示例:
[
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"last_activity_on": "2021-01-27",
"membership_type": "group_member",
"removable": true,
"created_at": "2021-01-03T12:16:02.000Z",
"last_login_at": "2022-10-09T01:33:06.000Z"
},
{
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"email": "john@example.com",
"last_activity_on": "2021-01-25",
"membership_type": "group_member",
"removable": true,
"created_at": "2021-01-04T18:46:42.000Z",
"last_login_at": "2022-09-29T22:18:46.000Z"
},
{
"id": 3,
"username": "foo_bar",
"name": "Foo bar",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"last_activity_on": "2021-01-20",
"membership_type": "group_invite",
"removable": false,
"created_at": "2021-01-09T07:12:31.000Z",
"last_login_at": "2022-10-10T07:28:56.000Z"
}
]
列出群组中计费成员的成员资格
引入于极狐GitLab 13.11。
获取群组可计费成员的成员资格列表。
列出用户所属的所有项目和群组。仅包含群组层级中的项目和群组。
例如,如果请求的群组是 Root Group
,并且请求的用户是 Root Group / Sub Group One
和 Other Group / Sub Group Two
的直接成员,那么仅返回 Root Group / Sub Group One
,因为 Other Group / Sub Group Two
不在 Root Group
的层级结构中。
响应仅代表直接成员资格,不包括继承的成员资格。
此 API 端点仅适用于顶级群组,不适用于子群组。
此 API 端点需要群组的管理员权限。
此 API 端点采用分页参数 page
和 per_page
限制成员资格列表。
GET /groups/:id/billable_members/:user_id/memberships
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
user_id
| integer | yes | 计费成员的用户 ID |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/billable_members/:user_id/memberships"
响应示例:
[
{
"id": 168,
"source_id": 131,
"source_full_name": "Root Group / Sub Group One",
"source_members_url": "https://gitlab.example.com/groups/root-group/sub-group-one/-/group_members",
"created_at": "2021-03-31T17:28:44.812Z",
"expires_at": "2022-03-21",
"access_level": {
"string_value": "Developer",
"integer_value": 30
}
},
{
"id": 169,
"source_id": 63,
"source_full_name": "Root Group / Sub Group One / My Project",
"source_members_url": "https://gitlab.example.com/root-group/sub-group-one/my-project/-/project_members",
"created_at": "2021-03-31T17:29:14.934Z",
"expires_at": null,
"access_level": {
"string_value": "Maintainer",
"integer_value": 40
}
}
]
从群组中移除计费成员
从群组及其子群组和项目中移除计费成员。
用户无需成为群组成员即可获得移除资格。例如,如果用户被直接添加到群组内的项目中,您仍然可以使用此 API 将其移除。
DELETE /groups/:id/billable_members/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
user_id
| integer | yes | 成员的用户 ID |
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/billable_members/:user_id"
更改群组中用户的成员资格状态
引入于极狐GitLab 15.0。
更改群组中用户的成员资格状态。该状态适用于所有子群组和项目。
PUT /groups/:id/members/:user_id/state
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
user_id
| integer | yes | 成员的用户 ID |
state
| string | yes | 成员的新状态:awaiting 或 active
|
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id/state?state=active"
响应示例:
{
"success":true
}
向群组或项目添加成员
向群组或项目添加成员。
POST /groups/:id/members
POST /projects/:id/members
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组路径 |
user_id
| integer/string | yes | 新成员的用户 ID 或以逗号分隔的多个 ID |
access_level
| integer | yes | 有效访问级别 |
expires_at
| string | no | 日期字符串,格式:YEAR-MONTH-DAY
|
invite_source
| string | no | 开启成员创建流程的邀请源 |
tasks_to_be_done
| array of strings | no | 邀请者希望成员关注的任务。任务将作为议题添加到指定项目。可能的值是:ci 、code 和 issues 。如果指定,则需要 tasks_project_id 。引入于极狐GitLab 14.5,功能标志为 invite_members_for_task 。默认禁用
|
tasks_project_id
| integer | no | 创建任务议题的项目 ID。如果指定,则需要 tasks_to_be_done 。引入于极狐GitLab 14.5,功能标志为 invite_members_for_task 。默认禁用
|
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--data "user_id=1&access_level=30" "https://gitlab.example.com/api/v4/groups/:id/members"
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--data "user_id=1&access_level=30" "https://gitlab.example.com/api/v4/projects/:id/members"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 30,
"email": "john@example.com",
"group_saml_identity": null
}
编辑群组或项目成员
更新群组或项目成员。
PUT /groups/:id/members/:user_id
PUT /projects/:id/members/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组路径 |
user_id
| integer | yes | 成员的用户 ID |
access_level
| integer | yes | 有效访问级别 |
expires_at
| string | no | 日期资源串,格式:YEAR-MONTH-DAY
|
member_role_id
| integer | no | 成员角色 ID |
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id?access_level=40"
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members/:user_id?access_level=40"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 40,
"email": "john@example.com",
"group_saml_identity": null
}
为群组成员设置覆盖标记
引入于极狐GitLab 13.0。
默认情况下,LDAP 群组成员的访问级别设置为 LDAP 通过 Group Sync 指定的值。 您可以通过调用此端点来允许访问级别覆盖。
POST /groups/:id/members/:user_id/override
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
user_id
| integer | yes | 成员的用户 ID |
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id/override"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22T14:13:35Z",
"access_level": 40,
"email": "john@example.com",
"override": true
}
移除群组成员覆盖
引入于极狐GitLab 13.0。
将覆盖标记设置为 False 并允许 LDAP Group Sync 将访问级别重置为 LDAP 规定的值。
DELETE /groups/:id/members/:user_id/override
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
user_id
| integer | yes | 成员的用户 ID |
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id/override"
响应示例:
{
"id": 1,
"username": "raymond_smith",
"name": "Raymond Smith",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root",
"created_at": "2012-10-22T14:13:35Z",
"created_by": {
"id": 2,
"username": "john_doe",
"name": "John Doe",
"state": "active",
"avatar_url": "https://www.gravatar.com/avatar/c2525a7f58ae3776070e44c106c48e15?s=80&d=identicon",
"web_url": "http://192.168.1.8:3000/root"
},
"expires_at": "2012-10-22",
"access_level": 40,
"email": "john@example.com",
"override": false
}
移除群组或项目成员
从已明确为用户分配角色的群组或项目中移除用户。
用户必须是群组成员才有资格移除。 例如,如果用户被直接添加到群组内的项目,而不是这个群组中,您不能使用此 API 进行移除。替代方法请参见从群组中移除计费成员。
DELETE /groups/:id/members/:user_id
DELETE /projects/:id/members/:user_id
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的项目或群组路径 |
user_id
| integer | yes | 成员的用户 ID |
skip_subresources
| boolean | false | 是否应跳过删除子群组和项目中已移除成员的直接成员资格。默认为 false
|
unassign_issuables
| boolean | false | 是否应从给定群组或项目中的任何议题或合并请求中取消分配已移除的成员。默认为 false
|
请求示例:
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:user_id"
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/members/:user_id"
通过群组成员申请
通过群组及其子群组及项目的成员申请。
PUT /groups/:id/members/:member_id/approve
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的根群组路径 |
member_id
| integer | yes | 成员 ID |
请求示例:
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/:member_id/approve"
通过群组的所有成员申请
通过群组及其子群组及项目的所有成员申请。
POST /groups/:id/members/approve_all
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的根群组路径 |
请求示例:
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/members/approve_all"
列出群组及其子群组和项目的成员申请
引入于极狐GitLab 14.6。
获取群组及其子群组和项目中处于 awaiting
状态的所有成员的列表,以及那些被邀请但没有极狐GitLab 账户的成员的列表。
此请求返回根群组层次结构中所有群组和项目的所有匹配的群组和项目成员。
当成员是尚未注册极狐GitLab 账户的受邀用户时,将返回受邀电子邮件地址。
此 API 端点仅适用于顶级群组,不适用于子群组。
此 API 端点需要管理员权限。
此 API 端点采用分页参数 page
和 per_page
限制成员列表。
GET /groups/:id/pending_members
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
id
| integer/string | yes | 经过身份验证的用户拥有的 ID 或 URL 编码的群组路径 |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/pending_members"
响应示例:
[
{
"id": 168,
"name": "Alex Garcia",
"username": "alex_garcia",
"email": "alex@example.com",
"avatar_url": "http://example.com/uploads/user/avatar/1/cd8.jpeg",
"web_url": "http://example.com/alex_garcia",
"approved": false,
"invited": false
},
{
"id": 169,
"email": "sidney@example.com",
"avatar_url": "http://gravatar.com/../e346561cd8.jpeg",
"approved": false,
"invited": true
},
{
"id": 170,
"email": "zhang@example.com",
"avatar_url": "http://gravatar.com/../e32131cd8.jpeg",
"approved": true,
"invited": true
}
]
授予群组访问项目的权限
请参见与群组共享项目。