调用DescribeCdnDomainLogs查询域名的离线日志下载地址。
说明
- 如果不指定StartTime和EndTime,该接口默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
- 查询数据的时间粒度为一小时。
- 单个用户的调用频率为:100次/秒。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeCdnDomainLogs |
系统规定参数。取值:DescribeCdnDomainLogs。 |
DomainName | String | 是 | example.com |
域名,只支持单个查询。 |
PageSize | Long | 否 | 300 |
分页大小,默认300,最大1000,取值:1~1000。 |
PageNumber | Long | 否 | 2 |
取得第几页,取值范围:大于1的任意整数。 |
StartTime | String | 否 | 2017-12-21T08:00:00Z |
获取日志起始时间。 日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2017-12-22T08:00:00Z |
获取日志结束时间。 日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 说明 结束时间需晚于起始时间。
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
DomainLogDetails | Array of DomainLogDetail |
DomainLogDetail组成的数据。 |
|
DomainLogDetail | |||
LogCount | Long | 10 |
本页返回的总条数。 |
DomainName | String | example.com |
加速域名。 |
LogInfos | Array of LogInfoDetail |
LogInfoDetail组成的数据。 |
|
LogInfoDetail | |||
EndTime | String | 2015-05-23T14:00:00Z |
结束时间。 |
LogSize | Long | 258 |
日志大小。 |
StartTime | String | 2015-05-23T13:00:00Z |
开始时间。 |
LogName | String | demo.aliyundoc.com_2015_05_23_2100_2200.gz |
日志名称。 |
LogPath | String | guide.aliyundoc.com-hangzhou.xxx |
日志路径。 |
PageInfos | Object |
PageInfoDetail组成的数据。 |
|
PageIndex | Long | 1 |
返回数据的页码。 |
PageSize | Long | 20 |
整页大小。 |
Total | Long | 20 |
总条数。 |
示例
请求示例
http(s)://cdn.aliyuncs.com/?Action=DescribeCdnDomainLogs
&DomainName=example.com
&StartTime=2017-12-21T08:00:00Z
&EndTime=2017-12-22T08:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeCdnDomainLogsResponse>
<RequestId>077D0284-F041-4A41-A932-B48377FDAA25</RequestId>
<DomainLogDetails>
<DomainLogDetail>
<LogInfos>
<LogInfoDetail>
<LogName>demo.aliyundoc.com_2018_03_25_180000_190000.gz</LogName>
<LogPath>guide.aliyundoc.com/image.example.com/2018_03_25/demo.aliyundoc.com_2018_03_25_180000_190000.gz?xxx</LogPath>
<EndTime>2018-05-31T04:00:00Z</EndTime>
<StartTime>2018-05-31T03:00:00Z</StartTime>
<LogSize>2645401</LogSize>
</LogInfoDetail>
<LogInfoDetail>
<LogName>demo.aliyundoc.com_2018_03_25_190000_200000.gz</LogName>
<LogPath>guide.aliyundoc.com/demo.example.com/2018_03_25/demo.aliyundoc.com_2018_03_25_190000_200000.gz?xxx</LogPath>
<EndTime>2018-05-31T06:00:00Z</EndTime>
<StartTime>2018-05-31T05:00:00Z</StartTime>
<LogSize>2653965</LogSize>
</LogInfoDetail>
</LogInfos>
<LogCount>20</LogCount>
<PageInfos>
<PageIndex>1</PageIndex>
<PageSize>20</PageSize>
<Total>20</Total>
</PageInfos>
<DomainName>example.com</DomainName>
</DomainLogDetail>
</DomainLogDetails>
</DescribeCdnDomainLogsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "077D0284-F041-4A41-A932-B48377FDAA25",
"DomainLogDetails" : {
"DomainLogDetail" : [ {
"LogInfos" : {
"LogInfoDetail" : [ {
"LogName" : "demo.aliyundoc.com_2018_03_25_180000_190000.gz",
"LogPath" : "guide.aliyundoc.com/image.example.com/2018_03_25/demo.aliyundoc.com_2018_03_25_180000_190000.gz?xxx",
"EndTime" : "2018-05-31T04:00:00Z",
"StartTime" : "2018-05-31T03:00:00Z",
"LogSize" : 2645401
}, {
"LogName" : "demo.aliyundoc.com_2018_03_25_190000_200000.gz",
"LogPath" : "guide.aliyundoc.com/demo.example.com/2018_03_25/demo.aliyundoc.com_2018_03_25_190000_200000.gz?xxx",
"EndTime" : "2018-05-31T06:00:00Z",
"StartTime" : "2018-05-31T05:00:00Z",
"LogSize" : 2653965
} ]
},
"LogCount" : 20,
"PageInfos" : {
"PageIndex" : 1,
"PageSize" : 20,
"Total" : 20
},
"DomainName" : "example.com"
} ]
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 开始时间设置错误,请检查更新后重试。 |
访问错误中心查看更多错误码。