AWS::EC2::EIP - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::EC2::EIP

指定一个弹性 IP (EIP) 地址,并且可以根据需要将其与 Amazon EC2 实例关联。

使用自带 IP 地址 (BYOIP),您可以从 AWS 拥有的地址池或从公共 IPv4 地址范围(您引入到 AWS 中以与 AWS 资源一起使用的地址范围)创建的地址池中分配弹性 IP 地址。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的自带 IP 地址 (BYOIP)

[EC2-VPC] 如果您释放了一个弹性 IP 地址,则可能能够恢复它。您无法恢复在分配给其他 AWS 账户后释放的弹性 IP 地址。您无法恢复 EC2-Classic 的弹性 IP 地址。要尝试恢复已释放的弹性 IP 地址,请在此操作中指定此地址。

弹性 IP 地址适用于 EC2-Classic 平台或 VPC。默认情况下,您可以为每个区域的 EC2-Classic 和 EC2-VPC 分别分配 5 个弹性 IP 地址。

有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的弹性 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

设置为 vpc 以分配用于 VPC 中的实例的地址。

默认值:此地址适用于 EC2-Classic 中的实例。

如果您定义弹性 IP 地址并且将其与相同模板中定义的 VPC 关联,则必须对该资源使用 DependsOn 属性,声明对 VPC 网关连接的依赖关系。

向 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

分配给弹性 IP 地址的任何标签。

重要

在更新 Tags 属性时,可能需要一些中断。在更新 EIP 时,将在关联的资源上重新关联该地址。

必需:否

类型Tag 的列表

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回 返回弹性 IP 地址。

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

Fn::GetAtt

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

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

AllocationId

AWS 分配的 ID,用于表示与 Amazon VPC 配合使用的地址的分配。该值仅针对 VPC 弹性 IP 地址返回。例如:eipalloc-5723d13e

示例

使用 AWS::EC2::EIP 分配 Amazon EC2 弹性 IP。

此示例显示了如何分配一个 Amazon EC2 弹性 IP 地址并将其分配给使用 AWS::EC2::EIP 资源的 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