All Products
Search
Document Center

Object Storage Service:Pemicu

Last Updated:Sep 24, 2026

Anda dapat menggunakan pemicu untuk memproses file baru di bucket Object Storage Service (OSS). Misalnya, Anda dapat mengonversi file .docx baru ke format .pdf atau mentranskode file .mov ke format .mp4. Berbeda dengan pemrosesan batch, pemicu hanya memproses file yang ditambahkan ke bucket setelah pemicu dibuat dan tidak memproses file yang sudah ada sebelumnya.

Catatan
  • API dan kit pengembangan perangkat lunak (SDK) untuk fitur pemrosesan data baru tersedia di wilayah yang memiliki titik akhir IMM.

  • Pemicu adalah tugas asinkron yang berjalan di latar belakang. Waktu penyelesaian tugas bervariasi, sehingga file output tidak langsung tersedia setelah file sumber diunggah.

  • Setelah pemicu dibuat, pemicu tersebut akan menghasilkan tugas pemrosesan data untuk setiap file baru. Eksekusi tugas dikenai biaya. Untuk informasi selengkapnya, lihat Penagihan.

Catatan penggunaan

  • Pemicu menghasilkan tugas pemrosesan data hanya untuk file yang memenuhi kondisi yang ditentukan. Disarankan untuk menguji pemicu dengan jumlah file yang terbatas terlebih dahulu.

  • Jika Anda menangguhkan pemicu, pemicu tersebut akan segera berhenti menghasilkan tugas pemrosesan data baru. Namun, tugas yang telah dikirim tetap berjalan hingga selesai.

  • Jalur output tidak boleh sama dengan jalur input atau memiliki jalur input sebagai awalan guna mencegah loop pemicu dan penimpaan file sumber.

  • Jalur output tidak boleh diakhiri dengan garis miring maju (/). Anda harus menentukan jalur objek output lengkap, termasuk ekstensi. Nama objek dapat mencakup variabel. Untuk informasi selengkapnya tentang variabel, lihat Variabel.

  • Nama file harus mengandung setidaknya satu variabel. Jika tidak, beberapa file output akan saling menimpa.

  • Saat menggunakan variabel {key}, {barename}, atau {basename} dalam jalur output, pastikan jalur output berbeda dari jalur input. Jika tidak, objek sumber berisiko tertimpa atau diproses secara rekursif.

  • File yang dihasilkan oleh pemicu tidak dapat digunakan kembali sebagai input.

  • Pemicu hanya mendukung file dengan kelas penyimpanan Standard.

Buat pemicu

  1. Masuk ke Konsol OSS.

  2. Di panel navigasi sebelah kiri, klik Buckets, lalu klik nama bucket tujuan.

  3. Di panel navigasi sebelah kiri, pilih Data Processing.

  4. Pilih salah satu kemampuan pemrosesan data, seperti document processing, ApsaraVideo Media Processing, atau lainnya (contoh ini menggunakan document processing).

  5. Klik tab Trigger, lalu klik Create Trigger.

  6. Di panel Create Trigger, konfigurasikan Input Configuration, Output Configuration, Permission Configuration, dan Notification Configuration.

    Parameter

    Deskripsi

    Input Bucket

    Bucket yang berisi file yang akan diproses.

    Path Prefix

    Awal jalur file yang akan diproses.

    Filter Rule

    Menyaring file yang akan diproses berdasarkan awalan jalur dan aturan filter.

    • All: Semua file di direktori yang ditentukan oleh parameter Path Prefix diproses.

    • File Prefix: Memproses data untuk file yang namanya sesuai dengan awalan tertentu di direktori yang ditentukan oleh Path Prefix. Untuk menentukan beberapa awalan, pisahkan dengan koma (,).

    • File Suffix: Pemrosesan data dilakukan pada file yang memiliki akhiran tertentu di direktori yang ditentukan oleh awalan jalur. Untuk menentukan beberapa akhiran, pisahkan dengan koma (,).

    Style

    Style yang ingin Anda gunakan untuk memproses objek. Jika tidak tersedia style, pilih Add Style dari daftar tarik-turun untuk membuat style.

    Output Path

    Jalur penyimpanan untuk file yang telah diproses.

    Jalur tidak boleh diakhiri dengan garis miring (/). Gunakan variabel dalam jalur output. Jika tidak, output dari beberapa tugas akan saling menimpa. Untuk informasi selengkapnya, lihat Variabel.

    Stop on Task Submission Failure

    Pilih apakah akan langsung berhenti jika tugas yang dikirim gagal.

    • Break: Jika terjadi error saat pengiriman subtugas, pemicu langsung gagal dan berhenti.

    • Ignore: Jika subtugas gagal dikirim, pemicu tetap berjalan.

    Service Role

    Peran yang memberikan izin kepada IMM untuk mengakses sumber daya cloud lainnya, seperti OSS. Kami menyarankan Anda menggunakan peran layanan AliyunIMMBatchTriggerRole. Jika peran layanan belum ada, Anda dapat membuatnya di halaman Resource Access Management (RAM).

    Message Queue

    Anda dapat mengonfigurasi antrian pesan untuk menerima hasil tugas pemrosesan data setelah selesai. Saat tugas selesai, notifikasi yang berisi hasil pemrosesan dapat dikirim ke antrian pesan ringan. Untuk informasi selengkapnya, lihat Quick Start.

  7. Klik OK.

Kueri pemicu

  1. Masuk ke Konsol OSS.

  2. Di panel navigasi sebelah kiri, klik Buckets, lalu klik nama bucket tujuan.

  3. Di panel navigasi sebelah kiri, pilih Data Processing, lalu pilih jenis pemrosesan yang diperlukan, seperti Document Processing atau ApsaraVideo Media Processing.

  4. Klik tab Trigger untuk melihat daftar pemicu.

    Tabel berikut menjelaskan status pemicu.

    Status

    Deskripsi

    Ready

    Tugas yang baru dibuat memiliki status ini.

    Running

    Tugas sedang berjalan normal.

    Success

    Tugas telah berhasil diselesaikan.

    Paused

    Tugas ditangguhkan. Tidak ada tugas baru yang dipicu. Tugas yang sudah dimulai akan tetap berjalan hingga selesai.

    Failed

    Tugas gagal. Terjadi error selama eksekusi, dan tugas tidak dapat pulih secara otomatis.

  5. Di kotak pencarian Trigger ID, masukkan ID pemicu dan klik ikon pencarian.

  6. Untuk melihat detail pemicu, klik View Details di kolom Actions.

  7. Klik ikon perluas di samping ID pemicu untuk melihat semua tugas untuk pemicu tersebut. Anda dapat mencari tugas berdasarkan jalur file atau status.