更新时间:2024-04-19 GMT+08:00

查询组织列表

功能介绍

查询组织列表。

URI

GET /v2/manage/namespaces

表1 Query参数

参数

是否必选

参数类型

描述

namespace

String

组织名称。小写字母开头,后面跟小写字母、数字、小数点、下划线或中划线(其中下划线最多允许连续两个,小数点、下划线、中划线不能直接相连),小写字母或数字结尾,1-64个字符。

filter

String

应填写namespace::{namespace}|mode::{mode}。其中{namespace}是组织名称,{mode}如果不设置,查看有权限的组织列表;设置为visible,查看可见的组织列表(部分组织:仓库有权限,组织没有权限)。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

消息体的类型(格式),下方类型可任选其一使用: application/json;charset=utf-8 application/json

缺省值:application/json

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

响应参数

表3 Response Body参数说明

参数

参数类型

描述

namespaces

Array of objects

组织列表

表4 namespaces参数说明

参数

参数类型

描述

id

Integer

组织ID

name

String

组织名称

creator_name

String

IAM用户名

auth

Integer

用户权限

  • 7表示管理权限
  • 3表示编辑权限
  • 1表示读取权限

请求示例

GET https://{Endpoint}/v2/manage/namespaces?filter=namespace::group

响应示例

状态码:200

查询组织列表成功

{
    "namespaces": [
        {
            "id": 1343008,
            "name": "group",
            "creator_name": "username",
            "auth": 7
        }
    ]
}

状态码

状态码

描述

200

查询成功

400

错误的请求

401

鉴权失败

404

组织不存在

500

内部错误

错误码

请参见错误码