本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# API Gateway 中自訂網域名稱的 IP 地址類型
<a name="rest-custom-domain-ip-address-type"></a>

當您建立自訂網域名稱時，您可以指定可叫用網域的 IP 地址類型。您可以選擇 IPv4 來解析要叫用網域的 IPv4 地址，也可以選擇雙堆疊來允許 IPv4 和 IPv6 地址叫用您的網域。我們建議您將 IP 地址類型設定為 dualstack，以減輕 IP 空間耗盡或用於安全狀態。如需雙堆疊 IP 地址類型優點的詳細資訊，請參閱 [上的 IPv6 AWS](https://docs.aws.amazon.com/whitepapers/latest/ipv6-on-aws/internet-protocol-version-6.html)。

您可以透過更新網域名稱的端點組態來變更 IP 地址類型。

## IP 地址類型的考量事項
<a name="api-gateway-ip-address-type-considerations"></a>

下列考量事項可能會影響您使用 IP 地址類型。
+ 公有 API 的 API Gateway APIs 自訂網域名稱預設 IP 地址類型為 IPv4。
+ 私有自訂網域名稱只能具有雙堆疊 IP 地址類型。
+ 您的自訂網域名稱不需要具有與其對應之所有 APIs的相同 IP 地址類型。如果您停用預設 API 端點，這可能會影響發起人如何叫用您的網域。

## 變更自訂網域名稱的 IP 地址類型
<a name="rest-custom-domain-ip-address-type-change"></a>

您可以更新網域名稱的端點組態來變更 IP 地址類型。您可以使用 AWS 管理主控台 AWS CLI CloudFormation、 或 AWS SDK 來更新端點組態。

------
#### [ AWS 管理主控台 ]

**變更自訂網域名稱的 IP 地址類型**

1. 在以下網址登入 API Gateway 主控台：[https://console.aws.amazon.com/apigateway](https://console.aws.amazon.com/apigateway)。

1. 選擇公有自訂網域名稱。

1. 選擇**端點組態**。

1. 針對 IP 地址類型，選取 **IPv4** 或 **Dualstack**。

1. 選擇**儲存**。

------
#### [ AWS CLI ]

下列 [update-domain-name](https://docs.aws.amazon.com/cli/latest/reference/apigateway/update-domain-name.html) 命令會將 API 更新為具有 dualstack 的 IP 地址類型：

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

輸出將如下所示：

```
{
    "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": {}
}
```

------