服务端 API 文档

获取 CDN 日志下载链接

最近更新时间:2019-08-14 19:20:29

接口名称

GetCdnLogList

功能说明

获取指定时间段内云点播 CDN 的日志下载链接:

  • 默认情况下 CDN 每小时生成一个日志文件,如果某一小时没有 CDN 访问,则不会生成日志文件。
  • 只能查询到最近30天内的 CDN 日志下载链接。
  • CDN 日志下载链接的有效期为24小时。

请求方式

请求域名

vod.api.qcloud.com

最高调用频率

100次/分钟

参数说明

参数名称 必填 类型 说明
startTime Integer 起始时间,Unix 时间戳,如北京时间2018-03-01 00:00:00的 Unix 时间戳为1519833600。
endTime Integer 结束时间,Unix 时间戳,如北京时间2018-03-02 00:00:00的 Unix 时间戳为1519920000。
hosts Array 域名列表,查询指定域名的 CDN 日志下载链接,如果请求不带 HOSTS 参数,则返回所有域名的 CDN 日志下载链接,最多返回20个域名的数据。
COMMON_PARAMS - 请参见 公共参数

请求示例

https://vod.api.qcloud.com/v2/index.php?Action=GetCdnLogList
&startTime=1519833600
&endTime=1519920000
&hosts.0=123.vod2.myqcloud.com
&COMMON_PARAMS

接口应答

参数说明

参数名称 类型 说明
code Integer 错误码,0:成功;其他值:失败。
message String 错误信息。
data Array 结果数据。
data.host String 域名。
data.domesticLogList Array 国内 CDN 节点产生的 CDN 日志下载链接列表,字段信息请参见 LogInfo
data.overseaLogList Array 海外 CDN 节点产生的 CDN 日志下载链接列表,字段信息请参见 LogInfo,如果域名没有开通海外加速,则不会返回该数据。

LogInfo 日志下载链接信息

参数名称 类型 说明
date String 日志所属日期,格式为:yyyy-MM-dd,如2018-03-01。
name String 日志名称,格式为:yyyyMMddHH-host,即日期小时-域名,如2018030112-123.vod2.myqcloud.com
link String 日志下载链接,24小时内下载有效,日志文件内容请参见 日志说明

错误码说明

错误码 含义说明
4000 - 7000 请参见 公共错误码
1000 无效参数。
17010 HOSTS 参数错误。
17011 域名列表数据超过20个。
17013 startTime 参数错误。

应答示例

{
    "code": 0,
    "message": "",
    "data": [{
        "host": "123.vod2.myqcloud.com",
        "domesticLogList": [{
            "date": "2018-03-01",
            "name": "2018030112-123.vod2.myqcloud.com",
            "link: ": "http: //log-download.cdn.qcloud.com/20180301/12/2018030112-123.vod2.myqcloud.com.gz?st=LZi3oQXkjkeBe1xTFTGPFQ&e=1501743762"
        }]
    }]
}

日志说明

日志文件的压缩格式为 GZIP,日志文件里面每条日志内容的各个字段以空格隔开,字段顺序(从左到右)及含义如下表所示:

字段顺序 字段内容
1 请求时间。
2 访问域名的客户端 IP。
3 被访问的域名。
4 文件请求路径。
5 本次访问字节数大小。
6 省份编号,请参见 省份编号映射
7 运营商编号,请参见 运营商编号映射
8 HTTP 状态码。
9 Referer 信息。
10 响应时间(毫秒)
11 User - Agent 信息。
12 Range 参数。
13 HTTP Method。
14 HTTP 协议标识。
15 缓存 HIT/MISS。

省份编号映射

编号 省份
22 北京
86 内蒙古
146 山西
1069 河北
1177 天津
119 宁夏
152 陕西
1208 甘肃
1467 青海
1468 新疆
145 黑龙江
1445 吉林
1464 辽宁
2 福建
120 江苏
121 安徽
122 山东
1050 上海
1442 浙江
182 河南
1135 湖北
1465 江西
1466 湖南
118 贵州
153 云南
1051 重庆
1068 四川
1155 西藏
4 广东
173 广西
1441 海南
0 其他
1 港澳台
-1 海外

运营商编号映射

编号 运营商
2 中国电信
26 中国联通
38 教育网
43 长城宽带
1046 中国移动
3947 中国铁通
-1 海外运营商
0 其他运营商

海外及中国港澳台地区编号映射

海外 CDN 节点日志文件中的省份编号字段表示海外地区编号。

编号 海外及中国港澳台地区
73 印度
1195 印度尼西亚
1176 新加坡
57 泰国
144 越南
3701 马来西亚
2588 菲律宾
2026 中国台湾
1044 日本
3379 韩国
1200 中国香港
3839 加拿大
669 美国
-2 海外其他地区
-3 未知

海外运营商映射

编号 海外地区
-1 海外运营商
目录