閱讀214 返回首頁    go 阿裏雲

查詢請求緩存命中率__資源監控接口_API 手冊_CDN-阿裏雲

DescribeDomainReqHitRateData

描述

獲取加速域名的請求命中率（命中請求百分比）

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

  • 支持批量域名查詢，多個域名可用逗號（半角）分隔
  • 最多可獲取最近90天的數據

請求參數

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

返回參數

名稱 類型 描述
DomainName String 加速域名信息
DataInterval String 每條記錄的時間間隔，以秒為單位
StartTime DateTime 開始時間
EndTime DateTime 結束時間
HitRateInterval DataModule[] 每個時間間隔的字節命中百分占比

DataModule

名稱 類型 描述
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天

示例

請求示例：

  1. https://cdn.aliyuncs.com?Action=DescribeDomainReqHitRateData&DomainName=test.com
  2. &StartTime=2015-12-10T20:00Z
  3. &EndTime=2015-12-10T21:00Z
  4. &<公共請求參數>

返回示例：

JSON格式

  2. {
  3.     "DomainName": "test.com",
  4.     "DataInterval": "300",
  5.     "RequestId": "5ADA5190-EE5B-4EF2-BE00-DC441B8D81DD",
  6.     "StartTime": "2015-12-10T20:00Z",
  7.     "EndTime": "2015-12-10T21:00Z",
  8.     "HitRateInterval": {
  9.         "DataModule": [
  10.             {
  11.                 "TimeStamp": "2015-12-10T21:00:00Z",
  12.                 "Value": "100.0"
  13.             },
  14.             {
  15.                 "TimeStamp": "2015-12-10T20:35:00Z",
  16.                 "Value": "100.0"
  17.             },
  18.             {
  19.                 "TimeStamp": "2015-12-10T20:50:00Z",
  20.                 "Value": "99.99932881437826"
  21.             },
  22.             {
  23.                 "TimeStamp": "2015-12-10T20:05:00Z",
  24.                 "Value": "100.0"
  25.             },
  26.             {
  27.                 "TimeStamp": "2015-12-10T20:10:00Z",
  28.                 "Value": "100.0"
  29.             },
  30.             {
  31.                 "TimeStamp": "2015-12-10T20:55:00Z",
  32.                 "Value": "100.0"
  33.             },
  34.             {
  35.                 "TimeStamp": "2015-12-10T20:30:00Z",
  36.                 "Value": "100.0"
  37.             },
  38.             {
  39.                 "TimeStamp": "2015-12-10T20:25:00Z",
  40.                 "Value": "100.0"
  41.             },
  42.             {
  43.                 "TimeStamp": "2015-12-10T20:00:00Z",
  44.                 "Value": "100.0"
  45.             },
  46.             {
  47.                 "TimeStamp": "2015-12-10T20:40:00Z",
  48.                 "Value": "100.0"
  49.             },
  50.             {
  51.                 "TimeStamp": "2015-12-10T20:15:00Z",
  52.                 "Value": "100.0"
  53.             },
  54.             {
  55.                 "TimeStamp": "2015-12-10T20:45:00Z",
  56.                 "Value": "100.0"
  57.             },
  58.             {
  59.                 "TimeStamp": "2015-12-10T20:20:00Z",
  60.                 "Value": "100.0"
  61.             }
  62.         ]
  63.     }
  64. }

XML格式：

  2. <DescribeDomainReqHitRateDataResponse>
  3.         <DataInterval>300</DataInterval>
  4.         <RequestId>515FC426-589D-41C9-BF56-62B2DAACD091</RequestId>
  5.         <DomainName>test.com</DomainName>
  6.         <EndTime>2015-12-10T21:00Z</EndTime>
  7.         <StartTime>2015-12-10T20:00Z</StartTime>
  8.         <HitRateInterval>
  9.                 <DataModule>
  10.                         <TimeStamp>2015-12-10T21:00:00Z</TimeStamp>
  11.                         <Value>100.0</Value>
  12.                 </DataModule>
  13.                 <DataModule>
  14.                         <TimeStamp>2015-12-10T20:35:00Z</TimeStamp>
  15.                         <Value>100.0</Value>
  16.                 </DataModule>
  17.                 <DataModule>
  18.                         <TimeStamp>2015-12-10T20:50:00Z</TimeStamp>
  19.                         <Value>99.99932881437826</Value>
  20.                 </DataModule>
  21.                 <DataModule>
  22.                         <TimeStamp>2015-12-10T20:05:00Z</TimeStamp>
  23.                         <Value>100.0</Value>
  24.                 </DataModule>
  25.                 <DataModule>
  26.                         <TimeStamp>2015-12-10T20:10:00Z</TimeStamp>
  27.                         <Value>100.0</Value>
  28.                 </DataModule>
  29.                 <DataModule>
  30.                         <TimeStamp>2015-12-10T20:55:00Z</TimeStamp>
  31.                         <Value>100.0</Value>
  32.                 </DataModule>
  33.                 <DataModule>
  34.                         <TimeStamp>2015-12-10T20:30:00Z</TimeStamp>
  35.                         <Value>100.0</Value>
  36.                 </DataModule>
  37.                 <DataModule>
  38.                         <TimeStamp>2015-12-10T20:25:00Z</TimeStamp>
  39.                         <Value>100.0</Value>
  40.                 </DataModule>
  41.                 <DataModule>
  42.                         <TimeStamp>2015-12-10T20:00:00Z</TimeStamp>
  43.                         <Value>100.0</Value>
  44.                 </DataModule>
  45.                 <DataModule>
  46.                         <TimeStamp>2015-12-10T20:40:00Z</TimeStamp>
  47.                         <Value>100.0</Value>
  48.                 </DataModule>
  49.                 <DataModule>
  50.                         <TimeStamp>2015-12-10T20:15:00Z</TimeStamp>
  51.                         <Value>100.0</Value>
  52.                 </DataModule>
  53.                 <DataModule>
  54.                         <TimeStamp>2015-12-10T20:45:00Z</TimeStamp>
  55.                         <Value>100.0</Value>
  56.                 </DataModule>
  57.                 <DataModule>
  58.                         <TimeStamp>2015-12-10T20:20:00Z</TimeStamp>
  59.                         <Value>100.0</Value>
  60.                 </DataModule>
  61.         </HitRateInterval>
  62. </DescribeDomainReqHitRateDataResponse>

最後更新：2016-12-05 18:19:10

  上一篇：go 查詢字節緩存命中率__資源監控接口_API 手冊_CDN-阿裏雲
  下一篇：go 查詢訪問QPS__資源監控接口_API 手冊_CDN-阿裏雲