Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge - Amazon EventBridge
Tentukan aturannyaBangun pola acaraPilih targetKonfigurasikan tag dan aturan ulasan

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

Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge

Untuk mengambil tindakan pada acara yang diterima oleh Amazon EventBridge, Anda dapat membuat aturan. Jika suatu peristiwa cocok dengan pola peristiwa yang ditentukan dalam aturan Anda, EventBridge kirimkan acara ke target yang ditentukan dan memicu tindakan yang ditentukan dalam aturan.

Video berikut mengeksplorasi pembuatan berbagai jenis aturan, dan cara mengujinya:

Langkah-langkah berikut memandu Anda melalui cara membuat aturan yang EventBridge digunakan untuk mencocokkan acara saat dikirim ke bus acara yang ditentukan.

Tentukan aturannya

Pertama, masukkan nama dan deskripsi untuk aturan Anda untuk mengidentifikasinya. Anda juga harus menentukan bus acara tempat aturan Anda mencari acara agar sesuai dengan pola acara.

Untuk menentukan detail aturan

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

  2. Di panel navigasi, pilih Aturan.

  3. Pilih Buat aturan.

  4. 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 di bus acara yang sama.

  5. Untuk bus acara, pilih bus acara untuk dikaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan acara yang berasal dari akun Anda, pilih bus acara AWS default. Ketika AWS service di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

  6. Untuk Tipe aturan, pilih Aturan dengan pola peristiwa.

  7. Pilih Selanjutnya.

Bangun pola acara

Selanjutnya, bangun pola acara. Untuk melakukan ini, tentukan sumber acara, pilih dasar untuk pola acara, dan tentukan atribut dan nilai yang cocok. Anda juga dapat menghasilkan pola acara JSON dan mengujinya terhadap peristiwa sampel.

Untuk membangun pola acara

  1. Untuk sumber Acara, pilih AWS acara atau acara EventBridge mitra.

  2. (Opsional) Di bagian Contoh peristiwa, pilih Contoh jenis acara yang ingin Anda uji pola acara Anda.

    Jenis acara sampel berikut tersedia:

    • AWS event - Pilih dari peristiwa yang dipancarkan dari didukung. AWS services

    • EventBridge acara mitra - Pilih dari acara yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.

    • Masukkan milik saya sendiri — Masukkan acara Anda sendiri dalam JSON teks.

      Anda juga dapat menggunakan acara AWS atau mitra sebagai titik awal untuk membuat acara kustom Anda sendiri.

      1. Pilih AWS acara atau acara EventBridge mitra.

      2. Gunakan dropdown Contoh peristiwa untuk memilih acara yang ingin Anda gunakan sebagai titik awal untuk acara kustom Anda.

        EventBridge menampilkan acara sampel.

      3. Pilih Salin.

      4. Pilih Enter my own untuk jenis Event.

      5. Hapus struktur peristiwa sampel di panel JSON pengeditan, dan tempel acara AWS atau mitra di tempatnya.

      6. Edit acara JSON untuk membuat acara sampel Anda sendiri.

  3. Pilih metode Creation. Anda dapat membuat pola acara dari EventBridge skema atau template, atau Anda dapat membuat pola acara khusus.

    Existing schema

    Untuk menggunakan EventBridge skema yang ada untuk membuat pola acara, lakukan hal berikut:

    1. Di bagian Metode pembuatan, untuk Metode, pilih Gunakan skema.

    2. Di bagian Pola acara, untuk jenis Skema, pilih Pilih skema dari registri Skema.

    3. Untuk registri Schema, pilih kotak dropdown dan masukkan nama registri skema, seperti. aws.events Anda juga dapat memilih opsi dari daftar dropdown yang muncul.

    4. Untuk Schema, pilih kotak dropdown dan masukkan nama skema yang akan digunakan. Misalnya, aws.s3@ObjectDeleted. Anda juga dapat memilih opsi dari daftar dropdown yang muncul.

    5. Di bagian Model, pilih tombol Edit di sebelah atribut apa pun untuk membuka propertinya. Atur bidang Relationship dan Value sesuai kebutuhan, lalu pilih Set untuk menyimpan atribut.

      catatan

      Untuk informasi tentang definisi atribut, pilih ikon Info di sebelah nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian Catatan pada kotak dialog properti atribut.

      Untuk menghapus properti atribut, pilih tombol Edit untuk atribut tersebut, lalu pilih Hapus.

    6. Pilih Hasilkan pola acara JSON untuk menghasilkan dan memvalidasi pola acara Anda sebagai JSON teks.

    7. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih Pola uji.

      EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.

      Anda juga dapat memilih salah satu opsi berikut:

      • Salin — Salin pola acara ke clipboard perangkat Anda.

      • Prettify — Membuat JSON teks lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.

    Custom schema

    Untuk menulis skema khusus dan mengubahnya menjadi pola acara, lakukan hal berikut:

    1. Di bagian Metode pembuatan, untuk Metode, pilih Gunakan skema.

    2. Di bagian Pola acara, untuk jenis Skema, pilih Masukkan skema.

    3. Masukkan skema Anda ke dalam kotak teks. Anda harus memformat skema sebagai JSON teks yang valid.

    4. Di bagian Model, pilih tombol Edit di sebelah atribut apa pun untuk membuka propertinya. Atur bidang Relationship dan Value sesuai kebutuhan, lalu pilih Set untuk menyimpan atribut.

      catatan

      Untuk informasi tentang definisi atribut, pilih ikon Info di sebelah nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian Catatan pada kotak dialog properti atribut.

      Untuk menghapus properti atribut, pilih tombol Edit untuk atribut tersebut, lalu pilih Hapus.

    5. Pilih Hasilkan pola acara JSON untuk menghasilkan dan memvalidasi pola acara Anda sebagai JSON teks.

    6. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih Pola uji.

      EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.

      Anda juga dapat memilih salah satu opsi berikut:

      • Salin — Salin pola acara ke clipboard perangkat Anda.

      • Prettify — Membuat JSON teks lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.

    Event pattern

    Untuk menulis pola acara khusus dalam JSON format, lakukan hal berikut:

    1. Di bagian Metode pembuatan, untuk Metode, pilih Pola kustom (JSONeditor).

    2. Untuk pola Acara, masukkan pola acara khusus Anda dalam teks JSON yang diformat.

    3. (Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih Pola uji.

      EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.

      Anda juga dapat memilih salah satu opsi berikut:

      • Salin — Salin pola acara ke clipboard perangkat Anda.

      • Prettify — Membuat JSON teks lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.

      • Bentuk pola acara - Membuka pola acara di Pattern Builder. Jika pola tidak dapat dirender di Pattern Builder apa adanya, EventBridge memperingatkan Anda sebelum membuka Pattern Builder.

  4. Pilih Selanjutnya.

Pilih target

Pilih satu atau beberapa target untuk menerima peristiwa yang cocok dengan pola yang ditentukan. Target dapat mencakup bus EventBridge acara, EventBridge API tujuan, termasuk mitra SaaS seperti Salesforce, atau lainnya. AWS service

Untuk memilih target

  1. Untuk jenis Target, pilih salah satu jenis target berikut:

    Event bus

    Untuk memilih bus EventBridge acara, pilih bus EventBridge acara, lalu lakukan hal berikut:

    API destination

    Untuk menggunakan EventBridge API tujuan, pilih EventBridge APItujuan, lalu lakukan salah satu hal berikut:

    • Untuk menggunakan API tujuan yang ada, pilih Gunakan API tujuan yang ada. Kemudian pilih API tujuan dari daftar dropdown.

    • Untuk membuat API tujuan baru, pilih Buat API tujuan baru. Kemudian, berikan rincian berikut untuk tujuan:

      • Nama — Masukkan nama untuk tujuan.

        Nama harus unik di dalam diri Anda Akun AWS. Nama dapat memiliki hingga 64 karakter. Karakter yang valid adalah A-Z, a-z, 0-9, dan. _ - (tanda hubung).

      • (Opsional) Deskripsi — Masukkan deskripsi untuk tujuan.

        Deskripsi dapat memiliki hingga 512 karakter.

      • APItitik akhir tujuan — URL Titik akhir untuk target.

        Titik akhir URL harus dimulai denganhttps. Anda dapat menyertakan wildcard * sebagai parameter jalur. Anda dapat mengatur parameter jalur dari HttpParameters atribut target.

      • HTTPmetode - Pilih HTTP metode yang digunakan saat Anda memanggil titik akhir.

      • (Opsional) Batas tingkat pemanggilan per detik - Masukkan jumlah maksimum pemanggilan yang diterima untuk setiap detik untuk tujuan ini.

        Nilai ini harus lebih besar dari nol. Secara default, nilai ini diatur ke 300.

      • Koneksi — Pilih untuk menggunakan koneksi baru atau yang sudah ada:

        • Untuk menggunakan koneksi yang ada, pilih Gunakan koneksi yang ada dan pilih koneksi dari daftar tarik-turun.

        • Untuk membuat koneksi baru untuk tujuan ini pilih Buat koneksi baru, lalu tentukan Nama koneksi, tipe Tujuan, dan jenis Otorisasi. Anda juga dapat menambahkan Deskripsi opsional untuk koneksi ini.

    Untuk informasi selengkapnya, lihat APItujuan sebagai target aturan di Amazon EventBridge.

    AWS service

    Untuk menggunakan AWS service, pilih AWS service, lalu lakukan hal berikut:

    1. Untuk Pilih target, pilih AWS service untuk digunakan sebagai target. Berikan informasi yang diminta untuk layanan yang Anda pilih.

      catatan

      Bidang yang ditampilkan bervariasi tergantung pada layanan yang dipilih. Untuk informasi selengkapnya tentang target yang tersedia, lihatTarget bus acara tersedia di EventBridge konsol.

  2. Untuk banyak jenis target, EventBridge perlu izin untuk mengirim acara ke target. Dalam kasus ini, EventBridge dapat membuat IAM peran yang diperlukan agar aturan Anda berjalan.

    Untuk peran Eksekusi, lakukan salah satu hal berikut:

    • Untuk membuat peran eksekusi baru untuk aturan ini:

      1. Pilih Buat peran baru untuk sumber daya khusus ini.

      2. Masukkan nama untuk peran eksekusi ini, atau gunakan nama yang dihasilkan oleh EventBridge.

    • Untuk menggunakan peran eksekusi yang ada untuk aturan ini:

      1. Pilih Gunakan peran yang ada.

      2. Masukkan atau pilih nama peran eksekusi yang akan digunakan dari daftar dropdown.

  3. (Opsional) Untuk pengaturan Tambahan, tentukan salah satu pengaturan opsional yang tersedia untuk jenis target Anda:

    Event bus

    (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon standar sebagai SQS antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu hal berikut ini:

    • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

    • Pilih SQS antrian Amazon di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari daftar drop-down.

    • Pilih SQS antrian Amazon di AWS akun lain sebagai antrian huruf mati, lalu masukkan antrian yang akan ARN digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke antrean tersebut.

      Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

    API destination

    1. (Opsional) Untuk Mengonfigurasi input target, pilih cara Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok. Pilih salah satu cara berikut:

      • Peristiwa yang cocok - EventBridge mengirimkan seluruh acara sumber asli ke target. Ini adalah opsi default.

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

        Di bawah Tentukan bagian dari peristiwa yang cocok, tentukan JSON jalur yang menentukan bagian acara yang ingin Anda kirim EventBridge ke target.

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

        Di bawah Tentukan konstanta JSON, tentukan JSON teks yang EventBridge ingin Anda kirim ke target, bukan acara.

      • Transformator input - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

        1. Pilih Konfigurasikan transformator input.

        2. Konfigurasikan transformator input mengikuti langkah-langkah masukMengkonfigurasi transformator input saat membuat aturan di EventBridge.

    2. (Opsional) Di bawah kebijakan Coba lagi, tentukan cara EventBridge mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.

      • Usia maksimum acara - Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan acara yang belum diproses. Defaultnya adalah 24 jam.

      • Coba lagi — Masukkan jumlah maksimum kali EventBridge harus mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan. Defaultnya adalah 185 kali.

    3. (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon standar sebagai SQS antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu hal berikut ini:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih SQS antrian Amazon di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari daftar drop-down.

      • Pilih SQS antrian Amazon di AWS akun lain sebagai antrian huruf mati, lalu masukkan antrian yang akan ARN digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke sana.

        Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

    AWS service

    Perhatikan bahwa EventBridge mungkin tidak menampilkan semua bidang berikut untuk AWS layanan tertentu.

    1. (Opsional) Untuk Mengonfigurasi input target, pilih cara Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok. Pilih salah satu cara berikut:

      • Peristiwa yang cocok - EventBridge mengirimkan seluruh acara sumber asli ke target. Ini adalah opsi default.

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

        Di bawah Tentukan bagian dari peristiwa yang cocok, tentukan JSON jalur yang menentukan bagian acara yang ingin Anda kirim EventBridge ke target.

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

        Di bawah Tentukan konstanta JSON, tentukan JSON teks yang EventBridge ingin Anda kirim ke target, bukan acara.

      • Transformator input - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

        1. Pilih Konfigurasikan transformator input.

        2. Konfigurasikan transformator input mengikuti langkah-langkah masukMengkonfigurasi transformator input saat membuat aturan di EventBridge.

    2. (Opsional) Di bawah kebijakan Coba lagi, tentukan cara EventBridge mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.

      • Usia maksimum acara - Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan acara yang belum diproses. Defaultnya adalah 24 jam.

      • Coba lagi — Masukkan jumlah maksimum kali EventBridge harus mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan. Defaultnya adalah 185 kali.

    3. (Opsional) Untuk antrian Dead-letter, pilih apakah akan menggunakan antrian Amazon standar sebagai SQS antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu hal berikut ini:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih SQS antrian Amazon di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian yang akan digunakan dari daftar drop-down.

      • Pilih SQS antrian Amazon di AWS akun lain sebagai antrian huruf mati, lalu masukkan antrian yang akan ARN digunakan. Anda harus melampirkan kebijakan berbasis sumber daya ke antrian yang memberikan EventBridge izin untuk mengirim pesan ke antrean tersebut.

        Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.

  4. (Opsional) Pilih Tambahkan target lain untuk menambahkan target lain untuk aturan ini.

  5. Pilih Selanjutnya.

Perhatikan bahwa EventBridge mungkin tidak menampilkan semua bidang berikut untuk AWS layanan tertentu.

Konfigurasikan tag dan aturan ulasan

Terakhir, masukkan tag yang diinginkan untuk aturan tersebut, lalu tinjau dan buat aturannya.

Untuk mengkonfigurasi tag, dan meninjau dan membuat aturan

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

  2. Pilih Berikutnya.

  3. Tinjau detail untuk aturan baru. Untuk membuat perubahan pada bagian mana pun, pilih tombol Edit di sebelah bagian itu.

    Saat puas dengan detail aturan, pilih Buat aturan.