View a markdown version of this page

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

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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 Gateway API sama terlepas dari apakah Anda membuat titik akhir Gateway API Regional atau titik akhir API Gateway yang dioptimalkan tepi. Jika Anda membuat endpoint API Gateway pribadi, prosesnya sedikit berbeda.

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

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

  • Titik akhir API pribadi: Anda membuat catatan alias Route 53 yang merutekan lalu lintas ke titik akhir API pribadi Anda menggunakan titik akhir VPC antarmuka untuk API Gateway di zona yang dihosting pribadi.

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 AWS sumber daya lainnya.

Prasyarat

Untuk memulai, Anda memerlukan yang berikut ini:

Mengkonfigurasi 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.

Custom domain names for public APIs

Prosedur berikut menjelaskan cara merutekan lalu lintas ke titik akhir API Gateway untuk nama domain khusus untuk API publik.

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 Konsol Manajemen AWS 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:

    penting

    Kami menyarankan Anda mengaktifkan Alias. Untuk nama domain yang tidak menggunakan catatan Alias Route 53, Anda mungkin mengalami masalah jika menggunakan VPC dengan DNS pribadi diaktifkan untuk memanggil API pribadi. DNS pribadi mengesampingkan perilaku resolusi DNS default dalam VPC, yang dapat menyebabkan konflik dengan catatan DNS eksternal.

    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 tempat Anda ingin merutekan 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​​.

    Value/Route lalu lintas ke

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

    Cara menentukan nilai Endpoint tergantung 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 Meng onfigurasi 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.

Custom domain names for private APIs

Prosedur berikut menjelaskan cara merutekan lalu lintas ke titik akhir API Gateway untuk nama domain khusus untuk API pribadi.

Untuk merutekan lalu lintas ke titik akhir API Gateway
  1. Buka konsol Route 53 di https://console.aws.amazon.com/route53/.

  2. Pada panel navigasi, pilih Zona yang di-hosting.

  3. Pilih nama zona pribadi yang dihosting yang memiliki nama domain yang ingin Anda gunakan untuk merutekan lalu lintas ke API Anda.

  4. Pilih Create record (Buat catatan).

  5. 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 tempat Anda ingin merutekan lalu lintas harus menyertakan nama domain khusus, seperti api.example.com yang cocok dengan nama catatan Route 53.

    Alias

    Aktifkan Alias.

    Value/Route lalu lintas ke

    Pilih Alias ke Titik Akhir VPC. Pilih Wilayah tempat titik akhir berasal, lalu pilih titik akhir VPC Anda.

    Tipe catatan

    Jika Anda menggunakan IPv6 untuk titik akhir VPC Anda, buat jenis rekaman AAAA. Jika Anda menggunakan dualstack untuk titik akhir VPC Anda, buat jenis rekaman AAAA dan A.

    Mengevaluasi Kondisi Target

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

  6. 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.