You need to enable JavaScript to run this app.
导航
视频直播
  • 文档首页
    • /
  • 视频直播

查询日志文件信息

最近更新时间：2023.08.07 11:52:07

首次发布时间：2022.02.24 18:33:53

我的收藏

本接口指定单个或多个域名，查询相关日志文件信息（不含拉流转推）。

说明

注意事项

请求频率：单用户请求频率限制为 10QPS。

请求说明

  • 请求方式：GET
  • 请求地址：https://live.volcengineapi.com?Action=DescribeLiveDomainLog&Version=2020-08-01

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是DescribeLiveDomainLog接口名称。当前 API 的名称为 DescribeLiveDomainLog。
VersionString是2020-08-01接口版本。当前 API 的版本为 2020-08-01。
DomainListString否www.example.com域名列表，多个域名用逗号“,”作为分隔符，缺省情况下返回所有域名的日志文件信息
StartTimeString否2021-12-31T14:00:00+08:00开始时间，默认为 24h 前，支持配置最近 30 天内的任意时间点，RFC3339 格式的 UTC 时间，精度为 s，例如，2021-12-31T14:00:00+08:00
EndTimeString否2021-12-31T15:00:00+08:00结束时间，默认为当前时间。RFC3339 格式的 UTC 时间，精度为 s，例如，2021-12-31T15:00:00+08:00
PageInteger否1页码，默认为 1
SizeInteger否20每页数量，默认为 20

返回参数

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

参数类型示例值描述
ListArray of LogInfo-日志文件信息列表
PaginationObject of Pagination-分页数量信息

LogInfo

参数类型示例值描述
DomainStringwww.example.com域名
LogNameStringwww.*****.gz日志文件名称，例如，www.example.com_2022_01_28_180000_190000.gz
LogSizeInteger1400日志文件大小，单位为 byte
DateTimeString2021-12-31T14:00:00+08:00日志文件对应小时区间，RFC3339 格式的 UTC 时间，精度为 s，例如，2021-12-31T14:00:00+08:00
DownloadUrlStringhttp://*****.gz文件下载链接

Pagination

参数类型示例值描述
PageCurInteger1当前所在分页
PageSizeInteger20每页显示信息条数
TotalCountInteger1信息总条数

示例

请求示例

GET https://live.volcengineapi.com?Action=DescribeLiveDomainLog&Version=2020-08-01&DomainList=www.example.com&EndTime=2021-12-31T15%3A00%3A00%2B08%3A00&Page=1&Size=20&StartTime=2021-12-31T14%3A00%3A00%2B08%3A00

返回示例

{
    "ResponseMetadata": {
        "RequestID": "2021123011141301024815919928650",
        "Action": "DescribeLiveDomainLog",
        "Version": "2020-08-01",
        "Service": "live",
        "Region": "cn-north-1"
    },
    "Result": {
        "List": [
            {
                "Domain": "www.example.com",
                "LogName": "www.*****.gz",
                "LogSize": 1400,
                "DateTime": "2021-12-31T14:00:00+08:00",
                "DownloadUrl": "http://*****.gz"
            },
        ],
        "Pagination": {
            "PageCur": 1,
            "PageSize": 20,
            "TotalCount": 1
        }
    }
}

错误码

访问公共错误码获取详细信息。