外观
名称空间操作
名称空间(namespace)是使用API接口的特有操作,可以创建完全隔离的资源环境,同一账号下的名称空间,存储独立,网络隔离。
1. 查询所有的名称空间
- Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
- 费用:不收费
- 流量限制:每token每秒20次。
- 接口作用:查询当前用户的所有已创建的名称空间
- namespace规则:每个用户都至少一个名称空间,这个名称空间通常是与用户名同名的。
接口路径
- 公网地址:https://console.casdao.com:9001/casdao/api/v1.0/k8s/spaces/list/namespace
- 内网地址:http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/list/namespace
请求方式
POST 方式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求体
无
输出说明
请求参数 | 说明 |
---|---|
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次。
- 接口作用:创建一个名称空间。包括初始化独立的存储空间和初始化独立的网络空间。
接口路径
- 公网地址:https://console.casdao.com:9001/casdao/api/v1.0/k8s/spaces/create/namespace
- 内网地址:http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/create/namespace
请求方式
POST 方式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求体
无
输出说明
请求参数 | 说明 |
---|---|
code | 响应码,成功为 200,非 200 状态码为失败,参考 msg 错误信息 |
msg | 响应信息,成功状态下为 null,失败状态下为具体错误信息 |
data | 响应数据 |
namespace | 创建的名称空间 |
示例
json
{
"code": 200,
"msg": "success",
"data": {
"namespace": "0x66b1ecbf-casdao"
}
}
3. 删除名称空间
- Token: 此接口需要 Token 调用,需要先调用登录接口换取 Token。
- 费用:免费,名称空间所对应的存储空间收费将停止。
- 流量限制:每token每秒5次。
- 接口作用:删除一个名称空间(不支持批量删除)
- 提示:删除过程较慢,根据占用空间大小不同,预计需要半分钟左右
- 提示:您无法删除默认名称空间,即跟您同名的名称空间
接口路径
- 公网地址:https://console.casdao.com:9001/casdao/api/v1.0/k8s/spaces/delete/namespace
- 内网地址:http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/delete/namespace
请求方式
POST 方式,请求参数为 JSON 格式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求体
请求参数 | 选项 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
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次。
- 接口作用:查询账单,可以查名称空间下的账单和主账号账单。
- 提示:名称空间被删除以后,账单有可能丢失。
接口路径
- 公网地址:https://console.casdao.com:9001/casdao/api/v1.0/k8s/spaces/query/bill
- 内网地址:http://12.2.100.11:9001/casdao/api/v1.0/k8s/spaces/query/bill
请求方式
POST 方式,请求参数为 JSON 格式
输入说明
请求头
请求头 | 说明 |
---|---|
X-Auth-Token | Token 值 |
请求体
请求参数 | 选项 | 类型 | 默认值 | 说明 |
---|---|---|---|---|
namespace | 可选 | 字符串 | 无 | 需要查询的namespace,不传为查询主账号 |
start_time | 可选 | 字符串 | 无 | 查询开始时间 |
end_time | 可选 | 字符串 | 无 | 查询结束时间 |
search | 可选 | 字符串 | 无 | 搜索名称空间或者资源名称 |
page | 可选 | 正整数 | 1 | 分页 |
page_size | 可选 | 正整数 | 10 | 每页大小 |