调用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"
}
}
错误码
访问错误中心查看更多错误码。