CDN

  • 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, ...]
        }
      }
    }
    
    以上内容是否对您有帮助?
  • Qvm free helper
    Close