使用DescribeDcdnReport API查詢已定製的報表資料-邊緣安全加速-阿里雲

介面說明

說明

單使用者調用頻率：3 次/秒。

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

dcdn:DescribeDcdnReport

get

*Domain

acs:dcdn:*:{#accountId}:domain/{#DomainName}

無

名稱	類型	必填	描述	樣本值
DomainName	string	否	待查詢的網域名稱列表，多個網域名稱用英文逗號（,）分隔。	www.example.com,www.example.org
ReportId	integer	是	待查詢的報表 ID，每次調用僅支援傳入單個報表 ID。您可以調用 DescribeDcdnSubList 介面查詢報表 ID。	2
Area	string	否	地區英文名，您可以調用 DescribeDcdnRegionAndIsp 介面擷取地區英文名。如果不傳該參數，預設查詢全部地區。如果傳入指定地區，則按照指定的地區擷取相應資料。支援傳入多個地區，多個地區用英文逗號（,）分隔。	shanghai
IsOverseas	string	否	是否為中國內地以外的地區。取值： 1：中國內地以外的地區。 0：中國內地。	0
HttpCode	string	否	HTTP 狀態代碼。取值： 2xx：2xx 狀態代碼。 3xx：3xx 狀態代碼。 4xx：4xx 狀態代碼。 5xx：5xx 狀態代碼。如果不傳該參數，預設查詢以上全部 HTTP 狀態代碼。	2xx
StartTime	string	是	查詢開始時間。使用 UTC+0 時間表示，格式為 yyyy-MM-ddTHH:mm:ssZ。	2021-07-02T00:00:00Z
EndTime	string	是	查詢結束時間。使用 UTC+0 時間表示，格式為 yyyy-MM-ddTHH:mm:ssZ。	2021-07-02T01:00:00Z

各報表必傳的請求參數說明

報表名稱	必傳參數	說明
PV 和 UV	Action、ReportId、DomainName、StartTime、EndTime。	不支援其他參數。
Top 用戶端 IP（按流量排序）	Action、ReportId、DomainName、Area、StartTime、EndTime。	不支援其他參數。
Top 用戶端 IP（按請求數排序）	Action、ReportId、DomainName、Area、StartTime、EndTime。	不支援其他參數。
訪問地區分布	Action、ReportId、DomainName、IsOverseas、StartTime、EndTime。	不支援其他參數。
電訊廠商分布	Action、ReportId、DomainName、IsOverseas、StartTime、EndTime。	不支援其他參數。
熱門 Referer（按流量排序）	Action、ReportId、DomainName、StartTime、EndTime。	不支援其他參數。
熱門 Referer（按請求數排序）	Action、ReportId、DomainName、StartTime、EndTime。	不支援其他參數。
熱門 URL（按流量排序）	Action、ReportId、DomainName、HttpCode、StartTime、EndTime。	不支援其他參數。
熱門 URL（按請求數排序）	Action、ReportId、DomainName、HttpCode、StartTime、EndTime。	不支援其他參數。
回源熱門 URL（按流量排序）	Action、ReportId、DomainName、HttpCode、StartTime、EndTime。	不支援其他參數。
回源熱門 URL（按請求數排序）	Action、ReportId、DomainName、HttpCode、StartTime、EndTime。	不支援其他參數。
網域名稱排行（按流量排序）	Action、ReportId、StartTime、EndTime。	不支援其他參數。

名稱	類型	描述	樣本值
	object
Content	object	查詢到的報表資料。	"data":[{"deliver":{ "report":{"title":"TopUrlByAcc","format":"table","sape":"","header":["url","traf","traf_rate","acc","acc_rate"]}}, "data":[{"acc":440,"acc_rate":"0.200%","traf":22,"url":"http://example.com","traf_rate":"0.100%"},{"acc":440,"acc_rate":"0.200%","traf":22,"url":"http://example.org","traf_rate":"0.100%"}]}]
RequestId	string	請求 ID。	04F0F334-1335-436C-A1D7-6C044FE73368

Content 資料說明

參數	類型	描述
deliver	report	報表樣式。
data	String[]	報表中的資料，例如：[{"表頭欄位 1":"value1","表頭欄位 2":"value2"}, {"表頭欄位 1":"value3","表頭欄位 2":"value4"}]。

report 資料說明

參數	類型	描述
title	String	報表標題。
format	String	報表類型。取值如下： chart：圖表。 table：表格。
shape	String	圖表類型。當 format 為 table 時，請忽略此欄位。取值如下： line：曲線圖。 pie：餅狀圖。 bar：柱狀圖。
header	String[]	報表的表頭欄位。
legend	String	圖形的圖例欄位。
xAxis	String	圖形 x 軸，沒有則為空白。
yAxis	String	圖形 y 軸，沒有則為空白。

正常返回樣本

JSON格式

{
  "Content": {
    "test": "test",
    "test2": 1
  },
  "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
}

HTTP status code	錯誤碼	錯誤資訊	描述
400	InvalidParameter	The specified parameter is invalid.	參數錯誤
400	TimeParseFailed	Failed to parse the time parameter.	解析時間參數失敗
400	SubscriptionAlreadyExists	The subscription already exists.	定製服務已開通
400	SubscriptionNotFound	The subscription is not found.	未開通定製服務
400	NameAlreadyExists	The name already exists.	名稱已存在
400	DeliverExceedLimit	The maximum number of subscribed tasks is exceeded.	訂閱任務個數已達上限

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

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