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

プライマリストリームとセカンダリストリームのマージ設定を照会します。

操作説明

この操作は、ユーザーごとに 1 秒あたり 100 クエリ（QPS）に制限されています。この制限を超えると、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:DescribeLiveStreamMerge

get

*Domain

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

なし

リクエストパラメーター

パラメーター	タイプ	必須 / 任意	説明	例
RegionId	string	任意	リージョン ID。	cn-shanghai
DomainName	string	必須	ストリーミングドメイン。	example.com
AppName	string	任意	マージされたストリーム出力のアプリケーション名。詳細については、「プライマリ/セカンダリストリームのマージ設定」をご参照ください。	app
StreamName	string	任意	マージされたストリーム出力のストリーム名。詳細については、「プライマリ/セカンダリストリームのマージ設定」をご参照ください。	StreamName
Protocol	string	任意	ストリーミングプロトコル。有効な値： rtmp (デフォルト) rtc	rtmp

レスポンスパラメーター

パラメーター	タイプ	説明	例
	object
LiveStreamMergeList	object
LiveStreamMerge	array<object>	ライブストリーム情報の一覧。
	object	マージされたストリームに関する情報。
AppName	string	マージされたストリーム出力のアプリケーション名。	app
AppUsing	string	使用中のアプリケーション。	app1
DomainName	string	ストリーミングドメイン。	example.com
EndTime	string	ストリームマージが終了した時刻。	2020-05-29T01:00:00Z
ExtraInAppStreams	string	3 番目から N 番目のインジェストエンドポイントのアプリケーションとストリーム。	app3/stream3,app4/stream4,app5/stream5,…,appN/streamN
InAppName1	string	ストリームマージのプライマリ入力アプリケーションの名前。	app1
InAppName2	string	ストリームマージのセカンダリ入力アプリケーションの名前。	app2
InStreamName1	string	ストリームマージのプライマリ入力ストリームの名前。	InStream1
InStreamName2	string	ストリームマージのセカンダリ入力ストリームの名前。	stream2
Protocol	string	ライブストリームプロトコル。	rtmp
StartTime	string	ストリームマージが開始された時刻。	2020-05-29T00:00:00Z
StreamName	string	マージされたストリーム出力のストリーム名。	StreamName
StreamUsing	string	使用中のストリーム。	InStream1
LiveMerger	string	現在のタスクがマージエンジンを使用しているかどうかを示します。	on
MergeParameters	string	タスクのフェールオーバー構成パラメーター。ファイルの終わり（EOF）またはネットワークエラーが原因でストリームが中断された場合、プライマリ/セカンダリフェールオーバーがすぐにトリガーされます。過去 5 秒間のスタッター率が 60% を超えると、プライマリ/セカンダリフェールオーバーがすぐにトリガーされます。 2 秒連続でフレームデータが受信されないためにストリームフェッチングがタイムアウトした場合、プライマリ/セカンダリフェールオーバーがトリガーされます。ストリームが中断されず、スタッターが発生しない場合でも、ali_max_no_frame_timeout 期間内の平均フレームレートが ali_low_frame_rate_threshold よりも小さい場合、プライマリ/セカンダリフェールオーバーがトリガーされます。 ali_max_no_frame_timeout パラメーターを設定すると、条件 3 のタイムアウト期間が ali_max_no_frame_timeout の値に更新されます。 block_all_jitter が有効になっている場合、条件 2、3、および 4 は適用されません。有効な値： ali_max_no_frame_timeout: 2 より大きく 10 より小さい値。 ali_low_frame_rate_threshold: 1 より大きく 200 より小さい値。 block_all_jitter: 0（無効、デフォルト）または 1（有効）。	ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0
RequestId	string	リクエスト ID。	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

例

成功レスポンス

JSONJSON

{
  "LiveStreamMergeList": {
    "LiveStreamMerge": [
      {
        "AppName": "app",
        "AppUsing": "app1",
        "DomainName": "example.com",
        "EndTime": "2020-05-29T01:00:00Z",
        "ExtraInAppStreams": "app3/stream3,app4/stream4,app5/stream5,…,appN/streamN",
        "InAppName1": "app1",
        "InAppName2": "app2",
        "InStreamName1": "InStream1",
        "InStreamName2": "stream2",
        "Protocol": "rtmp",
        "StartTime": "2020-05-29T00:00:00Z",
        "StreamName": "StreamName",
        "StreamUsing": "InStream1",
        "LiveMerger": "on",
        "MergeParameters": "ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0\n"
      }
    ]
  },
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidParam	Parameter invalid.
400	QuotaExceeded.Merge	Exceed max merge count limit
400	ConfigAlreadyExists	Config has already exist.
500	InternalError	The request processing has failed due to backend service exception.

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

変更履歴

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