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

Note
  • If you do not set StartTime or EndTime, data collected within the last 24 hours is queried. If you set both StartTime and EndTime, data collected within the specified time range is queried.
  • The log data was collected at an interval of 1 hour.
  • 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 software development kits (SDKs).

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeCdnDomainLogs

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

DomainName String Yes example.com

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

PageSize Long No 300

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

PageNumber Long No 2

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

StartTime String No 2017-12-21T08: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+0.

EndTime String No 2017-12-22T08: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+0.

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

Response parameters

Parameter Type Example Description
DomainLogDetails Array of DomainLogDetail

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

DomainLogDetail
DomainName String example.com

The accelerated domain name.

LogCount Long 10

The total number of entries returned on the current page.

LogInfos Array of LogInfoDetail

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

LogInfoDetail
EndTime String 2015-05-23T14:00:00Z

The end of the time range where the QPS data was queried.

LogName String demo.aliyundoc.com_2015_05_23_2100_2200.gz

The name of the log file.

LogPath String guide.aliyundoc.com-hangzhou.xxx

The path of the log file.

LogSize Long 258

The size of the log file.

StartTime String 2015-05-23T13:00:00Z

The start of the time range that was queried.

PageInfos Struct

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

PageIndex Long 1

The page number of the returned page.

PageSize Long 20

The number of entries returned per page.

Total Long 20

The total number of entries returned.

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

The ID of the request.

Examples

Sample requests

http(s)://cdn.aliyuncs.com/?Action=DescribeCdnDomainLogs
&DomainName=example.com
&StartTime=2017-12-21T08:00:00Z
&EndTime=2017-12-22T08:00:00Z
&<Common request parameters>

Sample success responses

XML format 

<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 format 

{
    "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"
            }
        ]
    }
}

Error codes

HttpCode Error code Error message Required
400 InvalidStartTime.Malformed Specified StartTime is malformed. The error message returned because the format of the specified start time is invalid. For more information about the time format, see the Request parameters section.
400 InvalidEndTime.Malformed Specified EndTime is malformed. The error message returned because the format of the specified end time is invalid. For more information about the time format, see the Request parameters section.
400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. The error message returned because the specified start time is invalid. Rectify the start time and try again.

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