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

AWS::EC2::Route

AWS::EC2::Route 资源在 VPC 中的路由表内创建新的路由。此路由目标既可以是连接到 VPC 的网关,也可以连接 VPC 中的 NAT 实例。

语法

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

JSON

{ "Type" : "AWS::EC2::Route", "Properties" : { "DestinationCidrBlock" : String, "DestinationIpv6CidrBlock" : String, "EgressOnlyInternetGatewayId" : String, "GatewayId" : String, "InstanceId" : String, "NatGatewayId" : String, "NetworkInterfaceId" : String, "RouteTableId" : String, "VpcPeeringConnectionId" : String } }

YAML

Type: "AWS::EC2::Route" Properties: DestinationCidrBlock: String DestinationIpv6CidrBlock: String EgressOnlyInternetGatewayId: String GatewayId: String InstanceId: String NatGatewayId: String NetworkInterfaceId: String RouteTableId: String VpcPeeringConnectionId: String

属性

DestinationCidrBlock

用于目标匹配的 IPv4 CIDR 地址块。例如:0.0.0.0/0。路由判断是根据最具体的匹配确定的。

Required: Conditional。您必须指定 DestinationCidrBlockDestinationIpv6CidrBlock 属性。

Type: String

更新要求替换

DestinationIpv6CidrBlock

用于目标匹配的 IPv6 CIDR 地址块。例如:::/0。路由判断是根据最具体的匹配确定的。

Required: Conditional。您必须指定 DestinationCidrBlockDestinationIpv6CidrBlock 属性。

Type: String

更新要求替换

EgressOnlyInternetGatewayId

附加到 VPC (仅限 IPv6) 的仅出口 Internet 网关的 ID。

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId。有关使用此属性的示例,请参阅带仅出口 Internet 网关的 Amazon EC2 路由

Type: String

更新要求无需中断

GatewayId

附加到 VPC 的 Internet 网关或虚拟私有网关的 ID。例如:igw-eaad4883

对于指定网关的路由条目,您必须指定对网关连接资源的依赖关系。有关更多信息,请参阅 DependsOn 属性

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId

Type: String

更新要求无需中断

InstanceId

您的 VPC 中的 NAT 实例。例如:i-1a2b3c4d

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId

Type: String

更新要求无需中断

NatGatewayId

NAT 网关的 ID。例如:nat-0a12bc456789de0fg

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId

Type: String

更新要求无需中断

NetworkInterfaceId

允许网络接口 ID 路由。

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId

Type: String

更新要求无需中断

RouteTableId

添加路由的路由表 ID。

必需:是

Type: String

更新要求替换

VpcPeeringConnectionId

VPC 对等连接的 ID。

Required: Conditional。您只能指定下列属性之一:EgressOnlyInternetGatewayIdGatewayIdInstanceIdNatGatewayIdNetworkInterfaceIdVpcPeeringConnectionId

Type: String

更新要求无需中断

返回值

Ref

当该资源的逻辑 ID 提供给 Ref内部函数时,Ref 将返回资源名称。

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

示例

下面的示例创建将添加到网关的路由。

JSON

{ "AWSTemplateFormatVersion" : "2010-09-09", "Resources" : { "myRoute" : { "Type" : "AWS::EC2::Route", "DependsOn" : "GatewayToInternet", "Properties" : { "RouteTableId" : { "Ref" : "myRouteTable" }, "DestinationCidrBlock" : "0.0.0.0/0", "GatewayId" : { "Ref" : "myInternetGateway" } } } } }

YAML

AWSTemplateFormatVersion: '2010-09-09' Resources: myRoute: Type: AWS::EC2::Route DependsOn: GatewayToInternet Properties: RouteTableId: Ref: myRouteTable DestinationCidrBlock: 0.0.0.0/0 GatewayId: Ref: myInternetGateway

更多信息