Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Nama domain khusus untuk REST publik APIs di API Gateway
*Nama domain khusus* lebih sederhana dan lebih intuitif URLs yang dapat Anda berikan kepada pengguna API Anda.
Setelah menerapkan API, Anda (dan pelanggan) dapat menjalankan API menggunakan URL dasar default dari format berikut:
```
https://{{api-id}}.execute-api.{{region}}.amazonaws.com/{{stage}}
```
dimana {{api-id}} dihasilkan oleh API Gateway, {{region}} adalah AWS Wilayah, dan {{stage}} ditentukan oleh Anda saat menerapkan API.
Bagian nama host dari URL, `{{api-id}}.execute-api.{{region}}.amazonaws.com` mengacu pada titik akhir API. Nama endpoint API default dibuat secara acak, sulit diingat, dan tidak ramah pengguna.
Dengan nama domain khusus, Anda dapat mengatur nama host API Anda, dan memilih jalur dasar (misalnya,`myservice`) untuk memetakan URL alternatif ke API Anda. Misalnya, URL dasar API yang lebih ramah pengguna dapat menjadi:
```
https://api.example.com/myservice
```
**catatan**
Untuk informasi tentang nama domain khusus untuk pribadi APIs, lihat[Nama domain khusus untuk pribadi APIs di API Gateway](apigateway-private-custom-domains.md).
## Pertimbangan-pertimbangan
Pertimbangan berikut dapat memengaruhi penggunaan nama domain kustom Anda:
+ Anda dapat menonaktifkan titik akhir default untuk API Anda. Klien masih dapat terhubung ke titik akhir default Anda, tetapi mereka akan menerima kode `403 Forbidden` status.
+ Nama domain kustom Regional dapat dikaitkan dengan REST APIs dan HTTP APIs. Anda dapat menggunakan [API Gateway Versi 2 APIs](https://docs.aws.amazon.com/apigatewayv2/latest/api-reference/api-reference.html) untuk membuat dan mengelola nama domain kustom Regional untuk REST APIs.
+ Nama domain khusus harus unik di dalam Wilayah di semua AWS akun.
+ Anda dapat memigrasikan nama domain kustom antara titik akhir yang dioptimalkan tepi dan Regional, tetapi Anda tidak dapat memigrasikan domain kustom publik ke nama domain kustom pribadi.
+ Anda harus membuat atau memperbarui catatan sumber daya penyedia DNS Anda untuk memetakan ke titik akhir API Anda. Tanpa pemetaan seperti itu, permintaan API yang terikat untuk nama domain khusus tidak dapat mencapai API Gateway.
+ Anda dapat mendukung jumlah nama domain yang hampir tak terbatas tanpa melebihi kuota default dengan menggunakan sertifikat wildcard. Untuk informasi selengkapnya, lihat [Nama domain kustom wildcard](#wildcard-custom-domain-names).
+ Anda dapat memilih kebijakan keamanan untuk nama domain kustom Anda. Untuk informasi selengkapnya, lihat [Pilih kebijakan keamanan untuk domain kustom Anda di API Gateway](apigateway-custom-domain-tls-version.md).
+ Untuk mengonfigurasi pemetaan API dengan beberapa level, Anda harus menggunakan nama domain kustom Regional dan menggunakan kebijakan keamanan TLS 1.2.
## Prasyarat untuk nama domain khusus
Berikut ini adalah prasyarat untuk membuat nama domain kustom publik atau pribadi. Untuk informasi tentang nama domain khusus untuk pribadi APIs, lihat[Nama domain khusus untuk pribadi APIs di API Gateway](apigateway-private-custom-domains.md).
### Daftarkan nama domain
Anda harus memiliki nama domain internet terdaftar untuk mengatur nama domain khusus untuk Anda APIs. Anda dapat mendaftarkan nama domain internet Anda menggunakan [Amazon Route 53](https://docs.aws.amazon.com/Route53/latest/DeveloperGuide/) atau menggunakan registrar domain pihak ketiga pilihan Anda. Nama domain kustom Anda dapat berupa nama subdomain atau domain root (juga dikenal sebagai “zone apex”) dari domain internet terdaftar.
Nama domain Anda harus mengikuti spesifikasi [RFC 1035](https://tools.ietf.org/html/rfc1035#section-2.3.4) dan dapat memiliki maksimum 63 oktet per label dan total 255 oktet.
### Tentukan sertifikat untuk nama domain kustom Anda
Sebelum menyiapkan nama domain khusus untuk API, Anda harus memiliki SSL/TLS sertifikat yang siap di ACM. Jika ACM tidak tersedia di AWS Wilayah tempat Anda membuat nama domain kustom, Anda harus mengimpor sertifikat ke API Gateway di Wilayah tersebut.
Untuk mengimpor SSL/TLS sertifikat, Anda harus menyediakan badan SSL/TLS sertifikat berformat PEM, kunci pribadinya, dan rantai sertifikat untuk nama domain kustom.
Setiap sertifikat yang disimpan dalam ACM diidentifikasi oleh ARN-nya. Dengan sertifikat yang dikeluarkan oleh ACM, Anda tidak perlu khawatir mengekspos detail sertifikat sensitif, seperti kunci pribadi. Untuk menggunakan sertifikat AWS terkelola untuk nama domain, Anda cukup mereferensikan ARN-nya.
Jika aplikasi Anda menggunakan pinning sertifikat, kadang-kadang dikenal sebagai penyematan SSL, untuk menyematkan sertifikat ACM, aplikasi mungkin tidak dapat terhubung ke domain Anda setelah AWS memperbarui sertifikat. Untuk informasi selengkapnya, lihat [Masalah penyematan sertifikat](https://docs.aws.amazon.com/acm/latest/userguide/troubleshooting-pinning.html) di *Panduan AWS Certificate Manager Pengguna*.
## Nama domain kustom wildcard
Dengan nama domain khusus wildcard, Anda dapat mendukung jumlah nama domain yang hampir tak terbatas tanpa melebihi kuota [default](limits.md). Misalnya, Anda bisa memberi setiap pelanggan Anda nama domain mereka sendiri`{{customername}}.example.com`.
Untuk membuat nama domain kustom wildcard, tentukan wildcard (`*`) sebagai subdomain pertama dari domain kustom yang mewakili semua kemungkinan subdomain dari domain root.
Misalnya, nama domain kustom wildcard `*.example.com` menghasilkan subdomain seperti`a.example.com`,, `b.example.com` dan. `c.example.com` Saat Anda membuat nama domain khusus wildcard, semua subdomainnya dirutekan oleh mode perutean nama domain wildcard. Untuk merutekan subdomain ke yang berbeda APIs, Anda dapat melakukan salah satu hal berikut:
+ Gunakan aturan perutean untuk merutekan permintaan masuk `*.example.com` ke REST target yang berbeda APIs menggunakan header. `Host` Untuk informasi selengkapnya, lihat [Contoh 4: Aturan perutean untuk nama domain wildcard](rest-api-routing-rules-examples.md#rest-api-routing-rules-examples-rule-for-wildcard-domains).
+ Buat nama domain untuk setiap subdomain yang ingin Anda rute ke titik akhir yang berbeda. Dalam satu AWS akun, Anda dapat memiliki keduanya `*.example.com` dan`a.example.com`.
Anda dapat menggunakan variabel `$context.domainName` dan `$context.domainPrefix` konteks untuk menentukan nama domain yang digunakan klien untuk memanggil API Anda. Untuk mempelajari lebih lanjut tentang variabel konteks, lihat[Variabel untuk transformasi data untuk API Gateway](api-gateway-mapping-template-reference.md).
Untuk membuat nama domain kustom wildcard, Anda harus memberikan sertifikat yang dikeluarkan oleh ACM yang telah divalidasi menggunakan DNS atau metode validasi email.
**catatan**
Anda tidak dapat membuat nama domain khusus wildcard jika AWS akun lain telah membuat nama domain kustom yang bertentangan dengan nama domain kustom wildcard. Misalnya, jika akun A telah dibuat`a.example.com`, maka akun B tidak dapat membuat nama `*.example.com` domain khusus wildcard.
Jika akun A dan akun B berbagi pemilik, Anda dapat menghubungi [Pusat AWS Dukungan](https://console.aws.amazon.com/support/home#/) untuk meminta pengecualian.
## Langkah selanjutnya untuk nama domain kustom
Berikut ini adalah langkah selanjutnya untuk nama domain kustom.
**Langkah selanjutnya**
+ Untuk mempelajari cara mengatur SSL/TLS sertifikat Anda, lihat[Siapkan sertifikat AWS Certificate Manager](how-to-specify-certificate-for-custom-domain-name.md).
+ Untuk mempelajari cara membuat nama domain kustom Regional, lihat[Siapkan nama domain kustom Regional di API Gateway](apigateway-regional-api-custom-domain-create.md).
+ Untuk mempelajari cara membuat nama domain kustom yang dioptimalkan tepi, lihat. [Siapkan nama domain kustom yang dioptimalkan tepi di API Gateway](how-to-edge-optimized-custom-domain-name.md)
+ Untuk mempelajari cara bermigrasi antara nama domain kustom Regional dan yang dioptimalkan di tepi, lihat. [Memigrasikan nama domain kustom ke jenis endpoint API yang berbeda di API Gateway](apigateway-regional-api-custom-domain-migrate.md)
+ Untuk mempelajari cara menghubungkan tahapan API ke nama domain kustom, lihat[Kirim lalu lintas ke Anda APIs melalui nama domain kustom Anda di API Gateway](rest-api-routing-mode.md).
+ Untuk mempelajari cara memilih kebijakan keamanan untuk nama domain kustom Anda, lihat[Pilih kebijakan keamanan untuk domain kustom Anda di API Gateway](apigateway-custom-domain-tls-version.md).
+ Untuk mempelajari cara menonaktifkan titik akhir default untuk nama domain kustom Anda, lihat[Nonaktifkan titik akhir default untuk REST APIs](rest-api-disable-default-endpoint.md).
+ Untuk mempelajari cara menggunakan pemeriksaan kesehatan Route 53 untuk mengontrol failover DNS dari API Gateway API, lihat. [Konfigurasikan pemeriksaan kesehatan khusus untuk failover DNS untuk API Gateway API](dns-failover.md)
Jika ini adalah pertama kalinya Anda membuat nama domain kustom, kami sarankan Anda mulai dengan[Siapkan sertifikat AWS Certificate Manager](how-to-specify-certificate-for-custom-domain-name.md), untuk menentukan sertifikat Anda, dan kemudian [Siapkan nama domain kustom Regional di API Gateway](apigateway-regional-api-custom-domain-create.md) membuat nama domain kustom Regional.