This is the new *CloudFormation Template Reference Guide*. Please update your bookmarks and links. For help getting started with CloudFormation, see the [AWS CloudFormation User Guide](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/Welcome.html).
# AWS::EC2::VolumeAttachment

Attaches an Amazon EBS volume to a running instance and exposes it to the instance with the specified device name.
Before this resource can be deleted (and therefore the volume detached), you must first unmount the volume in the instance. Failure to do so results in the volume being stuck in the busy state while it is trying to detach, which could possibly damage the file system or the data it contains.
If an Amazon EBS volume is the root device of an instance, it cannot be detached while the instance is in the "running" state. To detach the root volume, stop the instance first.
If the root volume is detached from an instance with an AWS Marketplace product code, then the product codes from that volume are no longer associated with the instance.
## Syntax

To declare this entity in your CloudFormation template, use the following syntax:
### JSON

```
{
 "Type" : "AWS::EC2::VolumeAttachment",
 "Properties" : {
 "[Device](#cfn-ec2-volumeattachment-device)" : {{String}},
 "[EbsCardIndex](#cfn-ec2-volumeattachment-ebscardindex)" : {{Integer}},
 "[InstanceId](#cfn-ec2-volumeattachment-instanceid)" : {{String}},
 "[VolumeId](#cfn-ec2-volumeattachment-volumeid)" : {{String}}
 }
}
```
### YAML

```
Type: AWS::EC2::VolumeAttachment
Properties:
 [Device](#cfn-ec2-volumeattachment-device): {{String}}
 [EbsCardIndex](#cfn-ec2-volumeattachment-ebscardindex): {{Integer}}
 [InstanceId](#cfn-ec2-volumeattachment-instanceid): {{String}}
 [VolumeId](#cfn-ec2-volumeattachment-volumeid): {{String}}
```
## Properties

`Device` 
The device name (for example, `/dev/sdh` or `xvdh`). 
*Required*: No 
*Type*: String 
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`EbsCardIndex` 
The index of the EBS card. Some instance types support multiple EBS cards. The default EBS card index is 0. 
*Required*: No 
*Type*: Integer 
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`InstanceId` 
The ID of the instance to which the volume attaches. This value can be a reference to an [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-instance.html) resource, or it can be the physical ID of an existing EC2 instance. 
*Required*: Yes 
*Type*: String 
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
`VolumeId` 
The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone. This value can be a reference to an [https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-ec2-ebs-volume.html) resource, or it can be the volume ID of an existing Amazon EBS volume. 
*Required*: Yes 
*Type*: String 
*Update requires*: [Replacement](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-update-behaviors.html#update-replacement)
## Examples

### Attach an EBS volume to a running instance

This example attaches an EC2 EBS volume to the EC2 instance with the logical name "Ec2Instance".
#### 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
```
## See also

+ [Attach an EBS volume to an instance](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-attaching-volume.html) 
+ [Detach an EBS volume from an instance](https://docs.aws.amazon.com/ebs/latest/userguide/ebs-detaching-volume.html) 
+ [AttachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-AttachVolume.html) in the *Amazon EC2 API Reference*
+ [DetachVolume](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/ApiReference-query-DetachVolume.html) in the *Amazon EC2 API Reference*
</div><div class="naked_ctrl">
<form action="/index.cgi/contrast" method="get" name="gate">
<p><a href="http://altstyle.alfasado.net">AltStyle</a> によって変換されたページ <a href="https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volumeattachment.md">(-&gt;オリジナル)</a>
/ <label>アドレス: <input type="text" name="naked_post_url" value="https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/aws-resource-ec2-volumeattachment.md" size="22" /></label> <label>モード: <select name="naked_post_mode">
<option value="default">デフォルト</option>
<option value="speech">音声ブラウザ</option>
<option value="ruby">ルビ付き</option>
<option value="contrast" selected="selected">配色反転</option>
<option value="larger-text">文字拡大</option>
<option value="mobile">モバイル</option>
</select>
<input type="submit" value="表示" />
</p>
</form>
</div>