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

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

错误码

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