調用DescribeDomainsUsageByDay查詢加速網域名稱天粒度的監控統計資料,支援擷取最近90天的資料。
- 如果您不指定StartTime和EndTime時,預設讀取過去24小時的資料;指定StartTime和EndTime時,按指定的起止時間查詢。
- 您只能查詢單個網域名稱或目前使用者下所有網域名稱的資料。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
請求參數
名稱 | 類型 | 是否必選 | 樣本值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeDomainsUsageByDay |
系統規定參數。取值:DescribeDomainsUsageByDay。 |
DomainName | String | 否 | example.com |
加速網域名稱,只支援填寫一個網域名稱。 預設查詢目前使用者下所有網域名稱。 |
StartTime | String | 否 | 2019-12-22T08:00:00Z |
擷取資料起始時間點。日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2019-12-23T09:00:00Z |
擷取資料結束時間點。日期格式按照ISO8601標記法,並使用UTC時間,格式為yyyy-MM-ddTHH:mm:ssZ。 说明
結束時間需大於起始時間。
|
返回資料
名稱 | 類型 | 樣本值 | 描述 |
---|---|---|---|
RequestId | String | C88EF8ED-72F0-45EA-9E86-95114E224FC5 |
請求ID。 |
DomainName | String | example.com |
加速網域名稱資訊。 |
DataInterval | String | 86400 |
每條記錄的時間間隔,單位:秒。 |
StartTime | String | 2019-12-22T08:00:00Z |
開始時間。 |
EndTime | String | 2019-12-23T09:00:00Z |
結束時間。 |
UsageByDays | Array of UsageByDay |
每個時間間隔統計資料。 |
|
UsageByDay | |||
BytesHitRate | String | 97.46250599529726 |
位元組命中率(百分比資料)。 |
TimeStamp | String | 2019-12-22 |
查詢資料的時間片起始時刻。 |
Qps | String | 7.466354166666667 |
每秒訪問量(次/秒)。 |
RequestHitRate | String | 70.24770071912111 |
請求命中率(百分比資料)。 |
MaxBps | String | 306747.76 |
頻寬峰值,單位:bps。 |
MaxBpsTime | String | 2019-12-23 10:55:00 |
頻寬峰值時刻。 |
MaxSrcBps | String | 72584.072 |
回源頻寬峰值,單位:bps。 |
TotalAccess | String | 645093 |
總訪問量。 |
MaxSrcBpsTime | String | 2019-12-23 11:45:00 |
回源頻寬峰值時刻。 |
TotalTraffic | String | 564300099309 |
總流量,單位:Byte。 |
UsageTotal | Struct |
摘要資料。 |
|
BytesHitRate | String | 97.03110726801242 |
位元組命中率(百分比資料)。 |
RequestHitRate | String | 69.92610837438424 |
請求命中率(百分比資料)。 |
MaxBps | String | 1.0747912780000001E8 |
頻寬峰值,單位:bps。 |
MaxBpsTime | String | 2019-12-23 10:55:00 |
頻寬峰值時刻。 |
MaxSrcBps | String | 72584.072 |
回源頻寬峰值,單位:bps。 |
TotalAccess | String | 1319500 |
總訪問量。 |
MaxSrcBpsTime | String | 2019-12-23 11:45:00 |
回源頻寬峰值時刻。 |
TotalTraffic | String | 1117711832100 |
總流量,單位:Byte。 |
樣本
請求樣本
http://cdn.aliyuncs.com/?Action=DescribeDomainsUsageByDay &DomainName=example.com &StartTime=2019-12-22T08:00:00Z &EndTime=2019-12-23T09:00:00Z &<公用請求參數>
正常返回樣本
XML
格式
<DescribeDomainsUsageByDayResponse> <UsageTotal> <RequestHitRate>0.46869615163699024</RequestHitRate> <MaxSrcBpsTime>2019-12-23 11:45:00</MaxSrcBpsTime> <MaxSrcBps>72584.072</MaxSrcBps> <MaxBps>306747.76</MaxBps> <TotalTraffic>220090843</TotalTraffic> <TotalAccess>1741</TotalAccess> <MaxBpsTime>2019-12-23 10:55:00</MaxBpsTime> <BytesHitRate>0.9338625414779297</BytesHitRate> </UsageTotal> <UsageByDays> <UsageByDay> <TimeStamp>2019-12-23</TimeStamp> <RequestHitRate>0.46869615163699024</RequestHitRate> <MaxSrcBpsTime>2019-12-23 11:45:00</MaxSrcBpsTime> <MaxSrcBps>72584.072</MaxSrcBps> <MaxBps>306747.76</MaxBps> <TotalTraffic>220090843</TotalTraffic> <TotalAccess>1741</TotalAccess> <MaxBpsTime>2019-12-23 10:55:00</MaxBpsTime> <Qps>0.020150462962962964</Qps> <BytesHitRate>0.9338625398107486</BytesHitRate> </UsageByDay> </UsageByDays> <RequestId>0DE5531F-A7C2-4788-A35A-38883193B2D8</RequestId> <EndTime>2019-12-23T09:00:00Z</EndTime> <StartTime>2019-12-22T08:00:00Z</StartTime> <DomainName>example.com</DomainName> <DataInterval>86400</DataInterval> </DescribeDomainsUsageByDayResponse>
JSON
格式
{ "UsageTotal": { "RequestHitRate": "0.46869615163699024", "MaxSrcBpsTime": "2019-12-23 11:45:00", "MaxSrcBps": 72584.072, "MaxBps": 306747.76, "TotalTraffic": 220090843, "TotalAccess": 1741, "MaxBpsTime": "2019-12-23 10:55:00", "BytesHitRate": "0.9338625414779297" }, "UsageByDays": { "UsageByDay": [ { "TimeStamp": "2019-12-23", "RequestHitRate": "0.46869615163699024", "MaxSrcBpsTime": "2019-12-23 11:45:00", "MaxSrcBps": 72584.072, "MaxBps": 306747.76, "TotalTraffic": 220090843, "TotalAccess": 1741, "MaxBpsTime": "2019-12-23 10:55:00", "Qps": "0.020150462962962964", "BytesHitRate": "0.9338625398107486" } ] }, "RequestId": "0DE5531F-A7C2-4788-A35A-38883193B2D8", "EndTime": "2019-12-23T09:00:00Z", "StartTime": "2019-12-22T08:00:00Z", "DomainName":"example.com", "DataInterval":86400 }
錯誤碼
HttpCode | 錯誤碼 | 錯誤資訊 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 結束時間格式錯誤。日期格式請參考所調用API的協助文檔說明。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 開始時間設定錯誤,請檢查更新後重試。 |
404 | InvalidDomain.NotFound | The domain provided does not exist in our records. | 網域名稱不存在或不屬於目前使用者。請檢查您填寫的網域名稱書寫是否正確,或者網域名稱是否在當前帳號中,查看網域名稱是否到期。 |
訪問 錯誤中心查看更多錯誤碼。