所有文档

          内容分发网络 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}
            ]
          }
          上一篇
          统计接口(新版)
          下一篇
          上行流量峰值