Namespaces API

原文：https://docs.gitlab.com/ee/api/namespaces.html

• List namespaces
• Search for namespace
• Get namespace by ID

Namespaces API

用户名和组名属于称为命名空间的特殊类别.

对于用户和组支持的 API 调用，请分别参阅用户和组文档.

使用分页 .

List namespaces

获取已认证用户的名称空间列表. 如果用户是管理员，则会显示 GitLab 实例中所有名称空间的列表.

GET /namespaces 

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/namespaces" 

响应示例：

[  {  "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 Bronze 或更高版本上的用户可能还会看到与名称空间关联的plan参数：

[  {  "id":  1,  "name":  "user1",  "plan":  "bronze",  ...  }  ] 

注意：仅向组维护者/所有者提供了members_count_with_descendants和plan .

Search for namespace

获取与名称或路径中的字符串匹配的所有名称空间.

GET /namespaces?search=foobar 

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/namespaces?search=twitter" 

响应示例：

[  {  "id":  4,  "name":  "twitter",  "path":  "twitter",  "kind":  "group",  "full_path":  "twitter",  "parent_id":  null,  "members_count_with_descendants":  2  }  ] 

Get namespace by ID

通过 ID 获取名称空间.

GET /namespaces/:id 

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/namespaces/2" 

响应示例：

{  "id":  2,  "name":  "group1",  "path":  "group1",  "kind":  "group",  "full_path":  "group1",  "parent_id":  null,  "members_count_with_descendants":  2  } 

请求示例：

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/namespaces/group1" 

响应示例：

{  "id":  2,  "name":  "group1",  "path":  "group1",  "kind":  "group",  "full_path":  "group1",  "parent_id":  null,  "members_count_with_descendants":  2  }