Jenis titik akhir API untuk REST API di API Gateway

Jenis titik akhir API mengacu pada nama host API. Jenis titik akhir API dapat dioptimalkan secara tepi, regional, atau pribadi, tergantung dari mana sebagian besar lalu lintas API Anda berasal.

Titik akhir API yang dioptimalkan tepi

Titik akhir API yang dioptimalkan tepi biasanya merutekan permintaan ke CloudFront Point of Presence (POP) terdekat, yang dapat membantu jika klien Anda didistribusikan secara geografis. Ini adalah tipe endpoint default untuk API Gateway REST API.

API yang dioptimalkan tepi menggunakan huruf besar pada nama header HTTP (misalnya,). Cookie

CloudFront mengurutkan cookie HTTP dalam urutan alami dengan nama cookie sebelum meneruskan permintaan ke asal Anda. Untuk informasi selengkapnya tentang cara CloudFront memproses cookie, lihat Caching Konten Berdasarkan Cookie.

Nama domain kustom apa pun yang Anda gunakan untuk API yang dioptimalkan tepi berlaku di semua wilayah.

Titik akhir API regional

Titik akhir API Regional ditujukan untuk klien di wilayah yang sama. Ketika klien yang berjalan pada instans EC2 memanggil API di wilayah yang sama, atau ketika API dimaksudkan untuk melayani sejumlah kecil klien dengan permintaan tinggi, API Regional mengurangi overhead koneksi.

Untuk API Regional, nama domain kustom apa pun yang Anda gunakan khusus untuk wilayah tempat API digunakan. Jika Anda menerapkan API regional di beberapa wilayah, API tersebut dapat memiliki nama domain kustom yang sama di semua wilayah. Anda dapat menggunakan domain khusus bersama dengan Amazon Route 53 untuk melakukan tugas seperti perutean berbasis latensi. Untuk informasi selengkapnya, lihat Siapkan nama domain kustom Regional di API Gateway dan Siapkan nama domain kustom yang dioptimalkan tepi di Gateway API.

Titik akhir API regional meneruskan semua nama header melalui apa adanya.

catatan

Dalam kasus di mana klien API tersebar secara geografis, mungkin masih masuk akal untuk menggunakan titik akhir API Regional, bersama dengan CloudFront distribusi Amazon Anda sendiri untuk memastikan bahwa API Gateway tidak mengaitkan API dengan distribusi yang dikendalikan layanan. CloudFront Untuk informasi selengkapnya tentang kasus penggunaan ini, lihat Bagaimana cara menyiapkan API Gateway dengan CloudFront distribusi saya sendiri? .

Titik akhir API pribadi

Titik akhir API pribadi adalah titik akhir API yang hanya dapat diakses dari Amazon Virtual Private Cloud (VPC) menggunakan titik akhir VPC antarmuka, yang merupakan antarmuka jaringan titik akhir (ENI) yang Anda buat di VPC Anda. Untuk informasi selengkapnya, lihat Pribadi REST APIs di API Gateway.

Titik akhir API pribadi meneruskan semua nama header melalui apa adanya.