指定した期間内のすべてのインデックスファイルを照会します。
操作説明
ApsaraVideo Live は、M3U8 インデックスファイルの情報を 6 か月間保存します。 過去 6 か月以内に作成された M3U8 インデックスファイルの情報のみを照会できます。
M3U8 インデックスファイルは Object Storage Service (OSS) バケットに保存されます。 保存期間は、OSS バケットのストレージ構成によって決まります。
QPS 制限
この操作は、アカウントごとに 1 秒あたり最大 15 回呼び出すことができます。 この制限を超えるリクエストはドロップされ、サービスが中断される可能性があります。 この操作を呼び出す際は、この制限に注意することを推奨します。
今すぐお試しください
テスト
RAM 認証
|
アクション |
アクセスレベル |
リソースタイプ |
条件キー |
依存アクション |
|
live:DescribeLiveStreamRecordIndexFiles |
get |
*All Resource
|
なし | なし |
リクエストパラメーター
|
パラメーター |
型 |
必須 / 任意 |
説明 |
例 |
| DomainName |
string |
必須 |
注意事項
QPS 制限この操作は、アカウントごとに 1 秒あたり最大 15 回呼び出すことができます。 この制限を超えるリクエストはドロップされ、サービスが中断される可能性があります。 この操作を呼び出す際は、この制限に注意することを推奨します。 詳細については、「QPS 制限」をご参照ください。 |
example.com |
| AppName |
string |
必須 |
システムで定義されたパラメーターです。値は DescribeLiveStreamRecordIndexFiles です。 |
liveApp**** |
| StreamName |
string |
必須 |
メインのストリーミングドメイン。 |
liveStream**** |
| StartTime |
string |
必須 |
ライブストリームが属するアプリケーションの名前です。 |
2017-12-21T08:00:00Z |
| EndTime |
string |
必須 |
ライブストリームの名前です。 |
2017-12-22T08:00:00Z |
| PageNum |
integer |
任意 |
ページ番号。デフォルト値は 1 です。 |
1 |
| PageSize |
integer |
任意 |
1ページあたりのエントリ数。有効な値の範囲は 5～30 で、デフォルト値は 10 です。 |
10 |
| Order |
string |
任意 |
作成時間によるエントリのソート順序。有効な値：
|
asc |
レスポンスフィールド
|
フィールド |
型 |
説明 |
例 |
|
object |
|||
| PageNum |
integer |
ページ番号。 |
10 |
| RequestId |
string |
リクエスト ID です。 |
DE24625C-7C0F-4020-8448-9C31A50C1556 |
| Order |
string |
ソート順。 |
asc |
| TotalPage |
integer |
総ページ数です。 |
20 |
| PageSize |
integer |
1ページあたりの表示件数。 |
5 |
| TotalNum |
integer |
指定された条件を満たすエントリの総数です。 |
12 |
| RecordIndexInfoList |
object |
||
| RecordIndexInfo |
array<object> |
インデックスファイル。 |
|
|
object |
|||
| RecordUrl |
string |
インデックスファイルの URL です。 |
http://****/atestObject****.m3u8 |
| StreamName |
string |
ライブストリームの名前。 |
liveStream**** |
| CreateTime |
string |
インデックスファイルが作成された時間。 |
2016-05-27T09:40:56Z |
| RecordId |
string |
インデックスファイルの ID です。 |
c4d7f0a4-b506-43f9-8de3-07732c3f**** |
| Height |
integer |
ビデオの高さ。 |
480 |
| OssBucket |
string |
Object Storage Service (OSS) のバケット名。 |
liveBucket**** |
| DomainName |
string |
メインのストリーミングドメイン。 |
example.com |
| OssObject |
string |
OSS内のストレージファイルの名前。 |
liveObject**** |
| EndTime |
string |
インデックスファイルの終了時刻です。時刻は、ISO 8601 標準に準拠した yyyy-MM-ddTHH:mm:ssZ 形式で、UTC で表示されます。 |
2015-12-01T07:46:00Z |
| AppName |
string |
ライブストリームが属するアプリケーションの名前です。 |
liveApp**** |
| StartTime |
string |
インデックスファイルの開始時刻。ISO 8601 標準に準拠した yyyy-MM-ddTHH:mm:ssZ 形式の UTC 時間です。 |
2015-12-01T07:36:00Z |
| Width |
integer |
ビデオの幅。 |
640 |
| Duration |
number |
録画時間 (単位：秒) です。 |
588.849 |
| OssEndpoint |
string |
OSS バケットのエンドポイントです。 |
cn-oss-****.aliyuncs.com |
| Format |
string |
ビデオのフォーマット。 |
HLS |
例
成功レスポンス
JSONJSON
{
"PageNum": 10,
"RequestId": "DE24625C-7C0F-4020-8448-9C31A50C1556",
"Order": "asc",
"TotalPage": 20,
"PageSize": 5,
"TotalNum": 12,
"RecordIndexInfoList": {
"RecordIndexInfo": [
{
"RecordUrl": "http://****/atestObject****.m3u8",
"StreamName": "liveStream****",
"CreateTime": "2016-05-27T09:40:56Z",
"RecordId": "c4d7f0a4-b506-43f9-8de3-07732c3f****",
"Height": 480,
"OssBucket": "liveBucket****",
"DomainName": "example.com",
"OssObject": "liveObject****",
"EndTime": "2015-12-01T07:46:00Z",
"AppName": "liveApp****",
"StartTime": "2015-12-01T07:36:00Z",
"Width": 640,
"Duration": 588.849,
"OssEndpoint": "cn-oss-****.aliyuncs.com",
"Format": "HLS"
}
]
}
}エラーコード
|
HTTP ステータスコード |
エラーコード |
エラーメッセージ |
説明 |
|---|---|---|---|
| 400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | |
| 400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | |
| 400 | InvalidEndTime.Mismatch | Specified end time does not math the specified start time. | |
| 400 | InvalidStartTime.Mismatch | Specified StartTime does not math the current time. | |
| 400 | Forbidden | Ram Permission is forbidden. |
完全なリストについては、「エラーコード」をご参照ください。
変更履歴
完全なリストについては、「変更履歴」をご参照ください。