Mengkonfigurasi transformator input saat membuat aturan di EventBridge

Sebagai bagian dari pembuatan aturan, Anda dapat menentukan transformator input EventBridge untuk digunakan untuk memproses peristiwa pencocokan sebelum mengirim peristiwa tersebut ke target yang ditentukan. Anda dapat mengonfigurasi transformator input untuk target yang merupakan AWS layanan atau API tujuan.

Untuk membuat transformator input target sebagai bagian dari aturan

1. Ikuti langkah-langkah untuk membuat aturan seperti yang dijelaskan dalamMembuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge.

2. Di Langkah 3 - Pilih target, perluas Pengaturan tambahan.

3. Untuk Konfigurasi input target, pilih Input transformator di dropdown.

   Klik Konfigurasi transformator input.

   EventBridge menampilkan kotak dialog Configure input transformator.

4. Di bagian Contoh peristiwa, pilih jenis acara Contoh yang ingin Anda uji pola acara Anda. Anda dapat memilih AWS acara, acara mitra, atau memasukkan acara khusus Anda sendiri.

   AWS events

   Pilih dari peristiwa yang dipancarkan dari yang didukung. Layanan AWS

   1. Pilih AWS acara.

   2. Di bawah Contoh peristiwa, pilih AWS acara yang diinginkan. Acara diselenggarakan oleh AWS layanan.

      Saat Anda memilih acara, EventBridge mengisi contoh acara.

      Misalnya, jika Anda memilih S3 Object Created, EventBridge menampilkan contoh acara S3 Object Created.

   3. (Opsional) Anda juga dapat memilih Salin untuk menyalin contoh peristiwa ke clipboard perangkat Anda.

   Partner events

   Pilih dari peristiwa yang dipancarkan dari layanan pihak ketiga yang mendukung EventBridge, seperti Salesforce.

   1. Pilih acara EventBridge mitra.

   2. Di bawah Contoh acara, pilih acara mitra yang diinginkan. Acara diselenggarakan oleh mitra.

      Saat Anda memilih acara, EventBridge mengisi contoh acara.

   3. (Opsional) Anda juga dapat memilih Salin untuk menyalin contoh peristiwa ke clipboard perangkat Anda.

   Enter your own

   Masukkan acara Anda sendiri dalam JSON teks.

   1. Pilih Masukkan milik Anda sendiri.

   2. EventBridge mengisi acara sampel dengan template atribut acara yang diperlukan.

   3. Edit dan tambahkan ke acara sampel sesuai keinginan. Contoh acara harus validJSON.

   4. (Opsional) Anda juga dapat memilih salah satu opsi berikut:

      • Salin - Salin contoh acara ke clipboard perangkat Anda.

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

5. (Opsional) Perluas jalur masukan Contoh, Template dan Output bagian untuk melihat contoh:

   • Bagaimana JSON jalur digunakan untuk mendefinisikan variabel yang mewakili data peristiwa

   • Bagaimana variabel-variabel tersebut dapat digunakan dalam template transformator input

   • Output yang dihasilkan yang EventBridge mengirim ke target

   Untuk contoh transformasi input yang lebih rinci, lihatContoh transformasi masukan.

6. Di bagian Transformator input target, tentukan variabel apa pun yang ingin Anda gunakan dalam template input.

   Variabel menggunakan JSON jalur untuk referensi nilai dalam sumber peristiwa asli. Anda kemudian dapat mereferensikan variabel-variabel tersebut dalam template input untuk memasukkan data dari peristiwa sumber asli dalam peristiwa yang diubah yang EventBridge lolos ke target. Anda dapat menentukan hingga 100 variabel. Transformator input harus validJSON.

   Misalnya, Anda telah memilih AWS acara S3 Object Created sebagai contoh acara Anda untuk transformator input ini. Anda kemudian dapat menentukan variabel berikut untuk digunakan dalam template Anda:

   {
     "requester": "$.detail.requester",
     "key": "$.detail.object.key",
     "bucket": "$.detail.bucket.name"
   }

   (Opsional) Anda juga dapat memilih Salin untuk menyalin transformator input ke clipboard perangkat Anda.

7. Di bagian Template, tulis template yang ingin Anda gunakan untuk menentukan apa yang EventBridge lolos ke target.

   Anda dapat menggunakanJSON, string, informasi statis, variabel yang telah Anda definisikan serta variabel cadangan. Untuk contoh transformasi input yang lebih rinci, lihatContoh transformasi masukan.

   Misalnya, Anda telah mendefinisikan variabel dalam contoh sebelumnya. Anda kemudian dapat membuat template berikut, yang mereferensikan variabel-variabel tersebut, serta variabel cadangan, dan informasi statis.

   {
       "message": "<requester> has created the object \"<key>\" in the bucket \"<bucket>\"",
       "RuleName": <aws.events.rule-name>,
       "ruleArn" : <aws.events.rule-arn>,
       "Transformed": "Yes"
   }

   (Opsional) Anda juga dapat memilih Salin untuk menyalin template ke clipboard perangkat Anda.

8. Untuk menguji template Anda, pilih Hasilkan output.

   EventBridge memproses peristiwa sampel berdasarkan template input, dan menampilkan output yang diubah yang dihasilkan di bawah Output. Ini adalah informasi yang EventBridge akan diteruskan ke target di tempat acara sumber asli.

   Output yang dihasilkan untuk contoh template input yang dijelaskan di atas adalah sebagai berikut:

   {
       "message": "123456789012 has created the object "example-key" in the bucket "example-bucket"",
       "RuleName": rule-name,
       "ruleArn" : arn:aws:events:us-east-1:123456789012:rule/rule-name,
       "Transformed": "Yes"
   }

   (Opsional) Anda juga dapat memilih Salin untuk menyalin output yang dihasilkan ke clipboard perangkat Anda.

9. Pilih Konfirmasi

10. Ikuti langkah-langkah lainnya untuk membuat aturan seperti yang dijelaskan dalamMembuat aturan yang bereaksi terhadap peristiwa di Amazon EventBridge.