すべてのプロダクト
Search

このプロダクト

    ApsaraVideo Live:DescribeLiveStreamMerge

    ドキュメントセンター

    ApsaraVideo Live:DescribeLiveStreamMerge

    最終更新日:Jun 22, 2026

    プライマリ/バックアップストリームのマージ設定を照会します。

    操作説明

    このAPIの1ユーザーあたりの1 秒あたりのクエリ数（QPS）制限は100です。この制限を超えると、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: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

    マージエンジンが使用されているかどうかを示します。

    列挙値:

    • off :

      マージエンジンは使用されていません。

    • on :

      マージエンジンは使用されています。

    on
    MergeParameters

    string

    フェールオーバーの構成パラメーターです。以下のいずれかの条件が満たされた場合、フェールオーバーがトリガーされます。

    1. ファイルの終わり (EOF) やネットワークエラーなど、明示的なストリーム中断が発生した場合。

    2. 直近 5 秒間のコマ落ち率が 60% を超えた場合。

    3. ストリームプルのタイムアウトが発生し、連続して 2 秒間フレームデータが受信されなかった場合。

    4. ストリーム中断やコマ落ちが検出されないが、直近 ali_max_no_frame_timeout 秒間の平均フレームレートが ali_low_frame_rate_threshold を下回った場合。ali_max_no_frame_timeout の値は、条件 3 のタイムアウト期間も定義します。

    block_all_jitter が有効になっている場合、条件 2、3、4 は適用されません。

    有効値の範囲：

    • ali_max_no_frame_timeout: 3 ～ 9 の整数

    • ali_low_frame_rate_threshold: 2 ～ 199 の整数

    • block_all_jitter: 0 (デフォルト、無効) または 1 (有効)

    ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0

    SwitchMode

    string

    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",
        "SwitchMode": ""
      }
    ]
  },
  "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.

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

    変更履歴

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