GetDomainLogs

本接口用于获取指定域名的原始访问日志的下载地址、日志总条数、日志大小及日志文件MD5值。

接口描述

当查询开始时间和查询结束时间均不指定时，默认查询时间为当天；
默认只支持33天内的日志下载。

请求语法

本接口请求需要包含指定目录/V3/GetDomainLogs、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数名称	是否必选	参数类型	示例值	参数说明
DomainId	是	String	2D09X6F	域名ID，只支持单个域名输入
StartTime	否	String	2022-10-03	查询开始时间，格式yyyy-MM-dd，开始时间和结束时间均不指定时，默认是当天
EndTime	否	String	2022-10-03	查询结束时间，格式yyyy-MM-dd，开始时间和结束时间均不指定时，默认是当天；若已指定开始时间StartTime，则EndTime为必填项
PageSize	否	Long	50	分页大小，取值为1-500，最大值为500，默认值为50
PageNumber	否	Long	1	取得第几页，取值为：1-10000，最大值为10000，默认值为1

返回参数

参数名称	参数类型	示例值	参数说明
DomainId	String	2D09X6F	域名ID
PageSize	Long	50	整页大小
PageNumber	Long	1	页码
TotalCount	Long	2	日志总条数
DomainLogs	DomainLogData[]		日志信息数据

DomainLogData

参数名称	参数类型	示例值	参数说明
StartTime	String	2022-10-03	日志开始时间
EndTime	String	2022-10-03	日志结束时间
LogName	String	2022-10-03-18-00.gz	日志名称
LogUrl	String	http://kss.ksyun.com/bucket/test.com/2022-10-03-18-00.log.gz?AccessKeyId=XXXXX&Expires=1487331449&Signature=XXXXXX&response-content-disposition=attachment	日志下载地址，33天后过期
LogSize	String	5242880	日志大小，单位Byte
MD5	String	21232f297a57a5a743894a0e4a801fc3	日志文件的MD5值

示例

请求示例

GET方式

GET /V3/GetDomainLogs?PageNumber=1
&PageSize=2
&StartTime=2022-10-03&EndTime=2022-10-03&DomainId=2D09X6F 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainLogs
x-version: V3

POST方式

POST /V3/GetDomainLogs 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainLogs
x-version: V3
Content-Type: application/json
{
 "StartTime": "2022-10-03",
 "EndTime": "2022-10-03",
 "PageNumber": 1,
 "PageSize": 2,
 "DomainId":"2D09X6F"
 }

返回示例

{
  "DomainId": "2D09X6F",
  "PageSize": 2,
  "PageNumber": 1,
  "TotalCount": 0,
  "DomainLogs": [
    {
      "StartTime": "2022-10-03",
      "EndTime": "2022-10-03",
      "LogName": "2022-10-03.gz",
      "LogUrl": "http://kss.ksyun.com/bucket/test.com/2022-10-03-18-00.log.gz?AccessKeyId=XXXXX&Expires=1487331449&Signature=XXXXXX&response-content-disposition=attachment",
      "LogSize": "5242880",
      "MD5": "21232f297a57a5a743894a0e4a801fc3"
    }
  ]
}

文档导读

上一篇：查询日志服务状态

下一篇：证书管理接口

纯净模式常规模式

纯净模式

点击可全屏预览文档内容