All Products
Search
Document Center

DescribeVodDomainLog

Last Updated: Jul 11, 2019

Description

You can call this operation to download raw CDN access logs for a specified domain name. For more information about the log format and latency, see Log management.

Note:

  • If you set neither the StartTime parameter nor the EndTime parameter, the log data in the last 24 hours is queried by default.
  • You can set both the StartTime and EndTime parameters to query logs generated in the specified duration.

Request parameters

Parameter Type Required Description
Action String Yes The operation that you want to perform. Set this parameter to DescribeVodDomainLog.
DomainName String Yes The domain name. You can specify only one domain name.
StartTime String No The beginning of the time range where the logs are queried.
  • Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
  • For example, 2016-10-20T04:00:00Z.
EndTime String No
  • The end of the time range where the logs are queried. The end time must be later than the start time.
  • The duration specified by StartTime and EndTime cannot exceed one year.
  • Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC.
  • For example, 2016-10-20T04:00:00Z.
PageSize Long No The number of entries to return on each page.
  • Default value: 300.
  • Maximum value: 1000.
  • Valid values: any integer of 1~1000.
PageNumber Long No The number of the page to return.
  • Default value: 1.
  • Valid values: any positive integer greater than or equal to 1.

Response parameters

Parameter Type Description
RequestId String The ID of the request.
DomainLogDetails DomainLogDetail[] The CDN log details.

DomainLogDetail

Parameter Type Description
DomainName String The domain name.
LogCount Long The total number of entries returned on the page.
LogInfos LogInfoDetail[] The CDN log details.
PageInfos PageInfoDetail The CDN log paging information.

LogInfoDetail

Parameter Type Description
LogName String The name of the log.
LogPath String The path of the log.
StartTime String The beginning of the time range where the logs are queried.
EndTime String The end of the time range where the logs are queried.
LogSize Long The size of the log.

PageInfoDetail

Parameter Type Description
PageNumber Long The number of the page returned.
PageSize Long The number of entries returned on each page.
Total Long The total number of entries returned.

API examples

Sample request

http://vod.cn-shanghai.aliyuncs.com/?Action=DescribeVodDomainLog&DomainName=example1.com&Format=JSON&<Common request parameters>

Note: For more information about common request parameters, see Common parameters.

Sample response

JSON format

{
    "RequestId": "077D0284-F041-4A41-A932-B48377FDAA25",
    "DomainLogDetails": {
        "DomainLogDetail": [
            {
                "LogInfos": {
                    "LogInfoDetail": [
                        {
                            "LogName": "example1.com_2018_03_25_180000_190000.gz",
                            "LogPath": "cdntest.example.com/example1.com/2018_03_25/example1.com_2018_03_25_180000_190000.gz? Expires=1522659931&OSSAccessKeyId=XXXXXX&Signature=XXXXXX",
                            "EndTime": "2018-05-31T04:00:00Z",
                            "StartTime": "2018-05-31T03:00:00Z",
                            "LogSize": 2645401
                        },
                        {
                            "LogName": "example1.com_2018_03_25_190000_200000.gz",
                            "LogPath": "cdntest.example.com/example1.com/2018_03_25/example1.com_2018_03_25_190000_200000.gz? Expires=1522659931&OSSAccessKeyId=XXXXXX&Signature=XXXXXX",
                            "EndTime": "2018-05-31T06:00:00Z",
                            "StartTime": "2018-05-31T05:00:00Z",
                            "LogSize": 2653965
                        }
                    ]
                },
                "LogCount": 2,
                "PageInfos": {
                    "PageSize":300,
                    "Total": 2,
                    "PageNumber": 1
                },
                "DomainName": "example1.com"
            }
        ]
    }
}