/v2/statistics/

流量统计信息

请求地址

https://api.upyun.com/v2/statistics/

HTTP请求方法

GET

是否需要登陆授权

是，关于登录授权，参见授权机制

请求参数

必选 数据类型及范围 说明
bucket_name false string 空间名称
start_time false string 开始时间
end_time false string 结束时间
domain false string 域名，如果传递这个参数，则必须传递 bucket_name
flow_type false string 流量类型(cdn：cdn服务的流量；live：直播服务流量, 默认cdn)
live_type false string 直播流量分类(up: 上行推流流量; down: 下行播放流量)

start_time 说明：

参数取值 说明
统计开始日期 流量统计开始日期，若为空，缺省为当前时间前推 6 个小时

end_time 说明:

参数取值 说明
统计结束日期 流量统计开始日期，若为空，缺省为当前时间

start_time 和 end_time 最大时间间隔不能超过 31 天

返回结果

{
   "interval" : "min_five",
   "peaks":[
      {
          "date":"2015-06-01",
          "bytes":"304339",
          "reqs":"4",
          "peak_time":1433136300,
          "bandwidth":"9409",
          "hreqs": 5,
          "dreqs": 6
      }
    ],
    "data":[
        {"time":1433088600,"reqs":"0","bytes":"0","rps":"0","bandwidth":"0", "hreqs": 0, "dreqs": 0},
        {"time":1433088900,"reqs":"0","bytes":"0","rps":"0","bandwidth":"0", "hreqs": 0, "dreqs": 0},
        {"time":1433089200,"reqs":"0","bytes":"0","rps":"0","bandwidth":"0", "hreqs": 0, "dreqs": 0}
     ]
}

返回字段说明:

返回值字段 字段类型 字段说明
peaks JSON Object 峰值时间的数据
interval string 时间间隔， min_five: 表示每隔 5 分钟的数据
data JSON Object 实际数据

data 字段说明:

返回值字段 字段类型 字段说明
time timestamp 当前数据的时间戳
reqs number 请求数
bytes number 字节数
bandwidth number 带宽 单位: bps
rps number 每秒请求数
hreqs number https 请求数
dreqs number 动态 cdn 请求数

peaks 字段说明：

返回字段 字段类型 字段说明
date timestamp 统计的时间
bytes number 流量
reqs number 请求次数
peak_time timestamp 峰值时间（注意：如果为null的时候表示此时没有峰值）
bandwidth number 峰值带宽，单位: bps
hreqs number 峰值 https 请求数
dreqs number 峰值动态 cdn 请求数

注意 返回数据结果中的列表开始和结尾的统计数据中，如果值为0或者空，将会被填0返回

注意 当为直播流量时，data中没有hreqs以及dreqs返回。peaks中没有hreqs以及dreqs

请求示例

curl -v "https://api.upyun.com/v2/statistics/?bucket_name=test_bucket&start_time=2016-06-17+00:00:00&end_time=2016-06-24+00:00:00&interval=day" -H 'Authorization:Bearer  xxxxxxx'

错误返回值与错误代码，参见错误代码说明

Last edited by jianhua.wang, 2016-11-15 13:38:33