volume_attachment
Gets or updates an individual volume_attachment resource, use volume_attachments to retrieve a list of resources or to create or delete a resource.
Overview
| Name | volume_attachment |
| Type | Resource |
| Description | Attaches an Amazon EBS volume to a running instance and exposes it to the instance with the specified device name.<br/> 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.<br/> 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.<br/> If the root volume is detached from an instance with an MKT product code, then the product codes from that volume are no longer associated with the instance. |
| Id | aws.ec2.volume_attachment |
Fields
| Name | Datatype | Description |
|---|---|---|
volume_id | string | 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 [AWS::EC2::Volume](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. |
instance_id | string | The ID of the instance to which the volume attaches. This value can be a reference to an [AWS::EC2::Instance](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. |
device | string | The device name (for example, /dev/sdh or xvdh). |
region | string | AWS region. |
Methods
| Name | Accessible by | Required Params |
|---|---|---|
get_resource | SELECT | data__Identifier, region |
SELECT Example
SELECT
region,
volume_id,
instance_id,
device
FROM aws.ec2.volume_attachment
WHERE region = 'us-east-1' AND data__Identifier = '<VolumeId>|<InstanceId>';
Permissions
To operate on the volume_attachment resource, the following permissions are required:
Read
ec2:DescribeVolumes