AWS::EC2::EIP - AWS CloudFormation

AWS::EC2::EIP

Elastic IP (EIP) アドレスを指定し、オプションで Amazon EC2 インスタンスに関連付けることができます。

Elastic IP アドレスは、AWS が所有するアドレスプールから、または Bring Your Own IP (BYOIP) により AWS リソースで使用するために AWS に持ち込んだパブリック IPv4 アドレス範囲から作成されたアドレスプールから、割り当てることができます。詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「自分の IP アドレスを使用する (BYOIP)」を参照してください。

[EC2-VPC] Elastic IP アドレスを解放した場合、復元できる場合があります。別の AWS アカウントに割り当てられた後で解放した Elastic IP アドレスを復元することはできません。EC2-Classic の Elastic IP アドレスを復元することはできません。解放した Elastic IP アドレスの復元を試行するには、このオペレーションで指定します。

Elastic IP アドレスは、EC2-Classic プラットフォームまたは VPC で使用されます。デフォルトでは、リージョンごとに EC2-Classic に 5 つの Elastic IP アドレスを割り当て、リージョンごとに EC2-VPC に 5 つの Elastic IP アドレスを割り当てることができます。

詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「Elastic IP アドレス」を参照してください。

構文

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

JSON

{ "Type" : "AWS::EC2::EIP", "Properties" : { "Domain" : String, "InstanceId" : String, "PublicIpv4Pool" : String, "Tags" : [ Tag, ... ] } }

YAML

Type: AWS::EC2::EIP Properties: Domain: String InstanceId: String PublicIpv4Pool: String Tags: - Tag

プロパティ

Domain

Elastic IP アドレスが VPC のインスタンスで使用するか、EC2-Classic のインスタンスで使用するかを示します。

デフォルト: リージョンが EC2-Classic をサポートしている場合、デフォルトは standard です。それ以外の場合は、デフォルトは vpc です。

リージョンが EC2-Classic をサポートしている場合、VPC で使用するアドレスを割り当てるときに使用します。

Elastic IP アドレスを定義し、同じテンプレートに定義されている VPC に関連付ける場合は、このリソースの DependsOn 属性を使用して、VPC ゲートウェイのアタッチメントへの依存関係を宣言する必要があります。

必須: いいえ

タイプ: 文字列

許可された値: standard | vpc

Update requires: Replacement

InstanceId

インスタンスの ID。

重要

InstanceId プロパティに更新すると、一時的な中断が必要になる場合があります。EIP の更新は、関連付けられたリソースのアドレスを再度関連付けます。

必須: いいえ

タイプ: 文字列

Update requires: Some interruptions

PublicIpv4Pool

所有するアドレスプールの ID。Amazon EC2 がアドレスプールからアドレスを選択できるようにするには、このパラメータを使用します。

重要

PublicIpv4Pool プロパティに更新すると、一時的な中断が必要になる場合があります。EIP の更新は、関連付けられたリソースのアドレスを再度関連付けます。

必須: いいえ

タイプ: 文字列

Update requires: Some interruptions

Tags

Elastic IP アドレスに割り当てられた任意のタグ。

重要

Tags プロパティに更新すると、一時的な中断が必要になる場合があります。EIP の更新は、関連付けられたリソースのアドレスを再度関連付けます。

必須: いいえ

タイプ: Tag のリスト

Update requires: No interruption

戻り値

Ref

このリソースの論理 ID を組み込みの Ref 関数に渡すと、Ref は次を返します: Elastic IP アドレス 。

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

Fn::GetAtt

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

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

AllocationId

Amazon VPC で使用するアドレスの割り当てを表すために AWS によって割り当てられた ID。この値は、VPC の Elastic IP アドレスに対してのみ返されます。たとえば、eipalloc-5723d13e と指定します。

AWS::EC2::EIP を使用して Amazon EC2 Elastic IP を割り当てる。

この例では、AWS::EC2::EIP リソースを使用して Amazon EC2 Elastic IP アドレスを Amazon EC2 インスタンスに割り当てる方法を示します。

JSON

"MyEIP" : { "Type" : "AWS::EC2::EIP", "Properties" : { "InstanceId" : { "Ref" : "logical name of an AWS::EC2::Instance resource" } } }

YAML

MyEIP: Type: AWS::EC2::EIP Properties: InstanceId: !Ref Logical name of an AWS::EC2::Instance resource