调用DescribeDcdnTopDomainsByFlow查询用户按流量排名的域名，支持获取最近90天的数据。
接口说明
不指定 StartTime 和 EndTime 时，默认读取当月的数据；指定 StartTime 和 EndTime 时，按指定的起止时间查询。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dcdn:DescribeDcdnTopDomainsByFlow |
none |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| StartTime |
string |
否 |
获取数据起始时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。 |
2016-03-01T04:00:00Z |
| EndTime |
string |
否 |
获取数据结束时间点。日期格式按照 ISO8601 表示法，并使用 UTC 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。 结束时间需大于起始时间。 |
2016-03-14T07:34:00Z |
| Limit |
integer |
否 |
域名获取数量限制，默认为 20，取值支持 1~100。 |
20 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| DomainOnlineCount |
integer |
账户下正在运行域名总数。 |
68 |
| EndTime |
string |
结束时间。 |
2016-03-14T07:34:00Z |
| StartTime |
string |
开始时间。 |
2016-03-14T06:34:00Z |
| RequestId |
string |
请求 ID。 |
4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70 |
| DomainCount |
integer |
账户下域名总数。 |
68 |
| TopDomains |
object |
||
| TopDomain |
array<object> |
排名域名列表。 |
|
|
object |
|||
| MaxBps |
integer |
带宽峰值。 |
22139626 |
| Rank |
integer |
排名。 |
1 |
| TotalAccess |
integer |
访问次数。 |
3 |
| TrafficPercent |
string |
流量占比。 |
21.686305274906182 |
| DomainName |
string |
域名。 |
example.com |
| TotalTraffic |
string |
总流量。 |
123 |
| MaxBpsTime |
string |
带宽峰值时刻，使用 ISO8601 表示法，并使用 UTC 时间。 |
2018-11-01T08:10:00Z |
示例
正常返回示例
JSON格式
{
"DomainOnlineCount": 68,
"EndTime": "2016-03-14T07:34:00Z",
"StartTime": "2016-03-14T06:34:00Z",
"RequestId": "4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70",
"DomainCount": 68,
"TopDomains": {
"TopDomain": [
{
"MaxBps": 22139626,
"Rank": 1,
"TotalAccess": 3,
"TrafficPercent": "21.686305274906182",
"DomainName": "example.com",
"TotalTraffic": "123",
"MaxBpsTime": "2018-11-01T08:10:00Z"
}
]
}
}错误码
|
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 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支持该开始时间，请重新填写。 |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。