群组和项目成员 API

created_by 字段引入于极狐GitLab 14.10。

角色

Git 分配给用户或群组的角色Gitlab::Access 模块被定义为 access_level

  • 无访问权限(0
  • 最小访问权限(5)(引入于 13.5)
  • 访客(10
  • 报告者(20
  • 开发者(30
  • 维护者(40
  • 拥有者(50)(对 14.9 及更高版本中的项目有效)
note在 14.9 及更高版本中,私有命名空间中的项目拥有 50(拥有者)的 access_level。 在 14.8 及更高版本中,私有命名空间中的项目拥有 40(维护者)的 access_level

限制

group_saml_identity 参数仅对 SSO 启用的群组拥有者可见。

列出群组或项目的所有成员

获取经过身份验证的用户可见的群组或项目成员的列表。仅返回直接成员,不返回祖先群组的继承成员。

这个功能使用分页参数 pageper_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 的成员资格,其代表了用户的有效权限。

如果出现以下任一情况,则返回受邀群组的成员:

  • 受邀群组是公开的。
  • 请求者也是受邀群组的成员。

该函数采用分页参数 pageper_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 根据成员状态过滤结果:awaitingactive
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 端点仅适用于顶级群组,不适用于子群组。

该函数采用分页参数 pageper_page 限制用户列表。

searchsort 参数允许您按名称搜索计费群组成员并分别对结果进行排序。

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 OneOther Group / Sub Group Two 的直接成员,那么仅返回 Root Group / Sub Group One,因为 Other Group / Sub Group Two 不在 Root Group 的层级结构中。

响应仅代表直接成员资格,不包括继承的成员资格。

此 API 端点仅适用于顶级群组,不适用于子群组。

此 API 端点需要群组的管理员权限。

此 API 端点采用分页参数 pageper_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 成员的新状态:awaitingactive
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 邀请者希望成员关注的任务。任务将作为议题添加到指定项目。可能的值是:cicodeissues。如果指定,则需要 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 端点采用分页参数 pageper_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
  }
]

授予群组访问项目的权限

请参见与群组共享项目