AWS::EC2::VolumeAttachment
実行中のインスタンスに Amazon EBS ボリュームをアタッチし、指定したデバイス名でインスタンスに公開します。
このリソースを削除するには (ボリュームをデタッチするには) まず、インスタンスからボリュームをアンマウントする必要があります。アンマウントせずにデタッチすると、ボリュームがビジー状態のままになり、そのファイルシステムまたは格納されているデータが破損する可能性もあります。
インスタンスのルートデバイスである Amazon EBS ボリュームは、インスタンスの状態が "実行中" である間はデタッチできません。ルートボリュームをデタッチするには、まずインスタンスを停止してください。
AWS Marketplace 製品コード付きのインスタンスからルートボリュームをデタッチすると、そのボリュームの AWS Marketplace 製品コードとそのインスタンスとの関連付けが失われます。
構文
AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。
JSON
{ "Type" : "AWS::EC2::VolumeAttachment", "Properties" : { "Device" :
String
, "InstanceId" :String
, "VolumeId" :String
} }
YAML
Type: AWS::EC2::VolumeAttachment Properties: Device:
String
InstanceId:String
VolumeId:String
プロパティ
Device
-
デバイス名 (
/dev/sdh
、xvdh
など)。必須: はい
タイプ: 文字列
Update requires: Replacement
InstanceId
-
ボリュームのアタッチ先となるインスタンスの ID。この値には、
AWS::EC2::Instance
リソースのリファレンスを指定できるほか、既存の EC2 インスタンスの物理 ID を指定することができます。必須: はい
タイプ: 文字列
Update requires: Replacement
VolumeId
-
Amazon EBS ボリュームの ID。ボリュームとそのアタッチ先インスタンスは同じアベイラビリティーゾーンに存在している必要があります。この値には、
AWS::EC2::Volume
リソースのリファレンスを指定できるほか、既存の Amazon EBS ボリュームのボリューム ID を指定することができます。必須: はい
タイプ: 文字列
Update requires: Replacement
例
実行中のインスタンスに EBS ボリュームを接続する
この例では、論理名が "Ec2Instance" である EC2 インスタンスに EC2 EBS ボリュームをアタッチします。
JSON
"NewVolume" : { "Type" : "AWS::EC2::Volume", "Properties" : { "Size" : "100", "AvailabilityZone" : { "Fn::GetAtt" : [ "Ec2Instance", "AvailabilityZone" ] }, "Tags" : [ { "Key" : "MyTag", "Value" : "TagValue" } ] } }, "MountPoint" : { "Type" : "AWS::EC2::VolumeAttachment", "Properties" : { "InstanceId" : { "Ref" : "Ec2Instance" }, "VolumeId" : { "Ref" : "NewVolume" }, "Device" : "/dev/sdh" } }
YAML
NewVolume: Type: AWS::EC2::Volume Properties: Size: 100 AvailabilityZone: !GetAtt Ec2Instance.AvailabilityZone Tags: - Key: MyTag Value: TagValue DeletionPolicy: Snapshot MountPoint: Type: AWS::EC2::VolumeAttachment Properties: InstanceId: !Ref Ec2Instance VolumeId: !Ref NewVolume Device: /dev/sdh
以下の資料も参照してください。
-
Amazon Elastic Compute Cloud ユーザーガイドの「Amazon Elastic Block Store (Amazon EBS) 」
-
Amazon Elastic Compute Cloud ユーザーガイドの「インスタンスへのボリュームのアタッチ」
-
Amazon Elastic Compute Cloud ユーザーガイドの「インスタンスからの Amazon EBS ボリュームのデタッチ」
-
Amazon Elastic Compute Cloud API リファレンスの「AttachVolume」
-
Amazon Elastic Compute Cloud API リファレンスの「DetachVolume」