统计接口(旧版)

pv/qps查询接口

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

URL参数:

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

响应体 (Response Body)

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

PvDetails内容:

参数 类型 说明
timestamp Timestamp 时间点
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
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 时间点
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为300
withRegion 可选 Bool 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个
prov 可选 String 查询的省份全拼,默认为空,查询全国数据。不可以与withRegion同时使用。
isp 可选 String 查询的运营商代码,默认为空,查询所有运营商数据。不可以与withRegion同时使用。

响应体(Response Body)

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

HttpCodeDetails内容:

参数 类型 说明
timestamp Timestamp 时间点
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600

响应体(Response Body)

参数 类型 说明
details list类型,TopUrlDetails内容项解释如下:
- timestamp:Timestamp类型,表示时间点。
- 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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600

响应体(Response Body)

参数 类型 说明
details list类型,TopRefererDetails内容项详细解释如下:
- timestamp:Timestamp类型,表示时间点。
- 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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度90天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
period 可选 Int 查询结果的粒度,单位秒,可选值为3600,86400, 默认为3600
withRegion 可选 查询客户端访问分布详情,当包含此项时,结果中details的记录数不能超过64个

响应体

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

UvDetails内容

参数 类型 说明
timestamp Timestamp 时间点
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 查询的时间范围结束值,默认为当前时间。endTime与startTime最大时间跨度31天
startTime 可选 Timestamp 查询的时间范围起始值,默认为endTime前推24小时
period 可选 Int 查询结果的粒度,单位秒,可选值为300,3600,86400, 默认为3600

响应体:

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

AvgSpeedDetails内容

参数 类型 说明
timestamp Timestamp 时间点
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}
  ]
}