Merutekan lalu lintas ke API Amazon API Gateway dengan menggunakan nama domain Anda

Anda dapat menggunakan Amazon API Gateway untuk membuat, menerbitkan, memelihara, memantau, dan mengamankan API. Anda dapat membuat API yang mengakses AWS layanan atau layanan web lainnya selain data yang disimpan di AWS Cloud.

Metode yang Anda gunakan untuk merutekan lalu lintas domain ke API pada API Gateway adalah sama terlepas dari apakah Anda membuat titik akhir API Gateway regional atau titik akhir API Gateway yang dioptimalkan edge.

• Titik akhir API Regional: Anda membuat catatan alias Route 53 yang merutekan lalu lintas ke titik akhir API regional.

• Titik akhir API yang dioptimalkan edge: Anda membuat catatan alias Route 53 yang merutekan lalu lintas ke API yang dioptimalkan edge. Hal ini menyebabkan lalu lintas dialihkan ke CloudFront distribusi yang terkait dengan API yang dioptimalkan tepi.

Catatan alias adalah ekstensi Route 53 ke DNS yang mirip dengan data CNAME. Untuk perbandingan alias dan data CNAME, lihat Memilih antara catatan alias dan nonalias.

catatan

Route 53 tidak mengenakan biaya untuk kueri alias ke API Gateway API atau sumber daya lainnya AWS .

Prasyarat

Untuk memulai, Anda memerlukan yang berikut ini:

• API Gateway API yang memiliki nama domain khusus, seperti api.example.com yang cocok dengan nama record Route 53 yang ingin Anda buat.

  Untuk informasi selengkapnya, lihat topik berikut.

  • Menyiapkan nama domain khusus untuk API HTTP di Panduan Pengembang Amazon API Gateway.

  • Menyiapkan nama domain khusus untuk REST API di Panduan Pengembang Amazon API Gateway.

  • Menyiapkan nama domain khusus untuk WebSocket API di Panduan Pengembang Amazon API Gateway.

• Nama domain terdaftar. Anda dapat menggunakan Amazon Route 53 sebagai pencatat domain Anda atau Anda dapat menggunakan registrar lain.

• Route 53 sebagai layanan DNS untuk domain. Jika Anda mendaftarkan nama domain Anda dengan menggunakan Route 53, kami secara otomatis mengonfigurasi Route 53 sebagai layanan DNS untuk domain.

  Untuk informasi tentang cara menggunakan Route 53 sebagai penyedia layanan DNS untuk domain Anda, lihat Membuat Amazon Route 53 menjadi layanan DNS untuk domain yang ada.

Mengonfigurasi Route 53 untuk merutekan lalu lintas ke titik akhir API Gateway

Untuk mengonfigurasi Route 53 untuk merutekan lalu lintas ke titik akhir API Gateway, lakukan prosedur berikut.

Untuk merutekan lalu lintas ke titik akhir API Gateway

1. Jika Anda membuat zona yang di-hosting Route 53 dan titik akhir menggunakan akun yang sama, lewati ke langkah 2.

   Jika Anda membuat zona yang di-hosting dan titik akhir menggunakan akun yang berbeda, dapatkan nama domain target untuk nama domain khusus yang ingin Anda gunakan:

   1. Masuk ke AWS Management Console dan buka konsol API Gateway di https://console.aws.amazon.com/apigateway/.

   2. Di panel navigasi, pilih Custom domain names (Nama domain khusus).

   3. Pilih nama domain kustom yang ingin Anda gunakan dan dapatkan nilai nama domain API Gateway.

2. Buka konsol Route 53 di https://console.aws.amazon.com/route53/.

3. Di panel navigasi, pilih Hosted zones (Zona yang di-hosting).

4. Pilih nama zona yang di-hosting yang memiliki nama domain yang ingin Anda gunakan untuk merutekan lalu lintas ke API Anda.

5. Pilih Create record (Buat catatan).

6. Tentukan nilai-nilai berikut ini:

   Kebijakan perutean

   Pilih kebijakan perutean yang sesuai. Untuk informasi selengkapnya, lihat Memilih kebijakan perutean.

   Nama catatan

   Masukkan nama domain yang ingin Anda gunakan untuk merutekan lalu lintas ke API Anda.

   API yang ingin Anda rutekan lalu lintas harus menyertakan nama domain khusus, seperti api.example.com yang cocok dengan nama catatan Route 53.

   Alias

   Jika Anda menggunakan metode pembuatan catatan Pembuatan cepat, aktifkan Alias​​.

   Menilai/Merutekan lalu lintas

   Pilih Alias to API Gateway API (Alias ke API Gateway API), lalu pilih Wilayah tempat titik akhir berasal.

   Cara Anda menentukan nilai untuk Endpoint bergantung pada apakah Anda membuat zona yang dihosting dan API menggunakan akun yang sama atau AWS akun yang berbeda:

   • Akun yang sama – Daftar nama domain target hanya mencakup API yang memiliki nama domain kustom yang cocok dengan nilai yang Anda tentukan untuk Nama catatan. Pilih nilai yang sesuai.

   • Akun yang berbeda – Masukkan nilai yang Anda dapatkan pada langkah 1 dari prosedur ini.

   Jenis catatan

   Pilih A – IPv4 address (A — alamat IPv4).

   Mengevaluasi kondisi target

   Untuk kontrol atas failover DNS, konfigurasikan pemeriksaan kesehatan khusus. Sebagai contoh, lihat Mengonfigurasi pemeriksaan kesehatan khusus untuk failover DNS di panduan pengguna API Gateway.

7. Pilih Create records (Buat catatan).

   Perubahan umumnya menyebar ke semua server nama Route 53 dalam waktu 60 detik. Saat propagasi selesai, Anda akan dapat merutekan lalu lintas ke API Anda dengan menggunakan nama catatan alias yang Anda buat dalam prosedur ini.