調用DescribeDomainSrcBpsData查詢回源頻寬資料,支援擷取最近90天的資料。
- 您擷取的回源頻寬監控資料單位:bit/second。
- 如果您不指定StartTime和EndTime,該介面返回過去24小時的資料;指定StartTime和EndTime,返回起止時間的資料。
- 您可以查詢批量網域名稱的資料,多個網域名稱用英文逗號(,)分隔。
- 單使用者調用頻率:100次/秒。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeDomainSrcBpsData |
系統規定參數。取值:DescribeDomainSrcBpsData。 |
DomainName | String | 否 | example.com |
加速網域名稱,多個網域名稱用半形逗號(,)分隔。 預設查詢所有加速網域名稱。 |
StartTime | String | 否 | 2019-12-10T20:00:00Z |
擷取資料起始時間點。 日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2019-12-10T20:30:00Z |
擷取資料結束時間點。 日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 说明
結束時間需大於起始時間。
|
Interval | String | 否 | 300 |
查詢資料的時間粒紋,單位:秒。根據您指定StartTime和EndTime兩者的時間跨度,該參數取值如下:
|
返回資料
名稱 | 類型 | 樣本值 | 描述 |
---|---|---|---|
DataInterval | String | 300 |
每條記錄的時間間隔,單位:秒。 |
DomainName | String | yourdomain.com |
加速網域名稱資訊。 |
StartTime | String | 2019-12-10T20:00:00Z |
開始時間。 |
EndTime | String | 2019-12-10T20:30:00Z |
結束時間。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
請求ID。 |
SrcBpsDataPerInterval | Array of DataModule |
每個時間間隔的回源頻寬資料。 |
|
DataModule | |||
HttpsValue | String | 10 |
Https回源頻寬。 |
TimeStamp | String | 2019-12-10T20:00:00Z |
時間片起始時刻。 |
Value | String | 500 |
詳細使用資料。 |
樣本
請求樣本
http://cdn.aliyuncs.com/?Action=DescribeDomainSrcBpsData &DomainName=example.com &StartTime=2019-12-10T20:00:00Z &EndTime=2019-12-10T20:30:00Z &<公用請求參數>
正常返回樣本
XML
格式
<DescribeDomainSrcBpsDataResponse> <SrcBpsDataPerInterval> <DataModule> <TimeStamp>2019-12-10T20:00:00Z</TimeStamp> <Value>31.709333333333337</Value> <HttpsValue>0</HttpsValue> </DataModule> <DataModule> <TimeStamp>2019-12-10T20:05:00Z</TimeStamp> <Value>31.709333333333337</Value> <HttpsValue>0</HttpsValue> </DataModule> <DataModule> <TimeStamp>2019-12-10T20:10:00Z</TimeStamp> <Value>31.709333333333337</Value> <HttpsValue>0</HttpsValue> </DataModule> <DataModule> <TimeStamp>2019-12-10T20:15:00Z</TimeStamp> <Value>31.709333333333337</Value> <HttpsValue>0</HttpsValue> </DataModule> <DataModule> <TimeStamp>2019-12-10T20:20:00Z</TimeStamp> <Value>31.709333333333337</Value> <HttpsValue>0</HttpsValue> </DataModule> <DataModule> <TimeStamp>2019-12-10T20:25:00Z</TimeStamp> <Value>43.32533333333333</Value> <HttpsValue>0</HttpsValue> </DataModule> </SrcBpsDataPerInterval> <DataInterval>300</DataInterval> <RequestId>28B4EBA6-0AF4-407A-AAC9-6BC5F8D8158B</RequestId> <EndTime>2019-12-10T20:30:00Z</EndTime> <StartTime>2019-12-10T20:00:00Z</StartTime> </DescribeDomainSrcBpsDataResponse>
JSON
格式
{ "SrcBpsDataPerInterval": { "DataModule": [ { "TimeStamp": "2019-12-10T20:00:00Z", "Value": "31.709333333333337", "HttpsValue": 0 }, { "TimeStamp": "2019-12-10T20:05:00Z", "Value": "31.709333333333337", "HttpsValue": 0 }, { "TimeStamp": "2019-12-10T20:10:00Z", "Value": "31.709333333333337", "HttpsValue": 0 }, { "TimeStamp": "2019-12-10T20:15:00Z", "Value": "31.709333333333337", "HttpsValue": 0 }, { "TimeStamp": "2019-12-10T20:20:00Z", "Value": "31.709333333333337", "HttpsValue": 0 }, { "TimeStamp": "2019-12-10T20:25:00Z", "Value": "43.32533333333333", "HttpsValue": 0 } ] }, "DataInterval": 300, "RequestId": "28B4EBA6-0AF4-407A-AAC9-6BC5F8D8158B", "EndTime": "2019-12-10T20:30:00Z", "StartTime": "2019-12-10T20: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. | 開始時間設定錯誤,請檢查更新後重試。 |
訪問 錯誤中心查看更多錯誤碼。