# API Gateway の REST API の IP アドレスタイプ
<a name="api-gateway-ip-address-type"></a>

API を作成する際、API を呼び出すことができる IP アドレスのタイプを指定します。IPv4 を選択して IPv4 アドレスを解決し、API を呼び出すことができます。デュアルスタックを選択すると、API の呼び出しを IPv4 アドレスと IPv6 アドレスの両方に許可できます。IP アドレスタイプをデュアルスタックに設定して、IP スペースの枯渇の問題を軽減したり、セキュリティ体制を強化したりすることをお勧めします。デュアルスタック IP アドレスタイプの利点の詳細については、「[IPv6 on AWS](https://docs.aws.amazon.com/whitepapers/latest/ipv6-on-aws/internet-protocol-version-6.html)」を参照してください。

API を IPv6 トラフィックのみに制限するには、リソースポリシーを作成して、ソース IP アドレスを IPv6 範囲のみに制限します。IP アドレスタイプは、API の設定を更新して、変更できます。この変更はすぐに有効になり、API を再デプロイする必要はありません。詳細については、[例: 送信元の IP アドレスまたは IP アドレスの範囲に基づき、API トラフィックを拒否する](apigateway-resource-policies-examples.md#apigateway-resource-policies-source-ip-address-example)を参照してください。

## IP アドレスタイプに関する考慮事項
<a name="api-gateway-ip-address-type-considerations"></a>

以下の考慮事項は、IP アドレスタイプの使用に影響する可能性があります。
+ すべてのリージョンおよびエッジ最適化 API のデフォルトの IP アドレスタイプは IPv4 です。
+ プライベート API は、デュアルスタック IP アドレスタイプのみを指定できます。
+ 既存の API の IP アドレスタイプを IPv4 からデュアルスタックに変更する場合、API へのアクセスを制御するポリシーが IPv6 呼び出しを考慮して更新されていることを確認します。IP アドレスタイプを変更すると、変更はすぐに有効になります。
+ API のエンドポイントタイプをリージョンまたはエッジ最適化からプライベートに移行すると、API Gateway によって IP アドレスタイプがデュアルスタックに変更されます。詳細については、「[API Gateway で API エンドポイントタイプを変更する (パブリックまたはプライベート)](apigateway-api-migration.md)」を参照してください。
+ API のエンドポイントタイプをプライベートからリージョンに移行する場合、IP アドレスタイプをデュアルスタックに設定する必要があります。エンドポイントの移行が完了したら、IP アドレスタイプを IPv4 に変更できます。詳細については、「[API Gateway で API エンドポイントタイプを変更する (パブリックまたはプライベート)](apigateway-api-migration.md)」を参照してください。
+ API は、その API とは異なる IP アドレスタイプのカスタムドメイン名にマッピングできます。デフォルトの API エンドポイントを無効にすると、発信者が API を呼び出す方法が影響を受ける可能性があります。
+ 外部定義ファイルを使用して API の IP アドレスタイプを設定することはできません。