8 数据统计

数据统计模块主要展示流量、带宽、存储统计的查询功能。

8.1 查询流量数据

8.1.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/stats/flow

用于查询点播的流量使用统计数据(查询的开始时间不能超过当前时刻90天,且不能查询当天数据)。

8.1.2 输入参数

参数 类型 必须 说明
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 获取流量数据列表分页后的索引
pageSize Int 获取流量数据列表一页的记录数,取值范围:[1,500]

8.1.3 输出参数

参数 类型 说明
code Int 状态码
totalFlow Double 查询时段的总流量(单位:GB)
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 当前取得页数
pageSize Int 一页的记录数目
pageNum Int 总页数
totalRecords Int 获取流量数据的数目
list List 流量数据列表
list.begintime Long 起始时间(单位:毫秒)
list.endtime Long 结束时间(单位:毫秒)
list.flow Double 流量值(单位:GB)
msg String 错误信息

8.1.4 响应状态码

状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

8.1.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"startDate":1490976000000,"endDate":1491062400000,"type":5,"currentPage":1,"pageSize":10}' https://vcloud.163.com/app/vod/stats/flow

输出1

{
    "ret" : {
        "startDate" : 1490976000000,
        "endDate" : 1491062400000,
        "totalFlow" : 1234.23,
        "type" : 2,
        "flowList" : [
            {
                "begintime" : 1490976000000,
                "endtime" : 1491062400000,
                "flow" : 123.21
            },
            ...
        ],
        "currentPage" : 1,
        "pageSize" : 10,
        "pageNum" : 2,
        "totalRecords" : 18
    },
    "code" : 200
}

8.2 查询带宽数据

8.2.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/stats/band

用于查询点播的带宽使用统计数据(统计粒度(1:每小时(2~7天);2:每天(32~366天);3:每十分钟(0~1天),4:每四小时(8~31天)),查询的开始时间不能超过当前时刻60天,且不能查询当天数据)。

8.2.2 输入参数

参数 类型 必须 说明
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 获取带宽数据列表分页后的索引
pageSize Int 获取带宽数据列表一页的记录数,取值范围:[1,500]

8.2.3 输出参数

参数 类型 说明
code Int 状态码
maxBand Double 查询时段的最大带宽值(单位:Mb/s)
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 当前取得页数
pageSize Int 一页的记录数目
pageNum Int 总页数
totalRecords Int 获取带宽数据的数目
bandList List 获取的带宽列表
bandList.begintime Long 起始时间(单位:毫秒)
bandList.endtime Long 结束时间(单位:毫秒)
bandList.band Double 带宽值(单位:Mb/s)
msg String 错误信息

8.2.4 响应状态码

状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

8.2.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"startDate":1490976000000,"endDate":1491062400000,"type":2,"currentPage":1,"pageSize":10}' https://vcloud.163.com/app/vod/stats/band

输出1

{
    "ret" : {
        "startDate" : 1490976000000,
        "endDate" : 1491062400000,
        "maxBand" : 1234.23,
        "type" : 2,
        "bandList" : [
            {
                "begintime" : 1490976000000,
                "endtime" : 1491062400000,
                "band" : 123.21
            },
            ...
        ],
        "currentPage" : 1,
        "pageSize" : 10,
        "pageNum" : 2,
        "totalRecords" : 18
    },
    "code" : 200
}

8.3 查询存储数据

8.3.1 接口描述

域名:vcloud.163.com

接口名:/app/vod/stats/storage

用于查询点播的存储使用统计数据(查询粒度为天,查询的开始时间不能超过当前时刻90天,且不能查询当天数据)。

8.3.2 输入参数

参数 类型 必须 说明
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 获取存储数据列表分页后的索引
pageSize Int 获取存储数据列表一页的记录数,取值范围:[1,500]

8.3.3 输出参数

参数 类型 说明
code Int 状态码
totalStorage Double 查询时段的总存储量(单位:GB)
startDate Long 需要查询的开始时间戳(单位:毫秒)
endDate Long 需要查询的结束时间戳(单位:毫秒)
currentPage Int 当前取得页数
pageSize Int 一页的记录数目
pageNum Int 总页数
totalRecords Int 获取存储数据的数目
type Int 统计粒度(2:每天)
storageList List 获取的存储列表
storageList.begintime Long 起始时间(单位:毫秒)
storageList.endtime Long 结束时间(单位:毫秒)
storageList.storage Double 存储量(单位:GB)
msg String 错误信息

8.3.4 响应状态码

状态码 含义
200 操作成功
400 请求报文格式错误,报文构造不正确或者没有完整发送
700 服务器内部出现错误,请稍后重试或者将完整错误信息发送给客服人员帮忙解决
710 权限认证失败,请参考文档中的接口鉴权部分
720 访问失败,余额不足。
721 服务未开通,请前往开通页面申请服务开通
722 服务开通审核中,请联系客服人员开通服务
723 请求的次数超过了配额限制

8.3.5 示例代码

输入1

curl -X POST -H "Content-Type: application/json;charset=utf-8" -H "AppKey: 027338bf05cc4a65b5d98bc9d6af80b3" -H "Nonce: 1" -H "CurTime: 1465723418" -H "CheckSum: 61bbfd88c51028a2a28b3628584e65a2abe7ae13" -d '{"startDate":1490976000000,"endDate":1491062400000,"type":5,"currentPage":1,"pageSize":10}' https://vcloud.163.com/app/vod/stats/storage

输出1

{
    "ret" : {
        "startDate" : 1490976000000,
        "endDate" : 1491062400000,
        "totalStorage" : 1234.23,
        "type" : 2,
        "storageList" : [
            {
                "begintime" : 1490976000000,
                "endtime" : 1491062399999,
                "storage" : 123.21
            },
            ...
        ],
        "currentPage" : 1,
        "pageSize" : 10,
        "pageNum" : 2,
        "totalRecords" : 18
    },
    "code" : 200
}