接口功能介绍
查询指定时间段内的时移用量。
使用说明
支持查询时移对应的存储用量。
接口详情
请求方式:POST
请求路径:/live/time-shift/query-time-shift-capacity
请求参数
参数名 | 类型 | 名称 | 是否必填 | 说明 |
---|---|---|---|---|
domain | string | 域名 | 是 | 域名 |
startTime | string | 开始时间 | 否 | 获取数据起始时间。不填默认当天凌晨零点。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
endTime | string | 结束时间 | 否 | 结束时间需大于起始时间,不填默认为当前时间。 |
响应参数
字段名称 | 类型 | 说明 |
---|---|---|
code | int | 100000表示成功,其他表示失败 |
message | string | 响应状态说明 |
data | dict | 接口返回的数据 |
domain | string | 域名 |
startTime | string | 查询开始时间 |
endTime | string | 查询结束时间 |
totalCapacity | int | 单位为KB。如果客户为多个存储中心,则为多个存储中心汇总的值 |
capacityList | list | 可展示多个存储中心相关信息 |
capacityList.capacity | int | 单位为KB【多个存储中心时,该存储中心的存储用量】 |
capacityList.OssRegion | string | OSS存储的Region名称 |
capacityList.OssBucket | string | OSS存储的Bucket名称 |
capacityList.OssEndpoint | string | OSS存储的Endpoint名称 |
示例
请求路径:https://cdnapi-global.ctapi.ctyun.cn/live/time-shift/query-time-shift-capacity
请求示例
{
"domain": "ctyun.cn",
"startTime": "2022-11-03 00:00:00",
"endTime": "2022-11-03 09:46:00"
}
正常响应示例
{
"code": 100000,
"message": "success",
"data": {
"domain": "ctyun.cn",
"startTime": "2022-11-03 00:00:00",
"endTime": "2022-11-03 09:46:00",
"totalCapacity": 18620,
"capacityList": [
{
"capacity": 0,
"OssRegion": "内蒙资源池0001",
"OssBucket": "test0615002",
"OssEndpoint": "https://nmrdoss.ctyun.store:10003"
},
{
"capacity": 18620,
"OssRegion": "内蒙资源池0001",
"OssBucket": "test0615",
"OssEndpoint": "https://nmrdoss.ctyun.store:10003"
}
]
}
}
错误码请参考:参数code和message含义