メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::EC2::Subnet

既存の VPC 内にサブネットを作成します。

構文

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

JSON

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

YAML

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

プロパティ

AssignIpv6AddressOnCreation

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

必須: 条件による。AssignIpv6AddressOnCreationtrue の場合、Ipv6CidrBlock を指定する必要があります。

タイプ: ブール値

更新に伴う要件: 中断はありません。

AvailabilityZone

サブネットを作成するアベイラビリティーゾーンです。デフォルト: AWS によってゾーンが選択されます (推奨)。

必須: いいえ

タイプ: 文字列

更新に伴う要件: 置換

注記

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

CidrBlock

サブネットがカバーする CIDR ブロックです (たとえば "10.0.0.0/24")。

必須: はい

タイプ: 文字列

更新に伴う要件: 置換

注記

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

Ipv6CidrBlock

サブネットの IPv6 ネットワーク範囲 (CIDR 表記)。サブネットサイズには /64 プレフィックス長を使用する必要があります。

必須: いいえ

タイプ: 文字列

更新に伴う要件: 中断はありません。

MapPublicIpOnLaunch

このサブネットで起動されたインスタンスがパブリック IP アドレスを受け取るかどうかを示します。デフォルトでは、値は false に設定されます。

Required: No

Type: Boolean

更新に伴う要件: 中断はありません。

Tags

このサブネットに対する任意のタグのセット (キーと値のペア)。

Required: No

Type: AWS CloudFormation Resource Tags

更新に伴う要件: 中断はありません。

VpcId

サブネットを作成する VPC の ID を含む Ref 構造です。VPC ID は、{ "Ref": "VPCID" } のように、"Ref" プロパティの値として提供されます。

必須: はい

: Ref ID

更新に伴う要件: 置換

注記

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

戻り値

リソースの論理 ID を組み込み関数に渡すことで、リソースから値を戻すことができます。戻される値は、使用する関数によって異なります。

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref により subnet-e19f0178 のようなリソース ID が返されます。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

Fn::GetAtt

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

AvailabilityZone

このサブネットのアベイラビリティーゾーン (us-east-1a など) を返します。

例:

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

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

NetworkAclAssociationId

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

VpcId

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

Fn::GetAtt の使用の詳細については、「Fn::GetAtt」を参照してください。

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

JSON

Copy
{ "AWSTemplateFormatVersion" : "2010-09-09", "Resources" : { "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

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

詳細

このページの内容: