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

使用说明

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

QPS限制

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

调试

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

请求参数


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

返回数据


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

示例

请求示例

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

正常返回示例

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>
  </RecordIndexInfo>
  <RequestId>5EBF2AC3-4B73-40A5-8B32-83F49D5F035E</RequestId>
</DescribeLiveStreamRecordIndexFileResponse>

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
        },
        "RequestId": "5EBF2AC3-4B73-40A5-8B32-83F49D5F035E"
    }
}

错误码

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