Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Siapkan nama domain kustom Regional di API Gateway
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-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, lihat[Siapkan sertifikat AWS Certificate Manager](how-to-specify-certificate-for-custom-domain-name.md).
+ 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 **AWSServiceRoleForAPIGateway**dan akan memiliki kebijakan **APIGatewayServiceRolePolicy**terkelola yang melekat padanya. Untuk informasi selengkapnya tentang penggunaan peran terkait layanan, lihat [Menggunakan Peran Tertaut Layanan](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html).
+ 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 aturan perutean untuk merutekan tahapan API Anda ke nama domain kustom Anda.
------
#### [ Konsol Manajemen AWS ]
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih **Nama domain khusus** dari panel navigasi utama.
1. Pilih **Buat**.
1. Untuk **nama Domain**, masukkan nama domain.
1. Untuk **mode Routing**, pilih **Routing rules only**.
Dalam mode routing ini, Anda hanya dapat mengirim lalu lintas dari nama domain kustom Anda ke Anda APIs dengan menggunakan aturan routing. Untuk informasi selengkapnya, lihat [Kirim lalu lintas ke Anda APIs melalui nama domain kustom Anda di API Gateway](rest-api-routing-mode.md).
1. Untuk **versi TLS Minimum**, pilih versi.
1. **Di bawah **Konfigurasi titik akhir**, untuk **jenis titik akhir API**, pilih Regional.**
1. Pilih sertifikat ACM. Sertifikat harus berada di Wilayah yang sama dengan API.
1. Pilih **Buat**.
------
#### [ AWS CLI ]
[create-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-domain-name.html)Perintah berikut membuat nama domain kustom:
```
aws apigatewayv2 create-domain-name \
--domain-name 'regional.example.com' \
--domain-name-configurations CertificateArn=arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678 \
--routing-mode ROUTING_RULE_ONLY
```
Outputnya akan terlihat seperti berikut:
```
{
"ApiMappingSelectionExpression": "$request.basepath",
"DomainName": "regional.example.com",
"DomainNameConfigurations": [
{
"ApiGatewayDomainName": "d-numh1z56v6.execute-api.us-west-2.amazonaws.com",
"CertificateArn": "arn:aws:acm:us-west-2:123456789012:certificate/123456789012-1234-1234-1234-12345678",
"DomainNameStatus": "AVAILABLE",
"EndpointType": "REGIONAL",
"HostedZoneId": "Z2OJLYMUO9EFXC",
"SecurityPolicy": "TLS_1_2"
}
"RoutingMode": "ROUTING_RULE_ONLY"
]
}
```
Nilai `DomainNameConfigurations` properti mengembalikan nama host API Regional. Anda harus membuat catatan DNS untuk mengarahkan nama domain kustom Anda ke nama domain Regional ini. Ini memungkinkan lalu lintas yang terikat pada nama domain kustom untuk dirutekan ke nama host API Regional ini.
------
## Buat aturan perutean untuk nama domain kustom Regional Anda
Setelah Anda membuat nama domain kustom Anda, Anda mengonfigurasi bagaimana lalu lintas dirutekan dari nama domain khusus Anda ke nama domain Anda APIs. Karena Anda mengatur mode perutean`ROUTING_RULE_ONLY`, Anda menggunakan aturan perutean untuk merutekan permintaan masuk ke nama domain kustom Anda ke nama domain Anda. APIs
Dalam contoh ini, Anda membuat aturan catch-all yang merutekan semua permintaan masuk ke nama domain kustom Anda ke satu tahap API Anda. Anda juga dapat mengonfigurasi aturan perutean berdasarkan kondisi header dan jalur yang berbeda. Untuk informasi selengkapnya, lihat [Aturan perutean untuk menghubungkan tahapan API ke nama domain khusus untuk REST APIs](rest-api-routing-rules.md).
------
#### [ Konsol Manajemen AWS ]
1. Masuk ke konsol API Gateway di [https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway).
1. Pilih nama domain khusus.
1. Pada tab **Routing details**, pilih **Add routing rule.**
1. Pilih **Tambahkan kondisi baru** untuk menambahkan kondisi baru.
1. Pertahankan aturan ini tanpa syarat apa pun. Ini merutekan semua permintaan ke nama domain kustom Anda ke API target dan tahap target Anda.
1. Untuk **Action**, gunakan dropdown untuk memilih API target dan tahap target Anda.
1. Pilih **Berikutnya**.
1. Di bidang prioritas, masukkan**100**.
API Gateway mengevaluasi aturan dalam urutan prioritas, dari nilai terendah hingga nilai tertinggi. Karena ini adalah aturan catch-all, Anda menggunakan prioritas tinggi sehingga API Gateway dapat mencocokkan aturan tambahan apa pun yang Anda buat terlebih dahulu.
1. Pilih **Buat aturan perutean**.
------
#### [ AWS CLI ]
`create-routing-rule`Perintah berikut membuat aturan perutean catch-all:
```
aws apigatewayv2 create-routing-rule \
--domain-name 'regional.example.com' \
--priority 100 \
--conditions \
--actions '[{
"InvokeApi": {
"ApiId": "a1b2c3",
"Stage": "prod"
}
}]'
```
------
Anda dapat mengubah mode perutean dan membuat aturan baru kapan saja. Untuk informasi selengkapnya, lihat [Kirim lalu lintas ke Anda APIs melalui nama domain kustom Anda di API Gateway](rest-api-routing-mode.md).
## 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.
------
#### [ Konsol Manajemen AWS ]
Untuk menggunakan Konsol Manajemen AWS, ikuti dokumentasi Route 53 tentang [mengonfigurasi Route 53 untuk merutekan lalu lintas ke API Gateway](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/routing-to-api-gateway.html).
------
#### [ AWS CLI ]
Untuk mengonfigurasi catatan DNS Anda untuk memetakan nama domain kustom Regional ke nama hostnya dari ID zona host yang diberikan, pertama-tama buat file JSON yang berisi konfigurasi untuk menyiapkan catatan DNS untuk nama domain Regional.
Berikut ini `setup-dns-record.json` menunjukkan cara membuat `A` catatan DNS untuk memetakan nama domain kustom Regional (`regional.example.com`) ke nama host Regional (`d-numh1z56v6.execute-api.us-west-2.amazonaws.com`) yang disediakan sebagai bagian dari pembuatan nama domain kustom. `HostedZoneId`Properti `DNSName` dan `AliasTarget` dapat mengambil `regionalHostedZoneId` nilai `regionalDomainName` dan, masing-masing, dari nama domain kustom. Anda juga bisa mendapatkan Regional Route 53 Hosted Zone IDs di [Amazon API Gateway Endpoints dan Quotas](https://docs.aws.amazon.com/general/latest/gr/apigateway.html).
```
{
"Changes": [
{
"Action": "CREATE",
"ResourceRecordSet": {
"Name": "regional.example.com",
"Type": "A",
"AliasTarget": {
"DNSName": "d-numh1z56v6.execute-api.us-west-2.amazonaws.com",
"HostedZoneId": "Z2OJLYMUO9EFXC",
"EvaluateTargetHealth": false
}
}
}
]
}
```
Berikut ini [change-resource-record-sets](https://docs.aws.amazon.com/cli/latest/reference/route53/change-resource-record-sets.html)membuat catatan DNS untuk nama domain kustom Regional Anda:
```
aws route53 change-resource-record-sets \
--hosted-zone-id Z2OJLYMUO9EFXC \
--change-batch file://path/to/your/setup-dns-record.json
```
Ganti `hosted-zone-id` dengan ID Zona Dihosting Route 53 dari catatan DNS yang ditetapkan di akun Anda. Nilai `change-batch` parameter menunjuk ke file JSON (*setup-dns-record.json*) dalam folder (*path/to/your*).
------