文档首页 > > API参考> 统计分析接口> 查询CDN统计信息

查询CDN统计信息

分享
更新时间: 2019/10/10 GMT+08:00

功能描述

查询CDN的统计数据,包括流量、峰值带宽、请求总数、请求命中率、流量命中率。

请求URI

GET /v1.0/{project_id}/asset/cdn-statistics

请求参数

表1 请求参数

参数

类型

说明

必选项(M)/可选项(O)

domain

String

域名列表,多个域名以逗号(半角)分隔。

示例:www.test1.com,www.test2.com。

ALL表示查询名下全部域名。一次最多查询100个域名。

M

start_time

String

起始时间,格式为yyyymmddhhmmss。

O

end_time

String

结束时间,格式为yyyymmddhhmmss。

  • “start_time”“end_time”均不存在时,“start_time”取当天零点,“end_time”取当前时间。
  • “start_time”不存在、“end_time”存在,请求非法。
  • “start_time”存在、“end_time”不存在,“end_time”取当前时间。
  • 只能查询最近三个月内的数据,且时间跨度不能超过31天。
  • 起始时间和结束时间会自动规整,起始时间规整为指定时间所在的整点时刻,结束时间规整为指定时间所在时间的下一小时整点时刻。

O

interval

Integer

查询粒度间隔。

取值如下:

  • 时间跨度1天:5分钟、1小时、4小时、8小时,分别对应300秒、3600秒、14400秒和28800秒。
  • 时间跨度2~7天:1小时、4小时、8小时、1天,分别对应3600秒、14400秒、28800秒和86400秒。
  • 时间跨度8~31天:4小时、8小时、1天,分别对应14400秒、28800秒和86400秒。

单位:秒。

若不设置,默认取对应时间跨度的最小间隔。

O

stat_type

String

统计数据类型。

取值如下:
  • cdn_bw:CDN峰值带宽
  • cdn_flux:CDN流量
  • req_num:请求总数
  • req_hit_rate:请求命中率
  • flux_hit_rate:流量命中率

每次只能查询一种统计数据。

M

请求样例

GET /v1.0/{project_id}/asset/cdn-statistics?domain=www.example.com&stat_type=cdn_bw

返回参数

  • 处理成功时返回
    表2 处理成功返回参数

    参数

    类型

    说明

    start_time

    String

    统计起始时间。

    interval

    Integer

    统计间隔。

    values

    Array of integers

    采样数据数组。

    从start_time开始,每个间隔对应一个采样数据。

  • 处理失败时返回
    表3 处理失败返回参数

    参数

    类型

    说明

    error_code

    String

    错误码。

    error_msg

    String

    错误描述。

返回样例

  • 处理成功返回 (200 OK)
    {
       "start_time": "string",
       "interval": 0,
       "values": [     0   ]
     }
  • 处理失败返回 (400 Bad Request)
    {
      "error_code": "VOD.10053",
      "error_msg": "请求参数非法,非法字段:{xx}。"
    }

错误码

错误码请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区