文档中心

获取日志文件下载地址

最近更新时间：2024.01.08 17:26:44

首次发布时间：2022.04.15 10:36:43

视频点播支持查询和下载指定域名的 CDN 原始访问日志，此接口用于获取日志文件下载地址。

使用说明

具体日志字段说明请参见日志管理。

注意事项

日志包延迟时间：一般情况下延迟在 3 小时之内，业务高峰期也有可能超过 12 小时。

请求说明

请求地址：https://vod.volcengineapi.com?Action=ListCdnAccessLog&Version=2022-01-01

调试

API Explorer

您可以通过API Explorer在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共请求参数。

参数	类型	是否必选	示例值	描述
Action	String	是	`ListCdnAccessLog`	接口名称。当前 API 的名称为 `ListCdnAccessLog`。
Version	String	是	`2022-01-01`	接口版本。当前 API 的版本为 `2022-01-01`。
Domains	String	是	`example.vod.com`	域名。您可以通过调用获取空间域名列表的接口获取。说明当前仅支持设置一个域名。
StartTimestamp	Integer	否	`1703433600`	查询范围起始时间。Unix 时间戳，单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。说明支持查询近 30 天日志。
EndTimestamp	Integer	否	`1703519940`	查询范围截止时间。Unix 时间戳，单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。
SpaceName	String	是	`test`	点播空间名称。可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。

返回参数

下表仅列出本接口特有的返回参数。更多信息请见公共返回参数。

参数	类型	示例值	描述
Logs	Array of Logs	`-`	日志列表

Logs

参数	类型	示例值	描述
Domain	String	`example.vod.com`	域名。
LogList	Array of LogList	`-`	日志列表。说明若无日志，则该字段不存在。

LogList

参数	类型	示例值	描述
DownloadUrl	String	`https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.ethanle******83c614b1982d39c6c81aa77a2391b365b8fb1fa25a6c0492d40c7b3`	下载地址 URL。
FileSize	Long	`208`	文件大小，单位为字节。
FileName	String	`video01.ethanle***410120000_20220410130000.gz`	日志文件名。
StartTimestamp	Integer	`1649563200`	日志包中日志数据开始时间。
EndTimestamp	Integer	`1649566800`	日志包中日志数据结束时间。

请求示例

https://vod.volcengineapi.com?Action=ListCdnAccessLog&Version=2022-01-01

返回示例

{
  "ResponseMetadata": {
    "RequestId": "202204101828***20913105216644",
    "Action": "ListCdnAccessLog",
    "Version": "2022-01-01",
    "Service": "vod",
    "Region": "cn-north-1"
  },
  "Result": {
    "Logs": [
      {
        "Domain": "video0***nlei.vip",
        "LogList": [
          {
            "DownloadUrl": "https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.ethanle******83c614b1982d39c6c81aa77a2391b365b8fb1fa25a6c0492d40c7b3",
            "FileSize": "208",
            "FileName": "video01.ethanle***410120000_20220410130000.gz",
            "StartTimestamp": 1649563200,
            "EndTimestamp": 1649566800
          },
          {
            "DownloadUrl": "https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.eth******3c614b1982d39c6c81aa77a2391b365b8fb1fa25a6c0492d40c7b3",
            "FileSize": "391",
            "FileName": "video01.ethanlei.vi***10020000_20220410030000.gz",
            "StartTimestamp": 1649527200,
            "EndTimestamp": 1649530800
          },
          {
            "DownloadUrl": "https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video******2a57e61783c614b1982d39c6c81aa77a2391b365b8fb1fa25a6c0492d40c7b3",
            "FileSize": "4756",
            "FileName": "video01.ethanlei.v***09230000_20220410000000.gz",
            "StartTimestamp": 1649516400,
            "EndTimestamp": 1649520000
          }
        ]
      }
    ]
  }
}

错误码

本接口无特有的错误码。更多信息请见公共错误码。

服务端 SDK

点播 OpenAPI 提供了配套的服务端 SDK，支持多种编程语言，帮助您实现快速开发。建议使用服务端 SDK 来调用 API，此 API 各语言调用的示例代码，请参考如下：