群组访问令牌 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 Request
或404 Not Found