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

AWS::EC2::Instance Ebs

描述 EBS 卷的块储存设备。

EbsAmazon EC2 BlockDeviceMapping 属性的属性。

语法

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

JSON

{ "DeleteOnTermination" : Boolean, "Encrypted" : Boolean, "Iops" : Integer, "KmsKeyId" : String, "SnapshotId" : String, "VolumeSize" : Integer, "VolumeType" : String }

YAML

DeleteOnTermination: Boolean Encrypted: Boolean Iops: Integer KmsKeyId: String SnapshotId: String VolumeSize: Integer VolumeType: String

属性

DeleteOnTermination

指示是否在实例终止时删除 EBS 卷。有关更多信息,请参阅《Amazon Elastic Compute Cloud 用户指南》中的在实例终止时保留 Amazon EBS 卷

必需:否

类型:布尔值

Update requires: No interruption

Encrypted

指定是否应对卷进行加密。将加密状态设置为 true 的效果取决于卷源(新建卷或从快照获取卷)、开始加密状态、所有权以及默认是否已启用加密。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的默认加密

加密的 Amazon EBS 卷必须挂载到支持 Amazon EBS 加密的实例。有关更多信息,请参阅支持的实例类型

必需:否

类型:布尔值

Update requires: No interruption

Iops

卷支持的每秒 I/O 操作数 (IOPS)。对于 io1,这表示为卷预配置的 IOPS 数。对于 gp2,这表示卷的基准性能和卷积累用于突增情况的 I/O 积分的速度。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的 Amazon EBS 卷类型

约束:在大多数区域内,范围为 100 至 16000 IOPS(对于 gp2 卷)和 100 至 64000 IOPS(对于 io1 卷)。最大 io1 IOPS 64,000 仅在基于 Nitro 的实例上是可保证的。其他实例系列可确保最高 32000 IOPS 的性能。有关更多信息,请参阅 Amazon Elastic Compute Cloud 用户指南 中的 Amazon EBS 卷类型

条件:该参数对于创建 io1 卷的请求来说是必需的;在创建 gp2st1sc1standard 卷的请求中不使用该参数。

必需:条件

类型:整数

Update requires: No interruption

KmsKeyId

用来对 EBS 卷进行加密的客户托管 CMK 的标识符(密钥 ID、密钥别名、ID ARN 或别名 ARN)。

必需:否

类型:字符串

Update requires: Replacement

SnapshotId

快照的 ID。

如果同时指定 SnapshotIdVolumeSize,则 VolumeSize 必须等于或大于快照大小。

必需:条件

类型:字符串

Update requires: No interruption

VolumeSize

卷的大小(以 GiB 计算).

默认值:如果您要从快照中创建卷,但未指定卷大小,则默认值为快照大小。

约束:1-16384(对于通用型 SSD (gp2))、4-16384(对于预配置 IOPS SSD (io1))、500-16384(对于吞吐量优化型 HDD (st1))、500-16384(对于 Cold HDD (sc1))以及 1-1024(对于磁性介质 (standard) 卷)。如果您指定快照,则卷大小必须大于或等于快照大小。

必需:条件

类型:整数

Update requires: No interruption

VolumeType

卷的类型。如果将类型设置为 io1,您还必须指定 Iops 参数。如果将类型设置为 gp2st1sc1standard,您必须省略 Iops 参数。

默认值:gp2

必需:否

类型:字符串

允许的值gp2 | io1 | sc1 | st1 | standard

Update requires: No interruption

示例

从快照创建 EBS 卷

此示例从快照创建 50 GB io1 EBS 卷,并将其配置为支持 1000 IOPS,并在终止其连接的实例后保持连接。

JSON

{ "DeviceName": "/dev/sdc", "Ebs": { "SnapshotId": "snap-xxxxxxxx", "VolumeSize": "50", "VolumeType": "io1", "Iops": "1000", "DeleteOnTermination": "false" } }

YAML

BlockDeviceMappings: - DeviceName: /dev/sdc Ebs: SnapshotId: snap-xxxxxxxx VolumeSize: 50 VolumeType: io1 Iops: 1000 DeleteOnTermination: false

另请参阅

  • Amazon Elastic Compute Cloud API 参考 中的 CreateVolume