Amazon API Gateway 现已支持双栈（IPv4 和 IPv6）端点，允许用户同时接受来自 IPv6 和 IPv4 客户端的调用。此更新适用于所有端点类型、自定义域和管理 API，旨在应对日益增长的 IPv4 地址稀缺问题，并帮助用户构建更具未来兼容性的网络基础设施。通过 AWS 管理控制台或 AWS Cloud Development Kit (CDK) 即可轻松配置双栈资源，为用户提供平滑的过渡路径。

🌐 Amazon API Gateway 现已支持双栈 (IPv4 和 IPv6) 端点，允许用户配置 REST、HTTP 和 WebSocket API 以及自定义域，以接受来自 IPv6 客户端的调用。

🖥️ 用户可以通过 AWS 管理控制台或 AWS Cloud Development Kit (CDK) 创建新的双栈 API 或域名。在控制台中，创建 API 或域名时，可以选择 IPv4 或双栈 (IPv4 和 IPv6) 作为 IP 地址类型。

⚙️ 如果需要，可以修改 IP 地址类型设置，无需重新部署 API 即可生效。所有端点类型的 REST API（EDGE、REGIONAL 和 PRIVATE）都支持双栈。私有 REST API 仅支持双栈配置。

💡 当 API 开始接收 IPv6 流量时，客户端源 IP 将采用 IPv6 格式。如果使用资源策略、Lambda 授权方或引用源 IP 地址的 IAM 策略，请确保它们已更新以适应 IPv6 地址格式。

<section class="blog-post-content lb-rtxt"><table id="amazon-polly-audio-table"><tbody><tr><td id="amazon-polly-audio-tab"><p></p></td></tr></tbody></table><p>Today, we are launching IPv6 support for <a href="https://aws.amazon.com/api-gateway/?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el&quot;&gt;Amazon API Gateway</a> across all endpoint types, custom domains, and management APIs, in all commercial and AWS GovCloud (US) Regions. You can now configure REST, HTTP, and WebSocket APIs, and custom domains, to accept calls from IPv6 clients alongside the existing IPv4 support. You can also call API Gateway management APIs from dual-stack (IPv6 and IPv4) clients. As organizations globally confront growing IPv4 address scarcity and increasing costs, implementing IPv6 becomes critical for future-proofing network infrastructure. This dual-stack approach helps organizations maintain future network compatibility and expand global reach. To learn more about dualstack in the Amazon <a href="https://aws.amazon.com/?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el&quot;&gt;Web Services (AWS)</a> environment, see the <a href="https://docs.aws.amazon.com/whitepapers/latest/ipv6-on-aws/IPv6-on-AWS.html&quot;&gt;IPv6 on AWS</a> documentation.</p><p><strong class="c4">Creating new dual-stack resources</strong></p><p>This post focuses on two ways to create an API or a domain name with a dualstack IP address type: <a href="https://aws.amazon.com/console/?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el&quot;&gt;AWS Management Console</a> and <a href="https://aws.amazon.com/cdk/?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el&quot;&gt;AWS Cloud Development Kit (CDK).</a></p><p><strong>AWS Console</strong></p><p>When creating a new API or domain name in the console, select IPv4 only or dualstack (IPv4 and IPv6) for the IP address type.</p><p>As shown in the following image, you can select the dualstack option when creating a new REST API.<a href="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/create-rest-api.png&quot;&gt;&lt;br /><img class="aligncenter size-full wp-image-94585" src="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/create-rest-api.png&quot; alt="" width="1032" height="752" /></a>For custom domain names, you can similarly configure dualstack as shown in the next image.<a href="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/custom-domain-dualstack-create.png&quot;&gt;&lt;img class="aligncenter size-full wp-image-94587" src="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/custom-domain-dualstack-create.png&quot; alt="" width="1043" height="719" /></a></p><p>If you need to revert to IPv4-only for any reason, you can modify the IP address type setting, with no need to redeploy your API for the update to take effect.<br /><a href="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/change-to-ipv4.png&quot;&gt;&lt;img class="aligncenter size-full wp-image-94589" src="https://d2908q01vomqb2.cloudfront.net/da4b9237bacccdf19c0760cab7aec4a8359010b0/2025/03/22/change-to-ipv4.png&quot; alt="" width="1035" height="752" /></a></p><p>REST APIs of all endpoint types (EDGE, REGIONAL and PRIVATE) support dualstack. Private REST APIs only support dualstack configuration.</p><p><strong>AWS CDK</strong></p><p>With AWS CDK, start by configuring a dual-stack REST API and domain name.</p><p><strong class="c4">IPv6 Source IP and authorization</strong></p><p>When your API begins receiving IPv6 traffic, client source IPs will be in IPv6 format. If you use resource policies, Lambda authorizers, or <a href="https://aws.amazon.com/iam/?nc2=type_a?trk=d21a4eb6-d91f-4286-843a-d35b2a06a274&amp;amp;sc_channel=el&quot;&gt;AWS Identity and Access Management (IAM)</a> policies that reference source IP addresses, make sure they’re updated to accommodate IPv6 address formats.</p><p>For example, to permit traffic from a specific IPv6 range in a resource policy.</p><p><strong>Summary</strong></p><p>API Gateway dual-stack support helps manage IPv4 address scarcity and costs, comply with government and industry mandates, and prepare for the future of networking. The dualstack implementation provides a smooth transition path by supporting both IPv4 and IPv6 clients simultaneously.</p><p>To get started with API Gateway dual-stack support, visit the <a href="https://docs.aws.amazon.com/apigateway/latest/developerguide/api-gateway-ip-address-type.html&quot;&gt;Amazon API Gateway</a> documentation. You can configure dualstack for new APIs or update existing APIs with minimal configuration changes.</p><p>–<a href="http://www.linkedin.com/in/zhengyubin714&quot;&gt;Betty&lt;/a&gt;&lt;/p&gt;&lt;p&gt;&lt;strong&gt;&lt;em&gt;Special thanks to Ellie Frank (elliesf), Anjali Gola (anjaligl), and Pranika Kakkar (pranika) for providing resources, answering questions, and offering valuable feedback during the writing process. This blog post was made possible through the collaborative support of the service and product management teams.</em></strong></p><hr /><p>How is the News Blog doing? Take this <a href="https://amazonmr.au1.qualtrics.com/jfe/form/SV_eyD5tC5xNGCdCmi&quot;&gt;1 minute survey</a>!</p><p><em>(This <a href="https://amazonmr.au1.qualtrics.com/jfe/form/SV_eyD5tC5xNGCdCmi&quot;&gt;survey&lt;/a&gt; is hosted by an external company. AWS handles your information as described in the <a href="https://aws.amazon.com/privacy/&quot;&gt;AWS Privacy Notice</a>. AWS will own the data gathered via this survey and will not share the information collected with survey respondents.)</em></p></section><aside id="Comments" class="blog-comments"><div data-lb-comp="aws-blog:cosmic-comments" data-env="prod" data-content-id="234356ff-96b1-4aed-b8fc-ede6e70ebe71" data-title="Amazon API Gateway now supports dual-stack (IPv4 and IPv6) endpoints" data-url="https://aws.amazon.com/blogs/aws/amazon-api-gateway-now-supports-dual-stack-ipv4-and-ipv6-endpoints/&quot;&gt;&lt;p data-failed-message="Comments cannot be loaded… Please refresh and try again.">Loading comments…</p></div></aside>