内容分发网络CDN

    统计接口(旧版)

    pv/qps查询接口

    Method Path 说明
    GET /v2/stat/pv 查询域名pv请求量

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名pv数之和
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度90天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400 默认为300
    withRegion 可选 Bool 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个
    prov 可选 String 查询的省份全拼,默认为空,查询全国数据。不可以与withRegion同时使用。
    isp 可选 String 查询的运营商代码,默认为空,查询所有运营商数据。不可以与withRegion同时使用。

    响应体 (Response Body)

    参数 类型 说明
    details list类型,参见下表PvDetails内容。 数据详情

    PvDetails内容:

    参数 类型 说明
    timestamp Timestamp 时间点,UTC时间
    pv Int 统计时间段内的请求量
    qps Int 统计时间段内的平均qps
    regions list类型,参见下表PvRegionData内容 客户端访问分布数据,当请求包含withRegion参数时包含此项

    PvRegionData内容:

    参数 类型 说明
    location String 客户端所在省份、地区
    isp String 客户端所属运营商
    pv Int 统计时间段内的请求量
    qps Int 统计时间段内的平均qps

    请求示例

    GET /v2/stat/pv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    返回示例

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","pv":1998202,"qps":556},
        {"timestamp":"2016-10-13T01:00:00Z","pv":2169932,"qps":603}
      ]
    }

    带宽&流量查询接口

    Method Path 说明
    GET /v2/stat/flow 查询域名流量记录

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,返回内容为所有域名的数据之和,如不指定则返回该用户所有域名流量之和
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为300
    withRegion 可选 Bool 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个
    prov 可选 String 查询的省份全拼,默认为空,查询全国数据。不可以与withRegion同时使用。
    isp 可选 String 查询的运营商代码,默认为空,查询所有运营商数据。不可以与withRegion同时使用。
    level 可选 String 查询边缘节点或者中心节点带宽。不可以与withRegion同时使用,可以填写“edge”或者“internal”。

    响应体 (Response Body)

    参数 类型 说明
    details list参见下表 数据详情

    FlowDetail内容:

    参数 类型 说明
    timestamp Timestamp 时间点,UTC时间
    flow Int 统计时间段内的传输字节数
    bps Int 统计时间段内的平均bps
    regions list参见下表 客户端访问分布数据,当请求中的withRegion为true时包含此项

    FlowRegionData内容:

    参数 类型 说明
    location String 客户端所在省份、地区
    isp String 客户端所属运营商
    flow Int 统计时间段内的传输字节数
    bps Int 统计时间段内的平均bps

    请求示例

    GET /v2/stat/flow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","flow":42652354694,"bps":94783010},
        {"timestamp":"2016-10-13T01:00:00Z","flow":45766298297,"bps":101702885}
      ]
    }

    回源流量查询接口

    Method Path 说明
    GET /v2/stat/srcflow 查询域名回源流量记录

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名回源流量之和
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为300

    响应体 (Response Body)

    参数 类型 说明
    details list参见下表 数据详情

    请求示例

    GET /v2/stat/srcflow?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","flow":741119469,"bps":1646932},
        {"timestamp":"2016-10-13T01:00:00Z","flow":905548590,"bps":2012330}
      ]
    }

    字节命中率查询接口

    Method Path 说明
    GET /v2/stat/hitrate 查询字节命中率

    URL参数:

    参数 是否可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名字节命中率的平均值
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    granularity 可选 Int 查询结果的粒度,单位秒,可选值为60,300,3600 默认为300

    响应体 (Response Body)

    参数 类型 说明
    details list类型,HitRateDetails内容项详细解释:
    - timestamp:Timestamp类型,表示时间点。
    - hitrate:Double类型,表示统计时间段内的字节命中率。
    数据详情

    请求示例

    GET /v2/stat/hitrate?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    响应示例

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","hitrate":0.98262418395615},
        {"timestamp":"2016-10-13T01:00:00Z","hitrate":0.98021363702777}
      ]
    }

    状态码统计查询接口

    Method Path 说明
    GET /v2/stat/httpcode 查询域名状态码统计

    URL参数:

    参数 是否可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名状态码计数
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为300
    withRegion 可选 Bool 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个
    prov 可选 String 查询的省份全拼,默认为空,查询全国数据。不可以与withRegion同时使用。
    isp 可选 String 查询的运营商代码,默认为空,查询所有运营商数据。不可以与withRegion同时使用。

    响应体(Response Body)

    参数 类型 说明
    details list参见下表解释 数据详情

    HttpCodeDetails内容:

    参数 类型 说明
    timestamp Timestamp 时间点,UTC时间
    counters list参见下表 HTTP状态码计数
    regions list参见下表解释 按客户端访问地域分布的数据详情

    HttpCodeRegionData内容:

    参数 类型 说明
    location String 客户端所在省份、地区
    isp String 客户端所属运营商
    counters list参见下表解释 HTTP状态码计数

    KvCounter内容:

    参数 类型 说明
    name String 统计项
    value Int 统计计数

    请求示例

    GET /v2/stat/httpcode?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    返回示例

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
     
    {
      "details":
      [
        {
          "timestamp":"2016-10-13T00:00:00Z",
          "counters": [
            {"name":"504","value": 12},
            {"name":"502", "value": 18},
            {"name":"502", "value": 24},
            {"name": "206", "value": 66},
            {"name": "200", "value":1759884},
            {"name": "304", "value": 259405},
            {"name": "499", "value": 602},
            {"name": "404", "value": 1902}
        ]
        },
        {
          "timestamp":"2016-10-13T01:00:00Z",
          "counters": [
            {"name":"504","value": 12},
            {"name":"502", "value": 18},
            {"name":"502", "value": 24},
            {"name": "206", "value": 66},
            {"name": "200", "value":1759884},
            {"name": "304", "value": 259405},
            {"name": "499", "value": 602},
            {"name": "404", "value": 1902}
        ],
        }
      ]
    }

    TopN url查询接口

    Method Path 说明
    GET /v2/stat/topn/url 查询top100 url列表

    url参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名的top100 url列表
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600

    响应体(Response Body)

    参数 类型 说明
    details list类型,TopUrlDetails内容项解释如下:
    - timestamp:Timestamp类型,表示时间点,UTC时间。
    - counters:list类型,表示Top100 url统计。KvCounter内容项解释如下:
    - name:String类型,表示统计项。
    - value:Int类型,表示统计计数。
    数据详情

    请求示例:

    GET /v2/stat/topn/url?domain=my.test.com&endTime=2016-10-22T03%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    响应示例:

    HTTP/1.1 200 OK
    Content-Length: 7113
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
     
    {
        "details": [
        {
          "timestamp": "2016-10-22T02:00:00Z",
          "counters":
          [
            {"name":"http://my.test.com/path/to/file1.png", "value": 2551},
            {"name":"http://my.test.com/path/to/file2.gif", "value": 1195},
            {"name":"http://my.test.com/path/to/file3.jpg", "value": 932},
            {"name":"http://my.test.com/path/to/file4.mp4", "value": 846},
            {"name":"http://my.test.com/path/to/file5.css", "value": 544},
            {"name":"http://my.test.com/path/to/file6.js", "value": 326},
            {"name":"http://my.test.com/path/to/file7.flv", "value": 122},
            {"name":"http://my.test.com/path/to/file8.zip", "value": 116},
            {"name":"http://my.test.com/path/to/file9.doc", "value": 98},
            {"name":"http://my.test.com/path/to/file10.mp3", "value": 76},
            {"name":"http://my.test.com/path/to/file11.pdf", "value": 18}
          ]
        },
        {
        "timestamp": "2016-10-22T03:00:00Z",
        "counters":
        [
          {"name":"http://my.test.com/path/to/file1.png", "value": 2382},
          {"name":"http://my.test.com/path/to/file2.gif", "value": 1245},
          {"name":"http://my.test.com/path/to/file3.jpg", "value": 923},
          {"name":"http://my.test.com/path/to/file4.mp4", "value": 811},
          {"name":"http://my.test.com/path/to/file5.css", "value": 532},
          {"name":"http://my.test.com/path/to/file6.js", "value": 423},
          {"name":"http://my.test.com/path/to/file7.flv", "value": 209},
          {"name":"http://my.test.com/path/to/file8.zip", "value": 155},
          {"name":"http://my.test.com/path/to/file9.doc", "value": 84},
          {"name":"http://my.test.com/path/to/file10.mp3", "value": 80},
          {"name":"http://my.test.com/path/to/file11.pdf", "value": 32}
         ]
        }
      ]
    }

    TopN referer查询接口

    Method Path 说明
    GET /v2/stat/topn/referer 查询top100 referer

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名的top100 referer
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600

    响应体(Response Body)

    参数 类型 说明
    details list类型,TopRefererDetails内容项详细解释如下:
    - timestamp:Timestamp类型,表示时间点,UTC时间。
    - counters:list类型,表示Top 100 refer统计计数。KvCounter内容项解释如下:
    - name:String类型,表示统计项。
    - value:Int类型,表示统计计数。
    数据详情

    请求示例:

    GET /v2/stat/topn/referer?domain=my.test.com&endTime=2016-10-22T02%3A01%3A00Z&period=3600&startTime=2016-10-22T01%3A57%3A00Z HTTP/1.1
    Host: cdn.baidubce.com 

    响应示例:

    HTTP/1.1 200 OK
    Content-Length: 180
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
     
    {
      "details":
      [
        {
          "timestamp":"2016-10-22T02:00:00Z",
          "counters":
          [
            {"name":"-", "value":53687},
            {"name":"i1.my.test.com", "value":752},
            {"name":"i2.my.test.com", "value":393},
            {"name":"i3.my.test.com", "value":1}
          ]
        }
      ]
    }

    uv查询接口

    Method Path 说明
    GET /v2/stat/uv 查询域名uv请求量

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名uv之和
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度90天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600
    withRegion 可选 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个

    响应体

    参数 类型 说明
    details list 数据详情

    UvDetails内容

    参数 类型 说明
    timestamp Timestamp 时间点,UTC时间
    uv Int 统计时间段内的请求量
    regions list 客户端访问分布数据,当请求包含withRegion参数时包含此项

    UvRegionData内容

    参数 类型 说明
    location String 客户端所在省份、地区
    isp String 客户端所属运营商
    uv Int 统计时间段内的请求量

    请求示例:

    GET /v2/stat/uv?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com 

    响应示例:

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","uv":1998202},
        {"timestamp":"2016-10-13T01:00:00Z","uv":2169932}
      ]
    }

    平均速率查询接口

    Method Path 说明
    GET /v2/stat/avgspeed 查询平均速率记录

    URL参数:

    参数 可选 类型 说明
    domain 可选 String 查询的域名,可多个域名用逗号分隔,如不指定则返回该用户所有域名平均速率的均值
    endTime 可选 Timestamp 查询的时间范围结束值,默认为当前时间,UTC时间。endTime与startTime最大时间跨度31天
    startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时,UTC时间
    period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为3600

    响应体:

    参数 类型 说明
    details list<AvgSpeedDetails> 数据详情

    AvgSpeedDetails内容

    参数 类型 说明
    timestamp Timestamp 时间点,UTC时间
    avgspeed Int 统计时间段内的平均速率

    请求示例:

    GET /v2/stat/avgspeed?domain=my.test.com&endTime=2016-10-13T02%3A00%3A00Z&period=3600&startTime=2016-10-13T00%3A00%3A00Z HTTP/1.1
    Host: cdn.baidubce.com

    响应示例:

    HTTP/1.1 200 OK
    Content-Length: 190
    Content-Type: application/json;utf-8
    x-bce-request-id: 81d0b05f-5ad4-1f22-8068-d5c9de60a1d7
    Server: BCE-CDN
    {
      "details":
      [
        {"timestamp":"2016-10-13T00:00:00Z","avgspeed":741119469},
        {"timestamp":"2016-10-13T01:00:00Z","avgspeed":905548590}
      ]
    }
    上一篇
    统计接口(新版)
    下一篇
    上行流量峰值