» rightscale_volume
Use this data source to locate and extract info about an existing volume to pass to other rightscale resources.
» Example Usage 1: Basic configuration of a volume data source
data "rightscale_volume" "a_volume" {
cloud_href = "${data.rightscale_cloud.ec2_us_oregon.href}"
filter {
name = "my_volume"
}
}
output "volume name" {
value = "${data.rightscale_volume.a_volume.name}"
}
output "volume href" {
value = "${data.rightscale_volume.a_volume.href}"
}
data "rightscale_cloud" "ec2_us_oregon" {
filter {
name = "EC2 us-west-2"
cloud_type = "amazon"
}
}
» Argument Reference
The following arguments are supported:
-
cloud_href
(Required) - The cloud_href the volume belongs to -
filter
(Optional) - The filter block supports:-
name
- The name of the volume -
description
- The description of the volume -
resource_uid
- The resource_uid of the volume. If this filter option is set, additional retry logic will be enabled to wait up to 5 minutes for cloud resources to be polled and populated for use. -
deployment_href
- The href of the deployment that contains the volume (e.g. /api/deployments/594684003) -
datacenter_href
- The href of the datacenter that holds the volume (e.g. /api/clouds/6/datacenters/6IHONC8ANOUHI) -
parent_volume_snapshot_href
- The href of snapshot the volume was created of
-
» Attributes Reference
The following attributes are exported:
-
name
- The name of the volume -
description
- The description of the volume -
resource_uid
- The resource_uid of the volume (e.g. vol-045e33fd28a746c45) -
links
- Hrefs of related API resources -
size
- The volume size (in GB) -
status
- The volume Status (e.g. available, in-use, ...) -
updated_at
- Last update of the volume -
id
- The volume ID (e.g. rs_cm:/api/clouds/1/volumes/63NFHKF8B7RP4) -
href
- Href of the volume (e.g. /api/clouds/1/volumes/63NFHKF8B7RP4)