调用DescribeLiveDomainLog查询视频直播指定域名的离线日志信息。

使用说明

  • 调用一次API仅支持查询单个域名的离线日志。
  • 可选参数StartTime和EndTime需要同时指定,指定起止时间后查询指定时间范围内的日志。
  • 不指定StartTime和EndTime时,默认读取过去24小时的日志数据。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeLiveDomainLog

系统规定参数,取值:DescribeLiveDomainLog

DomainName String example.com

播流域名或推流域名。

只支持单个域名查询。

RegionId String cn-shanghai

地域ID。

PageSize Long 20

分页大小。取值:

  • 1~1000之间的任意整数。
  • 默认值为300
  • 最大值为1000
PageNumber Long 1

当前页码。

StartTime String 2016-10-20T04:00:00Z

起始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

EndTime String 2016-10-20T05:00:00Z

结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

结束时间需大于起始时间。起始时间和结束时间,间隔不超过31天。

返回数据

名称 类型 示例值 描述
DomainLogDetails Array of DomainLogDetail

DomainLogDetail组成的数据。

DomainLogDetail
LogCount Long 10

本页返回的总条数。

LogInfos Array of LogInfoDetail

LogInfoDetail组成的数据。

LogInfoDetail
EndTime String 2016-10-20T05:00:00Z

结束时间。

LogName String developer.aliyundoc.com_2016_10_20_040000_050000.gz

日志名称。

LogPath String learn.aliyundoc.com/developer.aliyundoc.com/2016_10_20/example.aliyundoc.com_2016_10_20_040000_050000.gz?Expires=1522659931&OSSAccessKeyId=LTAI******eo4ZEuA&Signature=C01p%2BtA%******KP9Sru2Oxwy7Do0%3D

日志路径。

LogSize Long 10

日志大小。

StartTime String 2016-10-20T04:00:00Z

起始时间。

PageInfos Struct

页面信息。

PageIndex Long 1

返回数据的页码。

PageSize Long 20

分页大小。

Total Long 20

总日志条数。

DomainName String example.com

播流域名或推流域名。

RequestId String 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

请求ID。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveDomainLog
&DomainName=example.com
&<公共请求参数>

正常返回示例

XML格式

<DescribeLiveDomainLogResponse>
  <RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
  <DomainName>example.com</DomainName>
  <DomainLogDetails>
        <DomainLogDetail>
              <LogCount>10</LogCount>
              <LogInfos>
                    <LogInfoDetail>
                          <LogSize>10</LogSize>
                          <EndTime>2016-10-20T05:00:00Z</EndTime>
                          <StartTime>2016-10-20T04:00:00Z</StartTime>
                          <LogName>developer.aliyundoc.com_2016_10_20_040000_050000.gz</LogName>
                          <LogPath>learn.aliyundoc.com/developer.aliyundoc.com/2016_10_20/example.aliyundoc.com_2016_10_20_040000_050000.gz?Expires=1522659931&amp;OSSAccessKeyId=LTAI******eo4ZEuA&amp;Signature=C01p%2BtA%******KP9Sru2Oxwy7Do0%3D</LogPath>
                    </LogInfoDetail>
              </LogInfos>
              <PageInfos>
                    <PageSize>20</PageSize>
                    <Total>20</Total>
                    <PageIndex>1</PageIndex>
              </PageInfos>
        </DomainLogDetail>
  </DomainLogDetails>
</DescribeLiveDomainLogResponse>

JSON格式

{"RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8","DomainName":"example.com","DomainLogDetails":{"DomainLogDetail":[{"LogCount":"10","LogInfos":{"LogInfoDetail":[{"LogSize":"10","EndTime":"2016-10-20T05:00:00Z","StartTime":"2016-10-20T04:00:00Z","LogName":"developer.aliyundoc.com_2016_10_20_040000_050000.gz","LogPath":"learn.aliyundoc.com/developer.aliyundoc.com/2016_10_20/example.aliyundoc.com_2016_10_20_040000_050000.gz?Expires=1522659931&amp;OSSAccessKeyId=LTAI******eo4ZEuA&amp;Signature=C01p%2BtA%******KP9Sru2Oxwy7Do0%3D"}]},"PageInfos":{"PageSize":"20","Total":"20","PageIndex":"1"}}]}}

错误码

访问错误中心查看更多错误码。