Mengintegrasikan AWS Clean Rooms ke dalam aplikasi berbasis peristiwa menggunakan Amazon EventBridge

Anda dapat memasukkan AWS Clean Rooms ke dalam aplikasi berbasis peristiwa (EDAs) yang menggunakan peristiwa yang terjadi AWS Clean Rooms untuk berkomunikasi antara komponen aplikasi dan memulai proses hilir. Anda melakukan ini dengan menggunakan Amazon EventBridge untuk merutekan acara dari AWS Clean Rooms ke komponen perangkat lunak lainnya. Amazon EventBridge adalah layanan tanpa server yang menggunakan peristiwa untuk menghubungkan komponen aplikasi bersama-sama, sehingga memudahkan Anda untuk mengintegrasikan AWS layanan seperti AWS Clean Rooms ke dalam arsitektur berbasis peristiwa tanpa kode dan operasi tambahan.

Arsitektur berbasis peristiwa adalah gaya membangun sistem perangkat lunak yang digabungkan secara longgar yang bekerja sama dengan memancarkan dan menanggapi peristiwa. Dalam model ini, peristiwa mewakili perubahan dalam sumber daya atau lingkungan.

Berikut cara EventBridge bekerja dengan AWS Clean Rooms:

Seperti banyak AWS layanan, AWS Clean Rooms menghasilkan dan mengirim acara ke bus acara EventBridge default. Bus acara adalah router yang menerima acara dan merutekan mereka ke tujuan, atau target, yang Anda tentukan. Target dapat mencakup AWS layanan lain, aplikasi khusus, dan aplikasi mitra SaaS.

EventBridge rute acara sesuai dengan aturan yang Anda buat di bus acara. Untuk setiap aturan, Anda menentukan filter, atau pola acara, untuk memilih hanya peristiwa yang Anda inginkan. Setiap kali acara dikirim ke bus acara, EventBridge bandingkan dengan setiap aturan. Jika acara cocok dengan aturan, EventBridge rutekan acara ke target yang ditentukan.

Misalnya, Anda ingin tahu setiap kali AWS Clean Rooms kolaborasi baru dibuat di akun Anda. Anda dapat membuat aturan pada bus acara default. Dalam aturan, Anda akan membuat pola acara yang menetapkan peristiwa dari AWS Clean Rooms bernamaCollaboration Created. Setiap kali EventBridge menerima acara yang cocok dengan properti tersebut, itu akan merutekan acara ke alur kerja yang ditentukan.

AWS Clean Rooms acara

AWS layanan dapat mengirim acara langsung ke bus acara EventBridge default. Selain itu, AWS CloudTrail mengirimkan acara yang berasal dari berbagai AWS layanan ke EventBridge juga. Peristiwa ini dapat mencakup panggilan API, login dan tindakan konsol, peristiwa layanan, dan CloudTrail Wawasan. Untuk informasi selengkapnya, lihat acara AWS layanan yang disampaikan melalui AWS CloudTrail Panduan EventBridge Pengguna.

Untuk daftar lengkap AWS Clean Rooms acara yang dikirim ke EventBridge, lihat AWS Clean Rooms topik di Referensi EventBridge Acara.

Jenis detail acara	Deskripsi
Kolaborasi Dibuat	Kolaborasi Dibuat
Kolaborasi Diperbarui	Kolaborasi Diperbarui
Keanggotaan Dibuat	Keanggotaan Dibuat
Keanggotaan Diperbarui	Keanggotaan Diperbarui
Keanggotaan Dihapus	Keanggotaan Dihapus
Kueri yang Dilindungi Dikirim	Kueri yang Dilindungi Dikirim
Kueri yang Dilindungi Berhasil	Kueri yang Dilindungi Berhasil
Kueri yang Dilindungi Gagal	Kueri yang Dilindungi Gagal
Waktu Kueri yang Dilindungi Habis	Waktu Kueri yang Dilindungi Habis
Protected Job Dikirim	Protected Job Dikirim
Protected Job Berhasil	Protected Job Berhasil
Pekerjaan yang Dilindungi Gagal	Pekerjaan yang Dilindungi Gagal
Protected Job Dibatalkan	Protected Job Dibatalkan

Perutean AWS Clean Rooms acara menggunakan EventBridge

Untuk memiliki EventBridge rute AWS Clean Rooms acara ke target, Anda harus membuat aturan. Setiap aturan berisi pola acara, yang EventBridge cocok dengan setiap acara yang diterima di bus acara. Jika data peristiwa cocok dengan pola peristiwa yang ditentukan, EventBridge rute acara tersebut ke target aturan.

Untuk petunjuk komprehensif tentang cara membuat aturan bus acara, lihat Membuat aturan yang bereaksi terhadap peristiwa di Panduan EventBridge Pengguna.

Membuat pola acara yang cocok dengan AWS Clean Rooms acara

Setiap pola acara adalah objek JSON yang berisi:

• (Opsional): source Atribut yang mengidentifikasi layanan yang mengirim acara. Untuk AWS Clean Rooms acara, sumbernya adalahaws.cleanrooms.

• (Opsional): detail-type Atribut yang berisi array nama acara untuk dicocokkan.

• (Opsional): detail Atribut yang berisi data acara lain yang cocok.

Misalnya, pola acara berikut cocok dengan semua acara Keanggotaan Diperbarui tempat kolaborasi dihapus dari AWS Clean Rooms:

{
  "source": ["aws.cleanrooms"],
  "detail-type": ["Membership Updated"],
  "detail": {
    "status": ["COLLABORATION_DELETED"]
  }
}

Untuk informasi selengkapnya tentang penulisan pola acara, lihat Pola acara di Panduan EventBridge Pengguna.