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

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

更新时间:2022-09-29 11:08:53

适用产品

日志下载

接口描述

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

推荐使用 Open API在线调试

Open API在线调试功能提供可视化界面在线调试API、支持生成代码示例、快速检索查看API文档等能力。前往调试

请求参数

Params 参数

参数名称类型必填描述
datefrom
String开始时间 1.格式为yyyy-MM-ddTHH:mm:ss+08:00; 2.必须小于当前时间和dateTo; 3.dateFrom和dateTo相差不能超过31天(可联系技术支持调整); 4.只能查询最近2年内数据。(实际可查询的日志范围,取决于域名配置的日志保留天数)
dateto
String结束时间,格式为yyyy-MM-ddTHH:mm:ss+08:00; (实际可查询的日志范围,取决于域名配置的日志保留天数)

Body 参数

参数名称类型必填描述
logType
String日志类型,可选值:cdn,bot,ddos,waf 多个通过英文逗号分隔,若未传则默认按logtype=cdn,bot,waf查询数据
domain-list
DomainList域名列表 1.不传递则查询全部域名; 2.域名数量默认上限为20个(可联系技术支持调整)。 最大推荐上限为 500。
domain-name
List域名

返回参数

Body 参数

参数名称类型描述
logs
Listundefined
domain
String域名
files
Listundefined
dateFrom
String日志文件的开始时间,格式为yyyy-MM-dd-HHmm
dateTo
String日志文件的结束时间,格式为yyyy-MM-dd-HHmm
logUrl
String日志文件下载地址
fileSize
Integer日志文件大小

错误码

错误代码(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不符合规范

示例

JSON
XML
JSON
请求示例
复制代码 复制成功
#!/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
                        
                  }
              ]
          }
      ]
  }
本篇文档内容对您是否有帮助?
有帮助
没帮助
提交成功!非常感谢您的反馈,我们会继续努力做到更好!