調用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. 網域名稱不存在或不屬於目前使用者。請檢查您填寫的網域名稱書寫是否正確,或者網域名稱是否在當前帳號中,查看網域名稱是否到期。

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