服务端 API 文档

查询存储统计数据

最近更新时间:2020-06-29 15:35:47

接口名称

DescribeStorage

功能说明

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

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

请求方式

请求域名

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 - 请参见 公共参数

    请求示例

    https://vod.api.qcloud.com/v2/index.php?Action=DescribeVodStorage
    &startDate=2018-03-01
    &endDate=2018-03-03
    &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 参数错误。

    应答示例

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