AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::EC2::NatGateway

AWS::EC2::NatGateway 资源可在指定的公有子网中创建网络地址转换器 (NAT) 网关。使用 NAT 网关可允许私有子网中的实例连接到 Internet 或其他 AWS 服务,但是阻止 Internet 发起与这些实例的连接。要了解更多信息和查看示例架构图,请参阅 Amazon VPC 用户指南 中的 NAT 网关

注意

如果您添加了指向 NAT 网关的默认路由(AWS::EC2::Route 资源),则为路由的 NatGatewayId 属性指定 NAT 网关的 ID。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

Copy
{ "Type" : "AWS::EC2::NatGateway", "Properties" : { "AllocationId" : String, "SubnetId" : String, "Tags" : [ Resource Tag, ... ] } }

YAML

Copy
Type: "AWS::EC2::NatGateway" Properties: AllocationId: String SubnetId: String Tags: - Resource Tag

属性

AllocationId

要与 NAT 网关关联的弹性 IP 地址的分配 ID。如果弹性 IP 地址与其他资源关联,则必须先取消关联。

Required: Yes

Type: String

更新要求替换

SubnetId

要在其中创建 NAT 网关的公有子网。

Required: Yes

Type: String

更新要求替换

Tags

指定要与此资源关联的任意一组标签 (键值对)。使用标签来管理您的资源。

Required: No

Type: AWS CloudFormation 资源标签

更新要求无需中断

返回值

Ref

如果将 AWS::EC2::NatGateway 资源的逻辑 ID 传递给内部函数 Ref,此函数返回 NAT 网关的 ID,如 nat-0a12bc456789de0fg

有关使用 Ref 功能的更多信息,请参阅参考

示例

下面的示例创建一个 NAT 网关以及将此 NAT 网关关联至路由表的路由。路由表必须与 Internet 网关关联,以便 NAT 网关能够连接 Internet。

JSON

Copy
"NAT" : { "DependsOn" : "VPCGatewayAttach", "Type" : "AWS::EC2::NatGateway", "Properties" : { "AllocationId" : { "Fn::GetAtt" : ["EIP", "AllocationId"]}, "SubnetId" : { "Ref" : "Subnet"}, "Tags" : [ {"Key" : "foo", "Value" : "bar" } ] } }, "EIP" : { "Type" : "AWS::EC2::EIP", "Properties" : { "Domain" : "vpc" } }, "Route" : { "Type" : "AWS::EC2::Route", "Properties" : { "RouteTableId" : { "Ref" : "RouteTable" }, "DestinationCidrBlock" : "0.0.0.0/0", "NatGatewayId" : { "Ref" : "NAT" } } }

YAML

Copy
NAT: DependsOn: VPCGatewayAttach Type: AWS::EC2::NatGateway Properties: AllocationId: Fn::GetAtt: - EIP - AllocationId SubnetId: Ref: Subnet Tags: - Key: foo Value: bar EIP: Type: AWS::EC2::EIP Properties: Domain: vpc Route: Type: AWS::EC2::Route Properties: RouteTableId: Ref: RouteTable DestinationCidrBlock: 0.0.0.0/0 NatGatewayId: Ref: NAT

本页内容: