QueryDomainLogDownloadAddress-Documentation

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 30 min~1 hours of data delay

Data latency: 30min~1h
Single user trigger frequency: 300/5min
Applicable Products: Log Download

Request

Params Params

Name	Description
*dateFromString	Start time: 1.The format is yyyy-MM-ddTHH:mm:ss+08: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+08: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	Log type, optional values:cdn,bot,ddos; Multiple are separated by English commas. If they are not transmitted, the data will be queried by logtype = cdn,bot by default.

Body Params

Name	Description
- *domain-listObject
*domain-nameList	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

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 (Link valid for 24 hours)
fileSizeInteger	Size of log file

Error code

Error code(code)	Description(message)	HTTP status	Semantic
NotAcceptable	The accept header specified in your request is not acceptable.	400	Accept request header not supported, API supports json and xml format only, default is json format
MalformedXML	The XML you provided was not well-formed or did not validate against our published schema.	400	Request body XML format error
DomainNameIsRequired	The domain name is required.	400	Requrest body is specified and domain array is empty
DomainsExcessive	The number of domain is excessive once.	403	Number of queried domains exceeds limits set to the account
NoSuchDomain	The specified domain does not exist.	404	Domain does not exist, or does not belong to the current account that calls the interface
InvalidDatePeriod	The date specified is invalid.	400	Date from or dateto does not conform to the specification
DateSpanError	You cannot specify a period greater than 31.	400	Datefrom and dateto differ by more than 31 days
ReportError	report error.	400	System error ( log group interface response error and error code not 200 and 404) (no longer available, to be deleted)
InternalError	We encountered an internal error. Please try again.	500	System error
PARAM_INVALID	param: fileMd5 is null or invalid.	400	The parameter fileMd5 does not conform to specification

Example

JSON

Request example Copy 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?datefrom=2017-06-14T00:00:00%2B08:00&dateto=2017-06-17T00:00:00%2B08:00&logtype=cdn" \ -X "POST" \ -u "$username:$password" \ -H "Date: $date" \ -H "Accept: application/json" \ -d '{ "domain-list": { "domain-name": ["www.example1.com","www.example2.com"] } }'

#!/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?datefrom=2017-06-14T00:00:00%2B08:00&dateto=2017-06-17T00:00:00%2B08:00&logtype=cdn" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{
    "domain-list": {
        "domain-name": ["www.example1.com","www.example2.com"]
    }
}'

Response example Copy 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 } ] } ] }

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

QueryDomainLogDownloadAddress

Request

Params Params

Body Params

Response

Body Params

Error code

Example

Directory