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

AWS::EC2::CapacityReservation

使用指定的属性创建新的容量预留。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的容量预留

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::EC2::CapacityReservation", "Properties" : { "AvailabilityZone" : String, "EbsOptimized" : Boolean, "EndDate" : String, "EndDateType" : String, "EphemeralStorage" : Boolean, "InstanceCount" : Integer, "InstanceMatchCriteria" : String, "InstancePlatform" : String, "InstanceType" : String, "TagSpecifications" : [ TagSpecification, ... ], "Tenancy" : String } }

YAML

Type: AWS::EC2::CapacityReservation Properties: AvailabilityZone: String EbsOptimized: Boolean EndDate: String EndDateType: String EphemeralStorage: Boolean InstanceCount: Integer InstanceMatchCriteria: String InstancePlatform: String InstanceType: String TagSpecifications: - TagSpecification Tenancy: String

属性

AvailabilityZone

在其中创建容量预留的可用区。

必需:是

类型:字符串

Update requires: Replacement

EbsOptimized

指示容量预留是否支持 EBS 优化实例。此优化可为 Amazon EBS 提供专用吞吐量,并提供优化的配置堆栈以实现最佳 I/O 性能。某些实例类型不能使用此优化。使用 EBS 优化实例时,可能需要支付额外的使用费用。

必需:否

类型:布尔值

Update requires: Replacement

EndDate

容量预留的过期日期和时间。容量预留过期后,将释放预留容量,并且您无法再在其中启动实例。当容量预留的结束日期和时间已到时,容量预留的状态将变为 expired

如果 EndDateTypelimited,则必须提供 EndDate 值。如果 EndDateTypeunlimited,则忽略 EndDate

如果 EndDateTypelimited,则将在指定时间开始的一小时内取消容量预留。例如,如果您指定“5/31/2019, 13:30:55”,则容量预留可确保在 2019 年 5 月 31 日的 13:30:55 到 14:30:55 之间结束。

必需:否

类型:字符串

Update requires: No interruption

EndDateType

指示容量预留的结束方式。容量预留可具有下列结束类型之一:

  • unlimited - 容量预留保持活动状态,直到您明确取消它。如果 EndDateTypeunlimited,请不要提供 EndDate

  • limited - 容量预留在指定的日期和时间自动过期。如果 EndDateType 值为 limited,您必须提供 EndDate 值。

必需:否

类型:字符串

允许的值limited | unlimited

Update requires: No interruption

EphemeralStorage

指示容量预留是否支持具有临时块级存储的实例。

必需:否

类型:布尔值

Update requires: Replacement

InstanceCount

为其预留容量的实例的数量。

必需:是

类型:整数

Update requires: No interruption

InstanceMatchCriteria

指示容量预留接受的实例启动的类型。选项包括:

  • open - 容量预留自动匹配所有带匹配属性(实例类型、平台和可用区)的实例。具有匹配属性的实例会自动在容量预留中运行,而不指定任何其他参数。

  • targeted - 容量预留仅接受具有匹配属性(实例类型、平台和可用区)并明确定位到容量预留中的实例。这将确保仅允许的实例能够使用预留容量。

默认值:open

必需:否

类型:字符串

允许的值open | targeted

Update requires: Replacement

InstancePlatform

为其预留容量的操作系统的类型。

必需:是

类型:字符串

允许的值Linux with SQL Server Enterprise | Linux with SQL Server Standard | Linux with SQL Server Web | Linux/UNIX | Red Hat Enterprise Linux | SUSE Linux | Windows | Windows with SQL Server | Windows with SQL Server Enterprise | Windows with SQL Server Standard | Windows with SQL Server Web

Update requires: Replacement

InstanceType

为其预留容量的实例类型。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的实例类型

必需:是

类型:字符串

Update requires: Replacement

TagSpecifications

要在启动期间应用于容量预留的标签。

必需:否

类型TagSpecification 的列表

Update requires: Replacement

Tenancy

指示容量预留的租期。容量预留可具有下列租赁设置之一:

  • default - 在与其他 AWS 账户共享的硬件上创建容量预留。

  • dedicated - 在专用于单个 AWS 账户的单租户硬件上创建容量预留。

必需:否

类型:字符串

允许的值dedicated | default

Update requires: Replacement

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回资源 ID,例如 cr-1234ab5cd6789e0f1

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

Fn::GetAtt

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

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

AvailabilityZone

返回在其中预留容量的可用区。例如:us-east-1a

AvailableInstanceCount

返回剩余容量,表示可以在容量预留中启动的实例的数量。例如:9

InstanceType

返回为其预留容量的实例的类型。例如:m4.large

Tenancy

返回容量预留的租期。例如:dedicated

TotalInstanceCount

返回容量预留为其预留容量的实例的总数。例如:15

另请参阅

  • 适用于 Linux 实例的 Amazon Elastic Compute Cloud 用户指南 中的按需容量预留