調用DescribeDomainPvData擷取加速網域名稱1小時粒度的PV頁面訪問統計,支援擷取最近90天的資料。
- 如果您不指定StartTime和EndTime,該介面返回過去24小時的資料;指定StartTime和EndTime,返回起止時間的資料。
- 單使用者調用頻率:50次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeDomainPvData |
操作介面名,系統規定參數。取值: DescribeDomainPvData 。 |
| DomainName | String | 是 | example.com |
加速網域名稱,僅支援查詢一個網域名稱。 |
| StartTime | String | 否 | 2015-11-28T00:00:00Z |
擷取資料起始時間點。日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
| EndTime | String | 否 | 2015-11-29T00:00:00Z |
擷取資料結束時間點。日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 結束時間需大於起始時間。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
|---|---|---|---|
| DataInterval | String | 3600 |
每條記錄的時間間隔,單位為秒。 |
| DomainName | String | example.com |
加速網域名稱。 |
| StartTime | String | 2015-11-28T03:00:00Z |
開始時間。 |
| EndTime | String | 2015-11-28T04:00:00Z |
結束時間。 |
| RequestId | String | BCD7D917-76F1-442F-BB75-C810DE34C761 |
請求ID。 |
| PvDataInterval | Array of UsageData |
每個時間間隔的頁面訪問次數。 |
|
| UsageData | |||
| TimeStamp | String | 2015-11-28T03:00:00Z |
時間片起始時刻。 |
| Value | String | 9292 |
詳細使用資料。 |
樣本
請求樣本
http://cdn.aliyuncs.com/?Action=DescribeDomainPvData &DomainName=example.com &StartTime=2015-11-28T00:00:00Z &EndTime=2015-11-29T00:00:00Z &<公用請求參數>
正常返回樣本
XML 格式
<DescribeDomainPvDataResponse> <DataInterval>3600</DataInterval> <RequestId>BCD7D917-76F1-442F-BB75-C810DE34C761</RequestId> <DomainName>example.com</DomainName> <EndTime>2015-11-29T00:00:00Z</EndTime> <PvDataInterval> <UsageData> <TimeStamp>2015-11-28T03:00:00Z</TimeStamp> <Value>9292</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T23:00:00Z</TimeStamp> <Value>9239</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T07:00:00Z</TimeStamp> <Value>9464</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T12:00:00Z</TimeStamp> <Value>9379</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T22:00:00Z</TimeStamp> <Value>9243</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T10:00:00Z</TimeStamp> <Value>10063</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T15:00:00Z</TimeStamp> <Value>9068</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T14:00:00Z</TimeStamp> <Value>9353</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T04:00:00Z</TimeStamp> <Value>9513</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T02:00:00Z</TimeStamp> <Value>9377</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T08:00:00Z</TimeStamp> <Value>9579</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T20:00:00Z</TimeStamp> <Value>9109</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T09:00:00Z</TimeStamp> <Value>10631</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T06:00:00Z</TimeStamp> <Value>9587</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T01:00:00Z</TimeStamp> <Value>9108</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T16:00:00Z</TimeStamp> <Value>9454</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T21:00:00Z</TimeStamp> <Value>9285</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T19:00:00Z</TimeStamp> <Value>9059</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T00:00:00Z</TimeStamp> <Value>9470</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T05:00:00Z</TimeStamp> <Value>11830</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T13:00:00Z</TimeStamp> <Value>9992</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T17:00:00Z</TimeStamp> <Value>9529</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T18:00:00Z</TimeStamp> <Value>9203</Value> </UsageData> <UsageData> <TimeStamp>2015-11-28T11:00:00Z</TimeStamp> <Value>9604</Value> </UsageData> </PvDataInterval> <StartTime>2015-11-28T00:00:00Z</StartTime> </DescribeDomainPvDataResponse>
JSON 格式
{ "DataInterval": "3600", "RequestId": "BCD7D917-76F1-442F-BB75-C810DE34C761", "DomainName": "example.com", "EndTime": "2015-11-29T00:00:00Z", "PvDataInterval": { "UsageData": [ { "TimeStamp": "2015-11-28T03:00:00Z", "Value": "9292" }, { "TimeStamp": "2015-11-28T23:00:00Z", "Value": "9239" }, { "TimeStamp": "2015-11-28T07:00:00Z", "Value": "9464" }, { "TimeStamp": "2015-11-28T12:00:00Z", "Value": "9379" }, { "TimeStamp": "2015-11-28T22:00:00Z", "Value": "9243" }, { "TimeStamp": "2015-11-28T10:00:00Z", "Value": "10063" }, { "TimeStamp": "2015-11-28T15:00:00Z", "Value": "9068" }, { "TimeStamp": "2015-11-28T14:00:00Z", "Value": "9353" }, { "TimeStamp": "2015-11-28T04:00:00Z", "Value": "9513" }, { "TimeStamp": "2015-11-28T02:00:00Z", "Value": "9377" }, { "TimeStamp": "2015-11-28T08:00:00Z", "Value": "9579" }, { "TimeStamp": "2015-11-28T20:00:00Z", "Value": "9109" }, { "TimeStamp": "2015-11-28T09:00:00Z", "Value": "10631" }, { "TimeStamp": "2015-11-28T06:00:00Z", "Value": "9587" }, { "TimeStamp": "2015-11-28T01:00:00Z", "Value": "9108" }, { "TimeStamp": "2015-11-28T16:00:00Z", "Value": "9454" }, { "TimeStamp": "2015-11-28T21:00:00Z", "Value": "9285" }, { "TimeStamp": "2015-11-28T19:00:00Z", "Value": "9059" }, { "TimeStamp": "2015-11-28T00:00:00Z", "Value": "9470" }, { "TimeStamp": "2015-11-28T05:00:00Z", "Value": "11830" }, { "TimeStamp": "2015-11-28T13:00:00Z", "Value": "9992" }, { "TimeStamp": "2015-11-28T17:00:00Z", "Value": "9529" }, { "TimeStamp": "2015-11-28T18:00:00Z", "Value": "9203" }, { "TimeStamp": "2015-11-28T11:00:00Z", "Value": "9604" } ] }, "StartTime": "2015-11-28T00: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. | 開始時間設定錯誤,請檢查更新後重試。 |
| 400 | InvalidDomainName.ValueNotSupported | The specified value of parameter DomainName only support one or empty value. | 參數DomainName可以為空白或最多1個網域名稱。 |
訪問 錯誤中心查看更多錯誤碼。