RealTimeRecordCommand API によるオンデマンド録画のトリガー - LIVE - Alibaba Cloud - ApsaraVideo Live

操作説明

この操作を使用する前に、ライブストリーム録画の課金方法と料金を完全に理解していることを確認してください。請求明細の詳細については、「ライブストリーム録画の料金」をご参照ください。
この操作は、録画構成が効果を持っているライブストリームのみをコントロールできます。まず「録画構成の追加」を完了してください。
この操作を呼び出す前に、ターゲットストリーム (DomainName/AppName/StreamName) がアクティブなアップストリーミング状態であることを確認してください。
ライブストリームが録画中の場合 (自動録画または手動録画による)、この操作を呼び出してストリームの録画を停止できます。ただし、録画がすでに開始されている状態でこの操作を呼び出して録画を開始しようとすると、TaskAlreadyStarted エラーが返され、タスクがすでに開始されていることが示されます。
手動で開始された録画対象のライブストリームが中断された場合、録画は停止します。自動録画が設定されていない場合、アップストリーミングが再開されても録画は自動的に開始されません。

QPS 制限

この操作の単一ユーザー QPS 制限は、1 秒あたり 50 回の呼び出しです。この制限を超えると、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:RealTimeRecordCommand

none

*Domain

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-shanghai
Command	string	必須	操作アクション。有効な値: start: 強制的に録画を開始します。これは最初の操作として呼び出す必要があり、停止する前に再度呼び出すことはできません。 stop: 強制的に録画を一時停止します。ストリーム中断遅延 (デフォルトで 180 秒) が経過すると、録画ファイルが生成されます。これは start または restart の後にのみ呼び出せます。stop を呼び出した直後にファイルを生成するには、cancel_delay を呼び出してください。 cancel_delay: 待機を即座に終了して録画ファイルを生成し、録画を完全に停止します。ファイルを事前に生成するには、stop の後にこれを呼び出す必要があります。 restart: 強制的に録画を再開します。restart の前に録画が進行中の場合、ファイルが即座に生成されます。これは、タスクが開始済みまたは停止済みの状態にある場合にのみ呼び出せます。	start
DomainName	string	必須	ストリーマーのストリーミングドメイン。ストリームが属するドメインを指定します。	example.com
AppName	string	必須	ストリームが属するアプリケーションの名前。AppName は「ストリーム管理」ページのビューで確認できます。	liveApp****
StreamName	string	必須	ストリーム名。StreamName が正しいことを確認してください。StreamName は「ストリーム管理」ページのビューで確認できます。説明この操作は単一ストリーム操作のみをサポートしており、ワイルドカードはサポートしていません。	liveStream****

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

例

成功レスポンス

JSONJSON

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	MalformedParam	%s, please check and try again later.	無効なパラメーターが存在します。確認して再試行してください。
400	MissingParam	%s, please check and try again later.	必須パラメーターが不足しています。確認して再試行してください。
400	CodeConfigNotFound	%s, please check and try again later.	構成が存在しません。構成を確認して再試行してください。
500	InternalError	%s.	内部エラーが発生しました。しばらくしてから再試行してください。
409	StreamNotFound	%s, please check and try again later.	ストリームが存在しません。リクエストを確認して再試行してください。
409	TaskAlreadyStarted	%s, please do not start again.	タスクは既に開始されています。再度開始しないでください。

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

変更履歴

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