You need to enable JavaScript to run this app.
导航
视频点播
  • 文档首页
    • /视频点播/API 参考/工具服务/获取日志文件下载地址
获取日志文件下载地址
最近更新时间：2024.06.17 19:48:24首次发布时间：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
Object[]
-
日志列表。
Domain
String
example.vod.com
域名。
LogList
Object[]
-

日志列表。

说明

若无日志，则该字段不存在。

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

请求示例

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 各语言调用的示例代码，请参考如下：