特定の期間内のすべてのM3U8インデックスファイルに関する情報を照会します。
使用状況ノート
- ApsaraVideo Liveは、M3U8インデックスファイルに関する情報を6か月間のみ保存します。 クエリできるのは、過去6か月間に作成されたM3U8インデックスファイルに関する情報だけです。
- Object Storage Service (OSS) は、ストレージ構成で指定された期間、M3U8インデックスファイルを保存します。
QPS制限
1人のユーザーが1秒あたり最大15クエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。
デバッグ
リクエストパラメーター
パラメーター | データ型 | 必須/任意 | 例 | 説明 |
操作 | String | 必須 | DescribeLiveStreamRecordIndexFiles | 実行したい操作。 値をDescribeLiveStreamRecordIndexFilesに設定します。 |
AppName | String | 必須 | liveApp **** | ライブストリームが属するアプリケーションの名前。 |
DomainName | String | 必須 | www.example.com | メインのストリーミングドメイン。 |
EndTime | String | 必須 | 2017-12-22T08:00:00Z | 照会する時間範囲の終わり。 StartTimeおよびEndTimeパラメーターで指定された時間範囲は、4日を超えることはできません。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。 |
StartTime | String | 必須 | 2017-12-21T08:00:00Z | クエリする時間範囲の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。 |
StreamName | String | 必須 | liveStream **** | ライブストリームの名前。 |
PageNum | Integer | 任意 | 1 | 返すページの番号。 デフォルト値: 1 |
PageSize | Integer | 任意 | 10 | 返される各ページのエントリ数。 有効な値: 5〜30。 デフォルト値:10。 |
Order | String | 任意 | asc | ソート順。 設定可能な値は以下のとおりです。
|
レスポンスパラメーター
パラメーター | データ型 | 例 | 説明 |
RecordIndexInfoList | RecordIndexInfoの配列 | 照会されたM3U8インデックスファイルの記録設定。 | |
RecordIndexInfo | |||
RecordUrl | String | http:// ****/atestObject.m3u8 | M3U8インデックスファイルのURL。 |
DomainName | String | example.com | メインのストリーミングドメイン。 |
AppName | String | liveApp**** | ライブストリームが属するアプリケーションの名前。 |
StreamName | String | liveStream **** | ライブストリームの名前。 |
StartTime | String | 2015-12-01T07:36:00Z | データが照会された時間範囲の開始。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。 |
EndTime | String | 2015-12-01T07:46:00Z | データが照会された時間範囲の終わり。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。 |
有効期間 | Float | 588.849 | 記録の長さ。 (単位:秒) |
Height | Integer | 480 | ビデオの高さ。 |
幅 | Integer | 640 | ビデオの幅。 |
CreateTime | String | 2016-05-27T09:40:56Z | M3U8インデックスファイルが作成された時刻。 |
OssBucket | String | liveBucket **** | M3U8インデックスファイルが保存されているOSSバケットの名前。 |
OssEndpoint | String | oss-cn-shanghai.aliyuncs.com | OSSのエンドポイント。 |
OssObject | String | liveObject **** | OSSに保存されているレコードの名前。 |
レコードID | String | c4d7f0a4-b506-43f9-8de3-07732c3f **** | M3U8インデックスファイルのID。 |
PageNum | Integer | 10 | 返されたページの数です。 |
PageSize | Integer | 5 | 1 ページあたりで返されるエントリ数。 |
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 ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
<DescribeLiveStreamRecordIndexFilesResponse>
<注文> asc</注文>
<TotalNum>12</TotalNum>
<TotalPage>20</TotalPage>
<PageSize>5</PageSize>
<PageNum>10</PageNum>
<RequestId>DE24625C-7C0F-4020-8448-9C31A50C1556</RequestId>
<RecordIndexInfoList>
<RecordIndexInfo>
<EndTime>2015-12-01T17:36:00Z</EndTime>
<DomainNam e>example.com</DomainName>
<CreateTime>2016-05-27T09:40:56Z</CreateTime>
<StartTime>2015-12-01T17:36:00Z</StartTime>
<OssBucket>liveBucket ****</OssBucket>
<期間> 588.849</期間>
<AppName>liveApp ****</AppName>
<StreamName>liveStream ****</StreamName>
<OssEndpoin t>oss-cn-shanghai.aliyuncs.com</OssEndpoint>
<RecordUrl>http:// ****/atestObject.m3u8</RecordUrl>
<OssObject>liveObject ****</OssObject>
<高さ> 480</高さ>
<RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f ****</RecordId>
<Width>640</Width>
</RecordIndexInfo>
</RecordIndexInfoList>
</DescribeLiveStreamRecordIndexFilesResponse>
JSON
形式
{
"Order": "asc" 、
"TotalNum": "12" 、
"TotalPage": "20" 、
"PageSize": "5" 、
"PageNum": "10" 、
"RequestId": "DE24625C-7C0F-4020-8448-9C31A50C1556" 、
"RecordIndexInfoList": {
"RecordIndexInfo": [{
"EndTime": "2015-12-01T17:36:00Z" 、
"DomainName": "www.example.com" 、
"CreateTime": "2016-05-27T09:40:56Z" 、
"StartTime": "2015-12-01T17:36:00Z" 、
"OssBucket": "test123" 、
"期間": "588.849" 、
"AppName": "testApp" 、
"StreamName": "test123" 、
"OssEndpoint": "oss-cn-shanghai.aliyuncs.com" 、
"RecordUrl": "http:// ****/atestObject.m3u8" 、
"OssObject": "test123" 、
"高さ": "480" 、
"RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f ****" 、
"幅": "640"
}]
}
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
400 | InvalidStartTime.Malformed | 指定された StartTime は不正です。 | 開始時刻の形式が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime.Malformed | 指定された EndTime は不正です。 | 終了時刻の形式が無効な場合に返されるエラーメッセージ。 EndTimeパラメーターの値が有効かどうかを確認します。 |
400 | InvalidEndTime. ミスマッチ | 指定された終了時間は、指定された開始時間を計算しません。 | StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲が無効な場合に返されるエラーメッセージ。 StartTimeパラメーターとEndTimeパラメーターが正しく指定されているかどうかを確認します。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。