调用DescribeDcdnDomainMultiUsageData批量查询DCDN域名的各计量口径计费数据(最小粒度为5分钟), 不包含非请求类的计费项。
接口说明
不指定 StartTime 和 EndTime 时,默认读取过去 10 分钟的数据,同时支持按指定的起止时间查询,两者需要同时指定。
支持批量域名查询,多个域名用逗号(半角)分隔, 多个域名会分开返回。
最多可获取最近 90 天的数据。
查询时间跨度不超过 1 小时
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
dcdn:DescribeDcdnDomainMultiUsageData |
none |
*全部资源
|
无 | 无 |
请求参数
名称 |
类型 |
必填 |
描述 |
示例值 |
DomainName |
string |
否 |
若参数为空,默认返回所有加速域名分组数据。 可输入需要查询的加速域名,支持批量域名查询,多个域名用半角逗号(,)分隔。 |
example.com |
StartTime |
string |
否 |
获取数据起始时间点。
|
2017-12-10T20:00:00Z |
EndTime |
string |
否 |
结束时间需大于起始时间。
|
2017-12-10T21:00:00Z |
返回参数
名称 |
类型 |
描述 |
示例值 |
object |
|||
EndTime |
string |
结束时间。 |
2017-12-10T21:00:00Z |
StartTime |
string |
开始时间。 |
2017-12-10T20:00:00Z |
RequestId |
string |
该条任务请求 Id。 |
3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F |
RequestPerInterval |
object |
||
RequestDataModule |
array<object> |
每五分钟各请求计量数据。 |
|
object |
|||
Type |
string |
请求数类型,可以是 StaticHttps,DynamicHttps,DynamicHttp,StaticQuic,DynamicQuic 之一。 |
DynamicHttp |
TimeStamp |
string |
时间片起始时刻。 |
2017-12-10T20:00:00Z |
Domain |
string |
域名。 |
example.com |
Request |
integer |
请求数,单位个。 |
1128 |
TrafficPerInterval |
object |
||
TrafficDataModule |
array<object> |
每五分钟的各流量计量数据。 |
|
object |
|||
Type |
string |
类型,可以是 Simple,IPA,WebSocket 之一。 |
Simple |
Domain |
string |
域名。 |
example.com |
TimeStamp |
string |
时间片起始时刻。 |
2017-12-10T20:00:00Z |
Area |
string |
大区名称。 |
CN |
Bps |
number |
BPS 数据值,单位:bit/second |
11288111.1 |
示例
正常返回示例
JSON
格式
{
"EndTime": "2017-12-10T21:00:00Z",
"StartTime": "2017-12-10T20:00:00Z",
"RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
"RequestPerInterval": {
"RequestDataModule": [
{
"Type": "DynamicHttp",
"TimeStamp": "2017-12-10T20:00:00Z",
"Domain": "example.com",
"Request": 1128
}
]
},
"TrafficPerInterval": {
"TrafficDataModule": [
{
"Type": "Simple",
"Domain": "example.com",
"TimeStamp": "2017-12-10T20:00:00Z",
"Area": "CN",
"Bps": 11288111.1
}
]
}
}
错误码
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 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | 结束时间早于开始时间,请检查。 |
400 | InvalidTimeSpan | The time span exceeds the limit. | 时间跨度超过限制,请参照接口文档,配置合理查询跨度。 |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支持该开始时间,请重新填写。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。