You can call this operation to query the raw access log information for a specific domain, including the log path.

When you call this operation, follow these rules:
  • If you do not specify the StartTime and EndTime parameters, the log data within the last 24 hours is queried.
  • If you specify the StartTime and EndTime parameters, the log data within the specified time range is queried.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDcdnDomainLog

The operation that you want to perform. Set the value to DescribeDcdnDomainLog.

DomainName String Yes example.com

The name of the accelerated domain. You can specify only one domain name.

EndTime String No 2017-01-01T12:12:20Z

The end of the time range to query. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

The end time must be later than the start time. The maximum time range that can be queried is one year.

PageNumber Long No 2

The number of the page to return.

Pages start from page 1.

PageSize Long No 300

The number of entries to return on each page. Default value: 300. Maximum value: 1000.

Valid values: 1 to 1000.

StartTime String No 2017-01-01T12:12:20Z

The beginning of the time range to query.

Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.

Response parameters

Parameter Type Example Description
DomainLogDetails

The detailed log information, which is indicated by the DomainLogDetail parameter.

DomainLogDetail

The detailed log information.

LogCount Long 12

The total number of entries returned on this page.

LogInfos

The detailed log information, which is indicated by the LogInfoDetail parameter.

LogInfoDetail

The detailed log information.

EndTime String 1521979200

The end of the time range during which the data was queried.

LogName String example1.com_2018_03_25_190000_200000.gz

The name of the log file.

LogPath String cdnlog2.aliyuncs.com/test1.example.com/2018_03_25/example1.com_2018_03_25_190000_200000.gz? xxx

The path of the log file.

LogSize Long 2645401

The size of the log file.

StartTime String 1521975600

The beginning of the time range during which the data was queried.

PageInfos

The detailed log information, which is indicated by the PageInfoDetail parameter.

PageIndex Long 2

The page number of the returned page.

PageSize Long 10

The number of entries returned on each page

Total Long 20

The total number of entries returned.

DomainName String test1.example.com

The name of the accelerated domain returned.

RequestId String 077D0284-F041-4A41-A932-B48377FDAA25

The ID of the request.

Examples

Sample requests

http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainLog
&DomainName=example.com
&<Common request parameters>

Sample success responses

XML format

<DescribeDcdnDomainLogResponse>
	  <RequestId>077D0284-F041-4A41-A932-B48377FDAA25</RequestId>
	  <DomainLogDetails>
		    <DomainLogDetail>
			      <LogInfos>
				        <LogInfoDetail>
					          <LogName>example1.com_2018_03_25_180000_190000.gz</LogName>
					          <LogPath>cdnlog2.aliyuncs.com/test1.example.com/2018_03_25/example1.com_2018_03_25_180000_190000.gz? xxx</LogPath>
					          <EndTime>1521975600</EndTime>
					          <StartTime>1521972000</StartTime>
					          <LogSize>2645401</LogSize>
				        </LogInfoDetail>
				        <LogInfoDetail>
					          <LogName>example1.com_2018_03_25_190000_200000.gz</LogName>
					          <LogPath>cdnlog2.aliyuncs.com/test1.example.com/2018_03_25/example1.com_2018_03_25_190000_200000.gz? xxx</LogPath>
					          <EndTime>1521979200</EndTime>
					          <StartTime>1521975600</StartTime>
					          <LogSize>2653965</LogSize>
				        </LogInfoDetail>
			      </LogInfos>
			      <LogCount>20</LogCount>
			      <PageInfos>
				        <PageIndex>1</PageIndex>
				        <PageSize>20</PageSize>
				        <Total>20</Total>
			      </PageInfos>
			      <DomainName>test1.example.com</DomainName>
		    </DomainLogDetail>
	  </DomainLogDetails>
</DescribeDcdnDomainLogResponse>

JSON format

{
	"RequestId":"077D0284-F041-4A41-A932-B48377FDAA25",
	"DomainLogDetails":{
		"DomainLogDetail":[
			{
				"LogInfos":{
					"LogInfoDetail":[
						{
							"LogName":"example1.com_2018_03_25_180000_190000.gz",
							"LogPath":"cdnlog2.aliyuncs.com/test1.example.com/2018_03_25/example1.com_2018_03_25_180000_190000.gz? xxx",
							"EndTime":"1521975600",
							"LogSize":2645401,
							"StartTime":"1521972000"
						},
						{
							"LogName":"example1.com_2018_03_25_190000_200000.gz",
							"LogPath":"cdnlog2.aliyuncs.com/test1.example.com/2018_03_25/example1.com_2018_03_25_190000_200000.gz? xxx",
							"EndTime":"1521979200",
							"LogSize":2653965,
							"StartTime":"1521975600"
						}
					]
				},
				"LogCount":20,
				"PageInfos":{
					"PageSize":20,
					"PageIndex":1,
					"Total":20
				},
				"DomainName":"test1.example.com"
			}
		]
	}
}

Error codes

HTTP status code Error code Error message Description
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. The error message returned because the specified EndTime parameter is earlier than the specified StartTime parameter.

For a list of error codes, visit the API Error Center.