DescribeTopDomainsByFlow

Last Updated: Apr 16, 2018

Description

  • Obtain the domain names that are ranked by traffic.

  • When StartTime and EndTime are not specified, the interface reads data from the past month by default. Query by specified start time and end time is also supported. The two parameters must be both specified.

  • Data from the past 90 days can be obtained at most.

Request parameters

Parameters Type Required Example values Description
Action String Yes DescribeTopDomainsByFlow

The name of this interface. Value: DescribeTopDomainsByFlow

EndTime String No 2017-12-22T08:00:00:00Z

  • The end time must be later than the start time.
  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mmZ.

Limit Long No 20

Limit on the number of obtained domain names.
Value range: 1~100
Default value: 20

StartTime String No 2017-12-21T08:00:00:00Z

  • Start time of data query.
  • The date format adopts ISO8601 notation and uses the UTC time.
  • Format: YYYY-MM-DDThh:mmZ.
  • Minimum data granularity: 5 minutes.
  • If this parameter is left blank, the interface reads data from the current month by default.

Return parameters

Parameters Type Example values Description
RequestId String 4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70

The ID of the request.

StartTime String 2016-03-01T04:00Z

Start time.

EndTime String 2016-03-14T07:34Z

End time.

TopDomains

List of ranked domain names.

  └DomainName String test.test.com

Domain name.

  └Rank Long 1

Ranking.

  └TotalTraffic String 2043859876683.9001

Total traffic.

  └TrafficPercent String 30.64191989360235

Traffic proportion.

  └MaxBps Long 22139626

Peak bandwidth.

  └MaxBpsTime String 1457111400

Peak bandwidth time.

  └TotalAccess Long 107784230

Times of access.

DomainCount Long 68

Total number of domain names under the account.

DomainOnlineCount Long 68

Total number of running domain names under the account.

Example

Request example

  1. http://cdn.aliyuncs.com?Action=DescribeTopDomainsByFlow
  2. &StartTime=2015-11-29
  3. &EndTime=2015-11-30
  4. &Limit=5
  5. &<public request parameter>

Normal return example

JSON format

  1. {
  2. "DomainCount":68,
  3. "DomainOnlineCount":68,
  4. "EndTime":"2016-03-14T07:34Z",
  5. "RequestId":"4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70",
  6. "StartTime":"2016-03-01T04:00Z",
  7. "TopDomains":{
  8. "TopDomain":[
  9. {
  10. "DomainName":"cedexis.j0zz.com",
  11. "MaxBps":22139626,
  12. "MaxBpsTime":1457111400,
  13. "Rank":1,
  14. "TotalAccess":107784230,
  15. "TotalTraffic":2043859876683.9001,
  16. "TrafficPercent":30.64191989360235
  17. },
  18. {
  19. "DomainName":"wj.cdnpe.com",
  20. "MaxBps":1008772351,
  21. "MaxBpsTime":1457505600,
  22. "Rank":2,
  23. "TotalAccess":3843128,
  24. "TotalTraffic":1729970466149.2002,
  25. "TrafficPercent":25.936032624725815
  26. },
  27. {
  28. "DomainName":"imgtest.cdnpe.com",
  29. "MaxBps":16046911,
  30. "MaxBpsTime":1456897200,
  31. "Rank":3,
  32. "TotalAccess":547567,
  33. "TotalTraffic":1446507574551.6,
  34. "TrafficPercent":21.686305274906182
  35. },
  36. {
  37. "DomainName":"downtest.cdnpe.com",
  38. "MaxBps":15990893,
  39. "MaxBpsTime":1457567700,
  40. "Rank":4,
  41. "TotalAccess":548380,
  42. "TotalTraffic":1418144519687.5,
  43. "TrafficPercent":21.261081185428147
  44. },
  45. {
  46. "DomainName":"ali.ddimg.cn",
  47. "MaxBps":473599,
  48. "MaxBpsTime":1457845800,
  49. "Rank":5,
  50. "TotalAccess":152150,
  51. "TotalTraffic":28739937242.500004,
  52. "TrafficPercent":0.4308743788055894
  53. }
  54. ]
  55. }
  56. }

Exception return example

JSON format

  1. {
  2. "Code":"InternalError",
  3. "HostId":"cdn.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

Error code

For more information, see Error code of this product.

Thank you! We've received your feedback.