調用DescribeDomainUvData擷取加速網域名稱1小時粒度的UV頁面獨立訪問統計，支援擷取最近90天的資料。

調用該介面前，請您注意：
  • 如果您不指定StartTime和EndTime，該介面返回過去24小時的資料；指定StartTime和EndTime，返回起止時間的資料。
  • 您只可以查詢一個網域名稱或目前使用者下所有網域名稱的資料。
  • 單使用者調用頻率：100次/秒。

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

請求參數

名稱 類型 是否必選 樣本值 描述
Action String 是 DescribeDomainUvData

操作介面名，系統規定參數。取值： DescribeDomainUvData 。

DomainName String 是 example.com

加速網域名稱，僅支援查詢一個網域名稱。
StartTime String 否 2019-11-29T00:00:00Z

擷取資料起始時間點。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。
EndTime String 否 2019-11-29T04:00:00Z

擷取資料結束時間點。日期格式按照ISO8601標記法，並使用UTC時間，格式為yyyy-MM-ddTHH:mm:ssZ。

結束時間需大於起始時間。

返回資料

名稱 類型 樣本值 描述
DataInterval String 3600

時間間隔，單位：秒。
DomainName String example.com

加速網域名稱。
EndTime String 2019-11-29T04:00:00Z

擷取資料結束時間點。
RequestId String E9D3257A-1B7C-414C-90C1-8D07AC47BCAC

請求ID。
StartTime String 2019-11-29T00:00:00Z

擷取資料起始時間點。
UvDataInterval Array of UsageData

每個時間間隔的頁面獨立訪問次數。
UsageData
TimeStamp String 2019-11-29T00:00:00Z

時間片起始時刻。
Value String 318

詳細使用資料。

樣本

請求樣本


    http://cdn.aliyuncs.com/?Action=DescribeDomainUvData &DomainName=example.com &StartTime=2019-11-29T00:00:00Z &EndTime=2019-11-29T04:00:00Z &<公用請求參數>

正常返回樣本

XML 格式 


    <DescribeDomainUvDataResponse> <DataInterval>3600</DataInterval> <RequestId>17276F0E-66F4-4547-B9C6-42E2547362D4</RequestId> <DomainName>example.com</DomainName> <EndTime>2019-11-29T04:00:00Z</EndTime> <StartTime>2019-11-29T00:00:00Z</StartTime> <UvDataInterval> <UsageData> <TimeStamp>2019-11-29T00:00:00Z</TimeStamp> <Value>2</Value> </UsageData> <UsageData> <TimeStamp>2019-11-29T01:00:00Z</TimeStamp> <Value>12</Value> </UsageData> <UsageData> <TimeStamp>2019-11-29T02:00:00Z</TimeStamp> <Value>6</Value> </UsageData> <UsageData> <TimeStamp>2019-11-29T03:00:00Z</TimeStamp> <Value>7</Value> </UsageData> <UsageData> <TimeStamp>2019-11-29T04:00:00Z</TimeStamp> <Value>5</Value> </UsageData> </UvDataInterval> </DescribeDomainUvDataResponse>

JSON 格式 


    { "DataInterval": "3600", "RequestId": "17276F0E-66F4-4547-B9C6-42E2547362D4", "DomainName": "example.com", "EndTime": "2019-11-29T04:00:00Z", "StartTime": "2019-11-29T00:00:00Z", "UvDataInterval": { "UsageData": [ { "TimeStamp": "2019-11-29T00:00:00Z", "Value": "2" }, { "TimeStamp": "2019-11-29T01:00:00Z", "Value": "12" }, { "TimeStamp": "2019-11-29T02:00:00Z", "Value": "6" }, { "TimeStamp": "2019-11-29T03:00:00Z", "Value": "7" }, { "TimeStamp": "2019-11-29T04:00:00Z", "Value": "5" } ] } }

錯誤碼

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 InvalidDomainName.ValueNotSupported The specified value of parameter DomainName only support one or empty value. 參數DomainName可以為空白或最多1個網域名稱。
400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. 開始時間設定錯誤，請檢查更新後重試。

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