All Products
Search

This Product

    Image Search:Operasi Batch

    Document Center

    Image Search:Operasi Batch

    Last Updated:Jun 11, 2026

    Image Search memungkinkan Anda mengimpor gambar secara batch dari Alibaba Cloud OSS atau menghapus gambar yang telah diindeks secara batch, menyediakan cara yang efisien, andal, dan praktis untuk mengelola data gambar offline berskala besar.

    Alur Kerja

    1. Aktifkan OSS.

    2. Impor gambar ke OSS.

    3. Buat file increment.meta.

    4. Berikan otorisasi kepada Image Search untuk mengakses OSS.

    5. Buat tugas batch.

    Aktifkan OSS

    Jika Anda belum mengaktifkan OSS, aktifkan OSS terlebih dahulu, lalu buat bucket di Konsol.

    Catatan

    • OSS ditagih secara terpisah. Ikhtisar penagihan.

    • Bucket OSS harus berada di Wilayah yang sama dengan instans Image Search Anda.

    Impor gambar ke OSS

    Unggah file ke bucket OSS Anda.

    Catatan

    Anda dapat menentukan path penyimpanan gambar kustom saat membuat tugas batch.

    Buat file increment.meta

    Buat file bernama increment.meta di path OSS tempat gambar Anda disimpan. File ini mendefinisikan detail tugas batch.

    Catatan

    1. Gambar yang ditentukan dalam increment.meta harus berada dalam bucket yang sama dengan file tersebut.

    2. Nama file increment.meta bersifat tetap. Jangan mengganti namanya.

    3. Gambar dapat berada di path berbeda dalam bucket yang sama. Gunakan path relatif terhadap root bucket dalam PicName — misalnya, jika bucket bernama imagesearch dan increment.meta berada di direktori root, gambar di girlCloth/ harus ditentukan sebagai "PicName":"girlCloth/girl_cloth8.jpg". Jangan tambahkan garis miring (/) di awal atau akhir.

    4. Sertakan ekstensi file dalam nama gambar. Misalnya, gunakan "PicName":"girl_cloth10.jpg", bukan "PicName":"girl_cloth10".

    5. Setiap baris dalam increment.meta harus mendefinisikan satu operasi gambar.

    Kode berikut memberikan contoh file increment.meta:

    {"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth1.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value1","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1000","PicName": "girl_cloth2.jpg","CategoryId": 0,"IntAttr": 0,"StrAttr": "value2","CustomContent": "k1:v1,k2:v2,k3:v3","Region": "20,40,60,80"}
{"OperationType": "ADD","ProductId": "1001","PicName": "girl_cloth3.jpg","CategoryId": 1,"CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1002","PicName": "girl_cloth4.jpg","CategoryId": 0,"CustomContent": "k1:v1,k2:v2,k3:v3","Crop": false}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth7.jpg","CustomContent": "https://www.aliyun.com/imagesearch/girl_cloth7.jpg"}
{"OperationType": "ADD","ProductId": "1003","PicName": "girl_cloth6.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "ADD","ProductId": "1006","PicName": "girlCloth/girl_cloth10.jpg","CustomContent": "k1:v1,k2:v2,k3:v3"}
{"OperationType": "DELETE","ProductId": "1004","PicName": "fengyi.jpg"}
{"OperationType": "DELETE","ProductId": "1005"}

    Setiap operasi didefinisikan dalam format JSON. Tabel berikut menjelaskan bidang-bidangnya.

    Parameter

    Tipe

    Wajib

    Deskripsi

    OperationType

    String

    Ya

    Jenis operasi.

    • ADD: Tambahkan gambar.

    • DELETE: Hapus gambar.

    ProductId

    String

    Ya

    Pengenal unik untuk gambar, panjang maksimal 256 karakter.

    PicName

    String

    Ya

    Nama gambar di bucket OSS, panjang maksimal 256 karakter.

    Penting

    1. Setiap baris hanya boleh berisi satu nama gambar. Jika satu ProductId memiliki beberapa gambar, buat baris terpisah untuk masing-masing.

    2. Sertakan ekstensi file. Misalnya, gunakan girl_cloth.jpg, bukan girl_cloth.

    3. Menambahkan gambar dengan ProductId dan PicName yang sama dengan gambar yang sudah ada akan menimpa gambar aslinya, terlepas dari isinya.

    4. Gambar yang ditambahkan ke indeks harus memenuhi persyaratan berikut:

      • Ukuran gambar tidak boleh melebihi 4 MB.

      • Format yang didukung: PNG, JPG, JPEG, BMP, GIF, WEBP, TIFF, dan PPM.

      • Timeout transfer tidak boleh melebihi 5 detik.

      • Untuk product image search, generic image search, lebar dan tinggi gambar harus antara 100 hingga 4.096 piksel.

      • Gambar tidak boleh berisi informasi rotasi.

    CategoryId

    Integer

    Tidak

    Kategori gambar. Kategori yang valid tercantum di Referensi kategori.

    • Untuk product image search, kategori yang ditentukan harus valid. Jika tidak, pengindeksan gagal.

    • Jika Anda tidak menentukan kategori, sistem akan memprediksi kategori tersebut dan mengembalikannya dalam respons.

    • Untuk generic image search, sistem menetapkan kategori menjadi 88888888, terlepas dari input Anda.

    CustomContent

    String

    Ya

    Konten yang ditentukan pengguna, panjang maksimal 4.096 karakter.

    Catatan

    Hasil pencarian mencakup nilai ini. Anda dapat menggunakan bidang ini untuk menyimpan URL gambar atau informasi tambahan lainnya guna menghubungkan gambar dengan data bisnis Anda.

    IntAttr

    Integer

    Tidak

    Atribut integer untuk memfilter hasil pencarian.

    Catatan

    Gunakan atribut integer dalam kondisi filter untuk memfilter hasil pencarian. Untuk informasi selengkapnya, lihat Kondisi filter.

    StrAttr

    String

    Tidak

    Atribut string, panjang maksimal 128 karakter. Digunakan untuk memfilter dalam kueri pencarian.

    Catatan

    • Gunakan atribut string dalam kondisi filter untuk memfilter hasil pencarian. Untuk informasi selengkapnya, lihat Kondisi filter.

    • Karakter khusus seperti \, ¥, $, &, dan % tidak didukung.

    Crop

    Boolean

    Tidak

    Menentukan apakah akan melakukan identifikasi subjek. Default: true.

    • true: Sistem mengidentifikasi subjek utama dan melakukan pencarian berdasarkan subjek tersebut.

    • false: Sistem melakukan pencarian berdasarkan seluruh gambar tanpa identifikasi subjek.

    Region

    String

    Tidak

    Bidang subjek gambar dalam format x1,y1,x2,y2, di mana (x1, y1) adalah pojok kiri atas dan (x2, y2) adalah pojok kanan bawah.

    Catatan

    Jika parameter ini ditetapkan, parameter Crop diabaikan.

    Berikan Otorisasi kepada Image Search

    Operasi batch memerlukan akses Image Search ke resource OSS Anda. Berikan otorisasi ini saat pertama kali menggunakan fitur ini. Lewati bagian ini jika sudah diberi otorisasi.

    1. Masuk ke Konsol Image Search.

    2. Pilih jenis layanan dan instans yang dituju.

    3. Klik tab Batch Operation.

    4. Klik Create Batch Task, lalu pada kotak dialog yang muncul, klik Confirm one-click authorization.

    5. Di halaman Cloud resource access authorization, klik Confirm Authorization.

      Tindakan ini membuat role AliyunImageSearchAccessingOSSRole dan menyambungkan kebijakan sistem AliyunImageSearchAccessingOSSRolePolicy.

    Buat tugas batch

    1. Masuk ke Konsol Image Search.

    2. Pilih jenis layanan dan instans yang dituju.

    3. Klik tab Batch Operation.

    4. Klik Create Batch Task.

      Pada kotak dialog Create Batch Task, atur Bucket Name dan Path yang diperlukan, konfirmasi Meta File, opsional berikan URL Callback on Completion, lalu klik OK.

      • Region

        Wilayah tempat instans berada.

      • Bucket Name

        Nama bucket yang Anda buat di OSS.

        Penting

        Bucket OSS harus berada di Wilayah yang sama dengan instans Image Search Anda.

      • Path

        Path penyimpanan untuk gambar dan file increment.meta.

        Misalnya, jika bucket imagesearch1 Anda di China (Shanghai) memiliki gambar dan increment.meta di folder imagesearch/, masukkan path tersebut.

      • Meta File

        File yang mencantumkan gambar yang akan diproses. Sistem memeriksa keberadaan file bernama increment.meta.

      • Callback on Completion

        Masukkan URL callback. Hanya URL HTTP dan HTTPS yang didukung.

        {
  "finishTime": "2021-05-19 17:50:00",
  "instanceId": "imagesearch-cn-xxxx",
  "instanceName": "instanceName",
  "message": "success",
  "processResultUrl": "https://image-search-task-info.oss-cn-shanghai.aliyuncs.com/yyyyyyyyyy",
  "status": "NORMAL",
  "taskId": 111
}

        Bidang

        Deskripsi

        finishTime

        Waktu penyelesaian tugas (dengan presisi hingga detik).

        instanceName

        Nama instans Image Search.

        instanceId

        ID instans Image Search.

        status

        Hasil tugas: NORMAL (sukses) atau FAIL (gagal).

        taskId

        ID tugas.

        message

        Deskripsi hasil. success menunjukkan operasi berhasil.

        processResultUrl

        URL untuk mengunduh laporan error.

    Batalkan tugas batch

    1. Di tab Batch Operations, temukan tugas batch yang dituju dan klik Cancel di kolom Actions.

    2. Baca informasi di jendela pop-up, lalu klik OK untuk mulai menghentikan tugas batch. Di kotak dialog peringatan yang muncul, klik OK untuk mengonfirmasi pembatalan. Proses ini membutuhkan waktu sekitar 2 menit.

    3. Setelah dibatalkan, data yang telah diproses disimpan dan status berubah menjadi Stopped. Klik Download results untuk melihat detailnya.

    Langkah berikutnya

    Monitor tugas di tab Batch Operation. Tugas yang sedang berjalan menampilkan bilah Task Progress dan dapat dihentikan dengan Cancel. Tugas yang selesai ditampilkan sebagai Success atau Stopped dan dapat dijalankan ulang dengan Resubmit.

    • Anda dapat memfilter tugas berdasarkan Bucket Name atau Path.

    • Jika muncul pesan Some photos failed to be processed and have been isolated for you, klik Download results untuk melihat detail kegagalan.