CreateLivePullToPush - ApsaraVideo Live

Membuat task pull-to-push.

Deskripsi operasi

Penting Fitur pull-to-push merupakan layanan berbayar. Penagihan dimulai pukul 00.00 pada 5 Desember 2025.

Untuk informasi lebih lanjut mengenai biaya, lihat Biaya pull-to-push.
Anda dapat memanggil operasi ini untuk membuat task pull-to-push.
Anda dapat membuat task untuk menarik aliran live dan aliran video-on-demand (VOD).
Setelah task dibuat, task tersebut akan dimulai pada waktu mulai yang ditentukan dan secara otomatis dihentikan serta dihapus pada waktu akhir yang ditentukan.
Pastikan URL ingest tujuan tidak digunakan oleh task lain. Jika beberapa task mendorong aliran ke URL yang sama, stream ingest akan gagal.
Event callback pull-to-push mencakup callback untuk perubahan status task dan keluar dari task. Untuk informasi lebih lanjut, lihat Callback event pull-to-push.

Batas QPS

Batas queries per second (QPS) untuk operasi ini adalah 10 panggilan per detik per pengguna. Panggilan yang melebihi batas ini akan dikenai throttle, yang dapat memengaruhi bisnis Anda. Kami menyarankan agar Anda mematuhi batas tersebut.

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:CreateLivePullToPush

create

*全部资源

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	No	ID wilayah.	cn-beijing
Region	string	Yes	Wilayah tempat task dijalankan. Nilai yang valid: ap-southeast-1 (Singapura) ap-southeast-5 (Indonesia) cn-beijing (Beijing) cn-shanghai (Shanghai) cn-shenzhen (Shenzhen)	cn-shanghai
TaskName	string	No	Nama task. Parameter ini mendukung kueri fuzzy. Nilai default-nya adalah string kosong.	test
StartTime	string	Yes	Waktu mulai task. Catatan Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC.	2024-08-26T10:30:00Z
EndTime	string	Yes	Waktu akhir task. Catatan Waktu harus dalam format yyyy-MM-ddTHH:mm:ssZ dan dalam UTC. Nilai EndTime harus lebih lambat daripada nilai StartTime. Nilai EndTime harus lebih lambat daripada waktu saat ini.	2024-08-27T14:30:00Z
SourceType	string	Yes	Jenis aliran sumber. Nilai yang valid: live: aliran live. vod: resource ApsaraVideo VOD Alibaba Cloud. url: resource file video pihak ketiga.	live
SourceProtocol	string	No	Protokol aliran sumber. Nilai yang valid: rtmp srt http-flv hls Catatan Parameter ini wajib hanya jika SourceType diatur ke live. Parameter ini tidak valid jika SourceType diatur ke `vod` atau `url`.	rtmp
SourceUrls	array	Yes	Daftar URL aliran sumber. Catatan Jika SourceType adalah live, tentukan hanya satu URL pemutaran live lengkap. Jika SourceType adalah vod atau url, Anda dapat menentukan hingga 30 URL. Jenis live mendukung protokol RTMP, RTSP, SRT, dan HTTP-FLV. Untuk jenis vod, tentukan ID aset media dari resource ApsaraVideo VOD Alibaba Cloud. Jenis url mendukung protokol MP4 dan HTTP-FLV.	testurls
	string	No	URL aliran sumber. Catatan Jika SourceType adalah live, tentukan hanya satu URL pemutaran live lengkap. Jika SourceType adalah vod atau url, Anda dapat menentukan hingga 30 URL. Jenis live mendukung protokol RTMP, RTSP, SRT, dan HTTP-FLV. Untuk jenis vod, tentukan ID aset media dari resource ApsaraVideo VOD Alibaba Cloud. Jenis url mendukung protokol MP4 dan HTTP-FLV.	rtmp://pulltest.****.aliyunlive.com/pulltest493/pulltest-w434
DstUrl	string	Yes	URL ingest tujuan. Catatan Hanya protokol RTMP yang didukung. Panjang maksimum adalah 2.000 karakter.	rtmp://pushtest.********.aliyunlive.com/pulltest493/pulltest-w434
RepeatNumber	integer	No	Jumlah kali pemutaran diulang setelah aliran berakhir. Nilai yang valid: 0 (default): Pemutaran tidak diulang. -1: Pemutaran diulang secara loop. Bilangan bulat positif lainnya: Jumlah kali pemutaran diulang. Catatan Parameter ini hanya berlaku ketika SourceType adalah vod atau url.	0
FileIndex	integer	No	Indeks file. Pemutaran dimulai dari file ke-N.	0
Offset	integer	No	Offset awal file video, dalam satuan detik. Nilainya harus lebih besar dari 0. Catatan Offset waktu dari awal file video pertama tempat pemutaran dimulai. Parameter ini hanya berlaku ketika SourceType adalah vod atau url.	2
CallbackUrl	string	No	Alamat webhook HTTP. Nilai default-nya kosong. Catatan Alamat yang menerima callback terkait task. Panjang maksimum adalah 2.000 karakter. Jika Anda tidak menentukan parameter ini, event terkait task tidak dikirim sebagai callback.	https://callback*****.com
RetryInterval	integer	No	Interval retry, dalam satuan detik. Nilainya harus dalam rentang 60 hingga 300. Nilai default-nya adalah 60.	60
RetryCount	integer	No	Jumlah retry. Nilai default-nya adalah 3.	3

Elemen respons

Element	Type	Description	Example
	object	Objek respons.
RequestId	string	ID permintaan.	16A96B9A-F203-4EC5-8E43-CB92E68*****
RetCode	integer	Kode return. Catatan Nilai 0 menunjukkan bahwa permintaan berhasil. Untuk kode return lainnya, lihat bagian Kode error.	0
Description	string	Deskripsi error.	OK
TaskId	string	ID task.	fd245384-4067-4f91-9d75-9666a6bc9****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68*****",
  "RetCode": 0,
  "Description": "OK",
  "TaskId": "fd245384-4067-4f91-9d75-9666a6bc9****"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter	%s.
400	InvalidParam.CodeIllegalDuration	%s.
400	CodeInvalidAliUid	This aliuid does not have a live domain name.
400	CodeNotEnoughResource	Exceeded configuration limits or insufficient resources.
400	CodeConfigAlreadyExists	Code Config Already Exists
500	InternalError	%s.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.