命名空间管理

创建命名空间

参数名类型描述是否必填
namestring命名空间唯一名称是
commentstring描述否
user_ids[]string可以操作该资源的用户，仅当开启北极星鉴权时生效否
group_ids[]string可以操作该资源的用户组，，仅当开启北极星鉴权时生效否
remove_user_ids[]string被移除的可操作该资源的用户，仅当开启北极星鉴权时生效否
remove_group_ids[]string被移除的可操作该资源的用户组，仅当开启北极星鉴权时生效否

请求示例：

  1. POST /naming/v1/namespaces
  3. # 开启北极星服务端针对控制台接口鉴权开关后，需要添加下面的 header
  4. Header X-Polaris-Token: {访问凭据}
  6. [
  7.     {
  8.         "name": "...",
  9.         "comment": "..."
  10.     }
  11. ]

应答示例：

  1. {
  2.     "code":200000,
  3.     "info":"...",
  4.     "size":1,
  5.     "responses":[
  6.         {
  7.             "code":200000,
  8.             "info":"execute success",
  9.             "namespace":{
  10.                 "name":"...",
  11.                 "token":"..."
  12.             }
  13.         }
  14.     ]
  15. }

查询命名空间列表

参数名类型描述是否必填
namestring命名空间唯一名称是
offsetuint查询偏移量否
limituint查询条数，最多查询100条否

请求示例：

  1. GET /naming/v1/namespaces?name=&offset=&limit=
  3. # 开启北极星服务端针对控制台接口鉴权开关后，需要添加下面的 header
  4. Header X-Polaris-Token: {访问凭据}

应答示例：

  1. {
  2.     "code": 200000,
  3.     "info": "execute success",
  4.     "amount": 0,
  5.     "size": 3,
  6.     "namespaces": [
  7.         {
  8.             "name": "...",
  9.             "comment": "",
  10.             "ctime": "2021-11-22 23:50:52",
  11.             "mtime": "2021-11-22 23:50:52"
  12.         },
  13.         {
  14.             "name": "...",
  15.             "comment": "",
  16.             "ctime": "2021-11-22 23:50:52",
  17.             "mtime": "2021-11-22 23:50:52"
  18.         }
  19.     ]
  20. }

更新命名空间

参数名类型描述是否必填
namestring命名空间唯一名称是
commentstring描述否
tokenstring命名空间的token，用于权限鉴定是
user_ids[]string可以操作该资源的用户，仅当开启北极星鉴权时生效否
group_ids[]string可以操作该资源的用户组，，仅当开启北极星鉴权时生效否
remove_user_ids[]string被移除的可操作该资源的用户，仅当开启北极星鉴权时生效否
remove_group_ids[]string被移除的可操作该资源的用户组，仅当开启北极星鉴权时生效否

请求示例：

  1. PUT /naming/v1/namespaces
  3. # 开启北极星服务端针对控制台接口鉴权开关后，需要添加下面的 header
  4. Header X-Polaris-Token: {访问凭据}
  6. [
  7.     {
  8.         "name": "...",
  9.         "comment": "..."
  10.     }
  11. ]

应答示例：

  1. {
  2.     "code": 200000,
  3.     "info": "execute success",
  4.     "size": 0
  5. }

删除命名空间

参数名类型描述是否必填
namestring命名空间唯一名称是
tokenstring命名空间的token，用于权限鉴定是

请求示例：

  1. POST /naming/v1/namespaces/delete
  3. # 开启北极星服务端针对控制台接口鉴权开关后，需要添加下面的 header
  4. Header X-Polaris-Token: {访问凭据}
  6. [
  7.     {
  8.         "name": "...",
  9.     }
  10. ]

应答示例：

  1. {
  2.     "code": 200000,
  3.     "info": "execute success",
  4.     "size": 0
  5. }