CreateLiveStreamRecordIndexFiles - - Alibaba Cloud ドキュメントセンター

指定された時間範囲の m3u8 インデックスファイルを作成します。

操作説明

Object Storage Service (OSS) を設定する必要があります。詳細については、「OSS の設定」をご参照ください。 ApsaraVideo Live は、m3u8 形式でライブストリームを録画し、OSS に保存します。保存された TS シャードでリアルタイムビデオ編集を実行するために、録画のインデックスを作成できます。

説明

録画インデックスを作成するには、ライブストリームが取り込まれている必要があります。指定された時間内にストリームが取り込まれなかった場合、またはストリーム名が正しくない場合、操作は失敗します。
DomainName、AppName、StreamName が正しいことを確認してください。そうでない場合、InvalidStream.NotFound エラーが返されます。
StartTime と EndTime の間の期間は、少なくとも 1 つの TS シャードの期間である必要があります。デフォルトの期間は 30 秒です。
EndTime は StartTime より後の時刻である必要があります。 2 つの時刻の間の期間は 4 日を超えることはできません。
ApsaraVideo Live は TS シャード情報を 3 か月間しか保存しないため、過去 3 か月間の録画に対してのみ m3u8 ファイルを作成できます。
TS シャードファイルは OSS に保存されます。保存期間は、ご利用の OSS ストレージ構成によって異なります。詳細については、「ライフサイクルルールの設定」をご参照ください。
ApsaraVideo Live は作成された m3u8 インデックスファイルに関する情報を 6 か月間しか保存しないため、過去 6 か月以内に作成されたインデックスファイルの情報のみを照会できます。
M3U8 インデックスファイルは OSS に保存されます。保存期間は、ご利用の OSS ストレージ構成によって異なります。
m3u8 ファイルと TS ファイルが異なるバケットにある場合、m3u8 ファイル内の TS ファイルへのパスは HTTP 形式になります。

QPS 制限

この API 呼び出しの制限は、各ユーザーあたり 45 クエリ/秒 (QPS) です。制限を超えると、API 呼び出しがスロットリングされ、ビジネスに影響を与える可能性があります。それに応じて API 呼び出しを計画してください。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

live:CreateLiveStreamRecordIndexFiles

create

*Domain

acs:cdn:*:{#accountId}:domain/{#DomainName}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
DomainName	string	必須	ストリーミングドメイン。	example.com
AppName	string	必須	アプリケーションの名前。テンプレートを有効にするには、AppName がアップストリーミング URL の AppName と一致する必要があります。すべてのアプリケーションを照合するには、アスタリスク (*) を入力します。	liveApp****
StreamName	string	必須	ストリームの名前。テンプレートを有効にするには、StreamName がアップストリーミング URL の StreamName と一致する必要があります。すべてのストリームを照合するには、アスタリスク (*) を入力します。	liveStream****
OssEndpoint	string	必須	OSS バケットのエンドポイント。	cn-oss-****.aliyuncs.com
OssBucket	string	必須	OSS バケットの名前。	liveBucket****
OssObject	string	必須	OSS に保存されている録画ファイルの名前。	{AppName}/{StreamName}/{Date}/{Hour}/{Minute}_{Second}.m3u8
StartTime	string	必須	インデックスファイルの開始時刻。この時刻以降にアップロードされた TS ファイルがインデックスファイルに含まれます。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式である必要があります。	2017-12-21T08:00:00Z
EndTime	string	必須	インデックスファイルの終了時刻。この時刻より前にアップロードされた TS ファイルがインデックスファイルに含まれます。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式である必要があります。	2017-12-22T08:00:00Z
EndTimeIncluded	boolean	任意	終了時刻を含めるかどうかを指定します。これを true に設定すると、作成されたインデックスファイルが StartTime と EndTime の間の時間範囲を完全にカバーするように、システムはもう 1 つの TS ファイルを含めようとします。	false

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	550439A3-F8EC-4CA2-BB62-B9DB43EEEF30
RecordInfo	object	録画情報。
RecordUrl	string	インデックスファイルの URL。	http://*****/atestObject.m3u8
StreamName	string	ストリーム名。	liveStream****
CreateTime	string	ファイルが作成された時刻。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式です。	2016-05-27T09:40:56Z
RecordId	string	インデックスファイルの ID。	c4d7f0a4-b506-43f9-8de3-07732c3f****
Height	integer	動画の高さ。	480
OssBucket	string	OSS バケットの名前。	liveBucket****
DomainName	string	ストリーミングドメイン。	example.com
OssObject	string	OSS に保存されている録画ファイルの名前。	liveObject****.m3u8
EndTime	string	録画の終了時刻。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式です。	2015-12-01T07:40:00Z
AppName	string	アプリケーション名。	liveApp****
StartTime	string	録画の開始時刻。時刻は UTC で、yyyy-MM-ddTHH:mm:ssZ 形式です。	2015-12-01T07:36:00Z
Width	integer	動画の幅。	640
Duration	number	録画時間 (秒単位)。	20
OssEndpoint	string	OSS バケットのエンドポイント。	cn-oss-****.aliyuncs.com

例

成功レスポンス

JSONJSON

{
  "RequestId": "550439A3-F8EC-4CA2-BB62-B9DB43EEEF30",
  "RecordInfo": {
    "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****.m3u8",
    "EndTime": "2015-12-01T07:40:00Z",
    "AppName": "liveApp****",
    "StartTime": "2015-12-01T07:36:00Z",
    "Width": 640,
    "Duration": 20,
    "OssEndpoint": "cn-oss-****.aliyuncs.com"
  }
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidStartTime.Mismatch	Specified StartTime does not math the current time.
400	InvalidStartTime.Malformed	Specified StartTime is malformed.
400	InvalidParams	invalid params
400	InvalidEndTime.Malformed	Specified EndTime is malformed.
400	InvalidEndTime.Mismatch	Specified end time does not math the specified start time.
400	InvalidOssEndpoint.Malformed	Specified OssEndpoint is malformed.
400	InvalidOssBucket.Malformed	Specified OssBucket is malformed.
400	InvalidOssObject.Malformed	Specified OssObject is malformed.
400	InvalidStream.NotFound	Speicified stream does not exist.
400	InvalidConfig.Changed	The oss bucket info between StartTime and EndTime has changed.
400	NoRecordContent	The record content between StartTime and EndTime is empty.
400	RecordContentExceed	The record content between StartTime and EndTime is exceeded, please narrow down the range.
400	OperationNotSupport	The Operation is not support for flv/mp4 format or live to vod record.
500	InternalError	The request processing has failed due to some unknown error, exception or failure.
404	InvalidBucket.NotFound	The bucket does not belong to you.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。