AWS CloudFormation
ユーザーガイド (API バージョン 2010-05-15)

AWS::EC2::Subnet

VPC のサブネットを指定します。

各サブネットを作成するときに、サブネットの VPC ID と IPv4 CIDR ブロックを提供します。サブネットを作成した後で、CIDR ブロックを変更することはできません。サブネットの IPv4 CIDR ブロックのサイズは、VPC の IPv4 CIDR ブロック、または VPC の IPv4 CIDR ブロックのサブセットと同じにすることができます。VPC に複数のサブネットを作成する場合、CIDR ブロックは重複してはいけません。作成できる最小の IPv4 サブネット (および VPC) は /28 ネットマスク (16 の IPv4 アドレス) を使用し、最大の IPv4 は /16 ネットマスク (65,536 の IPv4 アドレス) を使用します。

IPv6 CIDR ブロックを VPC に関連付けている場合、/64 プレフィックス長を使用する IPv6 CIDR ブロックでサブネットを作成できます。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

{ "Type" : "AWS::EC2::Subnet", "Properties" : { "AssignIpv6AddressOnCreation" : Boolean, "AvailabilityZone" : String, "CidrBlock" : String, "Ipv6CidrBlock" : String, "MapPublicIpOnLaunch" : Boolean, "Tags" : [ Tag, ... ], "VpcId" : String } }

YAML

Type: AWS::EC2::Subnet Properties: AssignIpv6AddressOnCreation: Boolean AvailabilityZone: String CidrBlock: String Ipv6CidrBlock: String MapPublicIpOnLaunch: Boolean Tags: - Tag VpcId: String

プロパティ

AssignIpv6AddressOnCreation

このサブネットで作成されたネットワークインターフェイスが IPv6 アドレスを受け取るかどうかを示します。デフォルト値は false です。

AssignIpv6AddressOnCreation を指定する場合は、Ipv6CidrBlock も指定する必要があります。

AssignIpv6AddressOnCreation を指定すると、MapPublicIpOnLaunch を指定することはできません。

必須: いいえ

タイプ: ブール値

Update requires: No interruption

AvailabilityZone

サブネットのアベイラビリティーゾーン。

このプロパティを更新する場合は、CidrBlock プロパティも更新しなければなりません。

必須: いいえ

タイプ: 文字列

Update requires: Replacement

CidrBlock

サブネットに割り当てられている IPv4 CIDR ブロック。

このプロパティを更新する場合は、AvailabilityZone プロパティも更新しなければなりません。

必須: はい

タイプ: 文字列

Update requires: Replacement

Ipv6CidrBlock

IPv6 CIDR ブロック。

AssignIpv6AddressOnCreation を指定する場合は、Ipv6CidrBlock も指定する必要があります。

必須: 条件付き

タイプ: 文字列

Update requires: No interruption

MapPublicIpOnLaunch

このサブネットで起動されたインスタンスがパブリック IPv4 アドレスを受け取るかどうかを示します。

MapPublicIpOnLaunch を指定すると、AssignIpv6AddressOnCreation を指定することはできません。

必須: いいえ

タイプ: ブール値

Update requires: No interruption

Tags

サブネットに割り当てられているすべてのタグ。

必須: いいえ

タイプ: Tag のリスト

Update requires: No interruption

VpcId

サブネットがある VPC の ID。

このプロパティを更新する場合は、CidrBlock プロパティも更新しなければなりません。

必須: はい

タイプ: 文字列

Update requires: Replacement

戻り値

参照番号

サブネットの ID このリソースの論理 ID を組み込みの Ref 関数に渡すと、Ref が返ります。。

For more information about using the Ref function, see Ref.

Fn::GetAtt

Fn::GetAtt 組み込み関数は、このタイプの指定された属性の値を返します。以下には、利用可能な属性とサンプル戻り値のリストが示されます。

Fn::GetAtt 組み込み関数の使用方法の詳細については、「Fn::GetAtt」を参照してください。

AvailabilityZone

このサブネットのアベイラビリティーゾーン。次に例を示します。

{ "Fn::GetAtt" : [ "mySubnet", "AvailabilityZone" ] }

Ipv6CidrBlocks

[ 2001:db8:1234:1a00::/64 ] などのサブネットに関連付けられる IPv6 CIDR ブロック。

NetworkAclAssociationId

サブネットの VPC に関連付けられるネットワーク ACL の ID (acl-5fb85d36 など)。

VpcId

サブネットの VPC の ID (vpc-11ad4878 など)。

サブネット

以下の例では、同じテンプレートの他の箇所で宣言された myVPC という VPC の VPC ID を使用します。

JSON

"mySubnet" : { "Type" : "AWS::EC2::Subnet", "Properties" : { "VpcId" : { "Ref" : "myVPC" }, "CidrBlock" : "10.0.0.0/24", "AvailabilityZone" : "us-east-1a", "Tags" : [ { "Key" : "foo", "Value" : "bar" } ] } }

YAML

mySubnet: Type: AWS::EC2::Subnet Properties: VpcId: Ref: myVPC CidrBlock: 10.0.0.0/24 AvailabilityZone: "us-east-1a" Tags: - Key: foo Value: bar

以下の資料も参照してください。