文档首页/ 容器镜像服务 SWR/ API参考（安卡拉区域）/ API/ 组织管理/ 查询组织列表
更新时间：2024-12-02 GMT+08:00
查看PDF
分享

查询组织列表

功能介绍

查询组织列表。

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?namespace=group

响应示例

状态码：200

查询组织列表成功

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

状态码

状态码

描述

200

查询成功

400

错误的请求

401

鉴权失败

404

组织不存在

500

内部错误

错误码

请参见错误码。

父主题： 组织管理