CDN加速

文档中心 API文档 日志报表 查询多域名的日志下载地址

查询多域名的日志下载地址

更新时间:2021-04-29 15:05:54
适用产品:通用功能

接口描述

查询多个域名的日志下载地址。日志文件粒度默认为24小时,返回的数据以实际配置为准。

请求参数

参数名称类型必填描述
datefromString开始时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须小于当前时间和dateTo; 3.dateFrom和dateTo相差不能超过31天(可联系技术支持调整); 4.只能查询最近2年内数据。(实际可查询的日志范围,取决于域名配置的日志保留天数)
datetoString结束时间,格式为yyyy-MM-ddTHH:mm:ss+08:00; (实际可查询的日志范围,取决于域名配置的日志保留天数)
domain-listArray域名列表 1.不传递则查询全部域名; 2.域名个数限制跟进账号可调,默认20个(不传递时同样受此限制)。
domain-nameString域名

返回参数

参数名称类型描述
domainString域名
dateFromString日志文件的开始时间,格式为yyyy-MM-dd-HHmm
dateToString日志文件的结束时间,格式为yyyy-MM-dd-HHmm
logUrlString日志文件下载地址
fileSize int日志文件大小

错误码

错误代码(code)描述(message)HTTP状态码语义
NotAcceptableThe accept header specified in your request is not acceptable.400Accept请求头不支持,接口仅支持json和xml格式,默认为json格式
MalformedXMLThe XML you provided was not well-formed or did not validate against our published schema.400请求体XML格式错误
DomainNameIsRequiredThe domain name is required.400请求体有传递且域名数组为空
DomainsExcessiveThe number of domain is excessive once.403传递的任务个数超过账号限制
NoSuchDomainThe specified domain does not exist.404传递的域名不存在
InvalidDatePeriodThe date specified is invalid.400datefrom或dateto不符合规范
DateSpanErrorYou cannot specify a period greater than 31.400datefrom和dateto相差超过31天
ReportErrorreport error.400系统发生错误(日志组接口返回错误,且错误码非200和404)
InternalErrorWe encountered an internal error. Please try again.500系统发生错误
PARAM_INVALIDparam: fileMd5 is null or invalid.400参数fileMd5不符合规范

示例

示例说明
请求示例
复制
#!/bin/bash
# 请将示例中的(-H "X-Time-Zone") 参数设置为您希望在返回结果中获得的时区
# 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://open.chinanetcenter.com/api/report/log/downloadLink?datefrom=2017-11-01T00:00:00%2B08:00&dateto=2017-11-02T00:00:00%2B08:00" \
-X "POST" \
-u "$username:$password" \
-H "Date: $date" \
-H "Accept: application/json" \
-d '{
    "domain-list": {
        "domain-name": ["www.example1.com"]
    }
}'
返回示例
复制
{
      "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
                        
                  }
              ]
          }
      ]
  }