調用DescribeDomainBpsDataByLayer按協議分類擷取頻寬資料。

说明
  • 不指定StartTimeEndTime時,預設讀取過去24小時的資料;同時支援按指定的起止時間查詢,StartTimeEndTime兩者需要同時指定。
  • 歷史資料保留時間(僅供參考):五分鐘粒度的資料保留時間為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

查詢資料的時間粒紋,單位為秒。根據您指定StartTimeEndTime兩者的時間跨度,該參數的取值如下:

  • 3天以內(不含3天整):支援300360086400。如果不傳該參數,預設值為300
  • 3~31天(不含31天整):支援360086400。如果不傳該參數,預設值為3600
  • 31天及以上:支援86400。如果不傳該參數,預設值為86400
IspNameEn String unicom

電訊廠商英文名。通過 DescribeCdnRegionAndIsp介面獲得,預設查詢所有電訊廠商。

LocationNameEn String beijing

地區英文名。通過 DescribeCdnRegionAndIsp介面獲得,預設查詢所有地區。

Layer String IPv4

查詢維度。

  • 網路層:IPv4IPv6
  • 應用程式層:httphttpsquic
  • all:包含網路層和應用程式層。

預設值為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" } ] } }
   

錯誤碼

訪問 錯誤中心查看更多錯誤碼。