查询存储统计数据

最近更新时间:2019-05-10 09:30:48

接口名称

DescribeStorage

功能说明

查询使用的点播存储空间。

  1. 只能查询最近90天内的数据。
  2. 可以查询每天的存储,也可以查询指定日期每5分钟一个数据的详细列表。天存储数据是指当天23:55:00时的存储数据。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
startDate String 起始日期,格式为 yyyy-MM-dd ,如2018-03-01
endDate String 结束日期,格式为 yyyy-MM-dd ,如2018-03-02
needDetail Integer 是否返回每5分钟一个存储数据的详细列表
  • 1:返回详细数据
  • 0:返回天存储数据
如果 startDate 不等于 endDate ,忽略 needDetail 参数,只返回每天的存储数据,即详细数据只支持查询某一天的数据
COMMON_PARAMS 参见 公共参数

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败
message String 错误信息
data Object 结果数据
data.storage Array 存储统计数据列表,见 StorageData 说明

StorageData

参数名称 类型 说明
timeStamp Integer 时间,Unix 时间戳。对于天存储数据,timeStamp 为所属日期北京时间0点的 Unx 时间戳
value Integer 存储空间大小,单位字节(byte)

错误码说明

错误码 含义说明
4000 - 7000 参见 公共错误码
1000 无效参数
17013 startDate 参数错误

示例

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=DescribeVodStorage
&startDate=2018-03-01
&endDate=2018-03-03
&COMMON_PARAMS

应答示例

{
    "code": 0,
    "message": "",
    "data": {
        "storage": [{
                "timeStamp": 1519833600,
                "value": 13654621
            },
            {
                "timeStamp": 1519920000,
                "value": 16657630
            },
            {
                "timeStamp": 1520006400,
                "value": 16657630
            }
        ]
    }
}