調用DescribeTopDomainsByFlow擷取使用者按流量排名的網域名稱，支援擷取最近30天的資料。
说明
- 如果您不指定 StartTime 和 EndTime ，該介面返回當月資料；指定 StartTime 和 EndTime ，返回起止時間的資料。
- 單使用者調用頻率：100次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeTopDomainsByFlow |
系統規定參數。取值： DescribeTopDomainsByFlow 。 |
| StartTime | String | 否 | 2019-12-22T08:00:00Z |
擷取資料的起始時間點。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。 说明 StartTime必須設定為北京時間0點對應的UTC時間，例如：北京時間06月01日0點，需要設定為UTC時間“2021-05-31T16:00:00Z”。
|
| EndTime | String | 否 | 2019-12-23T08:00:00Z |
擷取資料的結束時間點。日期格式按照ISO8601標記法，並使用UTC時間。格式為yyyy-MM-ddTHH:mm:ssZ。 说明 結束時間需大於起始時間。
|
| Limit | Long | 否 | 20 |
網域名稱擷取數量限制，預設為 20 ，取值 1 ~ 100 。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
|---|---|---|---|
| RequestId | String | 4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70 |
請求ID。 |
| StartTime | String | 2019-12-22T08:00:00Z |
開始時間。 |
| EndTime | String | 2019-12-23T08:00:00Z |
結束時間。 |
| TopDomains | Array of TopDomain |
排名網域名稱列表。 |
|
| TopDomain | |||
| DomainName | String | example.com |
加速網域名稱。 |
| Rank | Long | 1 |
排名。 |
| TotalTraffic | String | 2043859876683.9001 |
總流量。 |
| TrafficPercent | String | 30.64191989360235 |
流量佔比。 |
| MaxBps | Float | 22139626 |
頻寬峰值。 |
| MaxBpsTime | String | 1457111400 |
頻寬峰值時刻。 |
| TotalAccess | Long | 107784230 |
訪問次數。 |
| DomainCount | Long | 68 |
帳號下的網域名稱總數。 |
| DomainOnlineCount | Long | 68 |
帳號下狀態為 正在運行 的網域名稱總數。 |
樣本
請求樣本
http(s)://cdn.aliyuncs.com/?Action=DescribeTopDomainsByFlow &StartTime=2019-12-22T08:00:00Z &EndTime=2019-12-23T08:00:00Z &Limit=5 &<公用請求參數>
正常返回樣本
XML 格式
<DescribeTopDomainsByFlowResponse> <DomainCount>4</DomainCount> <DomainOnlineCount>4</DomainOnlineCount> <RequestId>6796A2B4-15A7-4142-85C0-5A93406034B5</RequestId> <TopDomains> <TopDomain> <MaxBps>26.752000000000002</MaxBps> <Rank>3</Rank> <TrafficPercent>0.000910078753253719</TrafficPercent> <TotalTraffic>2003</TotalTraffic> <TotalAccess>2</TotalAccess> <DomainName>example.com</DomainName> <MaxBpsTime>2019-12-22T20:50:00Z</MaxBpsTime> </TopDomain> </TopDomains> <EndTime>2019-12-23T08:00:00Z</EndTime> <StartTime>2019-12-22T08:00:00Z</StartTime> </DescribeTopDomainsByFlowResponse>
JSON 格式
{ "DomainCount": 4, "DomainOnlineCount": 4, "RequestId": "6796A2B4-15A7-4142-85C0-5A93406034B5", "TopDomains": { "TopDomain": [ { "MaxBps": "26.752000000000002", "Rank": 3, "TrafficPercent": "0.000910078753253719", "TotalTraffic": 2003, "TotalAccess": 2, "DomainName": "example.com", "MaxBpsTime": "2019-12-22T20:50:00Z" } ] }, "EndTime": "2019-12-23T08:00:00Z", "StartTime": "2019-12-22T08:00:00Z" }
錯誤碼
| HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
| 400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 開始時間設定錯誤，請檢查更新後重試。 |
訪問 錯誤中心查看更多錯誤碼。