閱讀858 返回首頁    go windows


天粒度按流量域名排名__資源監控接口_API 手冊_CDN-阿裏雲

描述

獲取用戶按流量排名的域名

不指定StartTime和EndTime時,默認讀取當月的數據,同時支持按指定的起止時間查詢,兩者需要同時指定。

  • 最多可獲取最近90天的數據

請求參數

參數 類型 必要 描述
Action String 操作接口名,係統規定參數
取值:DescribeTopDomainsByFlow
StartTime String 獲取數據起始時間點,日期格式按照ISO8601表示法,並使用UTC時間。
格式為:YYYY-MM-DDThh:mmZ
最小數據粒度為5分鍾
不寫默認讀取當月數據
EndTime String 結束時間需大於起始時間;獲日期格式按照ISO8601表示法,並使用UTC時間。
格式為:YYYY-MM-DDThh:mmZ
Limit String 域名獲取數量限製,默認為20,取值支持1~100

返回參數

名稱 類型 描述
RequestId String 請求ID
StartTime String 開始時間
EndTime String 結束時間
TopDomains TopDomain[] 排名域名列表
DomainCount Long 賬戶下域名總數
DomainOnlineCount Long 賬戶下“正在運行”域名總數

TopDomain

名稱 類型 描述
DomainName String 域名
Rank Long 排名
TotalTraffic Double 總流量
TrafficPercent Double 流量占比
MaxBps Long 帶寬峰值
MaxBpsTime Long 帶寬峰值時刻
TotalAccess 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 域名正在配置中, 請稍後再試
InvalidDomain.Configure_failed Failed to configure the provided domain. 500 域名配置失敗
MissingParameter StartTime and EndTime can not be single. 400 StartTime和EndTime不能單獨設置
InvalidStartTime.Malformed Specified StartTime is malformed. 400 StartTime格式錯誤
InvalidEndTime.Malformed Specified EndTime is malformed. 400 EndTime格式錯誤
InvalidEndTime.Mismatch Specified end time does not math the specified start time. 400 EndTime小於StartTime
InvalidStartTime.ValueNotSupported 90 days data can be queried at most. 400 EndTime和StartTime差值超過90天
InvalidLimit.ValueNotSupported The number of domainNames limit between 1 and 100. 400 DomainName隻支持一個值或者不填

示例

請求示例:

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

返回示例:

JSON格式

{
  "DomainCount": 68,
  "DomainOnlineCount": 68,
  "RequestId": "4E09C5D7-E1CF-4CAA-A45E-8727F4C8FD70",
  "EndTime": "2016-03-14T07:34Z",
  "TopDomains": {
    "TopDomain": [
      {
        "MaxBps": 22139626,
        "Rank": 1,
        "TrafficPercent": 30.64191989360235,
        "TotalTraffic": 2043859876683.9001,
        "TotalAccess": 107784230,
        "DomainName": "cedexis.j0zz.com",
        "MaxBpsTime": 1457111400
      },
      {
        "MaxBps": 1008772351,
        "Rank": 2,
        "TrafficPercent": 25.936032624725815,
        "TotalTraffic": 1729970466149.2002,
        "TotalAccess": 3843128,
        "DomainName": "wj.cdnpe.com",
        "MaxBpsTime": 1457505600
      },
      {
        "MaxBps": 16046911,
        "Rank": 3,
        "TrafficPercent": 21.686305274906182,
        "TotalTraffic": 1446507574551.6,
        "TotalAccess": 547567,
        "DomainName": "imgtest.cdnpe.com",
        "MaxBpsTime": 1456897200
      },
      {
        "MaxBps": 15990893,
        "Rank": 4,
        "TrafficPercent": 21.261081185428147,
        "TotalTraffic": 1418144519687.5,
        "TotalAccess": 548380,
        "DomainName": "downtest.cdnpe.com",
        "MaxBpsTime": 1457567700
      },
      {
        "MaxBps": 473599,
        "Rank": 5,
        "TrafficPercent": 0.4308743788055894,
        "TotalTraffic": 28739937242.500004,
        "TotalAccess": 152150,
        "DomainName": "ali.ddimg.cn",
        "MaxBpsTime": 1457845800
      }
    ]
  },
  "StartTime": "2016-03-01T04:00Z"
}

XML格式:

<?xml version="1.0" encoding="utf-8"?>

<DescribeTopDomainsByFlowResponse>
  <DomainCount>68</DomainCount>
  <DomainOnlineCount>68</DomainOnlineCount>
  <RequestId>800C3EA7-C022-4F99-81CC-0FB5038B1D8E</RequestId>
  <EndTime>2016-03-14T07:35Z</EndTime>
  <TopDomains>
    <TopDomain>
      <MaxBps>22139626</MaxBps>
      <Rank>1</Rank>
      <TrafficPercent>30.64191989360235</TrafficPercent>
      <TotalTraffic>2.0438598766839001E12</TotalTraffic>
      <TotalAccess>107784230</TotalAccess>
      <DomainName>cedexis.j0zz.com</DomainName>
      <MaxBpsTime>1457111400</MaxBpsTime>
    </TopDomain>
    <TopDomain>
      <MaxBps>1008772351</MaxBps>
      <Rank>2</Rank>
      <TrafficPercent>25.936032624725815</TrafficPercent>
      <TotalTraffic>1.7299704661492002E12</TotalTraffic>
      <TotalAccess>3843128</TotalAccess>
      <DomainName>wj.cdnpe.com</DomainName>
      <MaxBpsTime>1457505600</MaxBpsTime>
    </TopDomain>
    <TopDomain>
      <MaxBps>16046911</MaxBps>
      <Rank>3</Rank>
      <TrafficPercent>21.686305274906182</TrafficPercent>
      <TotalTraffic>1.4465075745516E12</TotalTraffic>
      <TotalAccess>547567</TotalAccess>
      <DomainName>imgtest.cdnpe.com</DomainName>
      <MaxBpsTime>1456897200</MaxBpsTime>
    </TopDomain>
    <TopDomain>
      <MaxBps>15990893</MaxBps>
      <Rank>4</Rank>
      <TrafficPercent>21.261081185428147</TrafficPercent>
      <TotalTraffic>1.4181445196875E12</TotalTraffic>
      <TotalAccess>548380</TotalAccess>
      <DomainName>downtest.cdnpe.com</DomainName>
      <MaxBpsTime>1457567700</MaxBpsTime>
    </TopDomain>
    <TopDomain>
      <MaxBps>473599</MaxBps>
      <Rank>5</Rank>
      <TrafficPercent>0.4308743788055894</TrafficPercent>
      <TotalTraffic>2.8739937242500004E10</TotalTraffic>
      <TotalAccess>152150</TotalAccess>
      <DomainName>ali.ddimg.cn</DomainName>
      <MaxBpsTime>1457845800</MaxBpsTime>
    </TopDomain>
  </TopDomains>
  <StartTime>2016-03-01T04:00Z</StartTime>
</DescribeTopDomainsByFlowResponse>

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

  上一篇:go 天粒度資源使用概覽__資源監控接口_API 手冊_CDN-阿裏雲
  下一篇:go 查詢PV數據__資源監控接口_API 手冊_CDN-阿裏雲