更新时间:2022-04-24 GMT+08:00
分享

查询组织列表

功能介绍

查询组织列表

接口约束

调试

您可以在API Explorer中调试该接口。

URI

GET /v2/manage/namespaces

表1 Query参数

参数

是否必选

参数类型

描述

namespace

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

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

缺省值:application/json

X-Auth-Token

String

用户Token。

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

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

namespaces

Array of ShowNamespace objects

组织列表

表4 ShowNamespace

参数

参数类型

描述

id

Integer

id

name

String

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

creator_name

String

IAM用户名

auth

Integer

用户权限。7表示管理权限,3表示编辑权限,1表示读取权限。

请求示例

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

响应示例

状态码: 200

获取组织列表成功

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

状态码

状态码

描述

200

获取组织列表成功

400

错误的请求

401

鉴权失败

404

组织不存在

500

内部错误

错误码

请参见错误码

分享:

    相关文档

    相关产品

close