All Products
Search

This Product

    ApsaraVideo VOD:CreateUploadImage

    Document Center

    ApsaraVideo VOD:CreateUploadImage

    Last Updated:Jul 21, 2026

    Mengambil URL unggah dan kredensial untuk mengunggah image ke ApsaraVideo VOD, serta membuat informasi image. ApsaraVideo VOD menerbitkan URL unggah dan kredensial untuk memastikan otorisasi dan keamanan, mencegah unggahan berbahaya, dan mendukung pembuatan otomatis ID image (ImageId) untuk manajemen. Anda dapat memanggil operasi ini untuk memperoleh URL unggah dan kredensial, serta membuat informasi image.

    Deskripsi operasi

    • Sebelum menggunakan operasi ini, pastikan Anda memahami metode penagihan dan harga ApsaraVideo VOD. Mengunggah file media ke ApsaraVideo VOD menimbulkan biaya penyimpanan. Untuk informasi lebih lanjut, lihat Penagihan penyimpanan aset media. Jika Anda telah mengaktifkan akselerasi penyimpanan akselerasi transfer, mengunggah file media ke ApsaraVideo VOD juga menimbulkan biaya akselerasi unggah. Untuk informasi lebih lanjut, lihat Penagihan akselerasi penyimpanan akselerasi transfer.

    • Operasi ini hanya mengambil URL unggah dan kredensial, serta membuat informasi dasar aset media. Operasi ini tidak mengunggah file. Untuk contoh lengkap mengunggah file dengan memanggil API, lihat Mengunggah file media menggunakan API ApsaraVideo VOD.

    • Penyegaran URL unggah dan kredensial tidak didukung untuk unggahan image. Jika kredensial unggah image kedaluwarsa (periode validitas default adalah 3000 detik), panggil operasi ini lagi untuk memperoleh URL unggah dan kredensial baru.

    • Anda dapat mengonfigurasi callback untuk menerima notifikasi event untuk penyelesaian unggahan image guna menentukan apakah unggahan berhasil.

    • Mengambil URL unggah dan kredensial adalah operasi inti ApsaraVideo VOD dan diperlukan untuk setiap unggahan. ApsaraVideo VOD menyediakan beberapa metode unggah, masing-masing dengan persyaratan berbeda untuk mengambil URL unggah dan kredensial. Untuk informasi lebih lanjut, lihat URL unggah dan kredensial.

    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

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    Title

    string

    No

    Judul image. Aturan:

    • Panjang judul maksimal 128 karakter.

    • Judul harus dienkode dalam UTF-8.

    mytitle.
    ImageType

    string

    Yes

    Tipe image. Nilai valid:

    • default (default): image umum.

    • cover: Gambar mini video.

    Catatan

    Konsol ApsaraVideo VOD hanya mendukung Tampilan dan mengelola image bertipe default.

    default.
    ImageExt

    string

    No

    Ekstensi nama file dari file sumber image yang akan diunggah. Nilai valid:

    • png (default)

    • jpg

    • jpeg

    • gif

    • heic

    • webp

    png.
    OriginalFileName

    string

    No

    Alamat file sumber image yang akan diunggah.

    Catatan

    Ekstensi nama file bersifat opsional. Jika ekstensi nama file disertakan di sini dan berbeda dengan nilai yang ditentukan di ImageExt, nilai ImageExt yang akan digunakan.

    D:\picture_01
    Tags

    string

    No

    Tag image. Aturan:

    • Panjang setiap tag maksimal 32 karakter.

    • Anda dapat menentukan hingga 16 tag.

    • Pisahkan beberapa tag dengan koma (,).

    • Tag harus dienkode dalam UTF-8.

    Test.
    StorageLocation

    string

    No

    Alamat penyimpanan. Anda dapat memperoleh alamat penyimpanan dengan cara berikut: Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Management > Storage untuk Tampilan alamat penyimpanan.

    Catatan

    Jika Anda tidak menentukan parameter ini, image akan diunggah ke alamat penyimpanan default. Jika Anda menentukan parameter ini, image akan diunggah ke alamat penyimpanan yang ditentukan.

    outin-****..oss-cn-shanghai.aliyuncs.com.
    CateId

    integer

    No

    ID kategori. Anda dapat memperoleh ID kategori dengan cara berikut:

    • Masuk ke Konsol ApsaraVideo VOD dan pilih Configuration Management > Media Management > Categories untuk Tampilan ID kategori.

    • Memperoleh nilai CateId dari tanggapan saat Anda memanggil operasi AddCategory untuk membuat kategori.

    • Memperoleh nilai CateId dari tanggapan saat Anda memanggil operasi GetCategories untuk mengkueri kategori.

    100036****
    UserData

    string

    No

    Pengaturan kustom dalam string JSON. Pengaturan mendukung callback Paket, akselerasi unggah, dan konfigurasi lainnya. Untuk informasi lebih lanjut, lihat UserData.

    Catatan

    • Untuk menggunakan callback Paket dalam parameter ini, Anda harus mengonfigurasi URL callback HTTP dan memilih tipe event callback yang sesuai di konsol. Jika tidak, pengaturan callback tidak akan berlaku. Untuk informasi tentang cara mengonfigurasi callback HTTP di konsol, lihat Pengaturan callback.

    • Untuk menggunakan fitur akselerasi unggah, ajukan Tiket untuk mengaktifkannya. Untuk informasi lebih lanjut, lihat Instruksi unggah. Untuk informasi tentang cara mengajukan Tiket, lihat Hubungi kami.

    {"MessageCallback":{"CallbackURL":"http://example.aliyundoc.com"},"Extend":{"localId":"xxx","test":"www"}}
    Description

    string

    No

    Deskripsi image.

    • Panjang deskripsi maksimal 1024 karakter.

    • Deskripsi harus dienkode dalam UTF-8.

    Image upload test.
    AppId

    string

    No

    ID aplikasi. Nilai default: app-1000000. Jika Anda telah mengaktifkan layanan multi-aplikasi, tentukan ID aplikasi untuk mengunggah image ke aplikasi yang ditentukan. Untuk informasi lebih lanjut, lihat Multi-aplikasi.

    app-1000000

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Parameter tanggapan.

    FileURL

    string

    URL OSS dari file image (tanpa otentikasi).

    Saat Anda menambahkan Template watermark image, URL ini dapat digunakan sebagai parameter permintaan FileUrl dari 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 oleh operasi ini adalah nilai yang dienkode Base64. Saat Anda menggunakan SDK atau API untuk mengunggah aset media, dekode nilai tersebut dalam Base64 sebelum digunakan. Hanya unggahan menggunakan SDK native OSS atau API OSS yang memerlukan Anda mengurai UploadAddress.

    eyJTZWN1cmuIjoiQ0FJU3p3TjF****
    ImageURL

    string

    URL akses image.

    Catatan

    Jika ImageURL yang dikembalikan tidak dapat diakses di browser (error 403), otentikasi URL diaktifkan untuk nama domain VOD Anda. Nonaktifkan otentikasi URL atau buat URL yang ditandatangani.

    http://example.aliyundoc.com/cover/2017-34DB-4F4C-9373-003AA060****.png.
    ImageId

    string

    ID image. ID ini dapat digunakan sebagai parameter permintaan untuk operasi seperti GetImageInfo, GetImageInfos, UpdateImageInfos, dan DeleteImage.

    93ab850b4f6f46e91d24d81d4****
    UploadAuth

    string

    Unggah kredensial.

    Catatan

    Unggah kredensial yang dikembalikan oleh operasi ini adalah nilai yang dienkode Base64. Saat Anda menggunakan SDK atau API untuk mengunggah aset media, dekode nilai tersebut dalam Base64 sebelum digunakan. Hanya unggahan menggunakan SDK native OSS atau API OSS yang memerlukan Anda mengurai UploadAuth.

    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.