Referensi konfigurasi penggabungan live stream - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Mengkueri konfigurasi penggabungan aliran utama/cadangan.

Deskripsi operasi

Batas kueri per detik (QPS) untuk satu pengguna API ini adalah 100. Jika batas ini terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Gunakan API ini dengan tepat.

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

live:DescribeLiveStreamMerge

get

*Domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-shanghai
DomainName	string	Yes	Nama domain streaming.	example.com
AppName	string	No	Nama aplikasi keluaran hasil penggabungan. Anda dapat melihatnya di halaman Konfigurasi Penggabungan Aliran Utama/Cadangan.	app
StreamName	string	No	Nama aliran keluaran hasil penggabungan. Anda dapat melihatnya di halaman Konfigurasi Penggabungan Aliran Utama/Cadangan.	StreamName
Protocol	string	No	Protokol streaming. Nilai valid: rtmp (default) rtc.	rtmp

Elemen respons

Element	Type	Description	Example
	object
LiveStreamMergeList	object
LiveStreamMerge	array<object>	Daftar informasi aliran langsung.
	object	Daftar informasi aliran langsung.
AppName	string	The app name of the merged output stream.	app
AppUsing	string	The app name of the active input stream.	app1
DomainName	string	The streaming domain.	example.com
EndTime	string	The end time of the stream merge.	2020-05-29T01:00:00Z
ExtraInAppStreams	string	The app and stream names for the third to the Nth input streams.	app3/stream3,app4/stream4,app5/stream5,…,appN/streamN
InAppName1	string	The app name of the primary stream.	app1
InAppName2	string	The app name of the backup stream.	app2
InStreamName1	string	The stream name of the primary stream.	InStream1
InStreamName2	string	The stream name of the backup stream.	stream2
Protocol	string	The protocol of the input live streams.	rtmp
StartTime	string	The start time of the stream merge.	2020-05-29T00:00:00Z
StreamName	string	The stream name of the merged output stream.	StreamName
StreamUsing	string	The stream name of the active input stream.	InStream1
LiveMerger	string	Indicates whether the merge engine is used. Valid values: off : The merge engine is not used. on : The merge engine is used.	on
MergeParameters	string	The configuration parameters for failover. A failover is triggered if any of the following conditions are met: An explicit stream interruption occurs, such as an end-of-file (EOF) or a network error. The stutter rate in the last 5 seconds exceeds 60%. A stream pull timeout occurs and no frame data is received for 2 consecutive seconds. No stream interruption or stuttering is detected, but the average frame rate within the last `ali_max_no_frame_timeout` seconds is lower than `ali_low_frame_rate_threshold`. The value of `ali_max_no_frame_timeout` also defines the timeout period for Condition 3. If `block_all_jitter` is enabled, Conditions 2, 3, and 4 do not apply. Value ranges: `ali_max_no_frame_timeout`: An integer from 3 to 9. `ali_low_frame_rate_threshold`: An integer from 2 to 199. `block_all_jitter`: `0` (default, disabled) or `1` (enabled).	ali_low_frame_rate_threshold=10&ali_max_no_frame_timeout=5&block_all_jitter=0
SwitchMode	string
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Contoh

Respons sukses

JSONformat

{
  "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"
}

Kode kesalahan

HTTP status code	Error code	Error message
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.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.