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

AWS::EC2::VPC

利用您指定的 CIDR 块创建 Virtual Private Cloud (VPC)。要命名 VPC 资源,请使用 Tags 属性并指定 Name 键的值。

语法

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

JSON

{ "Type" : "AWS::EC2::VPC", "Properties" : { "CidrBlock" : String, "EnableDnsSupport" : Boolean, "EnableDnsHostnames" : Boolean, "InstanceTenancy" : String, "Tags" : [ Resource Tag, ... ] } }

YAML

Type: "AWS::EC2::VPC" Properties: CidrBlock: String EnableDnsSupport: Boolean EnableDnsHostnames: Boolean InstanceTenancy: String Tags: - Resource Tag

属性

CidrBlock

您希望 VPC 覆盖的 CIDR 块。例如:"10.0.0.0/16"

必需:是

类型:字符串

更新要求替换

EnableDnsSupport

指定是否支持 VPC 的 DNS 解析。如果该属性为 true,则 Amazon DNS 服务器会将您实例的 DNS 主机名称解析为相应的 IP 地址,否则不会解析。默认情况下,该值设置为 true

Required: No

Type: Boolean

更新要求无需中断

EnableDnsHostnames

指定在 VPC 中启动的实例是否获取 DNS 主机名。如果该属性为 true,则 VPC 内的实例可获得 DNS 主机名称,否则将无法获得。只有在也将 EnableDnsHostnames 属性设置为 true 的情况下,才可以将 EnableDnsSupport 设置为 true。默认情况下, 值设为 false.

Required: No

Type: Boolean

更新要求无需中断

InstanceTenancy

允许租户启动的实例已发布到 VPC 中。

  • "default":实例可通过任何租户启动。

  • "dedicated":在 VPC 中启动的任何实例自动具有专用租赁,除非您使用默认租户来启动它。

Required: No

类型:字符串

有效值"default""dedicated"

更新要求替换

Tags

此 VPC 的任意标签组(键/值对)。要命名 VPC 资源,请为 Name 键指定值。

Required: No

Type: AWS CloudFormation 资源标签

更新要求无需中断.

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回此资源 ID,如 vpc-18ac277d

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

Fn::GetAtt

Fn::GetAtt 返回一个此类型指定属性的值。以下为可用属性和示例返回值。

CidrBlock

用于 VPC 的一组 IP 地址。例如:10.0.0.0/16

CidrBlockAssociations

VPC 的 IPv4 CIDR 块关联 ID 的列表。例如:[ vpc-cidr-assoc-0280ab6b ]

DefaultNetworkAcl

与 VPC 关联的默认网络 ACL ID。例如:acl-814dafe3

DefaultSecurityGroup

与 VPC 关联的默认安全组 ID。例如:sg-b178e0d3

Ipv6CidrBlocks

与 VPC 关联的 IPv6 CIDR 块 (如 [ 2001:db8:1234:1a00::/56 ]) 的列表。

有关使用 Fn::GetAtt 的更多信息,请参见 Fn::GetAtt

示例

JSON

{ "AWSTemplateFormatVersion" : "2010-09-09", "Resources" : { "myVPC" : { "Type" : "AWS::EC2::VPC", "Properties" : { "CidrBlock" : "10.0.0.0/16", "EnableDnsSupport" : "false", "EnableDnsHostnames" : "false", "InstanceTenancy" : "dedicated", "Tags" : [ {"Key" : "foo", "Value" : "bar"} ] } } } }

YAML

AWSTemplateFormatVersion: '2010-09-09' Resources: myVPC: Type: AWS::EC2::VPC Properties: CidrBlock: 10.0.0.0/16 EnableDnsSupport: 'false' EnableDnsHostnames: 'false' InstanceTenancy: dedicated Tags: - Key: foo Value: bar

更多信息