最近更新时间: 2026-06-04 16:38:41

1. 快速查阅区

1.1 核心接口概览

接口功能	请求方法	接口路径	核心参数	成功响应
获取日志下载链接	POST	`/v2/tune/log/list`	day、domains	`{"code":200,"data":{...}}`

1.2 核心约束

请求域名: fusion.qiniuapi.com
鉴权方式: QBox 鉴权（详见鉴权指南）；
数据保留: 30 天，例如：当前日期为 2026-01-31，则只提供 2026-01-01 ~ 2026-01-30 的日志；
日志粒度: 每小时一个 gz 压缩文件，单小时内日志过大会进行切分(分片大小128MB)；
日志延迟: 6小时，例如：1月18日0点-1点的日志，会在1月18日8点-10点左右可下载。

2. 详细接口说明

2.1 获取日志下载链接

基本信息

请求方法: POST
接口地址: https://fusion.qiniuapi.com/v2/tune/log/list

请求参数

参数名	类型	必填	说明	示例值
day	string	是	查询日期，格式 yyyy-MM-dd，仅支持单日	`"2026-02-12"`
domains	string	是	域名，分号分隔 (同用量统计，非数组)	`"a.com;b.com"`

domains 为 string 类型，传数组会报 400。

请求示例

curl -X POST 'https://fusion.qiniuapi.com/v2/tune/log/list' \
  -H 'Host: fusion.qiniuapi.com' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: QBox <AK>:<Sign>' \
  -d '{"day":"2026-02-12","domains":"test.example.com"}'

响应参数

参数名	类型	说明
name	string	日志文件名 (含域名+日期+小时)
size	int	文件大小 (byte)
mtime	int	文件修改时间 (Unix 时间戳)
url	string	带签名的下载链接 (有时效)
md5	string	文件 MD5
domain	string	所属域名

响应示例

成功 (HTTP 200):

{
  "code": 200,
  "error": "",
  "data": {
    "test.example.com": [
      {
        "name": "v2/test.example.com_2026-02-12-07_part-00000.gz",
        "size": 311,
        "mtime": 1770868332,
        "url": "https://fusionlog.qiniu.com/v2/test.example.com_2026-02-12-07_part-00000.gz?e=...&token=...",
        "md5": "",
        "domain": "test.example.com"
      }
    ]
  }
}

data 按域名分组，每个域名对应一个日志文件数组。无数据时对应域名的数组为空。

失败:

{
    "code": 400,
    "error": "请求参数格式错误",
    "data": {}
}

日志格式

每行一条记录，字段顺序如下：

示例日志:

148.153.188.135 UNKNOWN 1 [13/Feb/2026:12:09:15 +0800] "GET https://test.example.com/qiniu_do_not_delete.gif HTTP/1.1" 403 345 "-" "Q-uc-client"

字段说明:

序号	字段	说明	示例
1	ClientIP	客户端 IP	`148.153.188.135`
2	Hit/Miss	命中状态	`HIT` / `MISS` / `UNKNOWN`
3	ResponseTime	响应时间 (毫秒)	`1`
4	Time	请求时间 ([] 包裹)	`[13/Feb/2026:12:09:15 +0800]`
5	Method	请求方法 ("" 包裹 5-7)	`GET`
6	URL	请求 URL (含域名完整路径)	`https://test.example.com/qiniu_do_not_delete.gif`
7	Protocol	请求协议	`HTTP/1.1`
8	StatusCode	HTTP 状态码	`403`
9	TrafficSize	响应大小 (byte)	`345`
10	Referer	来源页 ("" 包裹)	`"-"`
11	UserAgent	用户代理 ("" 包裹)	`"Q-uc-client"`

格式说明: Method+URL+Protocol 被 "" 包裹为一组，Referer 和 UserAgent 各自被 "" 包裹。

3. 常见问题

3.1 专属错误码

错误码	描述	场景	解决方案
400	参数格式错误	日期格式非 yyyy-MM-dd 或 domains 传数组	修正参数格式
400032	请求中存在无效的域名	域名未接入 CDN 或拼写错误	确认域名已创建且上线

3.2 最佳实践

查询时机: 日志延迟6小时，查询前日日志，建议次日上午查询
下载链接: url 含时效签名，获取后尽快下载
domains 格式: string 类型分号分隔，同用量统计
日志命名: 域名_日期-小时_part-序号.gz，按小时拆分
批量下载: 多域名一次查询，响应按域名分组

参考: 鉴权详见鉴权指南，错误码详见公共错误码&通用约束。

最近更新时间: 2026-06-04 16:38:41

1. 快速查阅区

1.1 核心接口概览

接口功能	请求方法	接口路径	核心参数	成功响应
获取日志下载链接	POST	`/v2/tune/log/list`	day、domains	`{"code":200,"data":{...}}`

1.2 核心约束

请求域名: fusion.qiniuapi.com
鉴权方式: QBox 鉴权（详见鉴权指南）；
数据保留: 30 天，例如：当前日期为 2026-01-31，则只提供 2026-01-01 ~ 2026-01-30 的日志；
日志粒度: 每小时一个 gz 压缩文件，单小时内日志过大会进行切分(分片大小128MB)；
日志延迟: 6小时，例如：1月18日0点-1点的日志，会在1月18日8点-10点左右可下载。

2. 详细接口说明

2.1 获取日志下载链接

基本信息

请求方法: POST
接口地址: https://fusion.qiniuapi.com/v2/tune/log/list

请求参数

参数名	类型	必填	说明	示例值
day	string	是	查询日期，格式 yyyy-MM-dd，仅支持单日	`"2026-02-12"`
domains	string	是	域名，分号分隔 (同用量统计，非数组)	`"a.com;b.com"`

domains 为 string 类型，传数组会报 400。

请求示例

curl -X POST 'https://fusion.qiniuapi.com/v2/tune/log/list' \
  -H 'Host: fusion.qiniuapi.com' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: QBox <AK>:<Sign>' \
  -d '{"day":"2026-02-12","domains":"test.example.com"}'

响应参数

参数名	类型	说明
name	string	日志文件名 (含域名+日期+小时)
size	int	文件大小 (byte)
mtime	int	文件修改时间 (Unix 时间戳)
url	string	带签名的下载链接 (有时效)
md5	string	文件 MD5
domain	string	所属域名

响应示例

成功 (HTTP 200):

{
  "code": 200,
  "error": "",
  "data": {
    "test.example.com": [
      {
        "name": "v2/test.example.com_2026-02-12-07_part-00000.gz",
        "size": 311,
        "mtime": 1770868332,
        "url": "https://fusionlog.qiniu.com/v2/test.example.com_2026-02-12-07_part-00000.gz?e=...&token=...",
        "md5": "",
        "domain": "test.example.com"
      }
    ]
  }
}

data 按域名分组，每个域名对应一个日志文件数组。无数据时对应域名的数组为空。

失败:

{
    "code": 400,
    "error": "请求参数格式错误",
    "data": {}
}

日志格式

每行一条记录，字段顺序如下：

示例日志:

148.153.188.135 UNKNOWN 1 [13/Feb/2026:12:09:15 +0800] "GET https://test.example.com/qiniu_do_not_delete.gif HTTP/1.1" 403 345 "-" "Q-uc-client"

字段说明:

序号	字段	说明	示例
1	ClientIP	客户端 IP	`148.153.188.135`
2	Hit/Miss	命中状态	`HIT` / `MISS` / `UNKNOWN`
3	ResponseTime	响应时间 (毫秒)	`1`
4	Time	请求时间 ([] 包裹)	`[13/Feb/2026:12:09:15 +0800]`
5	Method	请求方法 ("" 包裹 5-7)	`GET`
6	URL	请求 URL (含域名完整路径)	`https://test.example.com/qiniu_do_not_delete.gif`
7	Protocol	请求协议	`HTTP/1.1`
8	StatusCode	HTTP 状态码	`403`
9	TrafficSize	响应大小 (byte)	`345`
10	Referer	来源页 ("" 包裹)	`"-"`
11	UserAgent	用户代理 ("" 包裹)	`"Q-uc-client"`

格式说明: Method+URL+Protocol 被 "" 包裹为一组，Referer 和 UserAgent 各自被 "" 包裹。

3. 常见问题

3.1 专属错误码

错误码	描述	场景	解决方案
400	参数格式错误	日期格式非 yyyy-MM-dd 或 domains 传数组	修正参数格式
400032	请求中存在无效的域名	域名未接入 CDN 或拼写错误	确认域名已创建且上线

3.2 最佳实践

查询时机: 日志延迟6小时，查询前日日志，建议次日上午查询
下载链接: url 含时效签名，获取后尽快下载
domains 格式: string 类型分号分隔，同用量统计
日志命名: 域名_日期-小时_part-序号.gz，按小时拆分
批量下载: 多域名一次查询，响应按域名分组

参考: 鉴权详见鉴权指南，错误码详见公共错误码&通用约束。

日志下载

1. 快速查阅区

1.1 核心接口概览

1.2 核心约束

2. 详细接口说明

2.1 获取日志下载链接

基本信息

请求参数

请求示例

响应参数

响应示例

日志格式

3. 常见问题

3.1 专属错误码

3.2 最佳实践

本页内容

日志下载

1. 快速查阅区

1.1 核心接口概览

1.2 核心约束

2. 详细接口说明

2.1 获取日志下载链接

基本信息

请求参数

请求示例

响应参数

响应示例

日志格式

3. 常见问题

3.1 专属错误码

3.2 最佳实践

本页内容