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
<a name="eb-api-gateway-target"></a>

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](eb-targets.md), setiap [peristiwa](eb-events.md) 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](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/*/*"`.
+ `QueryStringParameters`mewakili 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
<a name="eb-targets-apigateway-dynamic"></a>

Ketika meminta target API Gateway, secara dinamis Anda dapat menambahkan data ke peristiwa yang dikirim ke target. Untuk informasi selengkapnya, lihat [Parameter terget](eb-targets.md#targets-specific-parms).

## Coba Lagi Invokasi
<a name="eb-targets-apigateway-retries"></a>

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](https://aws.amazon.com/blogs/architecture/exponential-backoff-and-jitter/). Setelah itu, EventBridge terbitkan `FailedInvocations` metrik di Amazon CloudWatch. EventBridge tidak mencoba lagi kesalahan HTTP 4xx lainnya.

## Waktu habis
<a name="eb-targets-apigateway-timeout"></a>

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.