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

查询拉流转推日志文件

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

首次发布时间：2022.07.08 13:48:55

我的收藏

查询一定时间范围内，直播拉流转推的日志文件。拉流转推日志格式说明请参见拉流转推日志说明。

说明

  • 本接口仅支持查询拉流转推日志文件，如需获取其他日志文件，请使用DescribeLiveDomainLog接口。
  • 生成的日志下载链接的有效时间为 7 天。

注意事项

  • 请求频率：单用户请求频率限制为 100 次/秒。
  • 数据延迟：数据延迟为 1 小时。

请求说明

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

请求参数

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

Query

参数类型是否必选示例值描述
ActionString是DescribeLivePullToPushLog接口名称。当前 API 的名称为 DescribeLivePullToPushLog。
VersionString是2020-08-01接口版本。当前 API 的版本为 2020-08-01。

Body

参数类型是否必选示例值描述
StartTimeString否2021-04-13T00:00:00+08:00开始时间，默认为 24h 前，支持配置最近 30 天内的任意时间点，RFC3339 格式的 UTC 时间，精度为 s，例如，2021-12-31T14:00:00+08:00
EndTimeString否2021-04-14T00:00:00+08:00结束时间，默认为当前时间。RFC3339 格式的 UTC 时间，精度为 s，例如，2021-12-31T14:00:00+08:00
SizeInteger否10每页数量，默认值为 20
PageInteger否1页码，默认值为 1，取值范围为正整数

返回参数

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

参数类型示例值描述
StartTimeString2021-04-13T00:00:00+08:00查询的起始时间
EndTimeString2021-04-14T00:00:00+08:00查询的结束时间
LogListArray of LogInfo-日志文件信息
PaginationObject of Pagination-分页数量信息

LogInfo

参数类型示例值描述
LogNameStringexample.gz日志文件名称
LogSizeInteger12.0日志文件大小，单位为 byte
DateTimeString2022-04-13T00:00:00+08:00日志记录的数据时间
DownloadUrlStringexample_download.gz日志下载链接

Pagination

参数类型示例值描述
PageCurInteger1当前日志所在的分页
PageSizeInteger10每页的结果数量
TotalCountInteger100返回的日志总数

示例

请求示例

POST https://live.volcengineapi.com?Action=DescribeLivePullToPushLog&Version=2020-08-01
{
  "StartTime": "2021-04-13T00:00:00+08:00",
  "EndTime": "2021-04-14T00:00:00+08:00",
  "Size": 10,
  "Page": 1
}

返回示例

{
  	"ResponseMetadata":{
    		"RequestId": "201806041104200100100232280022D30",
    		"Action": "DescribeLivePullToPushLog",
    		"Version": "2020-08-01",
    		"Service": "live",
    		"Region": "cn-north-1"
  	},
  	"Result":{
    		"StartTime": "2021-04-13T00:00:00+08:00",
    		"EndTime": "2021-04-14T00:00:00+08:00",
    		"LogList": [
     		 {
         	 "LogName": "example.gz",
          	"LogSize": 12.0,
         	  "DateTime":"2022-04-13T00:00:00+08:00",
          	"DownloadUrl":"example_download.gz",
      	 }
    		 ],
    		"Pagination": {
       			"PageCur": 1,
       			"PageSize": 10,
      		 	"TotalCount": 100,
    		}
 		}
}

错误码

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