调用DescribeDcdnReport查询已定制的报表数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeDcdnReport |
系统规定参数。取值:DescribeDcdnReport。 |
DomainName | String | 否 | www.example.com,www.example.org |
待查询的域名列表,多个域名用英文逗号(,)分隔。 |
ReportId | Long | 是 | 2 |
待查询的报表ID,每次调用仅支持传入单个报表ID。您可以调用DescribeDcdnSubList接口查询报表ID。 |
Area | String | 否 | shanghai |
地域英文名,您可以调用DescribeDcdnRegionAndIsp接口获取地域英文名。
|
IsOverseas | String | 否 | 0 |
是否为中国内地以外的区域。取值:
|
HttpCode | String | 否 | 2xx |
HTTP状态码。取值:
如果不传该参数,默认查询以上全部HTTP状态码。 |
StartTime | String | 是 | 2021-07-02T00:00:00Z |
查询开始时间。使用UTC+0时间表示,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 是 | 2021-07-02T01:00:00Z |
查询结束时间。使用UTC+0时间表示,格式为yyyy-MM-ddTHH:mm:ssZ。 |
报表名称 |
必传参数 |
说明 |
---|---|---|
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。 |
不支持其他参数。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Content | String | "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 | 04F0F334-1335-436C-A1D7-6C044FE73368 |
请求ID。 |
参数 |
类型 |
描述 |
---|---|---|
deliver |
report |
报表样式。 |
data |
String[] |
报表中的数据,例如:[{"表头字段1":"value1","表头字段2":"value2"}, {"表头字段1":"value3","表头字段2":"value4"}]。 |
参数 |
类型 |
描述 |
---|---|---|
title |
String |
报表标题。 |
format |
String |
报表类型。取值如下: chart:图表。 table:表格。 |
shape |
String |
图表类型。当format为table时,请忽略此字段。取值如下: line:曲线图。 pie:饼状图。 bar:柱状图。 |
header |
String[] |
报表的表头字段。 |
legend |
String |
图形的图例字段。 |
xAxis |
String |
图形x轴,没有则为空。 |
yAxis |
String |
图形y轴,没有则为空。 |
示例
请求示例
http(s)://dcdn.aliyuncs.com/?Action=DescribeDcdnReport
&ReportId=2
&DomainName=www.example.com,www.example.org
&StartTime=2021-07-02T00:00:00Z
&EndTime=2021-07-02T01:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeDcdnReportResponse>
<RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
<Content>
<data>
<deliver>
<report>
<title>TopUrlByAcc</title>
<format>table</format>
<shape/>
<header>url</header>
<header>traf</header>
<header>traf_rate</header>
<header>acc</header>
<header>acc_rate</header>
</report>
</deliver>
<data>
<acc>440</acc>
<acc_rate>0.200%</acc_rate>
<traf>22</traf>
<url>http://example.com</url>
<traf_rate>0.100%</traf_rate>
</data>
<data>
<acc>440</acc>
<acc_rate>0.200%</acc_rate>
<traf>22</traf>
<url>http://example.org</url>
<traf_rate>0.100%</traf_rate>
</data>
</data>
</Content>
</DescribeDcdnReportResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368",
"Content" : {
"data" : [ {
"deliver" : {
"report" : {
"title" : "TopUrlByAcc",
"format" : "table",
"shape" : "",
"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%"
} ]
} ]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
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. | 订阅任务个数已达上限 |
访问错误中心查看更多错误码。