QueryDomainLogDownloadAddress
Report Log Multi-Domain Service Interface description Query the log download address of multiple domains. The default granularity of log file is 24 hours and data are returned according to the actual configurations. Around 3-5 hours of data delay
- Data latency: 3~5h
- Limit of request rate per user: 300/5min
- Applicable Products: Log Download
Request
Body Params
| Name | Description |
|---|---|
domain-listObject | Domain list: 1.The default upper limit of the number of domain names is 20 (you can contact technical support for adjustment), The maximum recommended cap is 500 . |
*domain-nameList | Domain |
*datefromString | Start time: 1.The format is yyyy-MM-ddTHH:mm:ss+00:00 ; 2.Must be smaller than the current time and dateTo ; 3.Period between dataFrom and dateTo cannot be longer than 31 days . |
*datetoString | End time, format is yyyy-MM-ddTHH:mm:ss+00:00(The actual range of logs that can be queried depends on the number of days of log retention configured by the domain name). |
logTypeString | Default value: cdnbot Optional Value: cdnbotddoswaapwaf Log type, optional values:cdn,bot,ddos,waap,waf;Multiple are separated by English commas. If they are not transmitted, the data will be queried by logtype = cdn,bot by default. |
areaCodeString | Optional Value: Parameter Values areaCode |
Response
Body Params
| Name | Description |
|---|---|
logsList | |
domainString | Domain |
areaCodeString | areaCode |
filesList | |
dateFromString | The start time of log file, format is yyyy-MM-dd-HHmm |
dateToString | The end time of log file, format is yyyy-MM-dd-HHmm |
logUrlString | Download address of log file |
fileSizeInteger | Size of log file |
Error code
| Error code(code) | Description(message) | HTTP status | Semantic |
|---|---|---|---|
| NotAcceptable | Accept request header not supported, API supports json and xml format only, default is json format | 400 | Accept request header not supported, API supports json and xml format only, default is json format |
| MalformedXML | Request body XML format error | 400 | Request body XML format error |
| DomainNameIsRequired | Requrest body is specified and domain array is empty | 400 | Requrest body is specified and domain array is empty |
| DomainsExcessive | Number of queried domains exceeds limits set to the account | 403 | Number of queried domains exceeds limits set to the account |
| NoSuchDomain | Domain does not exist, or does not belong to the current account that calls the interface | 404 | Domain does not exist, or does not belong to the current account that calls the interface |
| InvalidDatePeriod | Date from or dateto does not conform to the specification | 400 | Date from or dateto does not conform to the specification |
| DateSpanError | Datefrom and dateto differ by more than 31 days | 400 | Datefrom and dateto differ by more than 31 days |
| ReportError | System error ( log group interface response error and error code not 200 and 404) (no longer available, to be deleted) | 400 | System error ( log group interface response error and error code not 200 and 404) (no longer available, to be deleted) |
| InternalError | System error | 500 | System error |
| PARAM_INVALID | The parameter fileMd5 does not conform to specification | 400 | The parameter fileMd5 does not conform to specification |
Example
- Request example Copy success
#!/bin/bash # Please remember to change the param (-H "X-Time-Zone") in this demo to the TimeZone you want in response #!/bin/bash username="example_username" apiKey="example_apiKey" date=`env LANG="en_US.UTF-8" date -u "+%a, %d %b %Y %H:%M:%S GMT"` password=`echo -en "$date" | openssl dgst -sha1 -hmac $apiKey -binary | openssl enc -base64` curl -i --url "https://api.cdnetworks.com/api/report/log/downloadLink" \ -X "POST" \ -H "X-Time-Zone:GMT+00:00" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{ "domain-list": { "domain-name": ["www.example1.com","www.example2.com"] }, "datefrom":"2017-06-14T00:00:00+00:00", "dateto":"2017-06-17T00:00:00+00:00", "logType":"cdn" }'- Response example Copy success
{ "logs": [ { "domainName": "www.example1.com", "files": [ { "dateFrom": "2017-06-14-0000", "dateTo": "2017-06-14-2359", "logUrl": "http://dx.wslog.chinanetcenter.com/log/c/www.example1.com/2017-06-14-0000-2330_www.example1.com.cn.log.gz?wskey=00c6ae5d3570005382bc74485900f4edac8d5f00152a", "fileSize": 17397875 }, { "dateFrom": "2017-06-16-0000", "dateTo": "2017-06-16-2359", "logUrl": "http://dx.wslog.chinanetcenter.com/log/c/www.example1.com/2017-06-16-0000-2330_www.example1.com.cn.log.gz?wskey=00c65bc688020053c99ef01a59008f8234e55f00983e", "fileSize": 10570627 } ] } ] }