GetDomainLogs

描述

获取指定域名的原始访问日志的下载地址。

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

请求语法

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

请求参数

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

返回参数

参数名	类型及范围	说明
DomainId	String	域名ID
PageSize	Long	整页大小
PageNumber	Long	页码
TotalCount	Long	日志总条数
DomainLogs	DomainLogData[]	日志信息数据

DomainLogData

参数名	类型及范围	说明
StartTime	String	日志开始时间
EndTime	String	日志结束时间
LogName	String	日志名称
LogUrl	String	日志下载地址，33天后过期
LogSize	String	日志大小，单位Byte

示例

请求示例

GET方式：

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

POST方式：

POST /2016-09-01/log/GetDomainLogs 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: GetDomainLogs
x-version: 2016-09-01
Content-Type: application/json

{
    "StartTime": "2017-01-03",
    "EndTime": "2017-01-03",
    "PageNumber": 1,
    "PageSize": 2,
    "DomainId": "2D09X6F"
}

返回示例

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

错误码

为了帮您快速定位问题，WCDN将错误码集中归类，请到【使用须知】查看详情。