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. Saat peristiwa cocok dengan pola peristiwa yang ditentukan dalam aturan Anda, EventBridge mengirimkan peristiwa ke target yang ditentukan dan memicu tindakan yang ditentukan dalam aturan.
Langkah-langkah berikut memandu Anda melalui cara membuat aturan yang digunakan EventBridge untuk mencocokkan peristiwa saat dikirim ke bus acara yang ditentukan.
Tentukan aturannya
Pertama, masukkan nama dan deskripsi aturan Anda untuk mengidentifikasinya. Anda juga harus menentukan bus acara tempat aturan Anda mencari peristiwa untuk dicocokkan dengan pola peristiwa.
Untuk menentukan detail aturan
Buka EventBridge konsol Amazon di https://console.aws.amazon.com/events/.
-
Di panel navigasi, pilih Aturan.
-
Pilih Buat aturan.
-
Pada halaman pemilihan pembuat aturan, pilih Pembuat Lanjutan.
Advanced Builder menggunakan pola JSON dan konfigurasi untuk aturan dan target. Untuk menggunakan kanvas visual sebagai gantinya, lihat Membuat aturan (Builder yang Ditingkatkan).
-
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 yang sama.
-
Untuk bus acara, pilih bus acara untuk dikaitkan dengan aturan ini. Jika Anda ingin aturan ini mencocokkan peristiwa yang berasal dari akun Anda, pilih bus acara AWS default. Ketika sebuah acara Layanan AWS di akun Anda memancarkan acara, itu selalu masuk ke bus acara default akun Anda.
-
Untuk Tipe aturan, pilih Aturan dengan pola peristiwa.
-
Pilih Selanjutnya.
Bangun pola peristiwa
Selanjutnya, bangun pola acara. Untuk melakukan ini, tentukan sumber peristiwa, pilih dasar untuk pola peristiwa, dan tentukan atribut dan nilai yang akan dicocokkan. Anda juga dapat menghasilkan pola peristiwa di JSON dan mengujinya terhadap peristiwa sampel.
Untuk membangun pola acara
-
Untuk Sumber acara, pilih AWS acara atau acara EventBridge mitra.
-
(Opsional) Di bagian Contoh peristiwa, pilih jenis peristiwa Sampel yang ingin Anda uji pola acara.
Contoh jenis acara berikut tersedia:
-
AWS peristiwa — Pilih dari acara yang dipancarkan dari yang didukung Layanan AWS.
-
EventBridge acara mitra — Pilih dari acara yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.
-
Masukkan milik saya sendiri — Masukkan acara Anda sendiri dalam teks JSON.
Anda juga dapat menggunakan acara AWS atau mitra sebagai titik awal untuk membuat acara khusus Anda sendiri.
Pilih AWS acara atau acara EventBridge mitra.
Gunakan dropdown Contoh acara untuk memilih acara yang ingin Anda gunakan sebagai titik awal untuk acara kustom Anda.
EventBridge menampilkan acara sampel.
Pilih Salin.
Pilih Masukkan milik saya untuk Jenis acara.
Hapus struktur acara sampel di panel pengeditan JSON, dan tempel acara mitra AWS atau di tempatnya.
Edit JSON acara untuk membuat acara sampel Anda sendiri.
-
Pilih metode pen ciptaan. Anda dapat membuat pola acara dari EventBridge skema atau templat, atau Anda dapat membuat pola acara khusus.
- Existing schema
-
Untuk menggunakan EventBridge skema yang ada untuk membuat pola acara, lakukan hal berikut:
-
Di bagian Metode pembuatan, untuk Metode, pilih Gunakan skema.
-
Di bagian Pola peristiwa, untuk Jenis skema, pilih Pilih skema dari registri skema.
-
Untuk registri skema, pilih kotak dropdown dan masukkan nama registri skema, sepertiaws.events. Anda juga dapat memilih opsi dari daftar dropdown yang muncul.
-
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.
-
Di bagian Model, pilih tombol Edit di sebelah atribut apa pun untuk membuka propertinya. Atur bidang Rel ation ship dan Value sesuai kebutuhan, lalu pilih Set untuk menyimpan atribut.
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 dari kotak dialog properti atribut.
Untuk menghapus properti atribut, pilih tombol Edit untuk atribut tersebut, lalu pilih H apus.
-
Pilih Hasilkan pola acara di JSON untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON.
-
(Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih P ola uji.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
-
Sal in — 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 khusus dan mengubahnya menjadi pola peristiwa, lakukan hal berikut:
-
Di bagian Metode pembuatan, untuk Metode, pilih Gunakan skema.
-
Di bagian Pola peristiwa, untuk Jenis skema, pilih Masukkan skema.
-
Masukkan skema Anda ke dalam kotak teks. Anda harus memformat skema sebagai teks JSON yang valid.
-
Di bagian Model, pilih tombol Edit di sebelah atribut apa pun untuk membuka propertinya. Atur bidang Rel ation ship dan Value sesuai kebutuhan, lalu pilih Set untuk menyimpan atribut.
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 dari kotak dialog properti atribut.
Untuk menghapus properti atribut, pilih tombol Edit untuk atribut tersebut, lalu pilih H apus.
-
Pilih Hasilkan pola acara di JSON untuk menghasilkan dan memvalidasi pola acara Anda sebagai teks JSON.
-
(Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih P ola uji.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
-
Sal in — 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:
-
Di bagian Metode pembuatan, untuk Metode, pilih Pola kustom (editor JSON).
-
Untuk Pola acara, masukkan pola acara kustom Anda dalam JSON-formatted teks.
-
(Opsional) Untuk menguji peristiwa sampel terhadap pola pengujian Anda, pilih P ola uji.
EventBridge menampilkan kotak pesan yang menyatakan apakah acara sampel Anda cocok dengan pola acara.
Anda juga dapat memilih salah satu opsi berikut:
-
Sal in — Salin pola acara ke clipboard perangkat Anda.
-
Prettify - Membuat teks JSON lebih mudah dibaca dengan menambahkan jeda baris, tab, dan spasi.
-
Formulir pola acara - Membuka pola acara di Pembuat Pola. Jika pola tidak dapat dirender di Pattern Builder apa adanya, EventBridge memperingatkan Anda sebelum membuka Pattern Builder.
-
Pilih Berikutnya.
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
-
Untuk Jenis Target, pilih salah satu jenis target berikut:
- Event bus
-
Pilih bus EventBridge acara.
Pilih bus acara untuk digunakan sebagai target.
-
Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, Anda EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda dapat dijalankan.
Untuk peran Eksekusi, lakukan salah satu hal berikut:
-
(Opsional) Untuk Pengaturan tambahan, tentukan salah satu pengaturan opsional yang tersedia untuk jenis target Anda:
(Opsional) Untuk Dead-letter antrian, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrean 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.
- API destination
-
Pilih tujuan EventBridge API.
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 titik akhir harus dimulai denganhttps. 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 laju 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 koneksi baru untuk tujuan ini pilih Buat koneksi baru, lalu tentukan Nama koneksi, Jenis Tujuan, dan Jenis O torisasi. Anda juga dapat menambahkan Deskripsi opsional untuk koneksi ini.
-
Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, Anda EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda dapat dijalankan.
Untuk peran Eksekusi, lakukan salah satu hal berikut:
-
(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.
-
(Opsional) Untuk Konfigurasikan input target, pilih cara Anda ingin menyesuaikan teks yang dikirim ke target untuk acara pencocokan. Pilih salah satu cara berikut:
-
Peristiwa yang cocok — EventBridge mengirimkan seluruh peristiwa 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 T entukan bagian dari acara yang cocok, tentukan jalur JSON yang mendefinisikan bagian acara yang EventBridge ingin Anda kirim ke target.
-
Konstan (teks JSON) — hanya EventBridge mengirimkan teks JSON yang ditentukan ke target. Tidak ada bagian dari peristiwa sumber asli yang dikirim.
Di bawah T entukan konstanta di JSON, tentukan teks JSON yang EventBridge ingin Anda kirim ke target alih-alih acara.
-
Input transformer — Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.
-
(Opsional) Di bawah Kebijakan C oba Ulang EventBridge , tentukan cara mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.
-
Usia maksimum acara — Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan peristiwa yang belum diproses. Defaultnya adalah 24 jam.
-
Coba lagi — Masukkan jumlah maksimum yang EventBridge harus dicoba lagi mengirim peristiwa ke target setelah kesalahan terjadi. Defaultnya adalah 185 kali.
-
(Opsional) Untuk Dead-letter antrian, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrean huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
-
Pilih Tidak ada untuk tidak menggunakan antrean surat mati.
-
Pilih Pilih antrian Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati, lalu pilih antri an 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 antrian tersebut.
Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.
Untuk informasi selengkapnya, lihat Tujuan API sebagai target di Amazon EventBridge.
- Layanan AWS
-
Pilih Layanan AWS.
-
Untuk Pilih target, pilih Layanan AWS yang akan digunakan sebagai target.
-
Jika Anda memilih AWS layanan yang mendukung target lintas akun, Anda dapat memilih target di akun yang sama dengan bus acara, atau akun yang berbeda.
Untuk target di akun yang sama, untuk Jenis Target pilih Target di akun ini.
Berikan informasi yang diminta untuk layanan yang Anda pilih.
-
Untuk sebagian besar tipe target, EventBridge membutuhkan izin untuk mengirim kejadian ke target. Dalam kasus ini, Anda EventBridge dapat membuat peran IAM yang diperlukan agar aturan Anda dapat berjalan.
Untuk peran Eksekusi, lakukan salah satu hal berikut:
Jika manajer peran diaktifkan di akun Anda, EventBridge lampirkan peran untuk Anda. EventBridge menggantikan opsi Buat peran baru untuk sumber daya spesifik ini dan Gunakan peran yang ada dengan opsi Ku stom isasi. Untuk menggunakan peran yang berbeda, pilih Sesuaikan. Untuk informasi selengkapnya, lihat Pembuatan peran IAM dalam Panduan Pengguna IAM.
Untuk target di akun yang berbeda, untuk Jenis Target pilih Target di AWS akun lain.
Masukkan ARN sumber daya target yang ingin Anda kirim acara.
Berikan informasi tambahan apa pun yang diminta untuk layanan yang Anda pilih.
Pilih nama peran eksekusi yang akan digunakan dari daftar dropdown.
-
(Opsional) Untuk Pengaturan tambahan, tentukan salah satu pengaturan opsional yang tersedia untuk jenis target Anda:
-
(Opsional) Untuk Konfigurasikan input target, pilih cara Anda ingin menyesuaikan teks yang dikirim ke target untuk acara pencocokan. Pilih salah satu cara berikut:
-
Peristiwa yang cocok — EventBridge mengirimkan seluruh peristiwa 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 T entukan bagian dari acara yang cocok, tentukan jalur JSON yang mendefinisikan bagian acara yang EventBridge ingin Anda kirim ke target.
-
Konstan (teks JSON) — hanya EventBridge mengirimkan teks JSON yang ditentukan ke target. Tidak ada bagian dari peristiwa sumber asli yang dikirim.
Di bawah T entukan konstanta di JSON, tentukan teks JSON yang EventBridge ingin Anda kirim ke target alih-alih acara.
-
Input transformer — Konfigurasikan transformator input untuk menyesuaikan teks yang ingin Anda EventBridge kirim ke target. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.
-
(Opsional) Di bawah Kebijakan C oba Ulang EventBridge , tentukan cara mencoba lagi mengirim peristiwa ke target setelah terjadi kesalahan.
-
Usia maksimum acara — Masukkan jumlah waktu maksimum (dalam jam, menit, dan detik) EventBridge untuk mempertahankan peristiwa yang belum diproses. Defaultnya adalah 24 jam.
-
Coba lagi — Masukkan jumlah maksimum yang EventBridge harus dicoba lagi mengirim peristiwa ke target setelah kesalahan terjadi. Defaultnya adalah 185 kali.
-
(Opsional) Untuk Dead-letter antrian, pilih apakah akan menggunakan antrian Amazon SQS standar sebagai antrian huruf mati. EventBridge mengirimkan peristiwa yang cocok dengan aturan ini ke antrean huruf mati jika tidak berhasil dikirim ke target. Lakukan salah satu tindakan berikut:
-
Pilih Tidak ada untuk tidak menggunakan antrean surat mati.
-
Pilih Pilih antrian Amazon SQS di AWS akun saat ini untuk digunakan sebagai antrian huruf mati, lalu pilih antri an 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 antrian tersebut.
Untuk informasi selengkapnya, lihat Memberikan izin untuk antrean surat mati.
-
(Opsional) Pilih Tambahkan target lain untuk menambahkan target lain untuk aturan ini.
-
Pilih Berikutnya.
Konfigurasikan tag dan aturan peninjauan
Terakhir, masukkan tag yang diinginkan untuk aturan, lalu tinjau dan buat aturan.
Untuk mengkonfigurasi tag, dan meninjau serta membuat aturan
-
(Opsional) Masukkan satu atau lebih tanda untuk aturan. Untuk informasi selengkapnya, lihat Menandai sumber daya di Amazon EventBridge.
-
Pilih Berikutnya.
-
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.
