

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

# Aturan di Amazon EventBridge
<a name="eb-rules"></a>

Anda menentukan apa yang EventBridge dilakukan dengan acara yang dikirimkan ke setiap bus acara. Untuk melakukan ini, Anda membuat *aturan*. Aturan menentukan peristiwa mana yang akan dikirim ke [target](eb-targets.md) mana yang akan diproses. Aturan tunggal dapat mengirim acara ke beberapa target, yang kemudian dijalankan secara paralel.

Anda dapat membuat dua jenis aturan: aturan yang cocok pada data peristiwa saat acara dikirimkan, dan aturan yang berjalan pada jadwal yang ditentukan. Selain itu, AWS layanan tertentu dapat membuat dan mengelola aturan di akun Anda juga.

## Aturan yang cocok dengan data acara
<a name="eb-rules-match"></a>

Anda dapat membuat aturan yang cocok dengan peristiwa yang masuk berdasarkan kriteria data peristiwa (disebut *pola peristiwa*). Pola peristiwamendefinisikan struktur acara dan bidang yang cocok dengan aturan. Jika suatu peristiwa cocok dengan kriteria yang ditentukan dalam pola peristiwa, EventBridge kirimkan ke target yang Anda tentukan.

Untuk informasi selengkapnya, lihat [Membuat aturan di Amazon EventBridge](eb-create-rule-visual.md).

## Aturan yang berjalan sesuai jadwal
<a name="eb-rules-scheduled"></a>

**catatan**  
Aturan terjadwal adalah fitur warisan dari. EventBridge  
EventBridgemenawarkan cara yang lebih fleksibel dan ampuh untuk membuat, menjalankan, dan mengelola tugas terjadwal secara terpusat, dalam skala: EventBridge Penjadwal. Dengan EventBridge Scheduler, Anda dapat membuat jadwal menggunakan ekspresi cron dan rate untuk pola berulang, atau mengonfigurasi pemanggilan satu kali. Anda dapat mengatur jendela waktu fleksibel untuk pengiriman, menentukan batas coba lagi, dan mengatur waktu retensi maksimum untuk pemanggilan API yang gagal.   
Scheduler sangat dapat disesuaikan, dan menawarkan skalabilitas yang ditingkatkan dibandingkan aturan terjadwal, dengan serangkaian operasi dan layanan API target yang lebih luas. AWS Kami menyarankan Anda menggunakan Scheduler untuk memanggil target pada jadwal.  
Untuk informasi selengkapnya, lihat [Buat jadwal](using-eventbridge-scheduler.md#using-eventbridge-scheduler-create) atau *[Panduan Pengguna EventBridge Penjadwal](https://docs.aws.amazon.com/scheduler/latest/UserGuide/what-is-scheduler.html)*.

Anda juga dapat membuat aturan yang mengirimkan peristiwa ke target yang ditentukan pada interval tertentu. Misalnya, untuk menjalankan Lambda fungsi secara berkala, Anda dapat membuat aturan untuk dijalankan sesuai jadwal.

Untuk informasi selengkapnya, lihat [Membuat aturan terjadwal (warisan) di Amazon EventBridge](eb-create-rule-schedule.md).

## Aturan yang dikelola oleh AWS layanan
<a name="eb-rules-managed"></a>

Selain aturan yang Anda buat, AWS layanan dapat membuat dan mengelola EventBridge aturan di AWS akun Anda yang diperlukan untuk fungsi tertentu dalam layanan tersebut. Ini semuanya disebut *aturan terkelola*. 

Saat layanan membuat aturan terkelola, layanan juga dapat membuat [IAM kebijakan](eb-iam.md) yang memberikan izin ke layanan tersebut untuk membuat aturan. Kebijakan IAM yang dibuat dengan cara ini memiliki jangkauan sempit dengan perizinan tingkat sumber daya untuk mengizinkan penciptaan aturan yang diperlukan saja.

Anda dapat menghapus aturan terkelola dengan menggunakan opsi **Hapus paksa**, tetapi Anda hanya harus menghapusnya jika Anda yakin bahwa layanan lain tidak lagi memerlukan aturan tersebut. Jika tidak, menghapus aturan terkelola menyebabkan fitur yang bergantung padanya berhenti bekerja.

# 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)

# Membuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge
<a name="eb-create-rule-wizard"></a>

Untuk mengambil tindakan pada acara yang diterima oleh Amazon EventBridge, Anda dapat membuat [aturan](eb-rules.md). Jika peristiwa cocok dengan [pola acara](eb-event-patterns.md) yang ditentukan dalam aturan Anda, EventBridge kirimkan acara ke [target](eb-targets.md) yang ditentukan dan memicu tindakan yang ditentukan dalam aturan.

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

**Topics**
+ [Tentukan aturannya](#eb-create-rule-define)
+ [Bangun pola peristiwa](#eb-create-rule-event-pattern)
+ [Pilih target](#eb-create-rule-target)
+ [Konfigurasikan tag dan aturan peninjauan](#eb-create-rule-review)

## Tentukan aturannya
<a name="eb-create-rule-define"></a>

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/](https://console.aws.amazon.com/events/).

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

1. Pilih **Buat aturan**.

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 memancarkan acara, itu selalu masuk ke bus acara default akun Anda.

1. Untuk **Tipe aturan**, pilih **Aturan dengan pola peristiwa**.

1. Pilih **Selanjutnya**.

## Bangun pola peristiwa
<a name="eb-create-rule-event-pattern"></a>

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 di JSON dan mengujinya terhadap peristiwa sampel.

**Untuk membangun pola acara**

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

1. (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. Layanan AWS
   + **EventBridge acara mitra** - Pilih dari acara yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
   + **Masukkan 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 **AWS acara** atau **acara EventBridge mitra**.

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

        EventBridge menampilkan acara sampel.

     1. Pilih **Salin**.

     1. Pilih **Enter my own** untuk **jenis Event.**

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

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

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

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

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

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

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

   1. Pilih **Hasilkan pola acara di JSON** untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON. 

   1. (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 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 **Metode pembuatan**, untuk **Metode**, pilih **Gunakan skema**.

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

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

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

   1. Pilih **Hasilkan pola acara di JSON** untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON. 

   1. (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 teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.

------
#### [ Event pattern ]

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

   1. Di bagian **Metode pembuatan**, untuk **Metode**, pilih **Pola kustom (editor JSON)**.

   1. Untuk **pola Acara**, masukkan pola acara khusus Anda dalam teks berformat JSON. 

   1. (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 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 dirender di Pattern Builder apa adanya, EventBridge memperingatkan Anda sebelum membuka Pattern Builder.

------

1. Pilih **Berikutnya**.

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

Pilih satu atau beberapa target untuk menerima peristiwa yang cocok 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 ]

   1. Pilih **bus EventBridge acara**.

   1. Pilih bus acara yang akan digunakan sebagai target.
      + Untuk menggunakan bus acara yang Wilayah AWS sama dengan aturan ini: 

        1. Pilih **Bus acara di akun dan Wilayah yang sama**.

        1. Untuk **bus acara untuk target**, pilih kotak dropdown dan masukkan nama bus acara. Anda juga dapat memilih bus acara dari daftar dropdown.

           Untuk informasi selengkapnya, lihat [Mengirim acara antara bus acara di akun dan Wilayah yang sama di Amazon EventBridge](eb-bus-to-bus.md).
      + Untuk menggunakan bus acara di akun yang berbeda Wilayah AWS atau sebagai aturan ini:

        1. Pilih **bus Acara di akun atau Wilayah yang berbeda**.

        1. Untuk **bus Event sebagai target**, masukkan ARN bus acara yang ingin Anda gunakan.

           Untuk informasi lebih lanjut, lihat: 
           + [Mengirim dan menerima acara antar AWS akun di Amazon EventBridge](eb-cross-account.md)
           + [Mengirim dan menerima acara antar AWS Wilayah di Amazon EventBridge](eb-cross-region.md)

   1. Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, EventBridge dapat membuat peran IAM 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**.

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

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

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

      (Opsional) Untuk **antrian Dead-letter**, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan 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](eb-rule-dlq.md#eb-dlq-perms).

------
#### [ API destination ]

   1. Pilih **tujuan EventBridge API**.

   1. Pilih tujuan API baru atau yang sudah ada:
      + Untuk menggunakan tujuan API yang ada, pilih **Gunakan tujuan API yang ada**. Kemudian pilih tujuan API dari daftar dropdown.
      + 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 diri Anda Akun AWS. Nama dapat memiliki hingga 64 karakter. **Karakter yang valid adalah **A-Z**, **a-z**, **0-9**, dan.** **\$1** **-** (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 dengan**https**. Anda dapat menyertakan wildcard **\$1** sebagai parameter jalur. 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 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.

   1. Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, EventBridge dapat membuat peran IAM 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**.

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

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

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

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

      1. (Opsional) Untuk Konfigurasi 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 jalur JSON yang menentukan bagian 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 EventBridge ingin Anda kirim ke target alih-alih acara.
         + **Transformator input** - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat [Transformasi EventBridge masukan Amazon](eb-transform-target-input.md).

           1. Pilih **Konfigurasikan transformator input**.

           1. Konfigurasikan transformator input mengikuti langkah-langkah masuk[Mengkonfigurasi transformator input saat membuat aturan di EventBridge](eb-transform-input-rule.md).

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

      1. (Opsional) Untuk **antrian Dead-letter**, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
         + Pilih **Tidak ada** untuk tidak menggunakan antrean surat mati.
         + Pilih **Pilih antrean Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian** yang akan digunakan dari daftar drop-down.
         + 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 antrian yang memberikan EventBridge izin untuk mengirim pesan ke sana. 

           Untuk informasi selengkapnya, lihat [Memberikan izin untuk antrean surat mati](eb-rule-dlq.md#eb-dlq-perms).

   Untuk informasi selengkapnya, lihat [Tujuan API sebagai target di Amazon EventBridge](eb-api-destinations.md).

------
#### [ Layanan AWS ]

   1. Pilih **Layanan AWS**.

   1. Untuk **Pilih target**, pilih Layanan AWS untuk digunakan sebagai target. 

   1. Jika Anda memilih AWS layanan yang mendukung target lintas akun, Anda dapat memilih target di akun yang sama dengan bus acara, atau akun lain.
      + Untuk target di akun yang sama, untuk **jenis Target** pilih **Target di akun ini**.

        1. 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, lihat[Target bus acara tersedia di EventBridge konsol](eb-targets.md#eb-console-targets).

        1. Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, EventBridge dapat membuat peran IAM 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**.

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

             1. Masukkan atau pilih nama peran eksekusi yang akan digunakan dari daftar dropdown.
      + Untuk target di akun yang berbeda, untuk **jenis Target** pilih **Target di AWS akun lain**.

        1. Masukkan ARN dari sumber daya target yang ingin Anda kirimi acara.

        1. Berikan informasi tambahan apa pun yang diminta untuk layanan yang Anda pilih.

        1. Pilih nama peran eksekusi yang akan digunakan dari daftar dropdown.

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

      1. (Opsional) Untuk Konfigurasi 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 jalur JSON yang menentukan bagian 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 EventBridge ingin Anda kirim ke target alih-alih acara.
         + **Transformator input** - Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat [Transformasi EventBridge masukan Amazon](eb-transform-target-input.md).

           1. Pilih **Konfigurasikan transformator input**.

           1. Konfigurasikan transformator input mengikuti langkah-langkah masuk[Mengkonfigurasi transformator input saat membuat aturan di EventBridge](eb-transform-input-rule.md).

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

      1. (Opsional) Untuk **antrian Dead-letter**, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrian huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
         + Pilih **Tidak ada** untuk tidak menggunakan antrean surat mati.
         + Pilih **Pilih antrean Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati dan kemudian pilih antrian** yang akan digunakan dari daftar drop-down.
         + 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 antrian yang memberikan EventBridge izin untuk mengirim pesan ke sana. 

           Untuk informasi selengkapnya, lihat [Memberikan izin untuk antrean surat mati](eb-rule-dlq.md#eb-dlq-perms).

------

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

1. Pilih **Berikutnya**.

## Konfigurasikan tag dan aturan peninjauan
<a name="eb-create-rule-review"></a>

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](eb-tagging.md).

1. Pilih **Berikutnya**.

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

# Menonaktifkan atau menghapus aturan di Amazon EventBridge
<a name="eb-delete-rule"></a>

Untuk menghentikan [aturan](eb-rules.md) dari mengolah [peristiwa](eb-events.md) atau berjalan pada jadwal, Anda dapat menghapus atau menonaktifkan aturan. Langkah-langkah berikut memandu Anda melalui cara menghapus atau menonaktifkan EventBridge aturan.

**Menghapus atau menonaktifkan aturan**

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

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

   Di bawah **Bus peristiwa**, pilih bus peristiwa yang terkait dengan aturan.

1. Lakukan salah satu dari berikut ini:

   1. Untuk menghapus aturan, pilih tombol di samping aturan dan pilih **Tindakan**, **Hapus**, **Hapus**.

      Jika aturan adalah aturan terkelola, masukkan nama aturan untuk mengakui bahwa aturan itu adalah aturan terkelola dan bahwa menghapusnya dapat menghentikan fungsionalitas dalam layanan yang membuat aturan. Untuk melanjutkan, masukkan nama aturan dan pilih **Hapus paksa**.

   1. Untuk menonaktifkan aturan sementara, pilih tombol di samping aturan dan pilih **Nonaktifkan**, **Nonaktifkan**.

      Anda tidak dapat menonaktifkan aturan terkelola.

# Praktik terbaik saat mendefinisikan aturan di Amazon EventBridge
<a name="eb-rules-best-practices"></a>

Di bawah ini adalah beberapa praktik terbaik untuk dipertimbangkan ketika Anda membuat aturan untuk bus acara Anda.

## Tetapkan satu target untuk setiap aturan
<a name="eb-rules-best-practices-single-target"></a>

Meskipun Anda dapat menentukan hingga lima target untuk aturan tertentu, mengelola aturan lebih mudah ketika Anda menentukan satu target untuk setiap aturan. Jika lebih dari satu target perlu menerima rangkaian peristiwa yang sama, kami sarankan untuk menduplikasi aturan untuk mengirimkan peristiwa yang sama ke target yang berbeda. Enkapsulasi ini menyederhanakan pemeliharaan aturan: jika kebutuhan target acara berbeda dari waktu ke waktu, Anda dapat memperbarui setiap aturan dan pola kejadiannya secara independen dari yang lain.

## Tetapkan izin aturan
<a name="eb-rules-best-practices-permissions"></a>

Anda dapat mengaktifkan komponen atau layanan aplikasi yang memakan peristiwa untuk mengendalikan aturan mereka sendiri. Pendekatan arsitektur umum yang diadopsi oleh pelanggan adalah mengisolasi komponen atau layanan aplikasi ini dengan menggunakan AWS akun terpisah. Untuk mengaktifkan aliran acara dari satu akun ke akun lainnya, Anda harus membuat aturan pada satu bus acara yang merutekan acara ke bus acara di akun lain. Anda dapat mengaktifkan tim atau layanan yang memakan acara untuk mengontrol pengelolaan aturan mereka sendiri. Anda melakukan ini dengan menentukan izin yang sesuai untuk akun mereka melalui kebijakan sumber daya. Ini berfungsi di seluruh akun dan Wilayah. 

Untuk informasi selengkapnya, lihat [Izin untuk bus acara di Amazon EventBridge](eb-event-bus-perms.md).

Misalnya kebijakan sumber daya, lihat [Pola desain multi-akun dengan EventBridge Amazon](https://github.com/aws-samples/amazon-eventbridge-resource-policy-samples/tree/main/patterns) GitHub.

## Pantau kinerja aturan
<a name="eb-rules-best-practices-monitor"></a>

Pantau aturan Anda untuk memastikan mereka berkinerja seperti yang Anda harapkan:
+ Memantau `TriggeredRules` metrik untuk titik data atau anomali yang hilang dapat membantu Anda mendeteksi perbedaan untuk penerbit yang membuat perubahan besar. Untuk informasi selengkapnya, lihat [Memantau Amazon EventBridge](eb-monitoring.md). 
+ Alarm pada anomali atau jumlah maksimum yang diharapkan juga dapat membantu mendeteksi ketika aturan cocok dengan peristiwa baru. Hal ini dapat terjadi ketika penerbit acara, termasuk AWS layanan dan mitra SaaS, memperkenalkan acara baru saat mengaktifkan kasus penggunaan dan fitur baru. Ketika peristiwa baru ini tidak terduga dan mengarah ke volume yang lebih tinggi daripada tingkat pemrosesan target hilir, mereka dapat menyebabkan backlog peristiwa. 

  Pemrosesan kejadian tak terduga semacam itu juga dapat menyebabkan biaya penagihan yang tidak diinginkan.

  Ini juga dapat memicu pembatasan aturan ketika akun melewati pemanggilan target agregat per kuota layanan detik. EventBridge masih akan mencoba mengirimkan acara yang dicocokkan dengan aturan yang dibatasi dan mencoba lagi hingga 24 jam atau seperti yang dijelaskan dalam kebijakan coba ulang khusus target. Anda dapat mendeteksi dan alarm membatasi aturan menggunakan metrik `ThrottledRules`
+ Untuk kasus penggunaan latensi rendah, Anda juga dapat memantau penggunaan latensi`IngestionToInvocationStartLatency`, yang memberikan indikasi kesehatan bus acara Anda. Setiap periode latensi tinggi yang diperpanjang selama 30 detik dapat mengindikasikan gangguan layanan atau pembatasan aturan.

# Menggunakan AWS Serverless Application Model template untuk menyebarkan sumber daya Amazon EventBridge
<a name="eb-use-sam"></a>

Anda dapat membuat dan menguji [aturan](eb-rules.md) secara manual di EventBridge konsol, yang dapat membantu dalam proses pengembangan saat Anda menyempurnakan [pola acara](eb-event-patterns.md). Namun, setelah Anda siap untuk menerapkan aplikasi Anda, lebih mudah untuk menggunakan kerangka kerja seperti [AWS SAM](https://docs.aws.amazon.com/serverless-application-model/latest/developerguide/what-is-sam.html)meluncurkan semua sumber daya tanpa server Anda secara konsisten.

Kita akan menggunakan [contoh aplikasi](https://github.com/aws-samples/amazon-eventbridge-producer-consumer-example) ini untuk melihat ke dalam cara-cara Anda dapat menggunakan AWS SAM template untuk membangun EventBridge sumber daya. File template.yaml dalam contoh ini adalah AWS SAM template yang mendefinisikan empat [AWS Lambda](https://docs.aws.amazon.com/lambda/latest/dg/welcome.html)fungsi dan menunjukkan dua cara berbeda untuk mengintegrasikan fungsi Lambda dengan. EventBridge

Untuk panduan aplikasi contoh ini, lihat. [Tutorial: Buat contoh EventBridge aplikasi Amazon](eb-tutorial-get-started.md)

 Ada dua pendekatan untuk menggunakan EventBridge dan AWS SAM template. Untuk integrasi sederhana di mana satu fungsi Lambda dipanggil oleh satu aturan, pendekatan template **Gabungan direkomendasikan**. Jika Anda memiliki logika routing yang kompleks, atau Anda terhubung ke sumber daya di luar AWS SAM template Anda, pendekatan **template Separated** adalah pilihan yang lebih baik.

**Topics**
+ [Template gabungan](#eb-combined-template)
+ [Template terpisah](#eb-separated-template)

## Template gabungan
<a name="eb-combined-template"></a>

Pendekatan pertama menggunakan `Events` properti untuk mengkonfigurasi EventBridge aturan. Kode contoh berikut mendefinisikan [peristiwa](eb-events.md) yang memanggil fungsi Lambda Anda.

**catatan**  
Contoh ini secara otomatis membuat aturan pada [bus acara](eb-event-bus.md) default, yang ada di setiap AWS akun. Untuk mengaitkan aturan dengan bus acara khusus, Anda dapat menambahkan `EventBusName` ke template.

```
atmConsumerCase3Fn:
  Type: AWS::Serverless::Function
  Properties:
    CodeUri: atmConsumer/
    Handler: handler.case3Handler
    Runtime: nodejs12.x
    Events:
      Trigger:
        Type: CloudWatchEvent 
        Properties:
          Pattern:
            source:
              - custom.myATMapp
            detail-type:
              - transaction                
            detail:
              result:
                - "anything-but": "approved"
```

 Kode YAMAL ini setara dengan pola peristiwa di EventBridge konsol. Di YAMB, Anda hanya perlu menentukan pola peristiwa, dan AWS SAM secara otomatis membuat peran IAM dengan izin yang diperlukan. 

## Template terpisah
<a name="eb-separated-template"></a>

Dalam pendekatan kedua untuk mendefinisikan EventBridge konfigurasi di AWS SAM, sumber daya dipisahkan lebih jelas dalam template. 

1. Pertama, Anda mendefinisikan fungsi Lambda:

   ```
   atmConsumerCase1Fn:
     Type: AWS::Serverless::Function
     Properties:
       CodeUri: atmConsumer/
       Handler: handler.case1Handler
       Runtime: nodejs12.x
   ```

1. Selanjutnya, tentukan aturan menggunakan sumber `AWS::Events::Rule` daya. Properti menentukan pola acara dan juga dapat menentukan [target](eb-targets.md). Anda dapat secara eksplisit menentukan beberapa target.

   ```
   EventRuleCase1: 
     Type: AWS::Events::Rule
     Properties: 
       Description: "Approved transactions"
       EventPattern: 
         source: 
           - "custom.myATMapp"
         detail-type:
           - transaction   
         detail: 
           result: 
             - "approved"
       State: "ENABLED"
       Targets: 
         - 
           Arn: 
             Fn::GetAtt: 
               - "atmConsumerCase1Fn"
               - "Arn"
           Id: "atmConsumerTarget1"
   ```

1. Terakhir, tentukan `AWS::Lambda::Permission` sumber daya yang memberikan izin EventBridge untuk memanggil target.

   ```
   PermissionForEventsToInvokeLambda: 
     Type: AWS::Lambda::Permission
     Properties: 
       FunctionName: 
         Ref: "atmConsumerCase1Fn"
       Action: "lambda:InvokeFunction"
       Principal: "events.amazonaws.com"
       SourceArn: 
         Fn::GetAtt: 
           - "EventRuleCase1"
           - "Arn"
   ```

# Menghasilkan AWS CloudFormation template dari EventBridge aturan yang ada
<a name="rule-generate-template"></a>

AWS CloudFormation memungkinkan Anda mengonfigurasi dan mengelola AWS sumber daya Anda di seluruh akun dan wilayah secara terpusat dan berulang dengan memperlakukan infrastruktur sebagai kode. CloudFormation melakukan ini dengan membiarkan Anda membuat *template*, yang menentukan sumber daya yang ingin Anda sediakan dan kelola.

EventBridge memungkinkan Anda untuk membuat template dari aturan yang ada di akun Anda, sebagai bantuan untuk membantu Anda mulai mengembangkan CloudFormation template. Anda dapat memilih satu aturan, atau beberapa aturan untuk disertakan dalam template. Anda kemudian dapat menggunakan template ini sebagai dasar untuk [membuat tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html) sumber daya yang CloudFormation dikelola.

Untuk informasi lebih lanjut tentang CloudFormation lihat [*Panduan CloudFormation Pengguna*.](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html)

**catatan**  
EventBridge tidak menyertakan [aturan terkelola](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html) dalam template yang dihasilkan.

Anda juga dapat [membuat template dari bus acara yang ada](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-generate-event-bus-template.html), termasuk aturan yang berisi bus acara.

**Untuk menghasilkan CloudFormation template dari satu atau beberapa aturan**

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

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

1. Di bawah **Pilih bus acara**, pilih bus acara yang berisi aturan yang ingin Anda sertakan dalam templat.

1. Di bawah **Aturan**, pilih aturan yang ingin Anda sertakan dalam CloudFormation templat yang dihasilkan.

   Untuk satu aturan, Anda juga dapat memilih nama aturan untuk menampilkan halaman detail aturan.

1. Pilih **CloudFormation Template**, lalu pilih format mana yang EventBridge ingin Anda buat template di: **JSON** atau **YAMG**.

   EventBridge menampilkan template, yang dihasilkan dalam format yang dipilih.

1. EventBridge memberi Anda pilihan untuk mengunduh file template, atau menyalin template ke clipboard.
   + Untuk mengunduh file templat, pilih **Unduh**.
   + **Untuk menyalin template ke clipboard, pilih Salin.**

1. Untuk keluar dari template, pilih **Batal**. 

Setelah Anda menyesuaikan CloudFormation template Anda seperlunya untuk kasus penggunaan Anda, Anda dapat menggunakannya untuk [membuat tumpukan](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-create-stack.html). CloudFormation

## Pertimbangan saat menggunakan CloudFormation template yang dihasilkan dari Amazon EventBridge
<a name="eb-generate-rule-template-considerations"></a>

Pertimbangkan faktor-faktor berikut saat menggunakan CloudFormation templat yang Anda hasilkan EventBridge:
+ EventBridge tidak menyertakan kata sandi apa pun dalam template generate.

  Anda dapat mengedit templat untuk menyertakan [parameter templat](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/parameters-section-structure.html) yang memungkinkan pengguna menentukan kata sandi atau informasi sensitif lainnya saat menggunakan templat untuk membuat atau memperbarui CloudFormation tumpukan.

  Selain itu, pengguna dapat menggunakan Secrets Manager untuk membuat rahasia di wilayah yang diinginkan dan kemudian mengedit template yang dihasilkan untuk menggunakan [parameter dinamis](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/dynamic-references.html#dynamic-references-secretsmanager).
+ Target dalam template yang dihasilkan tetap persis seperti yang ditentukan dalam bus acara asli. Hal ini dapat menyebabkan masalah lintas wilayah jika Anda tidak mengedit template dengan tepat sebelum menggunakannya untuk membuat tumpukan di wilayah lain.

  Selain itu, template yang dihasilkan tidak membuat target hilir secara otomatis.