调用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

播流域名或推流域名。

只支持单个域名查询。

PageSize Long 20

分页大小。取值:

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

当前页码。

说明 若不指定PageNumber查询,将默认返回第一页数据。
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天。

返回数据

名称 类型 示例值 描述
DomainName String example.com

播流域名或推流域名。

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

请求ID。

DomainLogDetails Array of DomainLogDetail

DomainLogDetail组成的数据。

DomainLogDetail
LogCount Long 10

本页返回的总条数。

LogInfos Array of LogInfoDetail

LogInfoDetail组成的数据。

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

结束时间。

LogSize Long 10

日志大小。

StartTime String 2016-10-20T04: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

日志路径。

PageInfos Object

页面信息。

PageIndex Long 1

返回数据的页码。

PageSize Long 20

分页大小。

Total Long 20

总日志条数。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/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格式

HTTP/1.1 200 OK
Content-Type:application/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"
      }
    } ]
  }
}

错误码

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