Set Up Live Stream Transcoding Configuration via API - ApsaraVideo Live - Alibaba Cloud - ApsaraVideo Live

Deskripsi operasi

Penggunaan fitur Transkoding aliran langsung dikenakan biaya Transkoding, yang dihitung berdasarkan standar Transkoding, spesifikasi resolusi, dan total durasi Transkoding. Untuk aturan penagihan, lihat Biaya Transkoding aliran langsung.
Pertama, dapatkan ID kunci master KMS pengguna melalui Key Management Service (KMS), lalu panggil operasi ini untuk menambahkan informasi konfigurasi Transkoding default. Saat ini, operasi ini hanya mendukung dua jenis template transkoding: template kualitas standar dan template Transkoding Narrowband HD™.
Alibaba Cloud KMS menyediakan kunci default untuk enkripsi sisi server layanan cloud secara gratis, dan tidak memerlukan pembelian instans. Namun, jika Anda perlu membangun solusi kriptografi aplikasi kustom, menggunakan fitur kredensial, atau mengelola siklus hidup kunci, Anda harus membeli instans manajemen kunci perangkat lunak atau perangkat keras. Untuk detail penagihan, lihat Penagihan.

Batas QPS

Batas QPS pengguna tunggal untuk operasi ini adalah 30 panggilan per detik. Jika batas terlampaui, panggilan API akan dibatasi, yang dapat memengaruhi bisnis Anda. Panggil operasi ini secara 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:AddLiveStreamTranscode

create

*Domain

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah. Saat menggunakan SDK 2.0, atur parameter ini ke ID wilayah yang sesuai dengan titik akhir pendaftaran layanan. Saat menggunakan SDK 1.0, abaikan parameter ini.	cn-shanghai
Domain	string	Yes	Domain streaming Streamer.	example.com
App	string	Yes	Nama aplikasi tempat aliran berada. Nilai App harus sama dengan AppName di URL ingest agar template transkoding berlaku. Nilai dapat memiliki panjang hingga 256 karakter dan dapat berisi angka, huruf, tanda hubung (-), dan garis bawah (_). App juga mendukung satu tanda bintang () sebagai nilai, yang cocok dengan string apa pun termasuk string kosong. Catatan* Jika template transkoding dengan App diatur ke satu tanda bintang () dikonfigurasi: saat pengguna menarik aliran yang telah dikodekan ulang, sistem pertama-tama mencocokkan template transkoding yang nilai App-nya sama dengan AppName di URL ingest. Jika tidak ada template tersebut, sistem mencocokkan template transkoding dengan App diatur ke satu tanda bintang ().	liveApp****
Template	string	Yes	Template transkoding. Nilai valid: Template kualitas standar: lld: definisi rendah. lsd: definisi standar. lhd: definisi tinggi. lud: definisi ultra-tinggi. Template Transkoding Narrowband HD™: ld: definisi rendah. sd: definisi standar. hd: definisi tinggi. ud: definisi ultra-tinggi.	lsd
EncryptParameters	string	No	Konfigurasi enkripsi. Format JSON. Bidang dijelaskan sebagai berikut: EncryptType: tipe enkripsi. Atur nilai ke aliyun. KmsKeyID: ID kunci master KMS pengguna. KmsKeyExpireInterval: interval rotasi kunci. Nilai valid: 60 hingga 3600. Unit: detik.	{"EncryptType": "aliyun", "KmsKeyID":"afce5722-81d2-43c3-9930-7601da11****","KmsKeyExpireInterval":"3600"}
Lazy	string	No	Apakah akan mengaktifkan transkoding sesuai permintaan. Nilai valid: yes: mengaktifkan transkoding sesuai permintaan. no: menonaktifkan transkoding sesuai permintaan.	yes

Elemen respons

Element	Type	Description	Example
	object	ID permintaan.
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68F4CD8

Contoh

Respons sukses

JSONformat

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidParameters	%s Please check and try again later.	Exception parameter exists, please check and try again.
400	ConfigAlreadyExists	%s Please check and try again later.	Configuration already exists, please check and try again.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.