服务端 API 文档

查询存储统计数据

最近更新时间:2021-01-07 14:42:17

接口名称

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
            }
        ]
    }
    }
    目录