查询汇总的 CDN 统计数据

最近更新时间:2019-07-15 17:23:09

接口名称

DescribeCdnStat

功能说明

查询指定域名在指定时间段累计的 CDN 统计数据(流量、带宽、请求数和请求命中率)。

说明:

  • 流量、请求数是所查询时间段累计的总流量、总请求数,带宽是所查询时间段的峰值带宽,请求命中率是所查询时间段的平均请求命中率。
  • 只能查询最近90天内的数据。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
hosts Array 域名列表,如果为空,则查询所有云点播域名的统计数据;如果域名数超过20个,则返回错误信息。
startDate String 起始日期,格式为 yyyy-MM-dd,如2018-03-01。
endDate String 结束日期,格式为 yyyy-MM-dd,如2018-03-02。
statType String 统计数据类型:
  • flux:流量,单位是字节(byte)。
  • bandwidth:带宽,单位是比特每秒(bps)。
  • requests:请求数。
  • hitrate:请求命中率,单位为万分比。
  • ip_visits:IP 访问次数(海外 CDN 节点不支持查询 IP 访问次数)。
  • COMMON_PARAMS - 请参见 公共参数

    请求示例

    https://vod.api.qcloud.com/v2/index.php?Action=DescribeCdnStat
    &hosts.0=123.vod2.myqcloud.com
    &startDate=2018-03-01
    &endDate=2018-03-02
    &statType=flux
    &COMMON_PARAMS

    接口应答

    参数说明

    参数名称 类型 说明
    code Integer 错误码,0:成功;其他值:失败。
    message String 错误信息。
    statType String 统计数据类型,和请求参数的 statType 一致。
    data Array 结果数据。
    data.host String 域名。
    data.domesticValue Integer 国内 CDN 节点的统计数据。
    data.overseaValue Integer 海外 CDN 节点的统计数据,如果域名没有开启海外加速,则不会返回该数据。

    错误码说明

    错误码 含义说明
    4000 - 7000 请参见 公共错误码
    1000 输入参数错误。
    17010 HOSTS 参数错误。
    17011 域名列表数据超过20个。
    17012 statType 参数错误。
    17013 startDate 参数错误。

    应答示例

    {
        "code": 0,
        "message": "",
        "statType": "flux",
        "data": [{
            "host": "123.vod2.myqcloud.com",
            "domesticValue": 13659874512,
            "overseaValue": 654859
        }]
    }