Queries the information about the CDN access logs for a domain name, including the log path.
Operation description
- This operation is available only in the China (Shanghai) region.
- For more information about the log format and latency, see Download logs.
- If you specify neither StartTime nor EndTime, the log data in the previous 24 hours is queried.
- You can specify both StartTime and EndTime to query the log data that is generated in the specified time range.
QPS limits
You can call this operation up to 100 times per second per account. Requests that exceed this limit are dropped and you will experience service interruptions. We recommend that you take note of this limit when you call this operation. For more information, see QPS limits on API operations.
Debugging
Authorization information
Request parameters
Parameter | Type | Required | Description | Example |
---|---|---|---|---|
DomainName | string | Yes | The domain name. Note
You can specify only one domain name in each query.
| example.com |
PageSize | long | No | The number of entries per page.
| 300 |
PageNumber | long | No | The page number. Default value: 1. | 1 |
StartTime | string | No | The beginning of the time range to query. Specify the time in the ISO 8601 standard in the | 2016-10-20T04:00:00Z |
EndTime | string | No | The end of the time range to query. The end time must be later than the start time. The maximum time range that can be specified is one year. Specify the time in the ISO 8601 standard in the | 2016-10-20T05:00:00Z |
Response parameters
Examples
Sample success responses
JSON
format
{
"RequestId": "077D0284-F041-4A41-4D3C-B48377FD****",
"DomainLogDetails": {
"DomainLogDetail": [
{
"LogCount": 2,
"DomainName": "example.com",
"LogInfos": {
"LogInfoDetail": [
{
"EndTime": "2018-05-31T05:00:00Z",
"LogSize": 2645401,
"StartTime": "2018-05-31T04:00:00Z",
"LogName": "example.com_2018_03_25_180000_19****.gz",
"LogPath": "example.com/2018_03_25/example.com_2018_03_25_180000_19****.gz?Expires=1522659931&OSSAccessKeyId=****&Signature=****"
}
]
},
"PageInfos": {
"PageNumber": 1,
"PageSize": 300,
"Total": 2
}
}
]
}
}
Error codes
For a list of error codes, visit the Service error codes.