调用DescribeDcdnDomainRealTimeDetailData批量获取域名的各地区运营商流量和访问次数的1分钟粒度数据。该API最长查询跨度不超过10分钟。
接口说明
单用户调用频率:10 次/秒。
该接口暂时仅支持日峰值带宽为 1 Gbps 以上的用户调用,如果您符合该条件,请提交工单申请该接口的调用权限。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
dcdn:DescribeDcdnDomainRealTimeDetailData |
get |
*Domain
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
DomainName |
string |
是 |
加速域名,多个用英文逗号(,)分隔。 |
example.com |
StartTime |
string |
是 |
获取数据的起始时间点。日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 |
2019-11-30T05:33:00Z |
EndTime |
string |
是 |
获取数据的结束时间点,日期格式按照 ISO8601 表示法,并使用 UTC 时间,格式为 yyyy-MM-ddTHH:mm:ssZ。 说明
结束时间需大于起始时间,且查询跨度不得超过 10 分钟。 |
2019-11-30T05:40:00Z |
Field |
string |
是 |
获取的类别信息,多个用逗号(,)分隔。取值:
|
bps |
LocationNameEn |
string |
否 |
地域英文名,通过 DescribeDcdnRegionAndIsp 获得。 默认查询所有地域。 |
beijing |
IspNameEn |
string |
否 |
运营商英文名,通过 DescribeDcdnRegionAndIsp 获得。 默认查询所有运营商。 |
unicom |
Merge |
string |
否 |
是否输出汇总值。取值:
默认值为 false。 |
true |
MergeLocIsp |
string |
否 |
是否合并 LocationNameEn 和 IspNameEn 输出汇总值。取值:
默认值为 false。 |
true |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
Data |
string |
数据信息列表。 说明
该字段受 API 限制,按 JSON 字符串返回,各个字段意义及名称如下表所示。 |
[ { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Guangdong", "isp": "telecom", "qps": 10.0 }, { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Jiangsu", "isp": "unicom", "qps": 11.1 } ] |
RequestId |
string |
请求 ID。 |
A603F324-7A05-4FB3-ADF3-2563233D26CC |
Data 字段说明
名称 | 类型 | 描述 | 示例值 |
domain_name | String | 查询域名。 | example.com |
isp | String | 运营商名称。 | unicom |
location | String | 地区名称。 | qingdao |
qps | Long | 每秒访问次数。 | 40 |
bps | Long | 带宽数据。 | 100 |
http_code | Map | http_code 明细,键为状态码名称,值为状态码数量。 | {"200": 1, "304": 2, "403": 3} |
time_stp | String | 数据起始时间,键为查询数据的起始时间,日期格式按照 ISO8601 表示法,并使用 UTC 时间。 | 2022-10-20T04:00:00Z |
示例
正常返回示例
JSON
格式
{
"Data": "[\n {\n \"time_stp\": \"2018-06-05T20:00:00Z\",\n \"domain_name\": \"example.com\",\n \"location\": \"Guangdong\",\n \"isp\": \"telecom\",\n \"qps\": 10.0\n },\n {\n \"time_stp\": \"2018-06-05T20:00:00Z\",\n \"domain_name\": \"example.com\",\n \"location\": \"Jiangsu\",\n \"isp\": \"unicom\",\n \"qps\": 11.1\n }\n ]",
"RequestId": "A603F324-7A05-4FB3-ADF3-2563233D26CC"
}
错误码
HTTP status code |
错误码 |
错误信息 |
描述 |
---|---|---|---|
400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 请同时提供开始时间和结束时间。 |
400 | InvalidStartTime.Malformed | The specified StartTime parameter is invalid. | 请提供正确的开始时间格式。日期格式按照ISO8601表示法,并使用UTC时间,格式为:yyyy-MM-ddTHH:mm:ssZ。 |
400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | 请提供正确的结束时间格式。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:yyyy-MM-ddTHH:mm:ssZ。 |
400 | InvalidParameter | The specified parameter is invalid. | 参数错误 |
400 | InvalidTime.Malformed | Specified StartTime or EndTime is malformed. | 开始时间或结束时间格式错误。日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
400 | InvalidDomainName.Malformed | The specific DomainName is invalid. | 指定的域名无效。 |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支持该开始时间,请重新填写。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。