AWS CloudFormation
ユーザーガイド (API バージョン 2010-05-15)

AWS::EC2::Instance Ebs

EBS ボリュームのブロックデバイスを指定します。

Ebs は、Amazon EC2 BlockDeviceMapping プロパティのプロパティです。

構文

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

JSON

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

YAML

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

プロパティ

DeleteOnTermination

インスタンス終了時に EBS ボリュームが削除されるかどうかを表します。

必須: いいえ

タイプ: ブール値

Update requires: No interruption

Encrypted

ボリュームを暗号化するかどうかを指定します。暗号化状態を true に設定した場合の効果は、ボリュームのオリジン (新規またはスナップショットから取得)、暗号化状態の開始、所有権、およびデフォルトで暗号化が有効であるかどうかによって異なります。詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「デフォルトでの暗号化」を参照してください。

暗号化された Amazon EBS ボリュームは、Amazon EBS 暗号化をサポートするインスタンスにアタッチする必要があります。詳細については、「サポートされるインスタンスタイプ」を参照してください。

必須: いいえ

タイプ: ブール値

Update requires: No interruption

Iops

ボリュームがサポートする 1 秒あたりの I/O オペレーションの数 (IOPS)。io1 ボリュームの場合、これはボリュームでプロビジョニングされている IOPS の数を表します。gp2 ボリュームの場合、これはボリュームのベースラインパフォーマンスと、バースト用の I/O クレジットがこのボリュームに蓄積されるレートを表します。詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「Amazon EBS ボリュームの種類」を参照してください。

制約: ほとんどのリージョンで、範囲は gp2 ボリュームで 100〜16,000 IOPS、io1 ボリュームで 100〜64,000 IOPS です。io1 の最大 IOPS である 64,000は、Nitro ベースのインスタンスでのみ保証されます。その他のインスタンスファミリーは、最大 32,000 IOPS までのパフォーマンスを保証します。詳細については、Amazon Elastic Compute Cloud ユーザーガイドの「Amazon EBS ボリュームの種類」を参照してください。

条件: このパラメータは、io1 ボリュームを作成するリクエストで必要です。gp2st1sc1、または standard ボリュームを作成するリクエストでは使用されません。

必須: 条件付き

タイプ: 整数

Update requires: No interruption

SnapshotId

スナップショットの ID。

SnapshotIdVolumeSize の両方を指定する場合、VolumeSize はスナップショットのサイズと同じか、それ以上である必要があります。

必須: 条件付き

タイプ: 文字列

Update requires: No interruption

VolumeSize

ボリュームのサイズ(GiB 単位).

デフォルト: スナップショットからボリュームを作成しており、ボリュームサイズを指定しない場合のデフォルトはスナップショットサイズです。

制約: 汎用 SSD (gp2) の場合は 1~16384、プロビジョンド IOPS SSD (io1) の場合は 4~16384、スループット最適化 HDD の場合は 500~16384 (st1)、Cold HDD の場合は 500~16384 (sc1)、マグネティック (standard) ボリュームの場合は 1~1024。スナップショットを指定する場合、ボリュームサイズはスナップショットサイズ以上である必要があります。

必須: 条件付き

タイプ: 整数

Update requires: No interruption

VolumeType

ボリュームタイプ。io1 タイプに設定した場合は、Iops プロパティも設定する必要があります。

デフォルト: standard

必須: いいえ

タイプ: 文字列

許可された値: gp2 | io1 | sc1 | st1 | standard

Update requires: No interruption

スナップショットからの EBS ボリュームの作成

この例では、スナップショットから 50GB の 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