调用DescribeLiveStreamRecordIndexFiles查询某个时间段内的所有录制索引文件。
使用说明
- 创建好的M3U8索引文件的信息在视频直播系统中仅保存6个月,若要查询仅能查询6个月内创建的索引文件的信息。
- M3U8索引文件存储在OSS中,保存时间由OSS的存储配置决定。
QPS限制
本接口的单用户QPS限制为15次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeLiveStreamRecordIndexFiles |
系统规定参数。取值:DescribeLiveStreamRecordIndexFiles。 |
AppName | String | 是 | liveApp**** |
直播流所属应用名称。 |
DomainName | String | 是 | example.com |
主播流域名。 |
EndTime | String | 是 | 2017-12-22T08:00:00Z |
结束时间。与StartTime间隔时间不能超过4天。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
StartTime | String | 是 | 2017-12-21T08:00:00Z |
开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
StreamName | String | 是 | liveStream**** |
播流名称。 |
PageNum | Integer | 否 | 1 |
当前页码。默认值为1。 |
PageSize | Integer | 否 | 10 |
每页大小。取值范围:5~30,默认值为10。 |
Order | String | 否 | asc |
排序。取值:
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RecordIndexInfoList | Array of RecordIndexInfo |
录制配置列表。 |
|
RecordIndexInfo | |||
RecordUrl | String | http://****/atestObject****.m3u8 |
索引文件地址。 |
DomainName | String | example.com |
主播流域名。 |
AppName | String | liveApp**** |
播流所属应用名称。 |
StreamName | String | liveStream**** |
播流名称。 |
StartTime | String | 2015-12-01T07:36:00Z |
开始时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
EndTime | String | 2015-12-01T07:46:00Z |
结束时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。 |
Duration | Float | 588.849 |
录制时长。单位:秒。 |
Height | Integer | 480 |
视频高。 |
Width | Integer | 640 |
视频宽。 |
CreateTime | String | 2016-05-27T09:40:56Z |
创建时间。 |
OssBucket | String | liveBucket**** |
OSS存储Bucket名称。 |
OssEndpoint | String | cn-oss-****.aliyuncs.com |
OSS存储的Endpoint名称。 |
OssObject | String | liveObject**** |
OSS存储的录制文件名。 |
RecordId | String | c4d7f0a4-b506-43f9-8de3-07732c3f**** |
索引文件ID。 |
PageNum | Integer | 10 |
分页的页码。 |
PageSize | Integer | 5 |
每页大小。 |
Order | String | asc |
排序。 |
TotalPage | Integer | 20 |
总页数。 |
TotalNum | Integer | 12 |
符合条件的总个数。 |
RequestId | String | DE24625C-7C0F-4020-8448-9C31A50C1556 |
请求ID。 |
示例
请求示例
http(s)://live.aliyuncs.com/?Action=DescribeLiveStreamRecordIndexFiles
&AppName=liveApp****
&DomainName=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream****
&<公共请求参数>
正常返回示例
XML
格式
<DescribeLiveStreamRecordIndexFilesResponse>
<Order>asc</Order>
<TotalNum>12</TotalNum>
<TotalPage>20</TotalPage>
<PageSize>5</PageSize>
<PageNum>10</PageNum>
<RequestId>DE24625C-7C0F-4020-8448-9C31A50C1556</RequestId>
<RecordIndexInfoList>
<RecordIndexInfo>
<EndTime>2015-12-01T07:46:00Z</EndTime>
<DomainName>example.com</DomainName>
<CreateTime>2016-05-27T09:40:56Z</CreateTime>
<StartTime>2015-12-01T07: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>
</RecordIndexInfoList>
</DescribeLiveStreamRecordIndexFilesResponse>
JSON
格式
{
"DescribeLiveStreamRecordIndexFilesResponse": {
"Order": "asc",
"TotalNum": 12,
"TotalPage": 20,
"PageSize": 5,
"PageNum": 10,
"RequestId": "DE24625C-7C0F-4020-8448-9C31A50C1556",
"RecordIndexInfoList": {
"RecordIndexInfo": {
"EndTime": "2015-12-01T07:46:00Z",
"DomainName": "example.com",
"CreateTime": "2016-05-27T09:40:56Z",
"StartTime": "2015-12-01T07: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
}
}
}
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | StartTime参数错误,请您确认该StartTime参数是否正确。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间错误,请您确认结束时间是否正确。 |
400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | 结束时间与开始时间不匹配,请您确认时间的匹配度。 |
访问错误中心查看更多错误码。