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 memantauAPIs. 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 ke permintaan yang dikirim ke titik akhir.
penting
EventBridge mendukung penggunaan titik akhir yang dioptimalkan oleh API Gateway Edge dan 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:
-
Untuk memanggil API host yang ditentukan pelanggan di API Gateway berdasarkan peristiwa AWS atau pihak ketiga.
-
Untuk memanggil titik akhir secara berkala pada jadwal.
Informasi EventBridge JSON acara dikirim sebagai badan HTTP permintaan ke titik akhir Anda. Anda dapat menentukan atribut permintaan lainnya di bidang HttpParameters
target sebagai berikut:
-
PathParameterValues
mencantumkan nilai yang sesuai secara berurutan dengan variabel jalur apa pun di titik akhir AndaARN, misalnya."arn:aws:execute-api:us-east-1:112233445566:myapi/dev/POST/pets/*/*"
-
QueryStringParameters
mewakili parameter string kueri yang EventBridge ditambahkan ke titik akhir yang dipanggil. -
HeaderParameters
mendefinisikan HTTP header untuk ditambahkan ke permintaan.
catatan
Untuk pertimbangan keamanan, kunci HTTP header berikut tidak diizinkan:
-
Apa pun diawali dengan
X-Amz
atauX-Amzn
-
Authorization
-
Connection
-
Content-Encoding
-
Content-Length
-
Host
-
Max-Forwards
-
TE
-
Transfer-Encoding
-
Trailer
-
Upgrade
-
Via
-
WWW-Authenticate
-
X-Forwarded-For
Parameter Dinamis
Saat menjalankan target API Gateway, Anda dapat menambahkan data secara dinamis 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 tanggapan yang dikirim dengan kode HTTP status 5xx atau 429 hingga 24 jam dengan mundur dan jitter eksponensialFailedInvocations
metrik di Amazon CloudWatch. EventBridge tidak mencoba lagi kesalahan 4xx HTTP 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.