访问数据查询

最近更新时间:2021-07-23 08:04:28

我的收藏

1. 接口描述

接口请求域名: cdn.tencentcloudapi.com 。

DescribeCdnData 用于查询 CDN 实时访问监控数据,支持以下指标查询:

  • 流量(单位为 byte)
  • 带宽(单位为 bps)
  • 请求数(单位为 次)
  • 命中请求数(单位为 次)
  • 请求命中率(单位为 %)
  • 命中流量(单位为 byte)
  • 流量命中率(单位为 %)
  • 状态码 2xx 汇总及各 2 开头状态码明细(单位为 个)
  • 状态码 3xx 汇总及各 3 开头状态码明细(单位为 个)
  • 状态码 4xx 汇总及各 4 开头状态码明细(单位为 个)
  • 状态码 5xx 汇总及各 5 开头状态码明细(单位为 个)

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数

</
参数名称 必选 类型 描述
Action String 公共参数,本接口取值:DescribeCdnData。
Version String 公共参数,本接口取值:2018-06-06。
Region String 公共参数,本接口不需要传递此参数。
StartTime Timestamp 查询起始时间,如:2018-09-04 10:40:00,返回结果大于等于指定时间
根据指定时间粒度不同,会进行向前归整,如 2018-09-04 10:40:00 在按 1 小时的时间粒度查询时,返回的第一个数据对应时间点为 2018-09-04 10:00:00
起始时间与结束时间间隔小于等于 90 天
EndTime Timestamp 查询结束时间,如:2018-09-04 10:40:00,返回结果小于等于指定时间
根据指定时间粒度不同,会进行向前归整,如 2018-09-04 10:40:00 在按 1 小时的时间粒度查询时,返回的最后一个数据对应时间点为 2018-09-04 10:00:00
起始时间与结束时间间隔小于等于 90 天
Metric String 指定查询指标,支持的类型有:
flux:流量,单位为 byte
fluxIn:上行流量,单位为 byte,该指标仅ecdn支持查询
fluxOut:下行流量,单位为 byte,该指标仅ecdn支持查询
bandwidth:带宽,单位为 bps
bandwidthIn:上行带宽,单位为 bps,该指标仅ecdn支持查询
bandwidthOut:下行带宽,单位为 bps,该指标仅ecdn支持查询
request:请求数,单位为 次
hitRequest:命中请求数,单位为 次
requestHitRate:请求命中率,单位为 %,保留小数点后两位
hitFlux:命中流量,单位为byte
fluxHitRate:流量命中率,单位为 %,保留小数点后两位
statusCode:状态码,返回 2xx、3xx、4xx、5xx 汇总数据,单位为 个
2xx:返回 2xx 状态码汇总及各 2 开头状态码数据,单位为 个
3xx:返回 3xx 状态码汇总及各 3 开头状态码数据,单位为 个
4xx:返回 4xx 状态码汇总及各 4 开头状态码数据,单位为 个
5xx:返回 5xx 状态码汇总及各 5 开头状态码数据,单位为 个
支持指定具体状态码查询,若未产生过,则返回为空
Domains.N Array of String 指定查询域名列表
最多可一次性查询 30 个加速域名明细
Project Integer 指定要查询的项目 ID,前往查看项目 ID
未填充域名情况下,指定项目查询,若填充了具体域名信息,以域名为主
Interval String 时间粒度,支持以下几种模式:
min:1 分钟粒度,指定查询区间 24 小时内(含 24 小时),可返回 1 分钟粒度明细数据(指定查询服务地域为中国境外时不支持 1 分钟粒度)
5min:5 分钟粒度,指定查询区间 31 天内(含 31 天),可返回 5 分钟粒度明细数据
hour:1 小时粒度,指定查询区间 31 天内(含 31 天),可返回 1 小时粒度明细数据
day:天粒度,指定查询区间大于 31 天,可返回天粒度明细数据
Detail Boolean 多域名查询时,默认(false)返回多个域名的汇总数据
可按需指定为 true,返回每一个 Domain 的明细数据(statusCode 指标暂不支持)
Isp Integer 查询中国境内CDN数据时,指定运营商查询,不填充表示查询所有运营商
运营商编码可以查看 运营商编码映射
指定运营商查询时,不可同时指定省份、IP协议查询