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

调试

请求参数

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

参数类型是否必选示例值描述
ActionStringListCdnAccessLog接口名称。当前 API 的名称为 ListCdnAccessLog
VersionString2022-01-01接口版本。当前 API 的版本为 2022-01-01

Domains

String

example.vod.com

域名。您可以通过调用获取空间域名列表的接口获取。

说明

当前仅支持设置一个域名。

StartTimestamp

Integer

1703433600

查询范围起始时间。Unix 时间戳,单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。

说明

支持查询近 30 天日志。

EndTimestampInteger1703519940查询范围截止时间。Unix 时间戳,单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。

SpaceName

String

test

点播空间名称。可通过以下方式获取空间名称:

  • 在视频点播控制台空间管理页面查看当前账号下所有空间的名称。
  • 调用 ListSpace 接口获取当前账号下所有空间的名称。

返回参数

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

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

Logs

参数类型示例值描述
DomainStringexample.vod.com域名。

LogList

Array of LogList

-

日志列表。

说明

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

LogList

参数类型示例值描述
DownloadUrlStringhttps://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.ethanle******83c614b1982d39c6c81aa77a2391b365b8fb1fa25a6c0492d40c7b3下载地址 URL。
FileSizeLong208文件大小,单位为字节。
FileNameStringvideo01.ethanle***410120000_20220410130000.gz日志文件名。
StartTimestampInteger1649563200日志包中日志数据开始时间。
EndTimestampInteger1649566800日志包中日志数据结束时间。

请求示例

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