Namespaces API
Namespaces API
用户名和组名属于称为命名空间的特殊类别.
对于用户和组支持的 API 调用,请分别参阅用户和文档.
使用分页 .
获取已认证用户的名称空间列表. 如果用户是管理员,则会显示 GitLab 实例中所有名称空间的列表.
响应示例:
[ { "id": 1, "name": "user1", "path": "user1", "kind": "user", "full_path": "user1" }, { "id": 2, "name": "group1", "path": "group1", "kind": "group", "full_path": "group1", "parent_id": null, "members_count_with_descendants": 2 }, { "id": 3, "name": "bar", "path": "bar", "kind": "group", "full_path": "foo/bar", "parent_id": 9, "members_count_with_descendants": 5 } ]
GitLab.com 上的用户可能还会看到与名称空间关联的plan
参数:
注意:仅向组维护者/所有者提供了和plan
.
获取与名称或路径中的字符串匹配的所有名称空间.
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/namespaces?search=twitter"
响应示例:
通过 ID 获取名称空间.
GET /namespaces/:id
Attribute | Type | Required | Description |
---|---|---|---|
id |
integer/string | yes | 名称空间的 ID 或 |
请求示例:
响应示例:
{ "id": 2, "name": "group1", "path": "group1", "kind": "group", "full_path": "group1", "parent_id": null, "members_count_with_descendants": 2 }
响应示例:
{ "id": 2, "name": "group1", "path": "group1", "kind": "group", "full_path": "group1", "parent_id": null, "members_count_with_descendants": 2 }