Saat mengintegrasikan OSS dengan Function Compute, Anda dapat menggunakan event OSS untuk memicu fungsi yang melakukan Pemrosesan data kustom. Topik ini menjelaskan batasan, jenis event, dan aturan pemicuan untuk Pemicu OSS di Function Compute.
Informasi latar belakang
OSS dan Function Compute terintegrasi secara mulus melalui Pemicu OSS. Anda dapat menulis fungsi untuk menangani event OSS. Ketika event dengan jenis tertentu terjadi di OSS, fungsi yang sesuai akan dipicu secara otomatis. Misalnya, Anda dapat mengonfigurasikan fungsi untuk menangani event PutObject. Saat Anda memanggil Operasi API OSS PutObject untuk mengunggah gambar ke Bucket OSS, fungsi tersebut akan dipicu secara otomatis untuk memproses gambar.
Setelah mengintegrasikan OSS dengan Function Compute, Anda dapat memanggil berbagai fungsi untuk memproses data gambar atau audio, lalu menulis hasilnya kembali ke berbagai layanan penyimpanan. Arsitektur ini memungkinkan Anda berfokus pada logika fungsi, sementara sistem menangani data dalam jumlah besar secara real-time dengan reliabilitas tinggi dan paralelisme berskala besar.
Batasan
-
Hanya Pemicu OSS berbasis EventBridge yang mendukung konfigurasi beberapa awalan objek dan akhiran objek.
-
Ekspresi reguler tidak didukung pada awalan objek dan akhiran objek, baik pada Pemicu OSS native maupun Pemicu OSS berbasis EventBridge.
-
Hanya Pemicu OSS berbasis EventBridge yang memungkinkan pengaitan lebih dari 10 Pemicu OSS dengan satu bucket.
Sebagai praktik terbaik, hindari mengaitkan lebih dari 10 pemicu dengan satu bucket. Jika memerlukan lebih banyak pemicu, buatlah bucket baru dan konfigurasikan pemicu untuk bucket tersebut.
-
Pemicu OSS native mengharuskan fungsi dan Bucket OSS berada di Wilayah yang sama. Konfigurasi lintas wilayah tidak didukung. Untuk memicu fungsi lintas wilayah, gunakan Pemicu OSS berbasis EventBridge atau arahkan event menggunakan EventBridge.
Definisi event
Ketika OSS mendeteksi event yang relevan, sistem mengodekan informasi event ke dalam string JSON dan meneruskannya ke fungsi penanganan event. Untuk informasi selengkapnya tentang format Notifikasi event OSS, lihat Paket notifikasi.
Tabel berikut mencantumkan Definisi event OSS yang didukung. Setiap jenis event sesuai dengan Operasi API ObjectCreated, ObjectRemoved, atau ObjectModified. Panggilan berhasil ke salah satu Operasi API ini akan memicu fungsi satu kali.
|
Jenis Peristiwa |
Nama Peristiwa |
Deskripsi |
|
ObjectCreated |
oss:ObjectCreated:PutObject |
Dipicu dengan memanggil API PutObject untuk mengunggah objek. Untuk informasi selengkapnya, lihat PutObject. |
|
oss:ObjectCreated:PutSymlink |
Dipicu dengan memanggil API PutSymlink untuk membuat tautan simbolik ke objek target di OSS. Anda dapat menggunakan tautan simbolik ini untuk mengakses objek target. Untuk informasi selengkapnya, lihat PutSymlink. |
|
|
oss:ObjectCreated:PostObject |
Dipicu dengan memanggil API PostObject untuk mengunggah objek ke bucket menggunakan formulir HTML. Untuk informasi selengkapnya, lihat PostObject. |
|
|
oss:ObjectCreated:CopyObject |
Dipicu dengan memanggil API CopyObject untuk menyalin objek di OSS. Untuk informasi selengkapnya, lihat CopyObject. |
|
|
oss:ObjectCreated:InitiateMultipartUpload |
Untuk mentransfer data menggunakan fitur MultipartUpload, Anda harus terlebih dahulu memanggil API InitiateMultipartUpload untuk menginisialisasi unggah multi-bagian. Untuk informasi selengkapnya, lihat InitiateMultipartUpload. |
|
|
oss:ObjectCreated:UploadPart |
Setelah event unggah multi-bagian diinisiasi, Anda dapat mengunggah data dalam beberapa bagian berdasarkan nama objek dan ID unggahan yang ditentukan. Untuk informasi selengkapnya, lihat UploadPart. |
|
|
oss:ObjectCreated:UploadPartCopy |
Operasi API UploadPartCopy mengunggah satu bagian dengan menyalin data dari objek yang sudah ada. Untuk informasi selengkapnya, lihat UploadPartCopy. |
|
|
oss:ObjectCreated:CompleteMultipartUpload |
Setelah semua bagian data diunggah, Anda harus memanggil API CompleteMultipartUpload untuk menyelesaikan unggah multi-bagian. Untuk informasi selengkapnya, lihat CompleteMultipartUpload. |
|
|
oss:ObjectCreated:AppendObject |
Operasi API AppendObject dipanggil untuk mengunggah objek dengan menambahkan data. Untuk informasi selengkapnya, lihat AppendObject. |
|
|
oss:ObjectCreated:* |
Dipicu oleh panggilan berhasil ke salah satu Operasi API ObjectCreated di atas. |
|
|
ObjectRemoved |
oss:ObjectRemoved:DeleteObject |
Dipicu dengan memanggil API DeleteObject untuk menghapus objek. Untuk informasi selengkapnya, lihat DeleteObject. |
|
oss:ObjectRemoved:DeleteObjects |
Dipicu dengan memanggil API DeleteMultipleObjects untuk menghapus multiple objek dalam satu permintaan. Untuk informasi selengkapnya, lihat DeleteMultipleObjects. |
|
|
oss:ObjectRemoved:AbortMultipartUpload |
Dipicu dengan memanggil API AbortMultipartUpload untuk membatalkan unggah multi-bagian. Untuk informasi selengkapnya, lihat AbortMultipartUpload. |
|
|
ObjectModified |
oss:ObjectModified:UpdateObjectMeta |
Dipicu dengan memanggil API UpdateObjectMeta untuk mengubah metadata objek. Catatan
Saat ini, event ini didukung di Wilayah berikut: China (Hangzhou), China (Shanghai), China (Qingdao), China (Beijing), China (Zhangjiakou), China (Hohhot), China (Shenzhen), dan China (Chengdu). |
|
ObjectReplication |
oss:ObjectReplication:ObjectCreated |
Operasi penulisan yang terjadi selama replikasi data. |
|
oss:ObjectReplication:ObjectModified |
Operasi penimpaan yang terjadi selama replikasi data. |
|
|
oss:ObjectReplication:ObjectRemoved |
Operasi penghapusan yang terjadi selama replikasi data. |
Aturan pemicuan
Menghindari loop pemicu
Saat menggunakan Pemicu OSS, berhati-hatilah untuk menghindari loop pemicu. Skenario umum terjadi ketika unggahan objek ke Bucket OSS memicu sebuah fungsi, kemudian fungsi tersebut memproses objek dan menulis satu atau lebih objek baru kembali ke bucket yang sama. Hal ini akan memicu fungsi tersebut lagi sehingga menciptakan loop eksekusi.
Untuk mencegah biaya yang tidak perlu akibat loop pemicu, sebaiknya konfigurasikan awalan objek atau akhiran objek. Misalnya, atur awalan objek untuk objek sumber menjadi src dan awalan objek untuk objek yang telah diproses menjadi dst. Cara ini memastikan bahwa objek yang telah diproses tidak memicu fungsi tersebut lagi. Jika awalan atau akhiran objek tidak diatur, pemicu akan mencocokkan objek dengan awalan atau akhiran apa pun. Untuk informasi selengkapnya, lihat Langkah 1: Membuat Pemicu OSS.
Aturan Pemicu OSS native
Untuk mencegah satu event memicu beberapa pemicu dalam bucket yang sama, sistem mendeteksi konflik konfigurasi saat pembuatan pemicu. Jika kombinasi event pemicu, awalan objek, dan akhiran objek dari pemicu baru tumpang tindih dengan pemicu yang sudah ada, pembuatan pemicu akan gagal.
Saat mengonfigurasikan pemicu, ikuti prinsip berikut:
-
Dalam bucket yang sama, kombinasi event pemicu, awalan objek, dan akhiran objek harus unik untuk setiap pemicu.
-
Awalan objek dan akhiran objek dicocokkan menggunakan wildcard. Jika awalan atau akhiran objek tidak dikonfigurasikan, nilai apa pun akan dicocokkan.
Sebaiknya rencanakan namespace objek saat mengonfigurasikan awalan dan akhiran objek untuk mencegah kegagalan pembuatan pemicu akibat rentang pencocokan yang tumpang tindih.
Jika satu jenis event OSS perlu memicu fungsi yang berbeda untuk Tugas pemrosesan yang berbeda (artinya kondisi pemicu yang sama harus dikonfigurasikan untuk fungsi yang berbeda), Anda dapat membuat Pemicu OSS berbasis EventBridge.
FAQ
Dokumen terkait
-
Mengonfigurasikan pemicu
Untuk detail mengenai konfigurasi dan penggunaan Pemicu OSS native serta Pemicu OSS berbasis EventBridge, lihat Mengonfigurasikan Pemicu OSS native dan Mengonfigurasikan Pemicu OSS berbasis EventBridge.
-
Topik terkait pemicu
-
Untuk memeriksa event mana yang memicu suatu fungsi, Anda dapat mencetak jenis event tersebut di log fungsi. Untuk informasi selengkapnya, lihat Management log.
-
Untuk memanggil satu fungsi dari fungsi lain, Anda dapat menggunakan API guna memanggil fungsi target. Untuk informasi selengkapnya, lihat Dapatkah fungsi saling memanggil?.
-