すべてのプロダクト
Search

このプロダクト

    Intelligent Media Services:AddMediaConnectFlowInput

    ドキュメントセンター

    Intelligent Media Services:AddMediaConnectFlowInput

    最終更新日:Mar 17, 2026

    MediaConnect フローインスタンスにインプットを追加します。

    操作説明

    • 指定されたフローインスタンス ID が存在しない場合、API はエラーを返します。

    • デフォルトでは、フローインスタンスは 1 つのインプットのみをサポートします。デュアルストリームディザスタリカバリを有効化すると、2 つ目のインプットを追加できます。

    インプットタイプの説明

    • RTMP-PUSH：RTMP リスナーインプットを作成します。RTMP プロトコルを使用して、API が返す URL へストリームをプッシュできます。

    • RTMP-PULL：RTMP back-to-origin インプットを作成します。フローインスタンスが指定したオリジンサーバーから RTMP ライブストリームをプルします。

    • SRT-Listener：SRT リスナーインプットを作成します。SRT プロトコルを使用して、API が返す URL へストリームをプッシュできます。

    • SRT-Caller：SRT back-to-origin インプットを作成します。フローインスタンスが指定したオリジンサーバーから SRT ライブストリームをプルします。

    • Flow：別の上流フローインスタンスの出力をインプットとして使用します。上流フローインスタンス ID と出力名の両方を指定する必要があります。上流フローインスタンスの出力は、SRT-Listener または RTMP-PULL タイプである必要があります。フローインスタンスがカスケード接続される場合、デフォルトで専用回線が使用されます。これにより、複数のフローインスタンス間でのクロスリージョンディストリビューションが可能になります。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    ice:AddMediaConnectFlowInput

    create

    *All Resource

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    FlowId

    string

    必須

    フローインスタンス ID

    34900dc6-90ec-4968-af3c-fcd87f231a5f
    InputProtocol

    string

    必須

    インプットタイプ

    列挙値:

    • RTMP-PUSH :

      RTMP-PUSH

    • SRT-Caller :

      SRT-Caller

    • RTMP-PULL :

      RTMP-PULL

    • SRT-Listener :

      SRT-Listener

    • Flow :

      Flow

    RTMP-PUSH
    InputName

    string

    必須

    インプット名

    AliTestInput
    MaxBitrate

    integer

    任意

    最大ビットレート（bps：ビット／秒）

    2000000
    Cidrs

    string

    任意

    CIDR 表記による IP アドレスホワイトリスト。複数の CIDR ブロックはカンマで区切ります。

    19.168.1.1/32,18.168.1.1/16
    InputFromUrl

    string

    任意

    インプット URL。インプットタイプが RTMP-PULL または SRT-Listener の場合にのみ必須です。

    rtmp://pull.test.alivecdn.com/live/alitest
    PairFlowId

    string

    任意

    上流フロー ID。インプットタイプが Flow の場合にのみ必須です。

    805fbdd0-575e-4146-b35d-ec7f63937b20
    PairOutputName

    string

    任意

    上流フローの出力名。インプットタイプが Flow の場合にのみ必須です。

    AliTestOutput
    SrtLatency

    integer

    任意

    SRT レイテンシー（ミリ秒）。インプットタイプが SRT-Listener または SRT-Caller の場合にのみ必須です。

    1000
    SrtPassphrase

    string

    任意

    SRT 暗号鍵。インプットタイプが SRT-Listener または SRT-Caller の場合にのみ必須です。

    BETTERG08S01
    SrtPbkeyLen

    string

    任意

    SRT 暗号鍵長（バイト単位）。インプットタイプが SRT-Listener または SRT-Caller の場合にのみ必須です。

    列挙値:

    • 0 :

      0

    • 16 :

      16

    • 24 :

      24

    • 32 :

      32

    32

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答本文

    Content

    object

    応答本文

    InputUrl

    string

    インプット URL

    rtmp://1.2.3.4:1935/live/AliTestInput_8666ec062190f00e263012666319a5be
    InnerInputUrl

    string

    Description

    string

    API 呼び出しの説明

    OK
    RetCode

    integer

    エラーコード。値が 0 の場合、成功を示します。

    0
    RequestId

    string

    リクエスト ID

    11357BE8-4C54-58EA-890A-5AB646EDE4B2

    例

    成功レスポンス

    JSONJSON

    {
  "Content": {
    "InputUrl": "rtmp://1.2.3.4:1935/live/AliTestInput_8666ec062190f00e263012666319a5be",
    "InnerInputUrl": ""
  },
  "Description": "OK",
  "RetCode": 0,
  "RequestId": "11357BE8-4C54-58EA-890A-5AB646EDE4B2"
}

    エラーコード

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

    変更履歴

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