CreateUploadImage - ApsaraVideo VOD

ApsaraVideo VOD mengembalikan URL unggah dan kredensial untuk memastikan otorisasi dan keamanan, mencegah unggahan berbahaya, serta secara otomatis membuat ID citra untuk keperluan manajemen. Operasi ini memperoleh URL dan kredensial unggah guna mengunggah file audio atau video sekaligus menghasilkan ID media tersebut.

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 trafik akselerasi.
Anda harus memperoleh URL dan kredensial terlebih dahulu sebelum mengunggah citra ke ApsaraVideo VOD. ApsaraVideo VOD menyediakan beberapa metode unggah, termasuk SDK unggah server, SDK unggah client, URL, API Object Storage Service (OSS), dan SDK OSS. Setiap metode memiliki persyaratan berbeda dalam memperoleh URL dan kredensial unggah. Untuk informasi selengkapnya, lihat bagian "Catatan penggunaan" pada topik URL dan kredensial unggah.
Anda tidak dapat melakukan refresh terhadap URL atau kredensial unggah selama proses unggah citra. Jika kredensial unggah kedaluwarsa, Anda dapat memanggil operasi ini untuk memperoleh URL dan kredensial unggah baru. Secara default, periode validitas kredensial unggah citra adalah 3.000 detik.
Untuk mengunggah watermark citra, Anda dapat memanggil operasi CreateUploadAttachedMedia.
Anda dapat mengonfigurasi callback untuk ImageUploadComplete guna menerima Notifikasi mengenai status unggah citra.

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

create

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Title	string	No	Judul citra. Aturan berikut berlaku: Judul dapat memiliki panjang hingga 128 karakter. Nilai harus dikodekan dalam UTF-8.	mytitle
ImageType	string	Yes	Tipe citra. Nilai yang valid: default: tipe citra default. cover: Gambar mini. Catatan Anda hanya dapat mengelola citra bertipe default di Konsol ApsaraVideo VOD.	default
ImageExt	string	No	Ekstensi nama file citra. Nilai yang valid: png (default) jpg jpeg gif	png
OriginalFileName	string	No	Nama file sumber. Catatan Nama harus mencantumkan ekstensi file. Ekstensi file tidak peka huruf besar/kecil.	D:\picture_01.png
Tags	string	No	Tag citra. Aturan berikut berlaku: Setiap tag dapat memiliki panjang hingga 32 karakter. Anda dapat menentukan maksimal 16 tag untuk satu citra. Pisahkan beberapa tag dengan koma (,). Nilai harus dikodekan dalam UTF-8.	test
StorageLocation	string	No	Alamat penyimpanan. Lakukan langkah-langkah berikut untuk memperoleh alamat penyimpanan: Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > Media Management > Storage. Di halaman Storage, lihat alamat penyimpanan. Catatan Jika Anda menentukan alamat penyimpanan, file media akan diunggah ke alamat tersebut.	outin-****..oss-cn-shanghai.aliyuncs.com
CateId	integer	No	ID kategori citra. Anda dapat memperoleh ID kategori dengan salah satu cara berikut: Masuk ke Konsol ApsaraVideo VOD. Di panel navigasi sebelah kiri, pilih Configuration Management > Media Management > Categories. Di halaman Categories, Anda dapat melihat ID kategori citra. Ambil nilai CateId dari respons operasi AddCategory. Ambil nilai CateId dari respons operasi GetCategories.	100036****
UserData	string	No	Konfigurasi kustom, termasuk konfigurasi callback dan konfigurasi akselerasi unggah. Nilainya harus berupa string JSON. Untuk informasi selengkapnya, lihat bagian "UserData: menentukan konfigurasi kustom untuk unggah media" pada topik Parameter permintaan. Catatan Konfigurasi callback 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. Jika ingin mengaktifkan fitur akselerasi unggah, kirim Tiket. Untuk informasi selengkapnya, lihat Ikhtisar. Untuk informasi tentang cara mengirim Tiket, lihat Hubungi kami.	{"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
Description	string	No	Deskripsi citra. Deskripsi dapat memiliki panjang hingga 1.024 karakter. Nilai harus dikodekan dalam UTF-8.	The description of the image
AppId	string	No	ID aplikasi. Nilai default: app-1000000. Untuk informasi selengkapnya, lihat Ikhtisar.	app-1000000

Elemen respons

Element	Type	Description	Example
	object	Hasil yang dikembalikan.
FileURL	string	URL OSS file. URL ini tidak berisi informasi yang digunakan untuk Penandatanganan URL. Anda dapat menentukan FileUrl saat memanggil operasi AddWatermark.	http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
RequestId	string	ID permintaan.	25818875-5F78-AEF6-D7393642****
UploadAddress	string	URL unggah. Catatan URL unggah yang dikembalikan merupakan URL yang dikodekan Base64. Anda harus mendekode URL yang dikodekan Base64 tersebut sebelum menggunakan SDK atau memanggil operasi API untuk mengunggah aset media pendukung. Anda hanya perlu mengurai UploadAddress jika menggunakan SDK OSS atau memanggil operasi API OSS untuk mengunggah aset media pendukung.	eyJTZWN1cmuIjoiQ0FJU3p3TjF****
ImageURL	string	URL citra. Catatan Jika URL yang dikembalikan tidak dapat diakses dari browser dan mengembalikan kode status HTTP 403, berarti fitur Penandatanganan URL di ApsaraVideo VOD telah diaktifkan. Untuk mengatasi masalah ini, Anda dapat menonaktifkan fitur URL signing atau menghasilkan URL yang ditandatangani.	http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png
ImageId	string	ID file citra.	93ab850b4f6f46e91d24d81d4****
UploadAuth	string	Kredensial unggah. Catatan Kredensial unggah yang dikembalikan merupakan nilai yang dikodekan Base64. Anda harus mendekode kredensial yang dikodekan Base64 tersebut sebelum menggunakan SDK atau memanggil operasi API untuk mengunggah aset media pendukung. Anda hanya perlu mengurai UploadAuth jika menggunakan SDK OSS atau memanggil operasi API OSS untuk mengunggah aset media pendukung.	eyJFbmmRCI6Im****

Contoh

Respons sukses

JSONformat

{
  "FileURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "RequestId": "25818875-5F78-AEF6-D7393642****",
  "UploadAddress": "eyJTZWN1cmuIjoiQ0FJU3p3TjF****",
  "ImageURL": "http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png",
  "ImageId": "93ab850b4f6f46e91d24d81d4****",
  "UploadAuth": "eyJFbmmRCI6Im****"
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.