human: 如何处理七牛云的CDN流量带宽

gpt: [CDN](https://developer.qiniu.com/fusion) > API 文档 > 流量带宽

#  流量带宽

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

# 访问域名

    
    
    Host: fusion.qiniuapi.com
    

# 认证授权

    
    
    Authorization: QBox <access_token>
    

access_token 详细描述请查阅[这里](https://developer.qiniu.com/kodo/6671/historical-
document-management-certificate)。

# 批量查询 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, ...]
        }
      }
    }
    

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