群组访问令牌 API

您可以阅读更多有关群组访问令牌的内容。

列出群组访问令牌

引入于极狐GitLab 14.7。

获取群组访问令牌列表。

GET groups/:id/access_tokens
参数 类型 是否必需 描述
id integer or string yes ID 或 URL 编码的群组路径
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/<group_id>/access_tokens"
[
   {
      "user_id" : 141,
      "scopes" : [
         "api"
      ],
      "name" : "token",
      "expires_at" : "2021-01-31",
      "id" : 42,
      "active" : true,
      "created_at" : "2021-01-20T22:11:48.151Z",
      "revoked" : false,
      "access_level": 40
   }
]

获取群组访问令牌

引入于极狐GitLab 14.10。

通过 ID 获取群组访问令牌

GET groups/:id/access_tokens/:token_id
参数 类型 是否必需 描述
id integer or string yes ID 或 URL 编码的群组路径
token_id integer or string yes 群组访问令牌的 ID
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/<group_id>/access_tokens/<token_id>"
{
   "user_id" : 141,
   "scopes" : [
      "api"
   ],
   "name" : "token",
   "expires_at" : "2021-01-31",
   "id" : 42,
   "active" : true,
   "created_at" : "2021-01-20T22:11:48.151Z",
   "revoked" : false,
   "access_level": 40
}

创建群组访问令牌

引入于极狐GitLab 14.7。

创建群组访问令牌。您必须拥有群组所有者的角色才能创建群组访问令牌。

POST groups/:id/access_tokens
参数 类型 是否必需 描述
id integer or string yes ID 或 URL 编码的群组路径
name String yes 群组访问令牌的名称
scopes Array[String] yes 范围列表
access_level Integer no 访问级别。有效值为 10(访客)、20(报告者)、30(开发者)、40(维护者)、50(所有者)
expires_at Date no 令牌于指定日期的午夜时间(UTC)过期
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
--header "Content-Type:application/json" \
--data '{ "name":"test_token", "scopes":["api", "read_repository"], "expires_at":"2021-01-31", "access_level": 30 }' \
"https://gitlab.example.com/api/v4/groups/<group_id>/access_tokens"
{
   "scopes" : [
      "api",
      "read_repository"
   ],
   "active" : true,
   "name" : "test",
   "revoked" : false,
   "created_at" : "2021-01-21T19:35:37.921Z",
   "user_id" : 166,
   "id" : 58,
   "expires_at" : "2021-01-31",
   "token" : "D4y...Wzr",
   "access_level": 30
}

撤回群组访问令牌

引入于极狐GitLab 14.7。

撤回群组访问令牌

DELETE groups/:id/access_tokens/:token_id
参数 类型 是否必需 描述
id integer or string yes ID 或 URL 编码的群组路径
token_id integer or string yes 群组访问令牌的 ID
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/<group_id>/access_tokens/<token_id>"

响应

  • 撤回成功:204: No Content
  • 撤回失败:400 Bad Request404 Not Found