閱讀168 返回首頁    go 阿裏雲 go 技術社區[雲棲]

查詢時刻網絡帶寬__資源監控接口_API 手冊_CDN-阿裏雲

描述

獲取加速域名的在某個時刻不同Locate和Isp上的帶寬數據，單位 bit/second

  • 不支持批量域名查詢
  • 時間精確到5分鍾粒度

請求參數

參數 類型 必要 描述
Action String 是 操作接口名，係統規定參數
取值：DescribeDomainBpsDataByTimeStamp
DomainName String 是 要查詢的域名，不能為空；
LocationNames String 是 需要查詢目標節點列表，用“,”隔開，不能為空； Location名通過DescribeCdnRegionAndIsp接口獲得;
IspNames String 是 需要查詢目標Isp列表，用“,”隔開，不能為空； ISP名通過DescribeCdnRegionAndIsp接口獲得;
TimePoint String 是 查詢目標時間點，日期格式按照ISO8601表示法，並使用UTC時間。
格式為：YYYY-MM-DDThh:mmZ
最小數據粒度為5分鍾

返回參數

名稱 類型 描述
DomainName String 加速域名信息
TimePoint String 時間點
BpsDataList BpsDataModel[] 每個Locate、ISP對應的bps值

BpsDataModel

名稱 類型 描述
LocationName String 節點名
IspName String Isp名
Bps Long 對應的帶寬值

特殊錯誤碼

錯誤代碼 描述 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 域名正在配置中, 請稍後再試
InvalidTimePoint.Malformed Specified TimePoint malformed. 400 TimePoint格式錯誤
InvaildParameter IspNames Not Supported 400 ISP不支持
InvaildParameter LocationNames Not Supported 400 Location不支持

示例

請求示例：

  1. https://cdn.aliyuncs.com?Action=DescribeDomainBpsDataByTimeStamp&DomainName=abc.com
  2. &LocationIds=liaoning,guangxi
  3. &IspIds=unicom,telecom
  4. &TimeStamp=2016-08-01T22:00Z
  5. &<公共請求參數>

返回示例：

JSON格式

  1. {
  2.     "TimeStamp": "2016-08-01T22:00Z", 
  3.     "BpsDataList": {
  4.         "BpsDataModel": [
  5.             {
  6.                 "LocationName": "Liaoning", 
  7.                 "Bps": 880996111, 
  8.                 "IspName": "telecom"
  9.             }, 
  10.             {
  11.                 "LocationName": "Liaoning", 
  12.                 "Bps": 52119553, 
  13.                 "IspName": "unicom"
  14.             }, 
  15.             {
  16.                 "LocationName": "Guangxi", 
  17.                 "Bps": 51295137, 
  18.                 "IspName": "telecom"
  19.             }, 
  20.             {
  21.                 "LocationName": "Guangxi", 
  22.                 "Bps": 18673571, 
  23.                 "IspName": "unicom"
  24.             }
  25.         ]
  26.     }, 
  27.     "RequestId": "7682DE14-3B4D-48D0-9B7C-DD3C8C3E1C78", 
  28.     "DomainName": "abc.cn"
  29. }

XML格式：

  1. <?xml version="1.0" ?>
  2. <DescribeDomainBpsDataByTimeStampResponse>
  3.         <TimeStamp>2016-08-01T22:00Z</TimeStamp>
  4.         <BpsDataList>
  5.                 <BpsDataModel>
  6.                         <LocationName>Liaoning</LocationName>
  7.                         <IspName>telecom</IspName>
  8.                         <Bps>880996111</Bps>
  9.                 </BpsDataModel>
  10.                 <BpsDataModel>
  11.                         <LocationName>Liaoning</LocationName>
  12.                         <IspName>unicom</IspName>
  13.                         <Bps>52119553</Bps>
  14.                 </BpsDataModel>
  15.                 <BpsDataModel>
  16.                         <LocationName>Guangxi</LocationName>
  17.                         <IspName>unicom</IspName>
  18.                         <Bps>51295137</Bps>
  19.                 </BpsDataModel>
  20.                 <BpsDataModel>
  21.                         <LocationName>Guangxi</LocationName>
  22.                         <IspName>unicom</IspName>
  23.                         <Bps>18673571</Bps>
  24.                 </BpsDataModel>
  25.         </BpsDataList>
  26.         <RequestId>AA2981FF-1A30-4590-B929-88FC85E12A8B</RequestId>
  27.         <DomainName>abc.cn</DomainName>
  28. </DescribeDomainBpsDataByTimeStampResponse>

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

  上一篇：go 獲取區域和運營商列表__資源監控接口_API 手冊_CDN-阿裏雲
  下一篇：go 查詢區域運營商資源信息__資源監控接口_API 手冊_CDN-阿裏雲