Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa - Amazon EventBridge
Buat aturan yang bereaksi terhadap peristiwa

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

Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa

Untuk mengambil tindakan atas acara yang diterima oleh AmazonEventBridge, Anda dapat membuat aturan. Saat peristiwa cocok dengan pola peristiwa yang didefinisikan dalam aturan Anda, EventBridge mengirimkan peristiwa untuk target yang ditentukan dan memicu tindakan yang didefinisikan dalam aturan.

Video berikut mengeksplorasi menciptakan berbagai jenis aturan, dan bagaimana untuk menguji mereka:

Buat aturan yang bereaksi terhadap peristiwa

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

Tentukan aturan

Pertama, masukkan nama dan deskripsi untuk aturan Anda untuk mengidentifikasinya. Anda juga harus menentukan bus acara di mana aturan Anda mencari peristiwa yang cocok dengan pola acara.

Untuk menentukan detail aturan

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

  2. Di panel navigasi, pilih Aturan.

  3. Pilih Buat aturan.

  4. Masukkan Nama dan, opsional, Deskripsi untuk aturan.

    Aturan tidak boleh memiliki nama yang sama dengan aturan lain di Wilayah AWS yang sama dan di bus peristiwa yang sama.

  5. Untuk Bus peristiwa, pilih bus peristiwa yang akan dihubungkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan kejadian yang berasal dari akun Anda, pilih bus kejadian AWS default. Saat akun Layanan AWS Anda menghasilkan kejadian, akun Anda akan selalu masuk ke bus kejadian default akun Anda.

  6. Untuk jenis Aturan, pilih Aturan dengan pola peristiwa.

  7. Pilih Selanjutnya.

Membangun pola acara

Selanjutnya, bangun pola acara. Untuk melakukan ini, tentukan sumber acara, pilih dasar untuk pola acara, dan tentukan atribut dan nilai yang akan dicocokkan. Anda juga dapat membuat pola acara di JSON dan mengujinya terhadap contoh peristiwa.

Untuk membangun pola acara

  1. Untuk Sumber acara, pilih AWSacara atau acara EventBridge mitra.

  2. (Opsional) Di bagian Contoh peristiwa, pilih Contoh jenis peristiwa yang Anda inginkan untuk menguji pola acara Anda.

    Jenis kejadian contoh berikut ini tersedia:

    • AWSperistiwa - Pilih dari peristiwa yang dipancarkan dari didukung. Layanan AWS

    • EventBridgeacara mitra — Pilih dari acara yang dipancarkan dari layanan pihak ketiga yang mendukungEventBridge, seperti Salesforce.

    • Masukkan saya sendiri - Masukkan acara Anda sendiri dalam teks JSON.

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

      1. Pilih AWSacara atau acara EventBridge mitra.

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

        EventBridgemenampilkan contoh acara.

      3. Pilih Salin.

      4. Pilih Enter my own for Event type.

      5. Hapus contoh struktur peristiwa di panel pengeditan JSON, dan tempelkan peristiwa AWS atau mitra di tempatnya.

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

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

    Existing schema

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

    1. Di bagian Creation method, untuk Method, pilih Use schema.

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

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

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

    5. Di bagian Model, pilih tombol Edit di samping 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 samping nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian Catatan pada kotak dialog atribut properti.

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

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

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

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

      Anda juga dapat memilih salah satu opsi berikut ini:

      • Salin - Salin pola peristiwa ke clipboard perangkat Anda.

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

    Custom schema

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

    1. Di bagian Creation method, untuk Method, pilih Use schema.

    2. Di bagian Event pattern, untuk tipe Skema, pilih Enter schema.

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

    4. Di bagian Model, pilih tombol Edit di samping 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 samping nama atribut. Untuk referensi tentang cara mengatur properti atribut dalam acara Anda, buka bagian Catatan pada kotak dialog atribut properti.

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

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

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

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

      Anda juga dapat memilih salah satu opsi berikut ini:

      • Salin - Salin pola peristiwa ke clipboard perangkat Anda.

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

    Event pattern

    Untuk menulis pola peristiwa kustom dalam format JSON, lakukan hal berikut:

    1. Di bagian Creation method, untuk Method, pilih Custom pattern (JSON editor).

    2. Untuk pola acara, masukkan pola acara kustom Anda dalam teks berformat JSON.

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

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

      Anda juga dapat memilih salah satu opsi berikut ini:

      • Salin - Salin pola peristiwa ke clipboard perangkat Anda.

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

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

  4. Pilih Selanjutnya.

Pilih target

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

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 tujuan EventBridge API, pilih tujuan EventBridge API, lalu lakukan salah satu hal berikut:

    • Untuk menggunakan tujuan API yang ada, pilih Gunakan tujuan API yang ada. Kemudian pilih tujuan API dari daftar tarik-turun.

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

      • Nama - Masukkan nama untuk tujuan.

        Nama harus unik di dalam AndaAkun 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.

      • Titik akhir tujuan API - Titik akhir URL untuk target.

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

      • Metode HTTP - Pilih metode HTTP 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 dropdown.

        • Untuk membuat sambungan baru untuk tujuan ini pilih Buat sambungan baru, lalu tentukan nama sambungan, jenis tujuan, dan jenis otorisasi. Anda juga dapat menambahkan nilai Deskripsi opsional untuk koneksi ini.

    Untuk informasi selengkapnya, lihat Tujuan API.

    Layanan AWS

    Untuk menggunakanLayanan AWS, pilih Layanan AWS, lalu lakukan hal berikut:

    1. Untuk Pilih target, pilih Layanan AWS 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 tersedia di EventBridge konsol.

  2. Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, EventBridge dapat membuat IAM role yang diperlukan bagi aturan Anda untuk berjalan.

    Untuk Execution role, lakukan salah satu hal berikut:

    • Untuk membuat peran eksekusi baru untuk aturan ini:

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

      2. Entah masukkan nama untuk peran eksekusi ini, atau gunakan nama yang dihasilkan olehEventBridge.

    • 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 Antrean surat mati, pilih apakah akan Anda menggunakan antrean Amazon SQS standar sebagai antrean surat mati. EventBridgemengirimkan peristiwa yang mencocokkan aturan ini dengan antrean surat mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

    • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

    • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

    • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrean yang memberikan izin EventBridge untuk mengirim pesan padanya.

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

    API destination

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

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

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

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

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

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

      • 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 diMengkonfigurasi transformator input sebagai bagian dari pembuatan aturan.

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

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

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

    3. (Opsional) Untuk Antrean surat mati, pilih apakah akan Anda menggunakan antrean Amazon SQS standar sebagai antrean surat mati. EventBridgemengirimkan peristiwa yang mencocokkan aturan ini dengan antrean surat mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

      • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrean yang memberikan izin EventBridge untuk mengirim pesan padanya.

        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 Konfigurasi input target, pilih bagaimana Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok. Pilih salah satu dari berikut:

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

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

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

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

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

      • 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 diMengkonfigurasi transformator input sebagai bagian dari pembuatan aturan.

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

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

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

    3. (Opsional) Untuk Antrean surat mati, pilih apakah akan Anda menggunakan antrean Amazon SQS standar sebagai antrean surat mati. EventBridgemengirimkan peristiwa yang mencocokkan aturan ini dengan antrean surat mati jika tidak berhasil dikirim ke target. Lakukan salah satu dari berikut:

      • Pilih Tidak ada untuk tidak menggunakan antrean surat mati.

      • Pilih Pilihan antrean Amazon SQS di akun AWS saat ini untuk digunakan sebagai antrean surat mati kemudian pilih antrean yang akan digunakan dari daftar menurun.

      • Pilih Pilihan antrean Amazon SQS di akun AWS lainnya sebagai antrean surat mati dan kemudian masukkan ARN antrean untuk menggunakannya. Anda harus melampirkan kebijakan berbasis sumber daya ke antrean yang memberikan izin EventBridge untuk mengirim pesan padanya.

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

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

  5. Pilih Selanjutnya.

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

Mengonfigurasi tag dan aturan ulasan

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

Untuk mengkonfigurasi tag, dan meninjau dan membuat aturan

  1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat EventBridge Tag Amazon.

  2. Pilih Next (Berikutnya).

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

    Jika puas dengan detail aturan, pilih Buat aturan.