Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konsumen API: Mengaitkan titik akhir VPC Anda dengan nama domain kustom pribadi yang dibagikan dengan Anda
Prosedur berikut menunjukkan cara menggunakan nama domain pribadi di domain lain Akun AWS. Tergantung pada hubungan kepercayaan Anda dengan penyedia API, AWS RAM mungkin menyelesaikan beberapa tugas untuk Anda.
Jika Anda berada di nama domain khusus yang berbeda Akun AWS dari pribadi, Anda hanya dapat mengaitkan titik akhir VPC Anda dengan nama domain kustom pribadi dan memanggilnya. Anda tidak dapat melihat policy atau parameter lain dari nama domain kustom pribadi.
Prasyarat
Prasyarat berikut diperlukan untuk menggunakan nama domain kustom pribadi di domain lain Akun AWS:
-
VPC dan titik akhir VPC untuk layanan. execute-api VPC Anda harus memiliki enableDnsHostnames dan diset enableDnsSupport el ketrue.
-
Sebaiknya Anda mengonfigurasi setidaknya dua Zona Ketersediaan per titik akhir VPC.
(Opsional) Terima berbagi sumber daya domain kustom pribadi
Jika penyedia API Anda digunakan AWS RAM untuk membuat pembagian sumber daya, Anda memiliki waktu 12 jam untuk menerimanya. Jika Anda berada di organisasi yang sama menggunakan AWS Organizations sebagai penyedia API, berbagi diterima secara otomatis. Jika Anda berada di organisasi yang mengaktifkan sumber daya bersama otomatis, sumber daya secara otomatis dibagikan dengan Anda.
- Konsol Manajemen AWS
-
Untuk menggunakan Konsol Manajemen AWS, lihat M enerima dan menolak undangan berbagi sumber daya di Panduan AWS RAM Pengguna.
- AWS CLI
Untuk menemukan semua sumber daya yang dibagikan dengan Anda, gunakan perintah get-resour ce-share-berikut:
aws ram get-resource-share-invitations \
--region us-west-2
Gunakan ARN berbagi sumber daya yang dihasilkan untuk menerima undangan berbagi sumber daya. Perintah accept-resource-share-invitation berikut menerima pembagian sumber daya.
aws ram accept-resource-share-invitation \
--resource-share-invitation-arn arn:aws:ram:us-west-2:123456789012:resource-share-invitation/1e3477be-4a95-46b4-bbe0-c4001EXAMPLE \
--region us-west-2
Mengaitkan titik akhir VPC Anda dengan nama domain kustom pribadi bersama
Karena nama domain kustom pribadi tidak unik, Anda mengaitkan titik akhir VPC Anda dengan nama domain khusus unik ARN. Setelah membuat asosiasi akses nama domain, diperlukan waktu hingga 15 menit agar titik akhir VPC berhasil memanggil nama domain kustom pribadi Anda. Jika Anda memiliki titik akhir VPC yang Anda gunakan untuk mengakses nama domain kustom publik, jangan menggunakannya untuk membuat asosiasi akses nama domain apa pun.
- Konsol Manajemen AWS
Untuk mengaitkan titik akhir VPC Anda dengan nama domain kustom pribadi bersama
Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway.
-
Di panel navigasi utama, pilih asosiasi akses nama domain.
Pilih Buat asosiasi akses nama domain.
-
Untuk nama domain ARN, pilih nama domain ARN yang dibagikan penyedia API dengan Anda.
Nama domain ARN mungkin tidak muncul dalam daftar dropdown. Anda dapat menggunakan AWS RAM konsol untuk melihat nama domain yang dibagikan dengan Anda dan kemudian menyalin nama domain ARN dan memasukkannya ke dalam bidang ini.
-
Untuk ID titik akhir VPC, pilih ID titik akhir VPC yang ingin Anda bentuk asosiasi akses nama domain.
Pilih Buat asosiasi akses nama domain.
- AWS CLI
Karena nama domain kustom pribadi tidak unik, Anda mengaitkan titik akhir VPC Anda dengan nama domain khusus unik ARN. Untuk menemukan nama domain ARN, gunakan salah satu perintah berikut.
-
- AWS RAM
-
Perintah list-resources berikut menc antumkan sumber daya yang dibagikan dengan Anda. Penyedia API harus menggunakan AWS RAM untuk berbagi domain kustom pribadi mereka dengan Anda untuk menggunakan perintah ini.
aws ram list-resources \
--resource-owner OTHER-ACCOUNTS \
--region us-west-2
--resource-type apigateway:Domainnames
- API Gateway
Per get-domain-names intah berikut mencantumkan semua nama domain kustom pribadi yang dimiliki oleh Akun AWS orang lain yang dapat Anda bentuk asosiasi akses nama domain.
aws apigateway get-domain-names \
--resource-owner OTHER_ACCOUNTS \
--region us-west-2
-
Setelah mengambil ARN, gunakan API Gateway untuk membuat asosiasi akses nama domain antara titik akhir VPC Anda dan nama domain kustom pribadi bersama. Gunakan perintah create-domain-name-access-association berikut:
aws apigateway create-domain-name-access-association \
--access-association-source-type VPCE \
--access-association-source 'vpce-1a2b3c4d5e6f1a2b3' \
--domain-name-arn arn:aws:apigateway:us-west-2:111122223333:/domainnames/private.example.com+abcd1234"
Outputnya akan terlihat seperti berikut ini.
{
"domainNameAccessAssociationARN": "arn:aws:apigateway:us-west-2:444455556666:/domainnameaccessassociations/domainname/private.example.com+abcd1234/vpcesource/vpce-abcd1234efg",
"accessAssociationSource": "vpce-1a2b3c4d5e6f1a2b3",
"accessAssociationSourceType": "VPCE",
"domainNameARN" : "arn:aws:apigateway:us-west-1:111122223333:/domainnames/private.example.com+a1b2c3"
}
Setelah Anda mengaitkan titik akhir VPC dengan nama domain kustom pribadi, konfirmasikan bahwa penyedia API Anda telah memperbarui kebijakan nama domain kustom pribadi mereka agar titik akhir VPC dapat memanggil nama domain mereka. Untuk informasi selengkapnya, lihat Izinkan akun lain untuk memanggil nama domain kustom pribadi Anda.
Buat zona yang dihosting Route 53
Untuk menyelesaikan nama domain kustom pribadi, Anda perlu membuat zona host pribadi Route 53. Zona yang dihosting adalah wadah yang menyimpan informasi tentang bagaimana Anda ingin merutekan lalu lintas untuk domain dalam satu atau lebih VPC tanpa mengekspos sumber daya Anda ke internet. Untuk informasi selengkapnya, lihat Menggunakan zona yang di-hosting pribadi.
- Konsol Manajemen AWS
-
Untuk menggunakan Konsol Manajemen AWS, lihat Membuat zona yang dihosting pribadi di Panduan Pengembang Amazon Route 53.
Untuk Nama, gunakan nama nama domain kustom pribadi. Untuk ID VPC, gunakan VPC yang berisi titik akhir VPC yang Anda gunakan untuk asosiasi akses nama domain Anda.
- AWS CLI
Perintah create-hosted-zone berikut membuat zona host pribadi:
aws route53 create-hosted-zone --name private.example.com \
--caller-reference 2014-04-01-18:47 \
--hosted-zone-config Comment="command-line version",PrivateZone=true \
--vpc VPCRegion=us-west-2,VPCId=vpc-abcd1234
Output berisi ID zona yang dihosting. Anda menggunakan ID zona yang dihosting dalam langkah-langkah berikut.
Buat catatan DNS Route 53
Setelah Anda membuat zona yang dihosting, Anda membuat catatan untuk menyelesaikan domain kustom pribadi. Dalam contoh ini, Anda membuat tipe rekaman A. 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.
- Konsol Manajemen AWS
-
Untuk menggunakan Konsol Manajemen AWS, lihat Mer utekan lalu lintas ke API Gateway API Amazon dengan menggunakan nama domain Anda.
Gunakan Quick create dan aktifkan Alias. Untuk titik akhir, gunakan nama DNS titik akhir VPC.
- AWS CLI
-
Untuk mengonfigurasi catatan DNS Anda untuk memetakan nama domain kustom pribadi ke nama host dari ID zona host yang diberikan, pertama-tama buat file JSON yang berisi konfigurasi untuk menyiapkan catatan DNS untuk nama domain pribadi.
Berikut ini setup-dns-record.json menunjukkan cara membuat A catatan DNS untuk memetakan nama domain kustom pribadi ke nama host pribadinya. Anda memberikan ID DNS VPC Anda, dan ID zona yang dihosting yang Anda buat pada langkah sebelumnya. DNSName
{
"Changes": [
{
"Action": "UPSERT",
"ResourceRecordSet": {
"Name": "private.example.com",
"Type": "A",
"AliasTarget": {
"DNSName": "vpce-abcd1234.execute-api.us-west-2.vpce.amazonaws.com",
"HostedZoneId": "Z2OJLYMUO9EFXC",
"EvaluateTargetHealth": false
}
}
}
]
}
Perintah change-resource-record-sets berikut membuat catatan DNS untuk nama domain kustom pribadi:
aws route53 change-resource-record-sets \
--hosted-zone-id ZABCDEFG1234 \
--change-batch file://path/to/your/setup-dns-record.json
Ganti hosted-zone-id dengan ID Zona Hosted Route 53 dari catatan DNS yang ditetapkan di akun Anda. Nilai change-batch parameter menunjuk ke file JSON.
Langkah selanjutnya untuk konsumen API
Anda sekarang dapat memanggil API pribadi Anda sendiri Akun AWS. Di VPC Anda, Anda dapat menggunakan perintah curl berikut untuk mengakses nama domain kustom pribadi Anda.
curl https://private.example.com/v1
Untuk informasi selengkapnya tentang cara lain untuk memanggil API pribadi Anda, lihatMemanggil API pribadi menggunakan nama domain khusus.
