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

# Membuat aturan di Amazon EventBridge
<a name="eb-create-rule-visual"></a>

## Prasyarat
<a name="eb-create-rule-prerequisites"></a>

Sebelum Anda mulai, pastikan Anda memiliki:
+ Akses ke EventBridge konsol Amazon
+ Izin IAM yang sesuai untuk membuat aturan EventBridge 
+ Pemahaman dasar tentang arsitektur yang digerakkan oleh peristiwa

## Ikhtisar
<a name="eb-create-rule-overview"></a>

Untuk mengambil tindakan pada acara yang diterima oleh EventBridge, Anda dapat membuat aturan. Saat acara cocok dengan pola acara yang ditentukan dalam aturan Anda, EventBridge kirimkan acara ke target yang ditentukan.

Topik ini memandu Anda membuat aturan yang EventBridge digunakan untuk mencocokkan acara saat dikirim ke bus acara yang ditentukan.

Membuat EventBridge aturan melibatkan empat langkah utama:

1. Pilih acara yang ingin Anda proses

1. Konfigurasikan penyaringan dan pengujian acara

1. Pilih dan konfigurasikan target

1. Konfigurasikan pengaturan aturan

## Pilih acara
<a name="eb-create-rule-source"></a>

Pertama, pilih acara yang ingin Anda kirim ke target.

**Untuk memilih acara**

1. Buka EventBridge konsol Amazon di [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Di panel navigasi, pilih **Aturan**, lalu pilih **Buat Aturan**.

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

   1. Pilih **Acara AWS Layanan atau Acara** **Kustom**.

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

   1. Seret satu atau beberapa peristiwa ke dalam kanvas **Build** dan letakkan di **Triggering Events**.

   EventBridge menampilkan bagian **Triggering 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 dari skema acara.
     + **Kode**: Skema acara dalam spesifikasi API Terbuka atau format JSON.
     + **Info**: Ikhtisar informasi tentang skema.
   + **Contoh peristiwa**, yang menampilkan sampel acara yang dipilih, jika tersedia.
   + **Pola acara (filter)**, yang berisi pola acara yang memilih semua acara yang Anda pilih.

## Filter acara untuk mengirim hanya apa yang Anda inginkan
<a name="eb-create-rule-event-pattern-visual"></a>

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

### Edit pola acara (opsional)
<a name="eb-create-rule-event-pattern-steps"></a>

Di panel **Memicu peristiwa**, Anda dapat membuat pola acara dengan dua cara:
+ Secara visual, menggunakan tampilan pohon **Skema**
+ Dengan langsung mengedit JSON di panel **pola Acara**

**Untuk mengedit pola acara menggunakan tampilan pohon Skema**

1. Pilih tab **Tree** dari panel **Schema**.

1. Tambahkan dan edit filter untuk membangun pola acara.

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

   1. Pilih operator perbandingan dari daftar drop-down.

      Untuk informasi selengkapnya tentang operator perbandingan, lihat [Membuat pola peristiwa](eb-create-pattern-operators.md).

   1. Masukkan nilai yang ingin Anda cocokkan.

   1. Klik tanda centang untuk menyelesaikan.

   EventBridge menambahkan filter yang Anda buat ke JSON di panel **pola Peristiwa**.

1. Tambahkan filter tambahan hingga Anda membuat pola acara yang cocok dengan semua atribut acara yang Anda inginkan.

### Uji pola acara
<a name="eb-create-rule-event-pattern-test"></a>

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

#### Uji pola acara (opsional)
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. Pilih contoh acara untuk pengujian, atau gunakan acara Anda sendiri.
   + **Gunakan contoh peristiwa yang disediakan**

     1. Pilih **Gunakan contoh peristiwa yang disediakan**.

     1. 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 acara generik dengan `details` elemen kosong.

     1. Edit acara JSON 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:  
Pilih **Gunakan sampel peristiwa yang disediakan**, pilih peristiwa dari **Sampel peristiwa pemicu**, lalu pilih **Salin**.
Pilih **Gunakan peristiwa Anda sendiri**.
Pilih seluruh peristiwa di jendela, lalu tempel sampel peristiwa di atasnya.
Edit peristiwa sesuai keinginan.

1. Pilih **Jalankan Uji**.

   EventBridge menampilkan pesan yang menyatakan apakah peristiwa uji cocok dengan pola acara.

## Pilih target
<a name="eb-create-rule-target-visual"></a>

Seret satu (dan hingga lima) target ke kanvas **Build** dan letakkan di **Target** untuk menerima peristiwa yang cocok dengan pola peristiwa yang ditentukan. Target dapat mencakup:
+ Bus EventBridge acara lainnya, 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 jatuhkan ke bentuk **Target** di kanvas Build.

   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.

1. Konfigurasikan target berdasarkan jenis target Anda. Untuk langkah-langkah konfigurasi terperinci, lihat [EventBridge Target](eb-targets.md).

### Sesuaikan data acara yang dikirim ke target
<a name="eb-create-rule-target-transform"></a>

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

#### Mengubah atau mengganti data peristiwa yang dikirim (opsional)
<a name="eb-create-rule-target-transform-steps"></a>

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

   EventBridge menampilkan bagian **Transformasi input**.

1. Di bawah **Konfigurasi transformasi input**, pilih **Aktifkan**.

1. Pilih metode Transformasi untuk memilih bagaimana Anda ingin menyesuaikan teks yang dikirim ke target untuk acara yang cocok:
   + **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 acara sumber asli yang dikirim.
   + **Transformator input** - Konfigurasikan transformator input untuk menyesuaikan teks yang EventBridge ingin Anda kirim ke target. Untuk informasi selengkapnya, lihat [Mengubah input target](eb-transform-target-input.md).

## Konfigurasikan aturan
<a name="eb-create-rule-configure"></a>

Terakhir, konfigurasikan dan buat aturan.

**Untuk mengkonfigurasi aturan (konsol)**

1. Pilih **Konfigurasikan**

1. 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.

1. 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 Layanan AWS di akun Anda mengirim acara, itu selalu masuk ke bus acara default akun Anda.

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

1. (Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat [Menandai sumber daya di Amazon EventBridge](eb-tagging.md).

1. Pilih **Create** (Buat).

## Langkah selanjutnya
<a name="eb-create-rule-next-steps"></a>

Setelah membuat aturan Anda, Anda dapat:
+ [Pantau performa aturan menggunakan metrik](eb-monitoring.md)
+ [Uji aturan Anda dengan contoh peristiwa](eb-event-pattern-sandbox.md)
+ [Ubah pola acara sesuai kebutuhan](eb-event-patterns.md)
+ [Tambahkan target tambahan ke aturan yang ada](eb-targets.md)

## Sumber daya tambahan
<a name="eb-create-rule-additional-resources"></a>

Untuk informasi selengkapnya tentang EventBridge aturan, lihat:
+ [EventBridge ikhtisar aturan](eb-rules.md)
+ [Membuat pola peristiwa](eb-event-patterns.md)
+ [EventBridge target](eb-targets.md)
+ [Aturan pemecahan masalah EventBridge ](eb-troubleshooting.md)