查詢回源流量資料 -

说明

如果您不指定StartTime和EndTime，該介面返回過去24小時的資料；指定StartTime和EndTime，返回起止時間的資料。
您可以查詢批量網域名稱的資料，多個網域名稱用半形逗號（,）分隔。
單使用者調用頻率：100次/秒。

調試

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

請求參數


名稱	類型	是否必選	樣本值	描述
Action	String	否	DescribeDomainSrcTrafficData	系統規定參數，取值：DescribeDomainSrcTrafficData。
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。说明結束時間需大於起始時間。
Interval	String	否	300	查詢資料的時間粒紋，單位：秒。根據您指定StartTime和EndTime兩者的時間跨度，該參數取值如下： 3天以內（不包含3天整）支援300、3600、 86400，如果不傳該參數，預設值為300。 3-31天（不包含31天整）支援3600和86400，如果不傳該參數，預設值為3600。 31天及以上支援86400，如果不傳該參數，預設值為86400。

返回資料


名稱	類型	樣本值	描述
DataInterval	String	300	每條記錄的時間間隔，單位：秒。
DomainName	String	example.com	加速網域名稱資訊。
StartTime	String	2015-12-10T20:00:00Z	開始時間。
EndTime	String	2015-12-10T21:00:00Z	結束時間。
RequestId	String	A666D44F-19D6-490E-97CF-1A64AB962C57	請求ID。
SrcTrafficDataPerInterval	Array of DataModule		每個時間間隔的回源流量資料。
DataModule
HttpsValue	String	0	Https回源流量。
TimeStamp	String	2015-12-10T20:35:00Z	時間片起始時刻。
Value	String	0	詳細使用資料。

樣本

請求樣本

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

正常返回樣本

XML格式

<DescribeDomainSrcTrafficDataResponse>
      <DomainName>example.com</DomainName>
      <DataInterval>300</DataInterval>
      <SrcFlowDataPerInterval>
            <DataModule>
                  <TimeStamp>2015-12-10T21:00:00Z</TimeStamp>
                  <Value>0</Value>
                  <HttpsValue>0</HttpsValue>
            </DataModule>
            <DataModule>
                  <TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
                  <Value>0</Value>
                  <HttpsValue>0</HttpsValue>
            </DataModule>
      </SrcFlowDataPerInterval>
      <RequestId>A666D44F-19D6-490E-97CF-1A64AB962C57</RequestId>
      <StartTime>2015-12-10T20:00:00Z</StartTime>
      <EndTime>2015-12-10T21:00:00Z</EndTime>
</DescribeDomainSrcTrafficDataResponse>

JSON格式

{
    "DomainName": "example.com",
    "DataInterval": "300",
    "SrcFlowDataPerInterval": {
        "DataModule": [
            {
                "TimeStamp": "2015-12-10T21:00:00Z",
                "Value": "0",
                "HttpsValue": "0"
            },
            {
                "TimeStamp": "2015-12-10T20:35:00Z",
                "Value": "0",
                "HttpsValue": "0"
            }
        ]
    },
    "RequestId": "A666D44F-19D6-490E-97CF-1A64AB962C57",
    "StartTime": "2015-12-10T20:00:00Z",
    "EndTime": "2015-12-10T21:00:00Z"
}

錯誤碼


HttpCode	錯誤碼	錯誤資訊	描述
400	MissingParameter	StartTime and EndTime can not be single.	開始時間與結束時間均為必填。
400	InvalidStartTime.Malformed	Specified StartTime is malformed.	起始時間格式錯誤。日期格式請參考所調用API的協助文檔說明。
400	InvalidEndTime.Malformed	Specified EndTime is malformed.	結束時間格式錯誤。日期格式請參考所調用API的協助文檔說明。
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.	請檢查時間設定是否正確，結束時間不能小於或等於開始時間。
400	InvalidStartTime.ValueNotSupported	The specified value of parameter StartTime is not supported.	開始時間設定錯誤，請檢查更新後重試。

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