调用DescribeLiveStreamRecordIndexFile查询单个录制索引文件。

使用说明

创建好的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"
    }
}

错误码

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