調用DescribeLiveStreamRecordIndexFiles查詢某個時間段內的所有錄制索引文件。
使用說明
- 創建好的M3U8索引文件的信息在視頻直播系統中僅保存6個月,若要查詢僅能查詢6個月內創建的索引文件的信息。
- M3U8索引文件存儲在OSS中,保存時間由OSS的存儲配置決定。
QPS限制
本接口的單用戶QPS限制為15次/秒。超過限制,API調用會被限流,這可能會影響您的業務,請合理調用。更多信息,請參見QPS限制。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLiveStreamRecordIndexFiles | 系統規定參數。取值:DescribeLiveStreamRecordIndexFiles。 |
DomainName | String | 是 | example.com | 主播流域名。 |
AppName | String | 是 | liveApp**** | 直播流所屬應用名稱。 |
StreamName | String | 是 | liveStream**** | 播流名稱。 |
StartTime | String | 是 | 2017-12-21T08:00:00Z | 開始時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
EndTime | String | 是 | 2017-12-22T08:00:00Z | 結束時間。與StartTime間隔時間不能超過4天。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
PageNum | Integer | 否 | 1 | 當前頁碼。默認值為1。 |
PageSize | Integer | 否 | 10 | 每頁大小。取值范圍:5~30,默認值為10。 |
Order | String | 否 | asc | 按創建時間排序。取值:
|
返回數據
名稱 |
類型 |
示例值 |
描述 |
PageNum | Integer | 10 | 分頁的頁碼。 |
RequestId | String | DE24625C-7C0F-4020-8448-9C31A50C1556 | 請求ID。 |
Order | String | asc | 排序。 |
TotalPage | Integer | 20 | 總頁數。 |
PageSize | Integer | 5 | 每頁大小。 |
TotalNum | Integer | 12 | 符合條件的總個數。 |
RecordIndexInfoList | Array of RecordIndexInfo | 錄制配置列表。 |
|
RecordIndexInfo | |||
RecordUrl | String | http://****/atestObject****.m3u8 | 索引文件地址。 |
StreamName | String | liveStream**** | 播流名稱。 |
CreateTime | String | 2016-05-27T09:40:56Z | 創建時間。 |
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 | 2015-12-01T07:46:00Z | 結束時間。格式為:yyyy-MM-ddTHH:mm:ssZ(UTC時間)。 |
AppName | String | liveApp**** | 播流所屬應用名稱。 |
StartTime | String | 2015-12-01T07: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 | HLS | 視頻格式。 |
示例
請求示例
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
格式
HTTP/1.1 200 OK
Content-Type:application/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>
<Format>mp4</Format>
</RecordIndexInfo>
</RecordIndexInfoList>
</DescribeLiveStreamRecordIndexFilesResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/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,
"Format" : "mp4"
}
}
}
}
錯誤碼
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. | 結束時間與開始時間不匹配,請您確認時間的匹配度。 |
訪問錯誤中心查看更多錯誤碼。
文檔內容是否對您有幫助?