Mengirim CloudEvents acara ke tujuan API

CloudEvents adalah spesifikasi vendor netral untuk pemformatan acara, dengan tujuan menyediakan interoperabilitas di seluruh layanan, platform, dan sistem. Anda dapat menggunakan EventBridge untuk mengubah peristiwa AWS layanan CloudEvents sebelum dikirim ke target, seperti tujuan API.

catatan

Prosedur berikut menjelaskan cara mengubah peristiwa sumber menjadi mode terstruktur CloudEvents. Dalam CloudEvents spesifikasi, pesan mode terstruktur adalah pesan di mana seluruh peristiwa (atribut dan data) dikodekan ke dalam muatan acara.

Untuk informasi selengkapnya tentang CloudEvents spesifikasi, lihat cloudevents.io.

Untuk mengubah AWS peristiwa ke CloudEvents format menggunakan konsol

Untuk mengubah acara ke CloudEvents format sebelum pengiriman ke target, Anda mulai dengan membuat aturan bus acara. Sebagai bagian dari mendefinisikan aturan, Anda menggunakan transformator input untuk EventBridge mengubah peristiwa sebelum mengirim ke target yang Anda tentukan.

1. Ikuti langkah-langkah dalam Membuat EventBridge aturan Amazon yang bereaksi terhadap peristiwa prosedur.

2. Pada Pilih target langkahnya, saat diminta untuk memilih tujuan API sebagai tipe target:

   1. Pilih tujuan EventBridge API.

   2. Lakukan salah satu hal berikut ini:

      • Pilih Gunakan tujuan API yang ada dan pilih tujuan API yang ada

      • Pilih Buat tujuan API baru dan tentukan setelan yang diperlukan untuk menentukan tujuan API baru Anda.

        Untuk informasi selengkapnya tentang menentukan pengaturan yang diperlukan, lihatBuat tujuan API.

   3. Tentukan parameter header Content-Type yang diperlukan untuk acara: CloudEvents

      • Di bawah Parameter Header pilih Tambahkan parameter header.

      • Untuk kunci, tentukanContent-Type.

        Untuk nilai, tentukanapplication/cloudevents+json; charset=UTF-8.

3. Tentukan peran eksekusi untuk target Anda.

4. Tentukan transformator input untuk mengubah data peristiwa sumber ke dalam CloudEvents format:

   1. Di bawah Pengaturan tambahan, untuk Konfigurasi input target, pilih Transformator input.

      Kemudian pilih Konfigurasi transformator input.

   2. Di bawah Transformator input target, tentukan jalur Input.

      Di jalur input di bawah ini, atribut region adalah atribut ekstensi kustom dari CloudEvents format. Karena itu tidak diperlukan untuk kepatuhan terhadap CloudEvents spesifikasi.

      CloudEvents memungkinkan Anda untuk menggunakan dan membuat atribut ekstensi yang tidak ditentukan dalam spesifikasi inti. Untuk informasi selengkapnya, termasuk daftar atribut ekstensi yang diketahui, lihat Atribut CloudEvents Ekstensi dalam dokumentasi CloudEvents spesifikasi pada GitHub.

      {
        "detail": "$.detail",
        "detail-type": "$.detail-type",
        "id": "$.id",
        "region": "$.region",
        "source": "$.source",
        "time": "$.time"
      }

   3. Untuk Template, masukkan template untuk mengubah data peristiwa sumber ke CloudEvents format.

      Dalam template di bawah region ini, tidak sepenuhnya diperlukan, karena region atribut di jalur input adalah atribut ekstensi untuk CloudEvents spesifikasi.

      {
        "specversion":"1.0",
        "id":<id>,
        "source":<source>,
        "type":<detail-type>,
        "time":<time>,
        "region":<region>,
        "data":<detail>
      }

5. Selesaikan pembuatan aturan mengikuti langkah-langkah prosedur.