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

AWS::EC2::NetworkInterface

AWS CloudFormation の Elastic Compute Cloud (EC2) インスタンスにおけるネットワークインターフェイスを記述します。これは、NetworkInterfacesAWS::EC2::Instance プロパティにリスト形式で指定されます。

構文

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

JSON

Copy
{ "Type" : "AWS::EC2::NetworkInterface", "Properties" : { "Description" : String, "GroupSet" : [ String, ... ], "Ipv6AddressCount" : Integer, "Ipv6Addresses" : [ Ipv6Address, ... ], "PrivateIpAddress" : String, "PrivateIpAddresses" : [ PrivateIpAddressSpecification, ... ], "SecondaryPrivateIpAddressCount" : Integer, "SourceDestCheck" : Boolean, "SubnetId" : String, "Tags" : [ リソースタグ, ... ] } }

YAML

Copy
Type: "AWS::EC2::NetworkInterface" Properties: Description: String GroupSet: - 文字列 Ipv6AddressCount: Integer Ipv6Addresses: - Ipv6Address PrivateIpAddress: String PrivateIpAddresses: - PrivateIpAddressSpecification SecondaryPrivateIpAddressCount: Integer SourceDestCheck: Boolean SubnetId: String Tags: - リソースタグ

プロパティ

Description

このネットワークインターフェイスの説明。

Required: No

Type: String

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

GroupSet

このネットワークインターフェイスに関連付けられているセキュリティグループ ID のリスト。

Required: No

: 文字列のリスト。

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

Ipv6AddressCount

ネットワークインターフェイスに関連付る IPv6 アドレスの数。EC2 はサブネットの範囲から自動的に IPv6 アドレスを選択します。固有 IPv6 アドレスを指定するには、Ipv6Addresses のプロパティを使用し、このプロパティは指定しないでください。

Required: No

Type: Integer

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

Ipv6Addresses

ネットワークインターフェイスに関連付けるためのサブネットの IPv6 CIDR ブロック範囲からの 1 つ以上の IPv6 アドレス。IPv6 アドレスの数を指定する場合は、Ipv6AddressCountのプロパティを使用し、このプロパティは指定しないでください。

Required: No

EC2 NetworkInterface Ipv6AddressesType: リスト

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

PrivateIpAddress

ネットワークインターフェイスに単一のプライベート IP アドレスを割り当てます。このアドレスがプライマリプライベート IP アドレスとして使用されます。複数のプライベート IP アドレスを指定する場合は、PrivateIpAddresses プロパティを使用します。

Required: No

Type: String

更新に伴う要件: 置換

PrivateIpAddresses

ネットワークインターフェイスに一連のプライベート IP アドレスを割り当てます。プライマリプライベート IP アドレスは、PrivateIpAddressSpecification プロパティで Primary プロパティの値を true に設定することによって指定できます。プライベート IP アドレスが EC2 によって自動的に割り当てられるようにする場合は、このプロパティを指定せず、SecondaryPrivateIpAddressCountプロパティを使用します。

プライベート IP アドレスの最大数については、Linux インスタンス用 Amazon EC2 ユーザーガイドの「インスタンスタイプあたりの ENI ごとのプライベート IP アドレス」を参照してください。

Required: No

: PrivateIpAddressSpecification のリスト。

プライマリプライベート IP アドレスを変更する場合は更新に伴う要件: 置換。それ以外の場合、更新に伴う中断はありません

SecondaryPrivateIpAddressCount

ネットワークインターフェイスに EC2 が自動的に割り当てるセカンダリプライベート IP アドレスの数。EC2 では、PrivateIpAddress プロパティの値がプライマリプライベート IP アドレスとして使用されます。そのプロパティを指定しなかった場合、プライマリとセカンダリの両方のプライベート IP アドレスが EC2 によって自動的に割り当てられます。

プライベート IP アドレスのリストを独自に指定する場合は、このプロパティを指定せずに、PrivateIpAddresses プロパティを使用してください。

プライベート IP アドレスの最大数については、Linux インスタンス用 Amazon EC2 ユーザーガイドの「インスタンスタイプあたりの ENI ごとのプライベート IP アドレス」を参照してください。

Required: No

型: 整数。

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

SourceDestCheck

インスタンスへのトラフィックまたはインスタンスからのトラフィックを検証するかどうかを示すフラグ。

Required: No

Type: Boolean

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

SubnetId

ネットワークインターフェイスに関連付けるサブネットの ID。

Required: Yes

Type: String

更新に伴う要件: 置換

Tags

このネットワークインターフェイスに対する任意のタグのセット (キーと値のペア)。

Required: No

Type: AWS CloudFormation Resource Tags

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

戻り値

参照番号

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

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

Fn::GetAtt

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

PrimaryPrivateIpAddress

ネットワークインターフェイスのプライマリプライベート IP アドレスを返します。たとえば、10.0.0.192 と指定します。

SecondaryPrivateIpAddresses

ネットワークインターフェイスのセカンダリプライベート IP アドレスを返します。たとえば、["10.0.0.161", "10.0.0.162", "10.0.0.163"] と指定します。

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

ヒント

NetworkInterface テンプレートサンプルの詳細については、「Elastic Network Interface (ENI) のテンプレートスニペット」を参照してください。

シンプルなスタンドアロン ENI

これは、シンプルなスタンドアロン Elastic Network Interface (ENI) です。利用可能なプロパティをすべて使用しています。

JSON

Copy
{ "AWSTemplateFormatVersion" : "2010-09-09", "Description" : "Simple Standalone ENI", "Resources" : { "myENI" : { "Type" : "AWS::EC2::NetworkInterface", "Properties" : { "Tags": [{"Key":"foo","Value":"bar"}], "Description": "A nice description.", "SourceDestCheck": "false", "GroupSet": ["sg-75zzz219"], "SubnetId": "subnet-3z648z53", "PrivateIpAddress": "10.0.0.16" } } } }

YAML

Copy
AWSTemplateFormatVersion: '2010-09-09' Description: Simple Standalone ENI Resources: myENI: Type: AWS::EC2::NetworkInterface Properties: Tags: - Key: foo Value: bar Description: A nice description. SourceDestCheck: 'false' GroupSet: - sg-75zzz219 SubnetId: subnet-3z648z53 PrivateIpAddress: 10.0.0.16

EC2 インスタンスの ENI

これは、EC2 インスタンスの ENI の例です。この例では、ENI が 1 つインスタンスに追加されます。NetworkInterface プロパティのリストを指定して、複数の ENI を追加することもできます。ただし、複数の ENI を指定できるのは、いずれの ENI も、割り当てられているのがプライベート IP アドレスのみである (パブリック IP アドレスが関連付けられていない) 場合に限られます。いずれかの ENI にパブリック IP アドレスが割り当てられている場合は、そのアドレスを指定したうえで、AWS::EC2::NetworkInterfaceAttachment リソースを使用し、他の ENI を追加してください。

JSON

Copy
"Ec2Instance" : { "Type" : "AWS::EC2::Instance", "Properties" : { "ImageId" : { "Fn::FindInMap" : [ "RegionMap", { "Ref" : "AWS::Region" }, "AMI" ]}, "KeyName" : { "Ref" : "KeyName" }, "SecurityGroupIds" : [{ "Ref" : "WebSecurityGroup" }], "SubnetId" : { "Ref" : "SubnetId" }, "NetworkInterfaces" : [ { "NetworkInterfaceId" : {"Ref" : "controlXface"}, "DeviceIndex" : "1" } ], "Tags" : [ {"Key" : "Role", "Value" : "Test Instance"}], "UserData" : { "Fn::Base64" : { "Ref" : "WebServerPort" }} } }

YAML

Copy
Ec2Instance: Type: AWS::EC2::Instance Properties: ImageId: Fn::FindInMap: - RegionMap - Ref: AWS::Region - AMI KeyName: Ref: KeyName SecurityGroupIds: - Ref: WebSecurityGroup SubnetId: Ref: SubnetId NetworkInterfaces: - NetworkInterfaceId: Ref: controlXface DeviceIndex: '1' Tags: - Key: Role Value: Test Instance UserData: Fn::Base64: Ref: WebServerPort

詳細

このページの内容: