Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Gunakan nama domain kustom Regional untuk membuat URL dasar API yang mudah digunakan. Dengan nama domain kustom Regional, Anda dapat memetakan tahap HTTP dan REST API ke nama domain kustom yang sama dan menggunakan otentikasi TLS bersama.
Pertimbangan
Berikut ini adalah pertimbangan untuk nama domain kustom Regional Anda.
-
Anda harus memberikan sertifikat ACM khusus Wilayah. Sertifikat ini harus berada di Wilayah yang sama dengan API Anda. Untuk informasi selengkapnya tentang membuat atau mengunggah sertifikat nama domain kustom, lihatSiapkan sertifikat AWS Certificate Manager.
-
Saat Anda membuat nama domain kustom Regional (atau memigrasikan satu) dengan sertifikat ACM, API Gateway akan membuat peran terkait layanan di akun Anda. Peran terkait layanan diperlukan untuk melampirkan sertifikat ACM Anda ke titik akhir Regional Anda. Peran tersebut diberi nama AWSServiceRoleForAPIGatewaydan akan memiliki kebijakan APIGatewayServiceRolePolicyterkelola yang melekat padanya. Untuk informasi selengkapnya tentang penggunaan peran terkait layanan, lihat Menggunakan Peran Tertaut Layanan.
-
Setelah Anda membuat nama domain kustom Regional Anda, Anda harus membuat catatan DNS untuk mengarahkan nama domain kustom ke domain Regional. Hal ini memungkinkan lalu lintas yang terikat pada nama domain kustom untuk dirutekan ke nama host Regional API.
Catatan DNS dapat berupa catatan CNAME atau A Alias. Jika Anda menggunakan Route 53 sebagai penyedia DNS Anda, buat catatan Alias A. Jika Anda menggunakan penyedia DNS pihak ketiga, gunakan catatan CNAME. Jika Anda menggunakan catatan CNAME dan membuat titik akhir VPC antarmuka API Gateway dengan DNS pribadi diaktifkan untuk API pribadi, Anda tidak dapat menyelesaikan nama domain kustom dalam VPC yang menghosting API pribadi Anda.
Buat nama domain kustom Regional
Prosedur berikut menunjukkan cara membuat nama domain kustom Regional. Setelah menyelesaikan prosedur ini, Anda membuat pemetaan jalur dasar untuk memetakan tahapan API Anda ke nama domain kustom Anda.
Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway
. -
Pilih Nama domain khusus dari panel navigasi utama.
-
Pilih Buat.
-
Untuk nama Domain, masukkan nama domain.
-
Untuk versi TLS Minimum, pilih versi.
-
Di bawah Konfigurasi titik akhir, untuk jenis titik akhir API, pilih Regional.
-
Pilih sertifikat ACM. Sertifikat harus berada di Wilayah yang sama dengan API.
-
Pilih Buat.
Buat pemetaan jalur dasar untuk nama domain kustom Regional Anda
Setelah Anda membuat nama domain kustom Anda, Anda membuat pemetaan jalur dasar untuk memetakan API Anda ke nama domain kustom Anda. Misalnya, Anda dapat memetakan tahap test
untuk ID API abc123
ke nama domain kustom regional.example.com
menggunakan kunci pemetaan API. myApi
Ini memetakan API https://abcd1234.execute-api.us-west-2.amazonaws.com/test
kehttps://regional.example.com/myApi
.
Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway
. -
Pilih nama domain khusus.
-
Pilih Konfigurasi pemetaan API.
-
Pilih Tambahkan pemetaan baru.
-
Tentukan API, Stage, dan Path untuk pemetaan.
-
Pilih Simpan.
Dengan nama domain kustom Regional, Anda dapat membuat pemetaan API dengan beberapa level, sepertihttps://regional.example.com/orders/v1/items/123
. Anda juga dapat memetakan tahap HTTP dan REST API ke nama domain kustom yang sama. Untuk informasi selengkapnya, lihat Memetakan tahapan API ke nama domain khusus untuk REST APIs.
Buat catatan DNS untuk nama domain kustom Regional Anda
Setelah Anda membuat nama domain kustom dan membuat pemetaan jalur dasar, Anda membuat catatan DNS untuk mengarahkan nama domain kustom Anda nama domain Regional yang baru dibuat.
Untuk menggunakan AWS Management Console, ikuti dokumentasi Route 53 tentang mengonfigurasi Route 53 untuk merutekan lalu lintas ke API Gateway.