DescribeVodDomainRealTimeDetailData - 查詢即時訪問詳細資料 -

介面說明

目前本介面服務地址僅支援：華東 2（上海）。
支援批量查詢，一次最多查詢 20 個網域名稱資料。
單次查詢的時間跨度（即 StartTime 和 EndTime 的時間跨度）最大為 10 分鐘，資料返回的時間粒紋為 1 分鐘。
僅支援查詢最近 7 天內的資料。

調試

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

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

vod:DescribeVodDomainRealTimeDetailData

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
DomainName	string	是	要查詢的加速網域名稱。支援批量查詢，多個網域名稱之間用半形逗號（,）分隔，一次最多支援 20 個網域名稱查詢。您可以登入ApsaraVideo for VOD控制台，從左側導航選擇組態管理 > 分發加速配置 > 網域名稱管理，查看您已接入到ApsaraVideo for VOD的加速網域名稱，或者調用 DescribeVodUserDomains 介面查詢加速網域名稱列表。	example.com
StartTime	string	是	擷取資料起始時間點。日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為 yyyy-MM-ddTHH:mm:ssZ。	2019-01-23T12:35:12Z
EndTime	string	是	擷取資料的結束時間點。日期格式按照 ISO8601 標記法，並使用 UTC 時間，格式為：yyyy-MM-ddTHH:mm:ssZ。說明結束時間需大於起始時間，並且結束時間和起始時間相差不超過 10 分鐘。	2019-01-23T12:40:00Z
Field	string	是	指定查詢的訪問資料類型，可同時指定多個訪問資料，多個訪問資料之間用半形逗號（,）分隔。取值： qps：每秒訪問次數。 bps：頻寬資料。 http_code：HTTP 狀態代碼。	qps
LocationNameEn	string	否	地區英文名。不傳入該參數，預設查詢所有地區。	shanghai
IspNameEn	string	否	電訊廠商英文名。不傳入該參數，預設查詢所有電訊廠商。	unicom
Merge	string	否	是否按網域名稱維度返回匯總後的資料。取值： true：是，返回的資料為各網域名稱匯總後的值。 false（預設值）：否，返回的資料將按網域名稱維度進行分組展示。	false
MergeLocIsp	string	否	是否按地區和電訊廠商維度返回匯總後的資料。取值： true：是，返回的資料，僅按網域名稱維度進行分組，會匯總各地區和電訊廠商的值。 false（預設值）：否，返回的資料，按網域名稱、地區、電訊廠商的維度進行分組展示。	true

返回參數

名稱

類型

描述

樣本值

object

Data

string

返回資料詳情。按 JSON 字串返回，具體結構及欄位描述如下：

說明

如對應欄位沒有資料則不返回該欄位。

欄位名稱	類型	描述
domain_name	String	查詢的加速網域名稱。
isp	String	電訊廠商名稱。
location	String	地區名稱。
qps	Long	每秒訪問次數。
bps	Long	頻寬資料，單位：bit/s。
http_code	Map	HTTP 狀態代碼詳情。鍵為狀態代碼名稱，值為狀態代碼數量。
time_stp	String	資料時間戳記。日期格式按照 ISO8601 標記法，並使用 UTC 時間。

[ { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Guangdong", "isp": "telecom", "qps": 10 }, { "time_stp": "2018-06-05T20:00:00Z", "domain_name": "example.com", "location": "Jiangsu", "isp": "unicom", "qps": 11.1 } ]

RequestId

string

請求 ID。

1710298E-8AFA-5F6D-A3E9-47103C52177D

樣本

正常返回樣本

JSON格式

{
  "Data": "[\n      {\n            \"time_stp\": \"2018-06-05T20:00:00Z\",\n            \"domain_name\": \"example.com\",\n            \"location\": \"Guangdong\",\n            \"isp\": \"telecom\",\n            \"qps\": 10\n      },\n      {\n            \"time_stp\": \"2018-06-05T20:00:00Z\",\n            \"domain_name\": \"example.com\",\n            \"location\": \"Jiangsu\",\n            \"isp\": \"unicom\",\n            \"qps\": 11.1\n      }\n]",
  "RequestId": "1710298E-8AFA-5F6D-A3E9-47103C52177D"
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidTime.Malformed	Specified StartTime or EndTime is malformed.
400	InvalidDomainName.Malformed	Specified domain name is malformed.

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

變更歷史

更多資訊，參考變更詳情。