調用DescribeDomainTrafficData查詢流量資料監控資料,支援擷取最近90天的資料,單位:byte。

说明
  • 如果您不指定StartTime和EndTime,該介面返回過去24小時的資料;指定StartTime和EndTime,返回起止時間的資料。
  • 單使用者調用頻率為100次/秒。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String DescribeDomainTrafficData

系統規定參數。取值:DescribeDomainTrafficData

DomainName String example.com

加速網域名稱,多個網域名稱用半形逗號(,)分隔。

預設查詢所有加速網域名稱。

StartTime String 2015-12-10T20:00:00Z

擷取資料起始時間點。

日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。

EndTime String 2015-12-10T21:00:00Z

擷取資料結束時間點。

日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。

说明 結束時間需大於起始時間。
LocationNameEn String beijing

地區英文名,通過 DescribeCdnRegionAndIsp獲得。

預設查詢所有地區資料。

IspNameEn String unicom

電訊廠商英文名,通過 DescribeCdnRegionAndIsp獲得。

預設查詢所有電訊廠商資料。

Interval String 300

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

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

返回資料

名稱 類型 樣本值 描述
DataInterval String 300

每條記錄的時間間隔,單位:秒。

DomainName String example.com

加速網域名稱資訊。

EndTime String 2015-12-10T21:00:00Z

結束時間。

RequestId String B955107D-E658-4E77-B913-E0AC3D31693E

請求ID。

StartTime String 2015-12-10T20:00:00Z

開始時間。

TrafficDataPerInterval Array of DataModule

每個時間間隔的流量資料。

DataModule
DomesticValue String 0

中國內地流量。

HttpsDomesticValue String 0

L1節點的HTTPS流量(中國內地)。

HttpsOverseasValue String 0

L1節點的HTTPS流量(全球(不包含中國內地))。

HttpsValue String 423304182

L1節點的HTTPS總流量。

OverseasValue String 0

全球(不包含中國內地)流量。

TimeStamp String example.com

時間片起始時刻。

Value String 423304182

總流量。

樣本

請求樣本


    http(s)://cdn.aliyuncs.com/?Action=DescribeDomainTrafficData &DomainName=example.com &StartTime=2015-12-10T20:00:00Z &EndTime=2015-12-10T21:00:00Z &<公用請求參數>
   

正常返回樣本

XML 格式


    <DescribeDomainTrafficDataResponse> <DomainName>example.com</DomainName> <DataInterval>300</DataInterval> <TrafficDataPerInterval> <DataModule> <TimeStamp>2015-12-10T20:00:00Z</TimeStamp> <Value>423304182</Value> <DomesticValue>0</DomesticValue> <OverseasValue>0</OverseasValue> <HttpsValue>423304182</HttpsValue> <HttpsDomesticValue>0</HttpsDomesticValue> <HttpsOverseasValue>0</HttpsOverseasValue> </DataModule> <DataModule> <TimeStamp>2015-12-10T20:05:00Z</TimeStamp> <Value>454680793</Value> <DomesticValue>0</DomesticValue> <OverseasValue>0</OverseasValue> <HttpsValue>423304182</HttpsValue> <HttpsDomesticValue>0</HttpsDomesticValue> <HttpsOverseasValue>0</HttpsOverseasValue> </DataModule> <DataModule> <TimeStamp>2015-12-10T20:10:00Z</TimeStamp> <Value>501718342</Value> <DomesticValue>0</DomesticValue> <OverseasValue>0</OverseasValue> <HttpsValue>423304182</HttpsValue> <HttpsDomesticValue>0</HttpsDomesticValue> <HttpsOverseasValue>0</HttpsOverseasValue> </DataModule> </TrafficDataPerInterval> <RequestId>B955107D-E658-4E77-B913-E0AC3D31693E</RequestId> <StartTime>2015-12-10T20:00:00Z</StartTime> <EndTime>2015-12-10T21:00:00Z</EndTime> </DescribeDomainTrafficDataResponse>
   

JSON 格式


    { "DomainName": "example.com", "DataInterval": "300", "TrafficDataPerInterval": { "DataModule": [ { "TimeStamp": "2015-12-10T20:00:00Z", "Value": "423304182", "DomesticValue": "0", "OverseasValue": "0", "HttpsValue": "423304182", "HttpsDomesticValue": "0", "HttpsOverseasValue": "0" }, { "TimeStamp": "2015-12-10T20:05:00Z", "Value": "454680793", "DomesticValue": "0", "OverseasValue": "0", "HttpsValue": "423304182", "HttpsDomesticValue": "0", "HttpsOverseasValue": "0" }, { "TimeStamp": "2015-12-10T20:10:00Z", "Value": "501718342", "DomesticValue": "0", "OverseasValue": "0", "HttpsValue": "423304182", "HttpsDomesticValue": "0", "HttpsOverseasValue": "0" } ] }, "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E", "StartTime": "2015-12-10T20:00:00Z", "EndTime": "2015-12-10T21:00:00Z" }
   

錯誤碼

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