調用DescribeDomainFileSizeProportionData擷取加速網域名稱1小時粒度的檔案大小佔比統計,支援擷取最近90天的資料。
- 如果您不指定StartTime和EndTime時,該介面返回過去24小時的資料;指定StartTime和EndTime時,返回起止時間的資料。
- 單使用者調用頻率:10次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
| 名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | DescribeDomainFileSizeProportionData |
操作介面名,系統規定參數。取值:DescribeDomainFileSizeProportionData。 |
| DomainName | String | 是 | example.com |
加速網域名稱,僅支援查詢單個網域名稱。 |
| StartTime | String | 否 | 2019-12-31T01:00:00Z |
擷取資料起始時間點,日期格式按照ISO8601標記法,並使用UTC時間。格式為yyyy-MM-ddTHH:mm:ssZ。 |
| EndTime | String | 否 | 2019-12-31T02:00:00Z |
擷取資料結束時間點。日期格式按照ISO8601標記法,並使用UTC時間。格式為yyyy-MM-ddTHH:mm:ssZ。 結束時間需大於起始時間。 |
返回資料
| 名稱 | 類型 | 樣本值 | 描述 |
|---|---|---|---|
| DataInterval | String | 3600 |
每條記錄的時間間隔,單位為秒。 |
| DomainName | String | example.com |
加速網域名稱。 |
| StartTime | String | 2019-12-31T01:00:00Z |
擷取資料起始時間點。 |
| EndTime | String | 2019-12-31T02:00:00Z |
擷取資料結束時間點。 |
| RequestId | String | 23ACE7E2-2302-42E3-98F8-E5E697FD86C3 |
請求ID。 |
| FileSizeProportionDataInterval | Array of UsageData |
每個時間間隔的每秒訪問資料。 |
|
| UsageData | |||
| TimeStamp | String | 2019-12-31T01:00:00Z |
時間片起始時刻。 |
| Value | Array of FileSizeProportionData |
各檔案大小佔比資料列表。 |
|
| FileSizeProportionData | |||
| FileSize | String | <50K |
檔案大小類型。 |
| Proportion | String | 0.01 |
佔比使用資料。 |
樣本
請求樣本
http://cdn.aliyuncs.com/?Action=DescribeDomainFileSizeProportionData &DomainName=example.com &StartTime=2019-12-31T01:00:00Z &EndTime=2019-12-31T02:00:00Z &<公用請求參數>
正常返回樣本
XML
格式
<DescribeDomainFileSizeProportionDataResponse> <DataInterval>3600</DataInterval> <RequestId>2609901D-9AE1-43A4-83C7-75AC76A7FAB3</RequestId> <FileSizeProportionDataInterval> <UsageData> <TimeStamp>2019-12-31T01:00:00Z</TimeStamp> <Value> <FileSizeProportionData> <FileSize><5K</FileSize> <Proportion>56.71</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><10K</FileSize> <Proportion>14.17</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><20K</FileSize> <Proportion>7.46</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><50K</FileSize> <Proportion>3.73</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><100K</FileSize> <Proportion>2.98</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><1M</FileSize> <Proportion>7.46</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize>>1M</FileSize> <Proportion>7.46</Proportion> </FileSizeProportionData> </Value> </UsageData> <UsageData> <TimeStamp>2019-12-31T02:00:00Z</TimeStamp> <Value> <FileSizeProportionData> <FileSize><5K</FileSize> <Proportion>61.11</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><10K</FileSize> <Proportion>14.44</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><20K</FileSize> <Proportion>7.77</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><50K</FileSize> <Proportion>2.22</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><100K</FileSize> <Proportion>2.22</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize><1M</FileSize> <Proportion>6.66</Proportion> </FileSizeProportionData> <FileSizeProportionData> <FileSize>>1M</FileSize> <Proportion>5.55</Proportion> </FileSizeProportionData> </Value> </UsageData> </FileSizeProportionDataInterval> <DomainName>example.com</DomainName> <EndTime>2019-12-31T02:00:00Z</EndTime> <StartTime>2019-12-31T01:00:00Z</StartTime> </DescribeDomainFileSizeProportionDataResponse>
JSON
格式
{ "DataInterval": "3600", "RequestId": "2609901D-9AE1-43A4-83C7-75AC76A7FAB3", "FileSizeProportionDataInterval": { "UsageData": [ { "TimeStamp": "2019-12-31T01:00:00Z", "Value": { "FileSizeProportionData": [ { "FileSize": "<5K", "Proportion": "56.71" }, { "FileSize": "<10K", "Proportion": "14.17" }, { "FileSize": "<20K", "Proportion": "7.46" }, { "FileSize": "<50K", "Proportion": "3.73" }, { "FileSize": "<100K", "Proportion": "2.98" }, { "FileSize": "<1M", "Proportion": "7.46" }, { "FileSize": ">1M", "Proportion": "7.46" } ] } }, { "TimeStamp": "2019-12-31T02:00:00Z", "Value": { "FileSizeProportionData": [ { "FileSize": "<5K", "Proportion": "61.11" }, { "FileSize": "<10K", "Proportion": "14.44" }, { "FileSize": "<20K", "Proportion": "7.77" }, { "FileSize": "<50K", "Proportion": "2.22" }, { "FileSize": "<100K", "Proportion": "2.22" }, { "FileSize": "<1M", "Proportion": "6.66" }, { "FileSize": ">1M", "Proportion": "5.55" } ] } } ] }, "DomainName": "example.com", "EndTime": "2019-12-31T02:00:00Z", "StartTime": "2019-12-31T01: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 EndTime 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個網域名稱。 |
訪問 錯誤中心查看更多錯誤碼。