You need to enable JavaScript to run this app.
导航
获取日志文件下载地址
最近更新时间: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

调试

请求参数

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

参数
类型
是否必选
示例值
描述
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 各语言调用的示例代码,请参考如下: