閱讀140 返回首頁    go 搜狐

查詢UV數據__資源監控接口_API 手冊_CDN-阿裏雲

描述

獲取加速域名最小1小時粒度的 UV頁麵獨立訪問統計

不指定StartTime和EndTime時，默認讀取過去24小時的數據，同時支持按指定的起止時間查詢，兩者需要同時指定。

  • 隻支持一個域名，或當前用戶下所有域名
  • 最多可獲取最近90天的數據

請求參數

參數 類型 必要 描述
Action String 是 操作接口名，係統規定參數
取值：DescribeDomainUvData
DomainName String 否 需要查詢的加速域名，隻支持一個域名，不寫代表當前用戶下所有域名
StartTime String 否 獲取數據起始時間點，日期格式按照ISO8601表示法，並使用UTC時間。
格式為：YYYY-MM-DDThh:mmZ
最小數據粒度為1小時
不寫默認讀取過去24小時數據
EndTime String 否 結束時間需大於起始時間；獲日期格式按照ISO8601表示法，並使用UTC時間。
格式為：YYYY-MM-DDThh:mmZ

返回參數

名稱 類型 描述
RequestId String 請求ID
DomainName String 加速域名信息
DataInterval String 每條記錄的時間間隔，以秒為單位，固定值1小時
StartTime DateTime 開始時間
EndTime DateTime 結束時間
UvDataInterval UsageData[] 每個時間間隔的頁麵獨立訪問次數

UsageData

名稱 類型 描述
TimeStamp String 時間片起始時刻
Vaule String 詳細使用數據

特殊錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
Throttling Request was denied due to request throttling. 503 請求被流量控製限製
IllegalOperation Illegal domain, operation is not permitted. 403 非法域名, 無法操作
OperationDenied Your account does not open CDN service yet. 403 未開通CDN服務
OperationDenied Your CDN service is suspended. 403 CDN服務已被停止
InvalidDomain.NotFound The domain provided does not belong to you. 404 域名不存在或不屬於當前用戶
InvalidDomain.Offline The domain provided is offline. 404 域名已下線
ServiceBusy The specified Domain is configuring, please retry later. 403 域名正在配置中, 請稍後再試
InvalidDomain.Configure_failed Failed to configure the provided domain. 500 域名配置失敗
MissingParameter StartTime and EndTime can not be single. 400 StartTime和EndTime不能單獨設置
InvalidStartTime.Malformed Specified start time is malformed. 400 StartTime格式錯誤
InvalidEndTime.Malformed Specified end time is malformed. 400 EndTime格式錯誤
InvalidEndTime.Mismatch Specified end time does not math the specified start time. 400 EndTime小於StartTime
InvalidStartTime.ValueNotSupported Specified end time does not math the specified start time. 400 EndTime和StartTime差值超過90天
InvalidDomainName.ValueNotSupported The specified value of parameter DomainName only support one or empty value. 400 DomainName隻支持一個值或者不填

示例

請求示例：

https://cdn.aliyuncs.com?Action=DescribeDomainUvData&DomainName=test.com
&StartTime=2015-11-29
&EndTime=2015-11-30
&<公共請求參數>

返回示例：

JSON格式

{
    "DataInterval": "3600",
    "RequestId": "E9D3257A-1B7C-414C-90C1-8D07AC47BCAC",
    "DomainName": "test.com",
    "EndTime": "2015-11-30",
    "StartTime": "2015-11-29",
    "UvDataInterval": {
        "UsageData": [
            {
                "TimeStamp": "2015-11-29T20:00:00Z",
                "Value": "318"
            },
            {
                "TimeStamp": "2015-11-29T18:00:00Z",
                "Value": "318"
            },
            {
                "TimeStamp": "2015-11-29T03:00:00Z",
                "Value": "329"
            },
            {
                "TimeStamp": "2015-11-29T21:00:00Z",
                "Value": "316"
            },
            {
                "TimeStamp": "2015-11-29T07:00:00Z",
                "Value": "319"
            },
            {
                "TimeStamp": "2015-11-29T00:00:00Z",
                "Value": "326"
            },
            {
                "TimeStamp": "2015-11-29T11:00:00Z",
                "Value": "321"
            },
            {
                "TimeStamp": "2015-11-29T10:00:00Z",
                "Value": "313"
            },
            {
                "TimeStamp": "2015-11-29T08:00:00Z",
                "Value": "331"
            },
            {
                "TimeStamp": "2015-11-29T01:00:00Z",
                "Value": "324"
            },
            {
                "TimeStamp": "2015-11-29T04:00:00Z",
                "Value": "330"
            },
            {
                "TimeStamp": "2015-11-29T14:00:00Z",
                "Value": "335"
            },
            {
                "TimeStamp": "2015-11-29T12:00:00Z",
                "Value": "318"
            },
            {
                "TimeStamp": "2015-11-29T23:00:00Z",
                "Value": "310"
            },
            {
                "TimeStamp": "2015-11-29T17:00:00Z",
                "Value": "309"
            },
            {
                "TimeStamp": "2015-11-29T22:00:00Z",
                "Value": "320"
            },
            {
                "TimeStamp": "2015-11-29T16:00:00Z",
                "Value": "309"
            },
            {
                "TimeStamp": "2015-11-29T02:00:00Z",
                "Value": "317"
            },
            {
                "TimeStamp": "2015-11-29T06:00:00Z",
                "Value": "309"
            },
            {
                "TimeStamp": "2015-11-29T19:00:00Z",
                "Value": "308"
            },
            {
                "TimeStamp": "2015-11-29T13:00:00Z",
                "Value": "347"
            },
            {
                "TimeStamp": "2015-11-29T15:00:00Z",
                "Value": "341"
            },
            {
                "TimeStamp": "2015-11-29T05:00:00Z",
                "Value": "347"
            },
            {
                "TimeStamp": "2015-11-29T09:00:00Z",
                "Value": "312"
            }
        ]
    }
}

XML格式：

<DescribeDomainUvDataResponse>
  <DataInterval>3600</DataInterval>
  <RequestId>8549C6DA-AE2B-4D22-9D0A-332485CAAB46</RequestId>
  <DomainName>test.com</DomainName>
  <EndTime>2015-11-30</EndTime>
  <StartTime>2015-11-29</StartTime>
  <UvDataInterval>
    <UsageData>
      <TimeStamp>2015-11-29T20:00:00Z</TimeStamp>
      <Value>318</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T18:00:00Z</TimeStamp>
      <Value>318</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T03:00:00Z</TimeStamp>
      <Value>329</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T21:00:00Z</TimeStamp>
      <Value>316</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T07:00:00Z</TimeStamp>
      <Value>319</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T00:00:00Z</TimeStamp>
      <Value>326</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T11:00:00Z</TimeStamp>
      <Value>321</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T10:00:00Z</TimeStamp>
      <Value>313</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T08:00:00Z</TimeStamp>
      <Value>331</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T01:00:00Z</TimeStamp>
      <Value>324</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T04:00:00Z</TimeStamp>
      <Value>330</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T14:00:00Z</TimeStamp>
      <Value>335</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T12:00:00Z</TimeStamp>
      <Value>318</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T23:00:00Z</TimeStamp>
      <Value>310</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T17:00:00Z</TimeStamp>
      <Value>309</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T22:00:00Z</TimeStamp>
      <Value>320</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T16:00:00Z</TimeStamp>
      <Value>309</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T02:00:00Z</TimeStamp>
      <Value>317</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T06:00:00Z</TimeStamp>
      <Value>309</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T19:00:00Z</TimeStamp>
      <Value>308</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T13:00:00Z</TimeStamp>
      <Value>347</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T15:00:00Z</TimeStamp>
      <Value>341</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T05:00:00Z</TimeStamp>
      <Value>347</Value>
    </UsageData>
    <UsageData>
      <TimeStamp>2015-11-29T09:00:00Z</TimeStamp>
      <Value>312</Value>
    </UsageData>
  </UvDataInterval>
</DescribeDomainUvDataResponse>

最後更新：2016-11-23 17:16:03

  上一篇：go 查詢PV數據__資源監控接口_API 手冊_CDN-阿裏雲
  下一篇：go 用戶區域占比__資源監控接口_API 手冊_CDN-阿裏雲