调用DescribeLivePushProxyLog查询直播转推离线日志下载地址。
使用说明
- 查询数据时间粒度:1小时。
- 最大查询范围:最近31天的数据。
- 如果不指定StartTime和EndTime,该接口默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
QPS限制
本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 |
类型 |
是否必选 |
示例值 |
描述 |
Action | String | 是 | DescribeLivePushProxyLog | 系统规定参数。取值:DescribeLivePushProxyLog。 |
DomainName | String | 是 | example.com | 推流域名。不支持多域名查询。 |
PageSize | Long | 否 | 300 | 分页大小。取值范围:[1, 1000],默认值为300。 |
PageNumber | Long | 否 | 2 | 分页的页数,默认值为1。 |
StartTime | String | 否 | 2023-09-20T08:00:00Z | 获取日志起始时间。 日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
EndTime | String | 否 | 2023-09-20T09:00:00Z | 获取日志结束时间。 日期格式按照ISO8601表示法,并使用UTC+0时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
返回数据
名称 |
类型 |
示例值 |
描述 |
DomainName | String | example.com | 推流域名。 |
RequestId | String | CF60DB6A-7FD6-426E-9288-122CC1A52FA7 | 请求ID。 |
DomainLogDetails | Array of DomainLogDetail | DomainLogDetail组成的数据。 |
|
DomainLogDetail | |||
LogCount | Long | 10 | 本页返回的总条数。 |
LogInfos | Array of LogInfoDetail | LogInfoDetail组成的数据。 |
|
LogInfoDetail | |||
EndTime | String | 1695189600 | 结束时间。 格式时间戳 |
LogSize | Long | 512 | 日志大小。 |
StartTime | String | 1695193200 | 起始时间。 格式时间戳 |
LogName | String | example.com _2023_09_20_160000_170000.****.gz | 日志名称。 |
LogPath | String | ****.aliyuncs.com/push_proxy/****/example.com/2023_09_20/1600/example.com _2023_09_20_160000_170000.****.gz | 日志路径。 |
PageInfos | Object | PageInfoDetail组成的数据。 |
|
PageIndex | Long | 1 | 返回数据的页码。 |
PageSize | Long | 20 | 分页大小。 |
Total | Long | 20 | 总条数。 |
示例
请求示例
http(s)://live.aliyuncs.com?Action=DescribeLivePushProxyLog
&DomainName=example.com
&PageSize=300
&PageNumber=2
&StartTime=2023-09-20T08:00:00Z
&EndTime=2023-09-20T09:00:00Z
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLivePushProxyLogResponse>
<DomainName>example.com</DomainName>
<RequestId>CF60DB6A-7FD6-426E-9288-122CC1A52FA7</RequestId>
<DomainLogDetails>
<LogCount>10</LogCount>
<LogInfos>
<EndTime>1695189600</EndTime>
<LogSize>512</LogSize>
<StartTime>1695193200</StartTime>
<LogName>example.com
_2023_09_20_160000_170000.****.gz</LogName>
<LogPath>****.aliyuncs.com/push_proxy/****/example.com/2023_09_20/1600/example.com
_2023_09_20_160000_170000.****.gz</LogPath>
</LogInfos>
<PageInfos>
<PageIndex>1</PageIndex>
<PageSize>20</PageSize>
<Total>20</Total>
</PageInfos>
</DomainLogDetails>
</DescribeLivePushProxyLogResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"DomainName" : "example.com",
"RequestId" : "CF60DB6A-7FD6-426E-9288-122CC1A52FA7",
"DomainLogDetails" : [ {
"LogCount" : 10,
"LogInfos" : [ {
"EndTime" : "1695189600",
"LogSize" : 512,
"StartTime" : "1695193200",
"LogName" : "example.com\n_2023_09_20_160000_170000.****.gz",
"LogPath" : "****.aliyuncs.com/push_proxy/****/example.com/2023_09_20/1600/example.com\n_2023_09_20_160000_170000.****.gz"
} ],
"PageInfos" : {
"PageIndex" : 1,
"PageSize" : 20,
"Total" : 20
}
} ]
}
错误码
HttpCode |
错误码 |
错误信息 |
描述 |
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime参数错误,请您确认该StartTime参数是否正确。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间错误,请您确认结束时间是否正确。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 传入的StartTime参数不支持。 |
访问错误中心查看更多错误码。
文档内容是否对您有帮助?