指定した時間範囲の録音用のM3U8インデックスファイルを作成します。

使用状況ノート

ApsaraVideo Liveを使用すると、ライブストリームをM3U8形式で録画し、M3U8ファイルとそのメディアセグメントファイルをObject Storage Service (OSS) バケットに保存し、保存したメディアセグメントファイルをリアルタイムで編集できます。

  • インデックスファイルは、ライブストリームが取り込まれた後にのみ作成できます。 指定された時間範囲でビデオがストリーミングされない場合、または指定されたライブストリーム名が無効な場合、インデックスファイルは作成されません。
  • StartTimeパラメーターとEndTimeパラメーターで指定される時間範囲は、少なくとも1つのメディアセグメントファイルの期間である必要があります。 1つのメディアセグメントファイルのデフォルトの期間は30秒です。
  • ApsaraVideo Liveは、メディアセグメントファイルに関する情報を3か月間のみ保存します。 M3U8インデックスファイルは、過去3か月の録画に対してのみ作成できます。
  • OSSは、ストレージ設定で指定された期間、メディアセグメントファイルを保存します。
  • ApsaraVideo Liveは、M3U8インデックスファイルに関する情報を6か月間のみ保存します。 クエリできるのは、過去6か月間に作成されたM3U8インデックスファイルに関する情報だけです。
  • OSSは、ストレージ設定で指定された期間、M3U8インデックスファイルを保存します。

QPS制限

1人のユーザーが1秒あたり最大45件のクエリ (QPS) を実行できます。 1秒あたりの呼び出し数がQPS制限を超えると、スロットリングがトリガーされます。 スロットルはビジネスに影響を与える可能性があります。 したがって、この操作のQPS制限を遵守することをお勧めします。 シングルユーザーの意味とQPSの詳細については、「ApsaraVideo LiveのAPI操作のQPS制限」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
操作 String 必須 CreateLiveStreamRecordIndexFiles

実行したい操作。 値をCreateLiveStreamRecordIndexFilesに設定します。

AppName String 必須 liveApp ****

ライブストリームが属するアプリケーションの名前。

DomainName String 必須 example.com

メインのストリーミングドメイン。

EndTime String 必須 2017-12-22T08:00:00Z

M3U8インデックスファイルが作成される記録の終わり。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

OssBucket String 必須 liveBucket ****

M3U8インデックスファイルが保存されているOSSバケットの名前。

OssEndpoint String 必須 oss-cn-developer.aliyundoc.com

OSSのエンドポイント。

OssObject String 必須 {AppName}/{StreamName}/{Date}/{Hour}/{Minute }_{ Second}.m3u8

OSSに保存されているレコードの名前。

StartTime String 必須 2017-12-21T08:00:00Z

M3U8インデックスファイルが作成される録音の先頭。 ISO 8601標準のyyyy-MM-dd T HH:mm:ss Z形式で時刻を指定します。 時刻はUTCである必要があります。

StreamName String 必須 liveStream ****

ライブストリームの名前。

レスポンスパラメーター

パラメーター データ型 説明
RecordInfo Struct

レコーディングの設定。

RecordUrl String http:// *****/atestObject.m3u8

M3U8インデックスファイルのURL。

DomainName String example.com

メインのストリーミングドメイン。

AppName String liveApp ****

ライブストリームが属するアプリケーションの名前。

StreamName String liveStream ****

ライブストリームの名前。

StartTime String 2015-12-01T07:36:00Z

M3U8インデックスファイルが作成される録音の先頭。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

EndTime String 2015-12-01T07:40:00Z

M3U8インデックスファイルが作成される記録の終わり。 時間は、 Z形式のISO 8601標準に従います。 時刻はUTCで表示されます。

有効期間 Float 20

記録の長さ。 (単位:秒)

Height Integer 480

ビデオの高さ。

Integer 640

ビデオの幅。

CreateTime String 2016-05-27T09:40:56Z

M3U8インデックスファイルが作成された時刻。 時間は、 Z形式のISO 8601標準に従います。 時刻は UTC 表示です。

OssBucket String liveBucket ****

M3U8インデックスファイルが保存されているOSSバケットの名前。

OssEndpoint String oss-cn-developer.aliyundoc.com

OSSのエンドポイント。

OssObject String liveObject ****.m3u8

OSSに保存されているレコードの名前。

レコードID String c4d7f0a4-b506-43f9-8de3-07732c3f ****

M3U8インデックスファイルのID。

RequestId String 550439A3-F8EC-4CA2-BB62-B9DB43EEEF30

リクエストの ID です。

リクエストの例

http(s):// live.aliyuncs.com/?Action=CreateLiveStreamRecordIndexFiles
&AppName=liveApp ****
&DomainNam e=example.com
&EndTime=2017-12-22T08:00:00Z
&OssBucket=liveBucket ****
&OssEndpoint= oss-cn-developer.aliyundoc.com
&OssObject={AppName}/{StreamName}/{Date}/{Hour}/{Minute }_{ Second}.m3u8
&StartTime=2017-12-21T08:00:00Z
&StreamName=liveStream ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

<CreateLiveStreamRecordIndexFilesResponse>
  <RequestId>550439A3-F8EC-4CA2-BB62-B9DB43EEEF30</RequestId>
  <RecordInfo>
        <EndTime>2015-12-01T07:40:00Z</EndTime>
        <DomainNam e>example.com</DomainName>
        <CreateTime>2016-05-27T09:40:56Z</CreateTime>
        <StartTime>2015-12-01T07:36:00Z</StartTime>
        <OssBucket>liveBucket ****</OssBucket>
        <期間> 20</期間>
        <AppName>liveApp ****</AppName>
        <StreamName>liveStream ****</StreamName>
        <OssEndpoint> oss-cn-developer.aliyundoc.com</OssEndpoint>
        <RecordUrl>http:// *****/atestObject.m3u8</RecordUrl>
        <OssObject>liveObject ****.m3u8</OssObject>
        <高さ> 480</高さ>
        <RecordId>c4d7f0a4-b506-43f9-8de3-07732c3f ****</RecordId>
        <Width>640</Width>
  </RecordInfo>
</CreateLiveStreamRecordIndexFilesResponse>

JSON 形式

{
    "CreateLiveStreamRecordIndexFilesResponse": {
        "RequestId": "550439A3-F8EC-4CA2-BB62-B9DB43EEEF30" 、
        "RecordInfo": {
            "EndTime": "2015-12-01T07:40:00Z" 、
            "DomainName": "example.com",
            "CreateTime": "2016-05-27T09:40:56Z" 、
            "StartTime": "2015-12-01T07:36:00Z" 、
            "OssBucket": "liveBucket ****" 、
            "期間": 20、
            "AppName": "liveApp ****" 、
            "StreamName": "liveStream ****" 、
            "OssEndpoint": "oss-cn-developer.aliyundoc.com" 、
            "RecordUrl": "http:// *****/atestObject.m3u8" 、
            "OssObject": "liveObject ****.m3u8" 、
            "高さ": 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パラメーターが正しく指定されているかどうかを確認します。
400 InvalidOssBucket.Malformed 指定されたOssBucketは不正です。 OSSバケット名の形式が無効な場合に返されるエラーメッセージ。 OssBucketパラメーターの値が有効かどうかを確認します。
400 InvalidOssObject.Malformed 指定されたOssObjectは不正です。 OSSオブジェクト名の形式が無効な場合に返されるエラーメッセージ。 OssObjectパラメーターの値が有効かどうかを確認します。
400 InvalidStream.NotFound Speicifiedストリームは存在しません。 ライブストリームが存在しない場合に返されるエラーメッセージ。 StreamNameパラメーターの値が有効かどうかを確認します。
400 InvalidConfig.Changed StartTimeとEndTimeの間のossバケット情報が変更されました。 StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲でバケット情報が変更された場合に返されるエラーメッセージ。
400 NoRecordContent StartTimeとEndTimeの間のレコードコンテンツは空です。 StartTimeパラメーターとEndTimeパラメーターで指定された時間範囲に記録が存在しない場合に返されるエラーメッセージ。
400 OperationNotSupport この操作はFLVまたはMP4形式をサポートしておらず、ライブからVODに録画されたストリーミングもサポートしていません。 この操作は、FLVまたはMP4形式での録画、またはライブからVODに録画されたストリーミングでは使用できない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。