調用DescribeDomainBpsDataByLayer按協議分類擷取頻寬資料。
- 不指定StartTime和EndTime時,預設讀取過去24小時的資料;同時支援按指定的起止時間查詢,StartTime和EndTime兩者需要同時指定。
- 歷史資料保留時間(僅供參考):五分鐘粒度的資料保留時間為62天,小時粒度的資料保留時間為120天,天粒度的資料保留時間為366天。
- 單使用者調用頻率為20次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDomainBpsDataByLayer |
系統規定參數。取值: DescribeDomainBpsDataByLayer。 |
DomainName | String | 否 | example.com |
需要查詢的加速網域名稱,多個網域名稱用半形逗號(,)分隔。 说明
不傳該參數,預設返回所有加速網域名稱合并後的資料。
|
StartTime | String | 否 | 2020-05-06T07:10:00Z |
擷取資料的起始時間點。 日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2020-05-06T07:20:00Z |
擷取資料的結束時間點。 日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 说明
結束時間需大於起始時間。
|
Interval | String | 否 | 300 |
查詢資料的時間粒紋,單位為秒。根據您指定StartTime和EndTime兩者的時間跨度,該參數的取值如下:
|
IspNameEn | String | 否 | unicom |
電訊廠商英文名。通過 DescribeCdnRegionAndIsp介面獲得,預設查詢所有電訊廠商。 |
LocationNameEn | String | 否 | beijing |
地區英文名。通過 DescribeCdnRegionAndIsp介面獲得,預設查詢所有地區。 |
Layer | String | 否 | IPv4 |
查詢維度。
預設值為all。 |
返回資料
名稱 | 類型 | 樣本值 | 描述 |
---|---|---|---|
BpsDataInterval | Array of DataModule |
每個時間間隔的每秒訪問次數Bps。 |
|
DataModule | |||
TimeStamp | String | 2020-05-06T07:10:00Z |
時間片起始時刻。 |
TrafficValue | String | 2838 |
總流量,單位:Byte。 |
Value | String | 75.68 |
峰值頻寬,單位:bps。 |
DataInterval | String | 300 |
每條記錄的時間間隔,單位為秒。 |
RequestId | String | C565B910-BC3B-467B-9046-2A48566EA967 |
請求ID。 |
樣本
請求樣本
http(s)://cdn.aliyuncs.com/?Action=DescribeDomainBpsDataByLayer &DomainName=example.com &StartTime=2020-05-06T07:10:00Z &EndTime=2020-05-06T07:20:00Z &<公用請求參數>
正常返回樣本
XML
格式
<DescribeDomainBpsDataByLayerResponse> <RequestId>C565B910-BC3B-467B-9046-2A48566EA967</RequestId> <DataInterval>300</DataInterval> <BpsDataInterval> <DataModule> <Value>75.68</Value> <TrafficValue>2838</TrafficValue> <TimeStamp>2020-05-06T07:10:00Z</TimeStamp> </DataModule> <DataModule> <Value>99138.85333333333</Value> <TrafficValue>3717707</TrafficValue> <TimeStamp>2020-05-06T07:15:00Z</TimeStamp> </DataModule> </BpsDataInterval> </DescribeDomainBpsDataByLayerResponse>
JSON
格式
{ "RequestId": "C565B910-BC3B-467B-9046-2A48566EA967", "DataInterval": 300, "BpsDataInterval": { "DataModule": [ { "Value": 75.68, "TrafficValue": 2838, "TimeStamp": "2020-05-06T07:10:00Z" }, { "Value": "99138.85333333333", "TrafficValue": 3717707, "TimeStamp": "2020-05-06T07:15:00Z" } ] } }
錯誤碼
訪問 錯誤中心查看更多錯誤碼。