volumes
Retrieves a list of volumes
in a region
Overview
Name | volumes |
Type | Resource |
Description | Specifies an Amazon Elastic Block Store (Amazon EBS) volume.<br/> When you use CFNlong to update an Amazon EBS volume that modifies ``Iops``, ``Size``, or ``VolumeType``, there is a cooldown period before another operation can occur. This can cause your stack to report being in ``UPDATE_IN_PROGRESS`` or ``UPDATE_ROLLBACK_IN_PROGRESS`` for long periods of time.<br/> Amazon EBS does not support sizing down an Amazon EBS volume. CFNlong does not attempt to modify an Amazon EBS volume to a smaller size on rollback.<br/> Some common scenarios when you might encounter a cooldown period for Amazon EBS include:<br/> + You successfully update an Amazon EBS volume and the update succeeds. When you attempt another update within the cooldown window, that update will be subject to a cooldown period.<br/> + You successfully update an Amazon EBS volume and the update succeeds but another change in your ``update-stack`` call fails. The rollback will be subject to a cooldown period.<br/> <br/> For more information on the coo |
Id | aws.ec2.volumes |
Fields
Name | Datatype | Description |
---|---|---|
volume_id | string | |
region | string | AWS region. |
Methods
Name | Accessible by | Required Params |
---|---|---|
create_resource | INSERT | data__DesiredState, region |
list_resource | SELECT | region |
SELECT
Example
SELECT
region,
volume_id
FROM aws.ec2.volumes
WHERE region = 'us-east-1'
Permissions
To operate on the volumes
resource, the following permissions are required:
Create
ec2:CreateVolume,
ec2:DescribeVolumes,
ec2:DescribeVolumeAttribute,
ec2:ModifyVolumeAttribute,
ec2:CreateTags,
kms:GenerateDataKeyWithoutPlaintext,
kms:CreateGrant
List
ec2:DescribeVolumes,
ec2:DescribeTags,
ec2:DescribeVolumeAttribute