CDN > API 文档 > 流量带宽

流量带宽

最近更新时间: 2023-12-06 14:59:56

访问域名

Host: fusion.qiniuapi.com

认证授权

Authorization: QBox <access_token>

access_token 详细描述请查阅这里。

批量查询 cdn 计费带宽

接口地址

/v2/tune/bandwidth

说明

返回的数据包含开始日期和结束日期
带宽的单位为 bps
data 只包含有流量的域名

请求语法

POST /v2/tune/bandwidth
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

请求内容

参数	类型	必要性	说明
StartDate	string	必须	开始日期，例如：2016-07-01
EndDate	string	必须	结束日期，例如：2016-07-03
Granularity	string	必须	粒度，取值：5min ／ hour ／day
Domains	string	必须	域名列表，以；分割
Type	string	非必须	指定带宽数据类型, `""`或`"bandwidth"`查询CDN带宽数据

响应状态码

HTTP状态码	含义	说明
200	success	成功
400031	invalid params	请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`以外的值
400032	invalid host	请求中存在无效的域名，请确保域名格式正确
400080	invalid start time	开始时间格式错误
400081	invalid end time	截止时间格式错误
400082	invalid time range	时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 31 天
500000	internal error	服务端内部错误，请联系技术支持

响应内容

200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>
    },
    ...
  }
}

参数	类型	说明
Code	int	HTTP 状态码，整型，见响应状态码
Error	string	自定义错误码描述，字符串
Time	[]string	时间点数组
data	map	带宽数据
Domain_i	string	域名
Domain_i_China	[]int	Domain_i 国内带宽数据，与 Time 一一对应
Domain_i_Oversea	[]int	Domain_i 海外带宽数据，与 Time 一一对应

示例

200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    }
  }
}

批量查询 cdn 计费流量

接口地址

/v2/tune/flux

说明

返回的数据包含开始日期和结束日期
流量的单位为 byte
data 只包含有流量的域名

请求语法

POST /v2/tune/flux
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

请求内容

参数	类型	必要性	说明
StartDate	string	必须	开始日期，例如：2016-07-01
EndDate	string	必须	结束日期，例如：2016-07-03
Granularity	string	必须	粒度，取值：5min ／ hour ／day
Domains	string	必须	域名列表，以；分割
Type	string	非必须	`""`或`"flux"`查询CDN流量数据

响应状态码

HTTP状态码	含义	说明
200	success	成功
400031	invalid params	请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`以外的值
400032	invalid host	请求中存在无效的域名，请确保域名格式正确
400080	invalid start time	开始时间格式错误
400081	invalid end time	截止时间格式错误
400082	invalid time range	时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 30 天
500000	internal error	服务端内部错误，请联系技术支持

响应内容

200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>
    },
    ...
  }
}

参数	类型	说明
Code	int	HTTP 状态码，整型，见响应状态码
Error	string	自定义错误码描述，字符串
Time	[]string	时间点数组
data	map	流量数据
Domain_i	string	域名
Domain_i_China	[]int	Domain_i 国内流量数据，与 Time 一一对应
Domain_i_Oversea	[]int	Domain_i 海外流量数据，与 Time 一一对应

示例

200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    }
  }
}

批量查询 cdn 监控带宽

接口地址

/v2/tune/monitoring/bandwidth

说明

返回的数据包含开始日期和结束日期
带宽的单位为 bps
data 只包含有流量的域名
监控接口侧重于CDN服务实时统计带宽数据的实效性，不保证数据与账单完全一致
支持查询3个月之内的带宽数据，/v2/tune/bandwidth接口无此限制

请求语法

POST /v2/tune/monitoring/bandwidth
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

请求内容

参数	类型	必要性	说明
StartDate	string	必须	开始日期，例如：2016-07-01
EndDate	string	必须	结束日期，例如：2016-07-03
Granularity	string	必须	粒度，取值：5min ／ hour ／day
Domains	string	必须	域名列表，以；分割
Type	string	非必须	指定带宽数据类型, `""`或`"bandwidth"`查询CDN带宽数据

响应状态码

HTTP状态码	含义	说明
200	success	成功
400031	invalid params	请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`以外的值
400032	invalid host	请求中存在无效的域名，请确保域名格式正确
400080	invalid start time	开始时间格式错误
400081	invalid end time	截止时间格式错误
400082	invalid time range	时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 31 天
500000	internal error	服务端内部错误，请联系技术支持

响应内容

200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>
    },
    ...
  }
}

参数	类型	说明
Code	int	HTTP 状态码，整型，见响应状态码
Error	string	自定义错误码描述，字符串
Time	[]string	时间点数组
data	map	带宽数据
Domain_i	string	域名
Domain_i_China	[]int	Domain_i 国内带宽数据，与 Time 一一对应
Domain_i_Oversea	[]int	Domain_i 海外带宽数据，与 Time 一一对应

示例

200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    }
  }
}

批量查询 cdn 监控流量

接口地址

/v2/tune/monitoring/flow

说明

返回的数据包含开始日期和结束日期
流量的单位为 byte
data 只包含有流量的域名
监控接口侧重于CDN服务实时统计流量数据的实效性，不保证数据与账单完全一致
支持查询3个月之内的流量数据，/v2/tune/flux接口无此限制

请求语法

POST /v2/tune/monitoring/flow
Content-Type: application/json

{
    "startDate": <StartDate>,
    "endDate": <EndDate>,
    "granularity": <Granularity>,
    "domains": <Domains>
}

请求内容

参数	类型	必要性	说明
StartDate	string	必须	开始日期，例如：2016-07-01
EndDate	string	必须	结束日期，例如：2016-07-03
Granularity	string	必须	粒度，取值：5min ／ hour ／day
Domains	string	必须	域名列表，以；分割
Type	string	非必须	`""`或`"flux"`查询CDN流量数据

响应状态码

HTTP状态码	含义	说明
200	success	成功
400031	invalid params	请求参数非法。 e.g. `"Type"`参数指定了除`""`(空)/`"bandwidth"`以外的值
400032	invalid host	请求中存在无效的域名，请确保域名格式正确
400080	invalid start time	开始时间格式错误
400081	invalid end time	截止时间格式错误
400082	invalid time range	时间范围错误，请确保开始时间早于结束时间，且时间范围不超过 30 天
500000	internal error	服务端内部错误，请联系技术支持

响应内容

200 OK HTTP/1.1 

{
  "code": <Code>,
  "error": <Error>,
  "time": <Time>,
  "data": {
    ...
    <Domain_i>: {
      "china": <Domain_i_China>,
      "oversea": <Domain_i_Oversea>
    },
    ...
  }
}

参数	类型	说明
Code	int	HTTP 状态码，整型，见响应状态码
Error	string	自定义错误码描述，字符串
Time	[]string	时间点数组
data	map	流量数据
Domain_i	string	域名
Domain_i_China	[]int	Domain_i 国内流量数据，与 Time 一一对应
Domain_i_Oversea	[]int	Domain_i 海外流量数据，与 Time 一一对应

示例

200 OK HTTP/1.1 

{
  "code": 200,
  "error": "",
  "time": ["2016-07-01 00:00:00","2016-07-01 00:05:00", ...],
  "data": {
    "a.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    },
    "b.com": {
      "china": [8888, 9999, 10000, ...],
      "oversea": [3333, 4444, 5000, ...]
    }
  }
}

以上内容是否对您有帮助？