Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Amazon API Gateway menargetkan aturan di Amazon EventBridge
Anda dapat menggunakan Amazon API Gateway untuk membuat, menerbitkan, memelihara, dan memantau APIs. 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
PathParameterValuesadalah 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. -
HeaderParametersmenetapkan header HTTP untuk ditambahkan ke permintaan.
catatan
Untuk pertimbangan keamanan, kunci header HTTP berikut ini tidak diizinkan:
-
Apa pun diawali dengan
X-AmzatauX-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 eksponensialFailedInvocations metrik di Amazon CloudWatch. EventBridge tidak mencoba lagi kesalahan HTTP 4xx lainnya.
Batas waktu
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, hapus EventBridge waktu permintaan, lalu coba lagi.
EventBridge Permintaan Pipes API Gateway memiliki batas waktu maksimum 29 detik, maksimum API Gateway.