Jenis alamat IP untuk nama domain kustom di API Gateway

Saat Anda membuat nama domain khusus, Anda menentukan jenis alamat IP yang dapat memanggil domain Anda. Anda dapat memilih IPv4 untuk menyelesaikan IPv4 alamat untuk memanggil domain Anda, atau Anda dapat memilih dualstack untuk mengizinkan keduanya IPv4 dan IPv6 alamat memanggil domain Anda. Kami menyarankan Anda mengatur jenis alamat IP ke dualstack untuk mengurangi kelelahan ruang IP atau untuk postur keamanan Anda. Untuk informasi selengkapnya tentang manfaat dari jenis alamat IP dualstack, lihat IPv6 di. AWS

Anda dapat mengubah jenis alamat IP dengan memperbarui konfigurasi titik akhir nama domain Anda.

Pertimbangan untuk jenis alamat IP

Pertimbangan berikut dapat memengaruhi penggunaan jenis alamat IP Anda.

• Jenis alamat IP default untuk nama domain kustom API Gateway untuk publik APIs adalah IPv4.

• Nama domain kustom pribadi hanya dapat memiliki tipe alamat IP dualstack.

• Nama domain kustom Anda tidak perlu memiliki jenis alamat IP yang sama untuk semua yang APIs dipetakan ke sana. Jika Anda menonaktifkan titik akhir API default, hal ini dapat memengaruhi cara penelepon dapat memanggil domain Anda.

Mengubah jenis alamat IP dari nama domain kustom

Anda dapat mengubah jenis alamat IP dengan memperbarui konfigurasi titik akhir nama domain. Anda dapat memperbarui konfigurasi titik akhir dengan menggunakan AWS Management Console,, AWS CLI AWS CloudFormation, atau AWS SDK.

AWS Management Console

Untuk mengubah jenis alamat IP dari nama domain kustom

1. Masuk ke konsol API Gateway di https://console.aws.amazon.com/apigateway.

2. Pilih nama domain kustom publik.

3. Pilih konfigurasi Endpoint.

4. Untuk jenis alamat IP, pilih salah satu IPv4atau Dualstack.

5. Pilih Simpan.

AWS CLI

update-domain-namePerintah berikut memperbarui API untuk memiliki tipe alamat IP dualstack:

aws apigateway update-domain-name \
    --domain-name dualstack.example.com \
    --patch-operations "op='replace',path='/endpointConfiguration/ipAddressType',value='dualstack'"

Outputnya akan terlihat seperti berikut:

{
    "domainName": "dualstack.example.com",
    "certificateUploadDate": "2025-02-04T14:46:10-08:00",
    "regionalDomainName": "d-abcd1234.execute-api.us-east-1.amazonaws.com",
    "regionalHostedZoneId": "Z3LQWSYCGH4ADY",
    "regionalCertificateArn": "arn:aws:acm:us-east-1:111122223333:certificate/a1b2c3d4-5678-90ab-cdef",
    "endpointConfiguration": {
        "types": [
            "REGIONAL"
        ],
        "ipAddressType": "dualstack"
    },
    "domainNameStatus": "AVAILABLE",
    "securityPolicy": "TLS_1_2",
    "tags": {}
}