human: 如何处理七牛云的CDN日志下载

gpt: [CDN](https://developer.qiniu.com/fusion) > API 文档 > 日志下载

#  日志下载

最近更新时间: 2023-12-06 15:01:10

日志下载接口可以查询域名日志列表，获取日志的下载外链，只提供 30 个自然日内的日志下载，例如当前日期为 2016-08-31，则只提供
2016-08-01 ~ 2016-08-30 的日志。

日志文件默认按小时下载，如果单小时内日志过大会进行切分(分片大小128MB)，日志文件采用gzip压缩。  
日志大概延迟6小时，举例：1月18日0点-1点的日志，会在1月18日8点-10点左右可下载。

# 访问域名

    
    
    Host: fusion.qiniuapi.com
    

# 接口地址

    
    
    /v2/tune/log/list
    

# 认证授权

    
    
    Authorization: <access_token>
    

access_token 详细描述请查阅[这里](https://developer.qiniu.com/kodo/manual/access-
token)。

# 请求报文

## 请求语法

    
    
    POST /v2/tune/log/list
    Content-Type: application/json
    
    {
        "day":<Day>,
        "domains": <Domains>
    }
    

## 请求内容

参数 | 类型 | 必须 | 描述  
---|---|---|---  
`<Day>` | string | 是 | 日期，例如 2016-07-01  
`<Domains>` | string | 是 | 域名列表，以英文分号 ; 分割  
  
# 响应报文

## 响应状态码

HTTP状态码 | 含义 | 说明  
---|---|---  
200 | success | 成功  
400 | invalid params | 请求参数格式错误  
401 | bad token | 认证授权失败（包括密钥信息不正确；数字签名错误；授权已超时）  
400032 | invalid host | 请求中存在无效的域名，请确保域名格式正确  
500000 | internal error | 服务器内部错误  
  
## 响应内容

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
        "code":<Code>,
        "error": <Error>,
        "data": {
                ...
                <Domain_i>:[
                    ...
                    {   
                        "name":<Name>,
                        "size":<Size>,
                        "mtime":<Mtime>,
                        "url":<Url>
                    },
                    ...
                ],
                ...
        }
    }
    

参数 | 类型 | 说明  
---|---|---  
Code | int | HTTP 状态码，整型，见响应状态码  
Error | string | 自定义错误码描述，字符串  
data | map | 日志数据  
Domain_i | string | 域名，字符串  
Domain_i_Name | string | 文件名，字符串  
Domain_i_Size | int64 | 文件大小，单位为 Byte  
Domain_i_Mtime | int64 | 文件修改时间，Unix 时间戳  
Domain_i_Url | string | 下载链接，字符串  
  
# 示例

## 请求示例

    
    
    POST https://fusion.qiniuapi.com/v2/tune/log/list
    Content-Type: application/json
    
    {
        "day":"2016-07-01",
        "domains": "log-test1.qiniu.com;log-test2.qiniu.com"
    }
    

## 响应示例

    
    
    HTTP/1.1 200 OK
    Content-Type: application/json
    
    {
        "data": {
            "log-test1.qiniu.com": [
                {
                    "name":"log-test1.qiniu.com_2016-07-01-00_00.gz",
                    "size": 88490306,
                    "mtime": 1466274440,
                    "url": "https://fusionlog.qiniu.com/log-test1.qiniu.com_2016-07-01-00_00.gz?e=1561008052&token=557TpseUM8ovpfUhaw8gfa2DQ0104ZScM-BTIcBx:8AUwyRCO6nwb8vTH_LNKg4016Ec"
                }
            ],
            "log-test2.qiniu.com": [
                {
                    "name":"log-test2.qiniu.com_2016-07-01-00_00.gz",
                    "size": 73280873,
                    "mtime": 1466273259,
                    "url": "https://fusionlog.qiniu.com/log-test2.qiniu.com_2016-07-01-00_00.gz?e=1561008052&token=336DepseUM8ovpfUhaw8gfa2DQ0104ZScM-BTIcBx:8AUwyRCO6nwb8vTH_LNKg3879Wd"
                }
            ]
        }
    }
    

# 日志格式

    
    
    IP 命中率 响应时间(毫秒) 请求时间 请求方法 请求URL	请求协议 状态码 响应大小 referer 用户代理
    ClientIP Hit/Miss ResponseTime [Time Zone] Method URL Protocol StatusCode TrafficSize Referer UserAgent
    

以上内容是否对您有帮助？