ListCdnAccessLog - 获取日志文件下载地址--视频点播-火山引擎

文档中心

立即注册

视频点播

工具服务

ListCdnAccessLog - 获取日志文件下载地址

调用 ListCdnAccessLog 获取指定加速域名的访问日志。

使用说明

本接口返回的是这些访问日志的下载 URL。
日志字段具体说明请见日志管理。

注意事项

在调用本接口时，建议您指定时间段的时间跨度不超过 30 天，不然可能由于日志数量庞大导致 API 调用超时。
日志延时：CDN 默认按小时粒度，在整点对过去一小时内采集到的日志进行打包，生成日志包。日志包大约在生成后的 3 小时可以被下载。由于网络延时等原因，CDN 采集到的日志可能会有最长 24 小时的延迟。对于采集到的延迟日志，CDN 会将其追加到相应的日志包中。因此，日志包在生成后的 24 小时内可能会有日志的追加。

请求说明

请求地址：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`。
SpaceName	String	是	`test`	点播空间名称。可通过以下方式获取空间名称：在视频点播控制台空间管理页面查看当前账号下所有空间的名称。调用 ListSpace 接口获取当前账号下所有空间的名称。
Domains	String	是	`example.volcengine.com`	加速域名。您可以通过调用获取空间域名列表的接口获取。说明当前仅支持设置一个域名。
StartTimestamp	Integer	否	`1703433600`	查询范围起始时间。Unix 时间戳，单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。说明支持查询近 30 天日志。
EndTimestamp	Integer	否	`1703519940`	查询范围截止时间。Unix 时间戳，单位为秒。它表示从 1970 年 1 月 1 日 00:00:00 UTC 到指定时间的秒数。
PageNum	Long	否	`1`	表示一个页码。该 API 返回的是该页码所指定的分页上的日志包列表。该 API 返回的日志包是根据 `PageSize` 而分页的。假设请求的时间段内共计有 913 个日志包，您指定的 `PageSize` 是 `10`，那么请求的时间段内共计有 92 个分页。如果您指定的 `PageNum` 是 `2`，表示获取第 2 页上的日志包列表。如果您指定的分页上没有日志包，则返回结果中 `LogList` 的列表长度为 0。`PageNum` 从 1 开始计数，默认值为 1。
PageSize	Long	否	`100`	表示每个分页包含的日志包数量。该参数的取值范围是 1-100，默认值是 `100`。

返回参数

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

参数	类型	示例值	描述
Logs	Object[]	`-`	日志列表
Domain	String	`example.volcengine.com`	加速域名。与请求参数 `Domain` 的值一致。
LogList	Object[]	`-`	日志列表。说明若无日志，则该字段不存在。
FileName	String	`video01.ethanle***410120000_20220410130000.gz`	日志文件路径。
FileSize	Long	`1024`	日志文件的大小，单位为字节。
DownloadUrl	String	`https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.ethanle******0492d40c7b3`	日志文件下载地址 URL。有效期为 24 小时。
EndTimestamp	Integer	`1649566800`	日志包中日志数据结束时间，Unix 时间戳。
StartTimestamp	Integer	`1649563200`	日志包中日志数据开始时间，Unix 时间戳。
PageNum	Long	`1`	当前返回的是第几页的数据，与请求参数 `PageNum` 的值一致。
PageSize	Long	`100`	当前页期望返回的日志包数量，与请求参数 `PageSize` 的值一致。
TotalCount	Long	`100`	表示请求时间段内的日志包总数。

请求示例

https://vod.volcengineapi.com?Action=ListCdnAccessLog&Version=2022-01-01&Domains=example.volcengine.com&StartTimestamp=1703433600&EndTimestamp=1703519940&SpaceName=test&PageNum=1&PageSize=100

返回示例

{
  "Result": {
    "Logs": [
      {
        "Domain": "example.volcengine.com",
        "LogList": [
          {
            "FileName": "video01.ethanle***410120000_20220410130000.gz",
            "FileSize": 1024,
            "DownloadUrl": "https://cdnlog.bytedance.com/cdn-openapi/userlog/file-download/v1?fileName=video01.ethanle******0492d40c7b3",
            "EndTimestamp": 1649566800,
            "StartTimestamp": 1649563200
          }
        ],
        "PageNum": 1,
        "PageSize": 100,
        "TotalCount": 100
      }
    ]
  },
  "ResponseMetadata": {
    "Action": "ListCdnAccessLog",
    "Region": "cn-north-1",
    "Service": "vod",
    "Version": "2022-01-01",
    "RequestId": "20230604110420****100232280022D31"
  }
}

错误码

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

服务端 SDK

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

最近更新时间：2025.12.11 10:33:23

这个页面对您有帮助吗？

有用

无用