Skip to content

名称空间操作

名称空间(namespace)是使用API接口的特有操作,可以创建完全隔离的资源环境,同一账号下的名称空间,存储独立,网络隔离。

1. 查询所有的名称空间

  • Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
  • 费用:不收费
  • 流量限制:每token每秒20次。
  • 接口作用:查询当前用户的所有已创建的名称空间
  • namespace规则:每个用户都至少一个名称空间,这个名称空间通常是与用户名同名的。

接口路径

请求方式

POST 方式

输入说明

请求头

请求头说明
X-Auth-TokenToken 值

请求体

输出说明

请求参数说明
code响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息
msg响应信息,成功状态下为 null,失败状态下为具体错误信息
data响应数据,json列表
namespace当前用户下的名称空间

示例

json
{
  "code": 200,
  "msg": "success",
  "data": [
    {
      "namespace": "casdao"
    },
    {
      "namespace": "0x66a8a990-casdao"
    },
    {
      "namespace": "0x66ab76ad-casdao"
    },
    {
      "namespace": "0x66ab7880-casdao"
    },
    {
      "namespace": "0x66ab7c4d-casdao"
    }
  ]
}

2. 创建一个名称空间

  • Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
  • 费用:每次创建名称空间,该名称空间将获得20G的云存储配额,将对此配额收费。存储配额收费同官网数据存储收费规则,等同于该用户扩容20G空间。
  • 流量限制:每token每秒20次。
  • 接口作用:创建一个名称空间。包括初始化独立的存储空间和初始化独立的网络空间。

接口路径

请求方式

POST 方式

输入说明

请求头

请求头说明
X-Auth-TokenToken 值

请求体

输出说明

请求参数说明
code响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息
msg响应信息,成功状态下为 null,失败状态下为具体错误信息
data响应数据
namespace创建的名称空间

示例

json
{
  "code": 200,
  "msg": "success",
  "data": {
    "namespace": "0x66b1ecbf-casdao"
  }
}

3. 删除名称空间

  • Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
  • 费用:免费,名称空间所对应的存储空间收费将停止。
  • 流量限制:每token每秒5次。
  • 接口作用:删除一个名称空间(不支持批量删除)
  • 提示:删除过程较慢,根据占用空间大小不同,预计需要半分钟左右
  • 提示:您无法删除默认名称空间,即跟您同名的名称空间

接口路径

请求方式

POST 方式,请求参数为 JSON 格式

输入说明

请求头

请求头说明
X-Auth-TokenToken 值

请求体

请求参数选项类型默认值说明
namespace必选字符串需要删除的namespace

示例

json
{
  "namespace": "0x66b1ecbf-casdao"
}

输出说明

请求参数说明
code响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息
msg响应信息,成功状态下为 null,失败状态下为具体错误信息
data响应数据

示例

json
{
    "code": 200,
    "msg": null,
    "data": {  
    }
}

4. 查询账单

  • Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
  • 费用:免费
  • 流量限制:每token每秒1次。
  • 接口作用:查询账单,可以查名称空间下的账单和主账号账单。
  • 提示:名称空间被删除以后,账单有可能丢失。

接口路径

请求方式

POST 方式,请求参数为 JSON 格式

输入说明

请求头

请求头说明
X-Auth-TokenToken 值

请求体

请求参数选项类型默认值说明
namespace可选字符串需要查询的namespace,不传为查询主账号
start_time可选字符串查询开始时间
end_time可选字符串查询结束时间
search可选字符串搜索名称空间或者资源名称
page可选正整数1分页
page_size可选正整数10每页大小

算力互联(北京)科技有限公司版权所有