View a markdown version of this page

Membuat aturan menggunakan Enhanced Builder - Amazon EventBridge

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Membuat aturan menggunakan Enhanced Builder

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

  • Akses ke EventBridge konsol Amazon

  • Izin IAM yang sesuai untuk membuat aturan EventBridge

  • Pemahaman dasar tentang arsitektur berbasis peristiwa

Gambaran umum

Untuk mengambil tindakan pada acara yang diterima oleh EventBridge, Anda dapat membuat aturan. Ketika suatu peristiwa cocok dengan pola peristiwa yang ditentukan dalam aturan Anda, EventBridge mengirimkan peristiwa ke target yang ditentukan.

Topik ini memandu Anda melalui pembuatan aturan yang EventBridge digunakan untuk mencocokkan peristiwa saat mereka dikirim ke bus acara yang ditentukan.

Membuat EventBridge aturan melibatkan empat langkah utama:

  1. Pilih acara yang ingin Anda proses

  2. Konfigurasikan pemfilteran dan pengujian acara

  3. Pilih dan konfigurasikan target

  4. Konfigurasikan pengaturan aturan

Pilih acara

Pertama, pilih acara yang ingin Anda kirim ke target.

Untuk memilih acara
  1. Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.

  2. Di panel navigasi, pilih Aturan, lalu pilih Buat aturan.

  3. Pada halaman pemilihan pembuat aturan, pilih Enhanced Builder.

    Enhanced Builder menyediakan kanvas visual untuk membangun aturan dan target dengan menyeret dan melepaskan acara dan target. Untuk menggunakan pola dan konfigurasi JSON sebagai gantinya, lihat Membuat aturan (Pembuat Lanjutan).

  4. Di tab Acara, temukan acara yang ingin Anda kirim ke target:

    1. Pilih A AWS cara Layanan atau A cara Kustom.

    2. Gunakan kotak Pencarian atau telusuri daftar acara untuk menemukan acara yang ingin Anda kirim ke target.

    3. Seret satu atau beberapa acara ke dalam kan vas Build dan letakkan di Trig ger Events.

    EventBridge menampilkan bagian T rigger Events. Bagian ini meliputi:

    • Acara, yang mencantumkan acara yang Anda pilih.

    • Skema, yang menampilkan skema acara yang dipilih, jika tersedia.

      Skema berisi tiga tab:

      • Pohon: Tampilan pohon skema acara.

      • Kode: Skema acara dalam spesifikasi Open API atau format JSON.

      • Info: Informasi ikhtisar tentang skema.

    • Contoh peristiwa, yang menampilkan sampel acara yang dipilih, jika tersedia.

    • Pola acara (filter), yang berisi pola acara yang memilih semua acara yang telah Anda pilih.

Filter acara untuk mengirim hanya apa yang Anda inginkan

Anda mungkin tidak ingin mengirim semua peristiwa dari jenis tertentu ke target. Anda dapat membuat pola acara Anda lebih spesifik sehingga hanya memilih acara yang berisi atribut dan nilai yang Anda minati.

Mengedit pola acara (opsional)

Di panel Trigger events, Anda dapat membangun pola acara dengan dua cara:

  • Secara visual, menggunakan tampilan pohon Skema

  • Dengan mengedit JSON secara langsung di panel pola acara

Untuk mengedit pola acara menggunakan tampilan pohon Skema
  1. Pilih tab Pohon pada panel S kema.

  2. Tambahkan dan edit filter untuk membangun pola acara.

    1. Pilih ikon filter di sebelah atribut yang ingin Anda tambahkan sebagai filter ke pola acara.

    2. Pilih operator perbandingan dari daftar drop-down.

      Untuk informasi selengkapnya tentang operator perbandingan, lihat Membuat pola peristiwa.

    3. Masukkan nilai yang ingin Anda cocokkan.

    4. Klik tanda centang untuk menyelesaikan.

    EventBridge menambahkan filter yang telah Anda buat ke JSON di panel pola acara.

  3. Tambahkan filter tambahan hingga Anda membuat pola acara yang cocok pada semua atribut acara yang Anda inginkan.

Uji pola acara

Setelah Anda membuat pola peristiwa yang cocok dengan semua atribut acara yang Anda inginkan, uji untuk memastikan pola peristiwa berfungsi seperti yang diharapkan.

Uji pola acara (opsional)

  1. Pilih acara sampel untuk pengujian, atau gunakan acara Anda sendiri.

    • Gunakan contoh acara yang disediakan

      1. Pilih Gunakan contoh acara yang disediakan.

      2. Di bawah Contoh peristiwa pemicu, pilih acara yang akan digunakan untuk pengujian dari daftar drop-down.

    • Gunakan acara Anda sendiri

      1. Pilih Gunakan peristiwa Anda sendiri.

        EventBridge menampilkan peristiwa generik dengan details elemen kosong.

      2. Edit JSON acara untuk membuat acara yang ingin Anda uji pola acara Anda.

        Tip

        Anda dapat menggunakan sampel peristiwa yang disediakan sebagai titik awal untuk membuat peristiwa kustom Anda sendiri untuk digunakan dalam pengujian Anda:

        1. Pilih Gunakan sampel peristiwa yang disediakan, pilih peristiwa dari Sampel peristiwa pemicu, lalu pilih Salin.

        2. Pilih Gunakan peristiwa Anda sendiri.

        3. Pilih seluruh peristiwa di jendela, lalu tempel sampel peristiwa di atasnya.

        4. Edit peristiwa sesuai keinginan.

  2. Pilih J alankan Tes.

    EventBridge menampilkan pesan yang menyatakan apakah acara pengujian cocok dengan pola acara.

Pilih target

Seret satu (dan hingga lima) target ke dalam kanvas Build dan letakkan di Tar get untuk menerima peristiwa yang sesuai dengan pola peristiwa yang ditentukan. Target dapat meliputi:

  • Bus EventBridge acara lainnya, yang sama atau berbeda Akun AWS

  • EventBridge Tujuan API, termasuk mitra SaaS seperti Salesforce

  • Berbagai sumber daya AWS layanan, seperti antrian Amazon SQS atau topik Amazon SNS

Untuk memilih target
  1. Pilih jenis target dari panel Target, dan letakkan ke bentuk Target di kanvas Bangun.

    EventBridge menampilkan bagian Target di Build, dengan opsi konfigurasi yang berlaku berdasarkan jenis target yang Anda pilih.

    Tip

    Jika Anda telah menentukan lebih dari satu target, memilih bentuk target akan menampilkan bagian konfigurasi untuk target tersebut.

  2. Konfigurasikan target berdasarkan jenis target Anda. Untuk langkah konfigurasi terperinci, lihat Tar EventBridge get.

Sesuaikan data acara yang dikirim ke target

Jika Anda memilih target selain bus EventBridge acara atau tujuan EventBridge API, Anda memiliki opsi untuk menyesuaikan data apa yang sebenarnya dikirimkan ke target.

Mengubah atau mengganti data acara yang dikirim (opsional)

  1. Di kanvas desain Bangun, pilih ikon transformasi Input dalam bentuk Target.

    EventBridge menampilkan bagian transformasi input.

  2. Di bawah Konfigurasi transformasi input, pilih Aktifkan.

  3. Pilih metode Transformasi untuk memilih bagaimana Anda ingin menyesuaikan teks yang dikirim ke target untuk acara pencocokan:

    • Bagian dari peristiwa yang cocok — EventBridge hanya mengirimkan bagian tertentu dari peristiwa sumber asli ke target.

    • Konstan (teks JSON) — hanya EventBridge mengirimkan teks JSON yang ditentukan ke target. Tidak ada bagian dari peristiwa sumber asli yang dikirim.

    • Input transformer — Konfigurasikan transformator input untuk menyesuaikan teks yang EventBridge ingin Anda kirim ke target. Untuk informasi selengkapnya, lihat Mengubah input target.

Konfigurasikan aturan

Terakhir, konfigurasikan dan buat aturan.

Untuk mengkonfigurasi aturan (konsol)
  1. Pilih Konfigurasikan

  2. Masukkan Nama dan, secara opsional, Deskripsi untuk aturan.

    Aturan tidak dapat memiliki nama yang sama dengan aturan lain di bus acara yang sama Wilayah AWS dan yang sama.

  3. Untuk bus acara, pilih bus acara untuk dikaitkan dengan aturan ini.

    Jika Anda ingin aturan ini mencocokkan peristiwa yang berasal dari akun Anda, pilih bus acara AWS default. Ketika sebuah acara Layanan AWS di akun Anda mengirim acara, itu selalu masuk ke bus acara default akun Anda.

  4. Untuk mengaktifkan aturan segera setelah dibuat, di bawah Aktivasi aktifkan Aktif.

  5. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat Menandai sumber daya di Amazon EventBridge.

  6. Pilih Create (Buat).

Langkah selanjutnya

Setelah membuat aturan, Anda dapat:

Sumber daya tambahan

Untuk informasi selengkapnya tentang EventBridge aturan, lihat: