

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

# Tutorial: Gunakan transformator input untuk mengubah acara EventBridge
<a name="eb-input-transformer-tutorial"></a>

Anda dapat menggunakan [transformator Input](eb-transform-target-input.md) EventBridge untuk menyesuaikan teks dari suatu [peristiwa](eb-events.md) sebelum Anda mengirimkannya ke target [aturan](eb-rules.md). 

Untuk melakukan ini, Anda menentukan jalur JSON dari acara tersebut dan menetapkan output mereka ke variabel yang berbeda. Kemudian Anda dapat menggunakan variabel-variabel dalam templat masukan. Karakter < and > tidak dapat lepas. Untuk informasi selengkapnya, lihat [Transformasi EventBridge masukan Amazon](eb-transform-target-input.md)

**catatan**  
Jika Anda menentukan variabel untuk mencocokkan jalur JSON yang tidak ada dalam acara, variabel tersebut tidak dibuat dan tidak muncul dalam output.

Dalam tutorial ini, Anda membuat aturan yang cocok dengan acara`detail-type: "customerCreated"`. Transformator input memetakan `type` variabel ke jalur JSON tipe \$1.detail-dari acara tersebut. Kemudian EventBridge menempatkan variabel ke dalam template masukan “Peristiwa ini adalah<type>.” Hasilnya adalah pesan Amazon SNS berikut.

```
"This event was of customerCreated type."
```

**Topics**
+ [Langkah 1: Buat topik Amazon SNS](#eb-input-transformer-tutorial-create-topic)
+ [Langkah 2: Buat langganan Amazon SNS](#eb-input-transformer-tutorial-create-sns)
+ [Langkah 3: Buat aturan](#eb-input-transformer-create-rule)
+ [Langkah 4: Kirim acara uji](#eb-input-transformer-send-test-events)
+ [Langkah 5: Mengonfirmasi keberhasilan](#success)
+ [Langkah 6: Bersihkan sumber daya Anda](#cleanup)

## Langkah 1: Buat topik Amazon SNS
<a name="eb-input-transformer-tutorial-create-topic"></a>

Buat topik untuk menerima acara dari EventBridge.

**Cara membuat topik**

1. [Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home)

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

1. Pilih **Buat topik**.

1. Untuk **Tipe**, pilih **Standar**.

1. Masukkan **eventbridge-IT-test** sebagai nama topik.

1. Pilih **Buat topik**.

## Langkah 2: Buat langganan Amazon SNS
<a name="eb-input-transformer-tutorial-create-sns"></a>

Buat langganan untuk mendapatkan email dengan informasi yang diubah.

**Untuk membuat langganan**

1. [Buka konsol Amazon SNS di https://console.aws.amazon.com/sns/ v3/home.](https://console.aws.amazon.com/sns/v3/home)

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

1. Pilih **Buat langganan**.

1. Untuk **Topik ARN**, pilih topik yang Anda buat di langkah 1. Untuk tutorial ini, pilih **EventBridge-it-Test**.

1. Untuk **Protokol**, pilih **Email**.

1. Untuk **Titik Akhir**, masukkan alamat email Anda.

1. Pilih **Buat langganan**.

1. Konfirmasikan langganan dengan memilih **Konfirmasi langganan** di email yang Anda terima dari AWS notifikasi.

## Langkah 3: Buat aturan
<a name="eb-input-transformer-create-rule"></a>

Buat aturan untuk menggunakan trafo input untuk menyesuaikan informasi keadaan instans yang masuk ke target.

**Untuk membuat tabel**

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 deskripsi aturan. Misalnya, beri nama aturan `ARTestRule`

1. Untuk **bus acara**, pilih bus acara yang ingin Anda kaitkan dengan aturan ini. Jika Anda ingin aturan ini cocok dengan peristiwa yang berasal dari akun Anda, pilih **default**. Saat layanan AWS di akun Anda menghasilkan kejadian, layanan tersebut akan selalu masuk ke bus kejadian default akun Anda.

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

1. Pilih **Selanjutnya**.

1. Untuk **sumber acara**, pilih **Lainnya**.

1. Untuk **pola Event**, masukkan yang berikut ini:

   ```
   {
     "detail-type": [
       "customerCreated"
     ]
   }
   ```

1. Pilih **Berikutnya**.

1. Untuk **Jenis target**, pilih **Layanan AWS **.

1. Untuk **Pilih target**, pilih **topik SNS** dari daftar drop-down.

1. Untuk **Topik**, pilih topik Amazon SNS yang Anda buat di langkah 1. Untuk tutorial ini, pilih **EventBridge-it-Test**.

1. Untuk **pengaturan tambahan**, lakukan hal berikut:

   1. Untuk **Konfigurasi input target**, pilih **Input transformator** dari daftar drop-down.

   1. Pilih **Konfigurasi transformator input**

   1. untuk **Contoh acara**, masukkan yang berikut ini:

      ```
      {
        "detail-type": "customerCreated"
      }
      ```

   1. Untuk **transformator input Target** lakukan hal berikut:

      1. Untuk **Jalur Input**, masukkan yang berikut ini:

         ```
         {"detail-type":"$.detail-type"}
         ```

      1. Untuk **Template Input**, masukkan yang berikut ini:

         ```
         "This event was of <detail-type> type."
         ```

   1. Pilih **Konfirmasi.** .

1. Pilih **Berikutnya**.

1. Pilih **Berikutnya**.

1. Tinjau detail aturan dan pilih **Buat aturan**.

## Langkah 4: Kirim acara uji
<a name="eb-input-transformer-send-test-events"></a>

Sekarang setelah Anda menyiapkan topik SNS dan aturannya, kami akan mengirim acara pengujian untuk memastikan aturan berfungsi dengan benar.

**Untuk mengirim acara pengujian (konsol)**

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

1. Di panel navigasi, pilih **Bus peristiwa**.

1. Di ubin **bus acara default**, pilih **Tindakan**, **Kirim acara**.

1. Masukkan sumber acara. Misalnya, `TestEvent`.

1. Untuk **tipe Detail**, masukkan`customerCreated`.

1. Untuk **detail Acara**, masukkan`{}`.

1. Pilih **Kirim**.

## Langkah 5: Mengonfirmasi keberhasilan
<a name="success"></a>

Jika Anda mendapatkan email dari AWS notifikasi yang cocok dengan output yang diharapkan, Anda telah berhasil menyelesaikan tutorial.

## Langkah 6: Bersihkan sumber daya Anda
<a name="cleanup"></a>

Sekarang Anda dapat menghapus sumber daya yang Anda buat untuk tutorial ini, kecuali Anda ingin mempertahankan itu. Dengan menghapus AWS sumber daya yang tidak lagi Anda gunakan, Anda mencegah tagihan yang tidak perlu ke AWS akun Anda.

**Untuk menghapus topik SNS**

1. Buka [halaman Topik](https://console.aws.amazon.com/sns/v3/home#/topics) konsol SNS.

1. Pilih topik yang Anda buat.

1. Pilih **Hapus**.

1. Masukkan **delete me**.

1. Pilih **Hapus**.

**Untuk menghapus langganan SNS**

1. Buka [halaman Langganan](https://console.aws.amazon.com/sns/v3/home#/subscriptions) konsol SNS.

1. Pilih langganan yang Anda buat.

1. Pilih **Hapus**.

1. Pilih **Hapus**.

**Untuk menghapus EventBridge aturan**

1. Buka [halaman Aturan](https://console.aws.amazon.com/events/home#/rules) EventBridge konsol.

1. Pilih aturan yang Anda buat.

1. Pilih **Hapus**.

1. Pilih **Hapus**.