UploadStreamByURL - ApsaraVideo VOD

Deskripsi operasi

Pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD sebelum memanggil operasi ini. Anda akan dikenai biaya penyimpanan setelah mengunggah file media ke ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Penagihan penyimpanan aset media. Jika Anda telah mengaktifkan layanan akselerasi, Anda akan dikenai biaya akselerasi saat mengunggah file media ke ApsaraVideo VOD. Untuk informasi selengkapnya, lihat Penagihan traffic akselerasi.
Operasi ini hanya tersedia di wilayah China (Shanghai) dan Singapore.
Anda dapat memanggil operasi ini untuk mengunggah aliran yang telah dikodekan ulang ke ApsaraVideo VOD dari penyimpanan eksternal. Jenis HDR berikut dari aliran yang telah dikodekan ulang didukung: HDR, HDR10, HLG, Dolby Vision, HDR Vivid, dan SDR+.
Anda dapat memanggil operasi GetURLUploadInfos untuk menanyakan status pengunggahan. Setelah pengunggahan selesai, callback dari event UploadByURLComplete akan dikembalikan.

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

vod:UploadStreamByURL

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
StreamURL	string	Yes	URL dari aliran yang telah dikodekan ulang. Jika autentikasi URL diperlukan, Anda harus menyertakan informasi autentikasi dalam parameter ini dan memastikan bahwa URL tersebut dapat diakses melalui Internet.	https://example.com/lesson-01.mp4
MediaId	string	Yes	ID media di ApsaraVideo VOD.	ca3a8f6e49*****57b65806709586
Definition	string	Yes	Kualitas aliran video. Untuk informasi selengkapnya mengenai nilai yang valid untuk parameter ini, lihat Parameter untuk aset media.	HD
FileExtension	string	No	Ekstensi nama file dari aliran yang telah dikodekan ulang. Untuk informasi selengkapnya, lihat bagian Format file media yang didukung di Ikhtisar. Jika Anda menetapkan nilai untuk parameter ini, ekstensi nama file yang ditentukan dalam StreamURL akan ditimpa. Catatan Parameter ini wajib diisi jika Anda tidak menentukan ekstensi nama file dalam StreamURL.	mp4
HDRType	string	No	Jenis HDR dari aliran yang telah dikodekan ulang. Nilai yang valid: HDR HDR10 HLG DolbyVision HDRVivid SDR+ Catatan Jenis HDR dari aliran yang telah dikodekan ulang tidak peka terhadap huruf besar/kecil. Anda dapat mengosongkan parameter ini untuk aliran non-HDR.	HDR10
UserData	string	No	Parameter yang ditentukan pengguna. Untuk informasi selengkapnya, lihat bagian "UserData: menentukan konfigurasi kustom untuk pengunggahan media" pada topik Parameter permintaan. Catatan Konfigurasi callback yang Anda tentukan untuk parameter ini hanya berlaku setelah Anda menentukan URL callback HTTP dan memilih event callback tertentu di Konsol ApsaraVideo VOD. Untuk informasi selengkapnya tentang cara mengonfigurasi pengaturan callback HTTP di Konsol ApsaraVideo VOD, lihat Konfigurasi pengaturan callback.	{"MessageCallback":{"CallbackURL":"http://aliyundoc.com"}, "Extend":{"localId":"xxx","test":"www"}}
UploadMetadata	string	No	Informasi metadata untuk mengunggah file media, dalam format string JSON. Untuk informasi selengkapnya, silakan merujuk pada tabel UploadMetadata di bawah ini.	{"AddressMapping":"1","CustomPath":"test/xxx","CustomFileName":"xxx.mp4","isOverwritePath":"0"}

Name	Type	Required	Descriptio
AddressMapping	String	No	Aturan pemetaan alamat. Nilai: 1 merepresentasikan pemetaan URL aliran yang telah dikodekan ulang, 2 merepresentasikan jalur kustom.
CustomPath	String	No	Jalur file kustom. Panjang tidak melebihi 1000 byte. Diencode UTF-8.
CustomFileName	String	No	Nama file kustom. Panjang tidak melebihi 1000 byte. Diencode UTF-8.
IsOverwritePath	String	No	Apakah akan menimpa jika jalur file kustom sudah ada. Nilai: 0 merepresentasikan jangan timpa, 1 merepresentasikan timpa.

Catatan

Ketika AddressMapping diatur ke 2, CustomPath dan CustomFileName harus disediakan.
Ketika IsOverwritePath diatur ke 0, jika jalur file kustom sudah ada, antarmuka akan mengembalikan kegagalan.

Elemen respons

Element	Type	Description	Example
	object	Informasi dasar.
RequestId	string	ID permintaan.	7AE96389-DF1E-598D-816B-7B40F13B4620
StreamJobId	string	ID pekerjaan pengunggahan aliran. Parameter ini digunakan saat Anda memanggil operasi GetURLUploadInfos. Di ApsaraVideo VOD, Anda hanya dapat mengunggah satu aliran yang telah dikodekan ulang dalam satu pekerjaan pengunggahan. Untuk informasi selengkapnya, lihat bagian PlayInfo: informasi pemutaran mengenai aliran video di Struktur dasar.	e304b34fb3d959f92baef97b6496****
FileURL	string	URL objek OSS.	http://outin-31059bcee7810a200163e1c8dba****.oss-cn-shanghai.aliyuncs.com/lesson-01.mp4
SourceURL	string	URL aliran input. Parameter ini digunakan saat Anda memanggil operasi GetURLUploadInfos.	https://example.com/lesson-01.mp4

Contoh

Respons sukses

JSONformat

{
  "RequestId": "7AE96389-DF1E-598D-816B-7B40F13B4620",
  "StreamJobId": "e304b34fb3d959f92baef97b6496****",
  "FileURL": "http://outin-31059bcee7810a200163e1c8dba****.oss-cn-shanghai.aliyuncs.com/lesson-01.mp4",
  "SourceURL": "https://example.com/lesson-01.mp4"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.