APItujuan sebagai target aturan di Amazon EventBridge

EventBridge APITujuan Amazon adalah HTTP titik akhir yang dapat Anda panggil sebagai target aturan, mirip dengan cara Anda memanggil AWS layanan atau sumber daya sebagai target. Menggunakan API tujuan, Anda dapat merutekan acara antar AWS layanan, aplikasi perangkat lunak terintegrasi sebagai layanan (SaaS), dan aplikasi Anda di luar AWS dengan menggunakan API panggilan. Ketika Anda menentukan API tujuan sebagai target aturan, EventBridge memanggil HTTP titik akhir untuk setiap peristiwa yang cocok dengan pola peristiwa yang ditentukan dalam aturan dan kemudian mengirimkan informasi peristiwa dengan permintaan. Dengan EventBridge, Anda dapat menggunakan HTTP metode apa pun kecuali CONNECT dan TRACE untuk permintaan. HTTPMetode yang paling umum digunakan adalah PUT danPOST. Anda juga dapat menggunakan transformator input untuk menyesuaikan peristiwa dengan parameter parameter titik HTTP akhir tertentu. Untuk informasi selengkapnya, lihat Transformasi EventBridge masukan Amazon.

catatan

APItujuan tidak mendukung tujuan pribadi, seperti VPC titik akhir antarmuka - termasuk pribadi HTTPS APIs di Virtual Private Clouds (VPC) menggunakan Jaringan pribadi dan Application Load Balancer dan titik akhir antarmuka. VPC

Untuk informasi selengkapnya, lihat Menggunakan Amazon EventBridge dengan titik VPC akhir Antarmuka.

penting

EventBridge permintaan ke titik akhir API tujuan harus memiliki batas waktu eksekusi klien maksimum 5 detik. Jika titik akhir target membutuhkan waktu lebih dari 5 detik untuk merespons, EventBridge hentikan permintaan. EventBridge percobaan ulang permintaan habis waktu hingga maksimum yang dikonfigurasi pada kebijakan coba ulang Anda. Secara default maksimal adalah 24 jam dan 185 kali. Setelah jumlah maksimum coba lagi, peristiwa dikirim ke antrean surat mati Anda jika Anda memilikinya. Jika tidak, peristiwa digagalkan.

Video berikut menunjukkan penggunaan API tujuan:

Peran terkait layanan untuk tujuan API

Saat Anda membuat sambungan untuk API tujuan, nama peran terkait layanan akan AWS ServiceRoleForAmazonEventBridgeApiDestinationsditambahkan ke akun Anda. EventBridge menggunakan peran terkait layanan untuk membuat dan menyimpan rahasia di Secrets Manager. Untuk memberikan izin yang diperlukan ke peran terkait layanan, EventBridge lampirkan AmazonEventBridgeApiDestinationsServiceRolePolicykebijakan ke peran tersebut. Kebijakan membatasi izin yang diberikan hanya kepada mereka yang diperlukan bagi peran untuk berinteraksi dengan rahasia untuk koneksi. Tidak ada izin lain yang disertakan, dan peran hanya dapat berinteraksi dengan koneksi di akun Anda untuk mengelola rahasia.

Kebijakan berikut adalahAmazonEventBridgeApiDestinationsServiceRolePolicy.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "secretsmanager:CreateSecret",
                "secretsmanager:UpdateSecret",
                "secretsmanager:DescribeSecret",
                "secretsmanager:DeleteSecret",
                "secretsmanager:GetSecretValue",
                "secretsmanager:PutSecretValue"
            ],
            "Resource": "arn:aws:secretsmanager:*:*:secret:events!connection/*"
        }
    ]
}

Untuk informasi selengkapnya tentang peran terkait layanan, lihat Menggunakan peran terkait layanan dalam dokumentasi. IAM

Ketersediaan wilayah

Peran AmazonEventBridgeApiDestinationsServiceRolePolicy terkait layanan didukung di wilayah berikut: AWS

• AS Timur (N. Virginia)

• AS Timur (Ohio)

• AS Barat (California Utara)

• AS Barat (Oregon)

• Afrika (Cape Town)

• Asia Pasifik (Hong Kong)

• Asia Pasifik (Mumbai)

• Asia Pasifik (Osaka)

• Asia Pasifik (Seoul)

• Asia Pasifik (Singapura)

• Asia Pasifik (Sydney)

• Asia Pasifik (Tokyo)

• Kanada (Pusat)

• Eropa (Frankfurt)

• Eropa (Irlandia)

• Eropa (London)

• Eropa (Milan)

• Eropa (Paris)

• Eropa (Stockholm)

• Amerika Selatan (Sao Paulo)

• Tiongkok (Ningxia)

• Tiongkok (Beijing)

Header dalam permintaan ke tujuan API

Bagian berikut merinci cara EventBridge menangani HTTP header dalam permintaan ke API tujuan.

Header termasuk dalam permintaan ke tujuan API

Selain header otorisasi yang ditentukan untuk koneksi yang digunakan untuk API tujuan, EventBridge termasuk header berikut di setiap permintaan.

Kunci header	Nilai header
User-Agent	Amazon//EventBridgeApiDestinations
Content-Type	Jika tidak ada nilai Content-Type kustom yang ditentukan, EventBridge sertakan nilai default berikut sebagai Content-Type: application/json; charset=utf-8
Kisaran	bytes=0-1048575
Terima-Pengenkodean	gzip,mengempis
Koneksi	tutup
Panjang Konten	Header entitas yang menunjukkan ukuran bodi entitas, dalam byte, yang dikirim ke penerima.
Host	Header permintaan yang menentukan host dan nomor port server di mana permintaan sedang dikirim.

Header yang tidak dapat diganti dalam permintaan ke tujuan API

EventBridge tidak memungkinkan Anda untuk mengganti header berikut:

• User-Agent

• Kisaran

Header EventBridge menghapus dari permintaan ke tujuan API

EventBridge menghapus header berikut untuk semua permintaan API tujuan:

• A-IM

• Terima-Charset

• Terima-Datetime

• Terima-Pengenkodean

• Cache-Control

• Koneksi

• Pengkodean Konten

• Content-Length

• Konten- MD5

• Tanggal

• Harapkan

• Diteruskan

• Dari

• Host

• HTTP2-Pengaturan

• Jika-Pertandingan

• Jika-Modifikasi-Sejak

• Jika-Tidak Pertandingan

• Jika-Rentang

• Jika-Tidak Dimodifikasi-Sejak

• Max-Maju

• Asal

• Pragma

• Otorisasi Proksi

• Kisaran

• Perujuk

• TE

• Trailer

• Transfer-Encoding

• User-Agent

• Peningkatan

• Melalui

• Peringatan

APIkode kesalahan tujuan

Saat EventBridge mencoba mengirimkan acara ke API tujuan dan terjadi kesalahan, EventBridge lakukan hal berikut:

• Peristiwa yang terkait dengan kode kesalahan 409, 429, dan 5xx dicoba lagi.

• Peristiwa yang berkaitan dengan kode kesalahan 1xx, 2xx, 3xx, dan 4xx (tidak termasuk 429) tidak dicoba lagi.

EventBridge APItujuan membaca header HTTP respons standar Retry-After untuk mengetahui berapa lama menunggu sebelum membuat permintaan tindak lanjut. EventBridge memilih nilai yang lebih konservatif antara kebijakan coba ulang yang ditentukan dan header. Retry-After Jika Retry-After nilainya negatif, EventBridge berhenti mencoba kembali pengiriman untuk acara itu.

Bagaimana tingkat invokasi memengaruhi pengiriman peristiwa

Jika Anda menetapkan tingkat invokasi per detik untuk nilai yang jauh lebih rendah daripada jumlah invokasi yang dihasilkan, peristiwa tidak dapat dikirimkan dalam waktu 24 jam coba lagi untuk peristiwa. Sebagai contoh, jika Anda menetapkan tingkat invokasi ke 10 invokasi per detik, tetapi ribuan peristiwa per detik dihasilkan, Anda akan dengan cepat memiliki backlog peristiwa untuk mengirimkan yang melebihi 24 jam. Untuk memastikan bahwa tidak ada peristiwa yang hilang, atur antrean surat mati untuk mengirim peristiwa dengan invokasi yang gagal sehingga Anda dapat memproses peristiwa di lain waktu. Untuk informasi selengkapnya, lihat Menggunakan antrian surat mati untuk memproses peristiwa yang tidak terkirim EventBridge.