Queries the address where you can download the raw access log data of a specified domain name.

Note If you specify neither the StartTime parameter nor the EndTime parameter, the data within the last 24 hours is returned. If you specify the StartTime and EndTime parameters, the data within the specified time range is returned.

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 accelerated domain name. You can specify only one domain name in each call.

PageSize Long No 300

The number of entries returned on each page.

Valid values: 1 to 1,000. Default value: 300. The maximum value: 1,000.

PageNumber Long No 2

The number of the page to return. Valid values: an integer greater than 1.

Default value: 1.

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

The start 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.

EndTime String No 2017-01-01T12:13: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.

Note The end time must be later than the start time.

Response parameters

Parameter Type Example Description
DomainLogDetails Array of DomainLogDetail

The log information. The log information is indicated by the DomainLogDetail parameter.

DomainLogDetail
LogCount Long 12

The total number of entries returned on the current page.

LogInfos Array of LogInfoDetail

The log information. The log information is indicated by the LogInfoDetail parameter.

LogInfoDetail
EndTime String 1521979200

The end time.

LogName String example1.com_2018_03_25_190000_200000.gz

The name of the log.

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 start time.

PageInfos Struct

The page information. The page information 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 accelerated domain name for which you want to query the data.

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>
  <DomainName>test1.example.com</DomainName>
  <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>
        </DomainLogDetail>
  </DomainLogDetails>
</DescribeDcdnDomainLogResponse>

JSON format

{
    "RequestId": "077D0284-F041-4A41-A932-B48377FDAA25",
    "DomainName": "test1.example.com",
    "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",
                            "StartTime": "1521972000",
                            "LogSize": 2645401
                        },
                        {
                            "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",
                            "StartTime": "1521975600",
                            "LogSize": 2653965
                        }
                    ]
                },
                "LogCount": 20,
                "PageInfos": {
                    "PageIndex": 1,
                    "PageSize": 20,
                    "Total": 20
                }
            }
        ]
    }
}

Error codes

HttpCode Error code Error message Description
400 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. The error message returned because the specified end time is earlier than the specified start time.

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