EventBridge Target Amazon untuk Amazon API Gateway

Anda dapat menggunakan Amazon API Gateway untuk membuat, menerbitkan, memelihara, dan memantau API. Amazon EventBridge mendukung pengiriman peristiwa ke titik akhir API Gateway. Saat Anda menentukan titik akhir API Gateway sebagai target, setiap peristiwa dikirim ke peta target untuk permintaan yang dikirim ke titik akhir.

penting

EventBridge mendukung penggunaan API Gateway Edge-optimized dan endpoint Regional sebagai target. Titik akhir pribadi saat ini tidak didukung. Untuk mempelajari selengkapnya tentang titik akhir, lihat https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-api-endpoint-types.html.

Anda dapat menggunakan target API Gateway untuk kasus penggunaan berikut ini:

• Untuk memanggil API yang ditentukan pelanggan yang dihosting di API Gateway berdasarkan peristiwa AWS atau pihak ketiga.

• Untuk memanggil titik akhir secara berkala pada jadwal.

Informasi peristiwa EventBridge JSON dikirim sebagai badan permintaan HTTP ke titik akhir Anda. Anda dapat menentukan atribut permintaan lainnya di bidang HttpParameters target sebagai berikut:

• Daftar PathParameterValues adalah nilai yang sesuai secara berurutan untuk setiap variabel jalur dalam ARN titik akhir Anda, sebagai contoh "arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*".

• QueryStringParametersmewakili parameter string kueri yang EventBridge ditambahkan ke titik akhir yang dipanggil.

• HeaderParameters menetapkan header HTTP untuk ditambahkan ke permintaan.

catatan

Untuk pertimbangan keamanan, kunci header HTTP berikut ini tidak diizinkan:

• Apa pun diawali dengan X-Amz atau X-Amzn

• Authorization

• Connection

• Content-Encoding

• Content-Length

• Host

• Max-Forwards

• TE

• Transfer-Encoding

• Trailer

• Upgrade

• Via

• WWW-Authenticate

• X-Forwarded-For

Parameter Dinamis

Ketika meminta target API Gateway, secara dinamis Anda dapat menambahkan data ke peristiwa yang dikirim ke target. Untuk informasi selengkapnya, lihat Parameter terget.

Coba Lagi Invokasi

Seperti semua target, EventBridge coba ulang beberapa pemanggilan yang gagal. Untuk API Gateway, EventBridge coba ulang respons yang dikirim dengan kode status HTTP 5xx atau 429 hingga 24 jam dengan mundur dan jitter eksponensial. Setelah itu, EventBridge terbitkan FailedInvocations metrik di Amazon CloudWatch. EventBridge tidak mencoba lagi kesalahan HTTP 4xx lainnya.

Waktu habis

EventBridge aturan Permintaan API Gateway harus memiliki batas waktu eksekusi klien maksimum 5 detik. Jika API Gateway membutuhkan waktu lebih dari 5 detik untuk merespons, EventBridge hentikan permintaan, lalu coba lagi.

EventBridge Permintaan Pipes API Gateway memiliki batas waktu maksimum 29 detik, maksimum API Gateway.