4.1.1 创建组织
功能介绍
创建组织
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/manage/namespaces
请求参数
表4-1 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
表4-2 请求 Body 参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
响应参数
无
请求示例
POST https://{endpoint}/v2/manage/namespaces { "namespace" : "group"
}
响应示例
无
状态码
状态码 描述
201 创建组织成功
400 错误的请求或namespace个数超过上限
401 鉴权失败
409 已存在
500 内部错误
错误码
请参见错误码。
4.1.2 查询组织列表
功能介绍
查询组织列表
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/manage/namespaces
表4-3 Query 参数
参数 是否必选 参数类型 描述
namespace 否 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
请求参数
表4-4 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
响应参数
状态码： 200
表4-5 响应 Body 参数
参数 参数类型 描述
namespaces Array of ShowNames pace objects
组织列表
表4-6 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 内部错误
错误码
请参见错误码。
4.1.3 删除组织
功能介绍
删除组织
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
DELETE /v2/manage/namespaces/{namespace}
表4-7 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
请求参数
表4-8 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
响应参数
无
请求示例
DELETE https://{endpoint}/v2/manage/namespaces/{namespace}
响应示例
无
状态码
状态码 描述
204 删除成功
400 错误的请求
401 鉴权失败
404 组织不存在
406 组织中还存有镜像，不允许删除组织
500 内部错误
错误码
请参见错误码。
4.1.4 获取组织详情
功能介绍
获取组织详情
接口约束
无
调试
您可以在API Explorer中调试该接口。
URI
GET /v2/manage/namespaces/{namespace}
表4-9 路径参数
参数 是否必选 参数类型 描述
namespace 是 String 组织名称。小写字母开头，后面 跟小写字母、数字、小数点、下 划线或中划线（其中下划线最多 允许连续两个，小数点、下划 线、中划线不能直接相连），小 写字母或数字结尾，1-64个字 符。
请求参数
表4-10 请求 Header 参数
参数 是否必选 参数类型 描述
Content-Type 是 String 消息体的类型（格式），下方类 型可任选其一使用：
application/json;charset=utf-8 application/json
缺省值：application/json X-Auth-Token 是 String 用户Token。
通过调用IAM服务获取用户 Token接口获取（响应消息头中 X-Subject-Token的值）。
响应参数
状态码： 200
表4-11 响应 Body 参数
参数 参数类型 描述
id Integer id
name String 组织名称。小写字母开头，后面跟小写字母、数 字、小数点、下划线或中划线（其中下划线最多 允许连续两个，小数点、下划线、中划线不能直 接相连），小写字母或数字结尾，1-64个字符。
creator_name String IAM用户名
auth Integer 用户权限。7表示管理权限，3表示编辑权限，1 表示读取权限。
请求示例
GET https://{endpoint}/v2/manage/namespaces/{namespace}
响应示例
状态码： 200 查询成功
{ "id" : 1422, "name" : "huawei",
"creator_name" : "liugenping", "auth" : 7
}
状态码
状态码 描述
200 查询成功
400 错误的请求
401 鉴权失败
404 组织不存在
500 内部错误
错误码
请参见错误码。