Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Membuat aturan menggunakan Advanced Builder Untuk mengambil tindakan pada acara yang diterima oleh Amazon EventBridge, Anda dapat membuat [aturan](eb-rules.md). Jika suatu peristiwa cocok dengan [pola peristiwa](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 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. Pada halaman pemilihan pembuat aturan, pilih **Advanced Builder**. Advanced Builder menggunakan pola dan konfigurasi JSON untuk aturan dan target. Untuk menggunakan kanvas visual sebagai gantinya, lihat [Membuat aturan (Enhanced Builder)](eb-create-rule-visual.md). 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 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 **Masukkan milik saya** untuk **jenis Acara.** 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 **Skema**, 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 kustom 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 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 **tipe 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.** **\_** **-** (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 **\*** 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 bagaimana 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 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 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 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**.