All Products
Search
Document Center

Intelligent Media Services:AddMediaConnectFlowInput

Last Updated:Jun 11, 2026

Membuat Input untuk instans MediaConnect Flow.

Deskripsi operasi

  • Jika ID instans Flow yang ditentukan tidak ada, API akan mengembalikan error.

  • Secara default, sebuah Flow hanya dapat memiliki satu input. Setelah pemulihan bencana aliran ganda diaktifkan, Anda dapat menambahkan satu input tambahan.

Deskripsi tipe input

  • RTMP-PUSH: Membuat input bertipe listener RTMP. Anda dapat melakukan push stream ke URL yang dikembalikan oleh API menggunakan protokol RTMP.

  • RTMP-PULL: Membuat input bertipe pull-from-origin RTMP. Flow akan menarik kembali live stream RTMP dari origin yang Anda tentukan.

  • SRT-Listener: Membuat input bertipe listener SRT. Anda dapat melakukan push stream ke URL yang dikembalikan oleh API menggunakan protokol SRT.

  • SRT-Caller: Membuat input bertipe pull-from-origin SRT. Flow akan menarik kembali live stream SRT dari origin yang Anda tentukan.

  • Flow: Menggunakan output dari instans Flow upstream lain sebagai input. Anda perlu menentukan baik ID instans Flow peer maupun nama outputnya. Output dari instans Flow upstream harus bertipe SRT-Listener/RTMP-PULL. Penyambungan (cascading) antar instans Flow secara default menggunakan jalur khusus (dedicated line), yang dapat digunakan untuk distribusi lintas-region di antara beberapa Flow.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

  • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

  • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

  • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

  • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

    • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

    • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

  • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

  • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ice:AddMediaConnectFlowInput

create

*全部资源

*

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

FlowId

string

Yes

ID instans Flow

34900dc6-90ec-4968-af3c-fcd87f231a5f

InputProtocol

string

Yes

Tipe input

Valid values:

  • RTMP-PUSH :

    RTMP-PUSH

  • SRT-Caller :

    SRT-Caller

  • RTMP-PULL :

    RTMP-PULL

  • SRT-Listener :

    SRT-Listener

  • Flow :

    Flow

RTMP-PUSH

InputName

string

Yes

Nama input

AliTestInput

MaxBitrate

integer

No

Bitrate input, dalam bps

2000000

Cidrs

string

No

Daftar putih IP dalam format CIDR. Beberapa segmen IP dipisahkan dengan koma.

19.168.1.1/32,18.168.1.1/16

InputFromUrl

string

No

URL input. Diperlukan hanya ketika tipe input adalah RTMP-PULL/SRT-Listener.

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

PairFlowId

string

No

FlowId peer. Diperlukan hanya ketika tipe input adalah Flow.

805fbdd0-575e-4146-b35d-ec7f63937b20

PairOutputName

string

No

Nama output dari Flow peer. Diperlukan hanya ketika tipe input adalah Flow.

AliTestOutput

SrtLatency

integer

No

Latensi SRT. Diperlukan hanya ketika tipe input adalah SRT-Listener/SRT-Caller.

1000

SrtPassphrase

string

No

Frasa sandi enkripsi SRT. Diperlukan hanya ketika tipe input adalah SRT-Listener/SRT-Caller.

BETTERG08S01

SrtPbkeyLen

string

No

Panjang kunci enkripsi SRT. Diperlukan hanya ketika tipe input adalah SRT-Listener/SRT-Caller.

Valid values:

  • 0 :

    0

  • 16 :

    16

  • 24 :

    24

  • 32 :

    32

32

WithInternalVip

string

No

Elemen respons

Element

Type

Description

Example

object

Konten respons

Content

object

Isi respons

InputUrl

string

URL input

rtmp://1.2.3.4:1935/live/AliTestInput_8666ec062190f00e263012666319a5be

InnerInputUrl

string

Description

string

Deskripsi panggilan API

OK

RetCode

integer

Kode error yang dikembalikan. 0 menunjukkan sukses.

0

RequestId

string

ID permintaan

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.