查询单个录制索引文件 - 视频直播

使用说明

创建好的M3U8索引文件的信息在视频直播系统中仅保存6个月，若要查询仅能查询6个月内创建的索引文件的信息。M3U8索引文件存储在OSS中，保存时间由OSS的存储配置决定。

QPS限制

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

调试

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

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLiveStreamRecordIndexFile	系统规定参数。取值：DescribeLiveStreamRecordIndexFile。
DomainName	String	是	example.com	主播流域名。
AppName	String	是	liveApp****	播流所属应用名称。
StreamName	String	是	liveStream****	播流名称。
RecordId	String	是	c4d7f0a4-b506-43f9-8de3-07732c3f****	索引文件ID。说明通过查询所有录制索引文件接口查询

返回数据

名称	类型	示例值	描述
RequestId	String	5EBF2AC3-4B73-40A5-8B32-83F49D5F035E	请求ID。
RecordIndexInfo	Object		录制配置。
RecordUrl	String	http://**/atestObject**.m3u8	索引文件地址。
StreamName	String	liveStream****	播流名称。
CreateTime	String	2016-05-27T09:40:56Z	创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
RecordId	String	c4d7f0a4-b506-43f9-8de3-07732c3f****	索引文件ID。
Height	Integer	480	视频高。
OssBucket	String	liveBucket****	OSS存储的Bucket名称。
DomainName	String	example.com	主播流域名。
OssObject	String	liveObject****	OSS存储的录制文件名。
EndTime	String	2016-05-25T05:47:11Z	结束时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
AppName	String	liveApp****	流所属应用名称。
StartTime	String	2015-12-01T05:36:00Z	开始时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。
Width	Integer	640	视频宽。
Duration	Float	588.849	录制时长。单位：秒。
OssEndpoint	String	cn-oss-****.aliyuncs.com	OSS存储的Endpoint名称。
Format	String	mp4	视频格式。

示例

请求示例

http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamRecordIndexFile
&AppName=liveApp****
&DomainName=example.com
&RecordId=c4d7f0a4-b506-43f9-8de3-07732c3f****
&StreamName=liveStream****
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLiveStreamRecordIndexFileResponse>
    <RecordIndexInfo>
        <EndTime>2016-05-25T05:47:11Z</EndTime>
        <DomainName>example.com</DomainName>
        <CreateTime>2016-05-27T09:40:56Z</CreateTime>
        <StartTime>2015-12-01T05:36:00Z</StartTime>
        <OssBucket>liveBucket****</OssBucket>
        <Duration>588.849</Duration>
        <AppName>liveApp****</AppName>
        <StreamName>liveStream****</StreamName>
        <OssEndpoint>cn-oss-****.aliyuncs.com</OssEndpoint>
        <RecordUrl>http://****/atestObject****.m3u8</RecordUrl>
        <OssObject>liveObject****</OssObject>
        <Height>480</Height>
        <RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f****</RecordId>
        <Width>640</Width>
        <Format>mp4</Format>
    </RecordIndexInfo>
    <RequestId>5EBF2AC3-4B73-40A5-8B32-83F49D5F035E</RequestId>
</DescribeLiveStreamRecordIndexFileResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "DescribeLiveStreamRecordIndexFileResponse" : {
    "RecordIndexInfo" : {
      "EndTime" : "2016-05-25T05:47:11Z",
      "DomainName" : "example.com",
      "CreateTime" : "2016-05-27T09:40:56Z",
      "StartTime" : "2015-12-01T05:36:00Z",
      "OssBucket" : "liveBucket****",
      "Duration" : 588.849,
      "AppName" : "liveApp****",
      "StreamName" : "liveStream****",
      "OssEndpoint" : "cn-oss-****.aliyuncs.com",
      "RecordUrl" : "http://****/atestObject****.m3u8",
      "OssObject" : "liveObject****",
      "Height" : 480,
      "RecordId" : "c4d7f0a4-b506-43f9-8de3-07732c3f****",
      "Width" : 640,
      "Format" : "mp4"
    },
    "RequestId" : "5EBF2AC3-4B73-40A5-8B32-83F49D5F035E"
  }
}

错误码

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