查询调度域名请求数的汇总信息
更新时间：2023-03-28 17:34:08
适用产品
CDN Pro
接口描述
获取一段时间内一个或多个调度域名的DNS解析请求数汇总数据。可通过该接口查询每个调度域名的请求数数据。
推荐使用 Open API在线调试
Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试
请求参数
Params 参数
| 参数名称 | 描述 |
|---|---|
*startdateString | 查询范围的开始时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：startdate=2019-10-30T00:00:00Z。 |
*enddateString | 查询范围的结束时间，以RFC 3339日期格式表示。必须使用UTC时区指定时间。示例：enddate=2019-11-14T00:00:00Z。由于数据处理存在延迟，所指定的结束时间必须至少比当前时间早5分钟，否则返回的数据可能不准确。 |
Body 参数
| 参数名称 | 描述 |
|---|---|
filtersGetEdgeHostnameSummaryStatisticsRequestFilters | 指定查询范围。 |
edgeHostnamesList | 指定一个或多个调度域名进行查询。 |
groupByList | 指定edgeHostnames，按调度域名分组汇总返回数据。如未指定，则只返回所有调度域名的汇总数据。 |
返回参数
Body 参数
| 参数名称 | 描述 |
|---|---|
metaDataGetEdgeHostnameSummaryStatisticsResponseMetaData | 此对象包含的字段是对groups对象中返回数据的描述。 |
startTimeString | RFC 3339格式的日期，表示查询的起始时间。 |
endTimeString | RFC 3339格式的日期，表示查询的结束时间。 |
isCompleteBoolean | 该接口最多返回10000个分组的数据。如果实际分组数量大于10000，则isComplete的值将为false。 |
dataNamesList | 返回的数据类型，即调度域名DNS解析请求数。 |
dataUnitString | 返回值的计量单位。 |
groupsList | 按调度域名分组汇总的数据。 |
groupString | 分组名称。'__all__' 是一个特殊分组，包含其它所有分组的数据。 |
dataList | DNS解析请求数。 |
错误码
| 错误代码（code） | 描述（message） | HTTP状态码 | 语义 |
|---|---|---|---|
| InvalidGroupBy | Invalid group name(s): "abc". We only support grouping by "edgeHostnames". | 400 | groupBy参数无效。仅支持按"edgeHostnames"进行分组汇总查询。 |
| InvalidTimeSpan | The max time span must be no more than 366 days. | 400 | 查询跨度不能超过366天。 |
示例
200
- 请求示例 复制成功
#!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://open.chinanetcenter.com/cdn/report/edgeHostnameReqSummary" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{"groupBy": ["edgeHostnames"]}'- 返回示例 复制成功
{ "metaData": { "startTime": "2020-01-01T12:35:00Z", "endTime": "2020-01-29T12:40:00Z", "isComplete": true, "dataNames": [ "edgeHostname dns request" ], "dataUnit": "counts" }, "groups": [ { "group": "__all__", "data": [ 3692 ] } ] }
本篇文档内容对您是否有帮助？
有帮助
我要反馈