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

Note
  • If you do not specify the StartTime and EndTime parameters, the log data that is collected over the last 24 hours is returned. If you specify both the StartTime and EndTime parameters, the log data that is collected within the time range that you specify is returned.
  • The maximum number of times that each user can call this operation per second is 100.

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 that you want to query. You can specify only one domain name in each request.

PageSize Long No 300

The number of entries to return on each page.

Valid values: 1 to 1000. Default value: 300. Maximum value: 1000.

PageNumber Long No 1

The number of the page to return. Pages start from page 1.

Default value: 1.

StartTime String No 2021-11-07T17:00:00Z

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.

EndTime String No 2021-11-07T18:00:00Z

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 array consists of multiple DomainLogDetail parameters. The details about the logs of a domain name are included in a separate DomainLogDetail parameter.

DomainLogDetail
LogCount Long 4

The total number of entries returned on the current page.

LogInfos Array of LogInfoDetail

The array consists of multiple LogInfoDetail parameters. The details about each log are included in a separate LogInfoDetail parameter.

LogInfoDetail
EndTime String 2021-11-07T18:00:00Z

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

LogName String example.com_2021_11_08_010000_020000.gz

The name of the log file.

LogPath String example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_010000_020000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=u0V6foRfZniHE8i%2BHUdxGOhZsK****

The path of the log file.

You need to take note of the Expires field in the LogPath parameter. The Expires field indicates the timestamp when the log file expires. After the log file expires, the log download URL becomes invalid, and you must obtain the download URL again. For more information, see Add signatures to a URL.

LogSize Long 192

The size of the log file.

StartTime String 2021-11-07T17:00:00Z

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

PageInfos Struct

The information about the page. The information about the page is indicated by the PageInfoDetail parameter.

PageIndex Long 1

The page number of the returned page.

PageSize Long 10

The number of entries returned per page.

Total Long 4

The total number of returned entries.

DomainName String example.com

The domain name for which the data was queried.

RequestId String 95594003-CAC5-5636-AF72-2A094364****

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>95594003-CAC5-5636-AF72-2A094364****</RequestId>
  <DomainName>example.com</DomainName>
  <DomainLogDetails>
        <DomainLogDetail>
              <LogInfos>
                    <LogInfoDetail>
                          <LogSize>192</LogSize>
                          <EndTime>2021-11-07T18:00:00Z</EndTime>
                          <StartTime>2021-11-07T17:00:00Z</StartTime>
                          <LogName>example.com_2021_11_08_010000_020000.gz</LogName>
                          <LogPath>example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_010000_020000.gz?Expires=1636963354&amp;OSSAccessKeyId=LTAIviCc6zy8****&amp;Signature=u0V6foRfZniHE8i%2BHUdxGOhZsK****</LogPath>
                    </LogInfoDetail>
                    <LogInfoDetail>
                          <LogSize>226</LogSize>
                          <EndTime>2021-11-07T20:00:00Z</EndTime>
                          <StartTime>2021-11-07T19:00:00Z</StartTime>
                          <LogName>example.com_2021_11_08_030000_040000.gz</LogName>
                          <LogPath>example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_030000_040000.gz?Expires=1636963354&amp;OSSAccessKeyId=LTAIviCc6zy8****&amp;Signature=GPETaV9ydedqtQxoEcVONxQvY****</LogPath>
                    </LogInfoDetail>
                    <LogInfoDetail>
                          <LogSize>260</LogSize>
                          <EndTime>2021-11-07T21:00:00Z</EndTime>
                          <StartTime>2021-11-07T20:00:00Z</StartTime>
                          <LogName>example.com_2021_11_08_040000_050000.gz</LogName>
                          <LogPath>example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_040000_050000.gz?Expires=1636963354&amp;OSSAccessKeyId=LTAIviCc6zy8****&amp;Signature=WIOGy%2BLRp86zpex%2FCGOETf6UUg****</LogPath>
                    </LogInfoDetail>
                    <LogInfoDetail>
                          <LogSize>413</LogSize>
                          <EndTime>2021-11-07T22:00:00Z</EndTime>
                          <StartTime>2021-11-07T21:00:00Z</StartTime>
                          <LogName>example.com_2021_11_08_050000_060000.gz</LogName>
                          <LogPath>example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_050000_060000.gz?Expires=1636963354&amp;OSSAccessKeyId=LTAIviCc6zy8****&amp;Signature=vZpNRaKuaFsOB7RT%2F%2BS8wjfmjO****</LogPath>
                    </LogInfoDetail>
              </LogInfos>
              <PageInfos>
                    <PageSize>10</PageSize>
                    <Total>4</Total>
                    <PageIndex>1</PageIndex>
              </PageInfos>
              <LogCount>4</LogCount>
        </DomainLogDetail>
  </DomainLogDetails>
</DescribeDcdnDomainLogResponse>

JSON format

{
    "RequestId": "95594003-CAC5-5636-AF72-2A094364****",
    "DomainName": "example.com",
    "DomainLogDetails": {
        "DomainLogDetail": [
            {
                "LogInfos": {
                    "LogInfoDetail": [
                        {
                            "LogSize": 192,
                            "EndTime": "2021-11-07T18:00:00Z",
                            "StartTime": "2021-11-07T17:00:00Z",
                            "LogName": "example.com_2021_11_08_010000_020000.gz",
                            "LogPath": "example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_010000_020000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=u0V6foRfZniHE8i%2BHUdxGOhZsK****"
                        },
                        {
                            "LogSize": 226,
                            "EndTime": "2021-11-07T20:00:00Z",
                            "StartTime": "2021-11-07T19:00:00Z",
                            "LogName": "example.com_2021_11_08_030000_040000.gz",
                            "LogPath": "example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_030000_040000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=GPETaV9ydedqtQxoEcVONxQvY****"
                        },
                        {
                            "LogSize": 260,
                            "EndTime": "2021-11-07T21:00:00Z",
                            "StartTime": "2021-11-07T20:00:00Z",
                            "LogName": "example.com_2021_11_08_040000_050000.gz",
                            "LogPath": "example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_040000_050000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=WIOGy%2BLRp86zpex%2FCGOETf6UUg****"
                        },
                        {
                            "LogSize": 413,
                            "EndTime": "2021-11-07T22:00:00Z",
                            "StartTime": "2021-11-07T21:00:00Z",
                            "LogName": "example.com_2021_11_08_050000_060000.gz",
                            "LogPath": "example.aliyundoc.com /v1.l1cache/105252530/example.com/2021_11_08/example.com_2021_11_08_050000_060000.gz?Expires=1636963354&OSSAccessKeyId=LTAIviCc6zy8****&Signature=vZpNRaKuaFsOB7RT%2F%2BS8wjfmjO****"
                        }
                    ]
                },
                "PageInfos": {
                    "PageSize": 10,
                    "Total": 4,
                    "PageIndex": 1
                },
                "LogCount": 4
            }
        ]
    }
}

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 end time is earlier than the start time.

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