openstack_blockstorage_volume_v3

Manages a V3 volume resource within OpenStack.

Example Usage

resource "openstack_blockstorage_volume_v3" "volume_1" {
  region      = "RegionOne"
  name        = "volume_1"
  description = "first test volume"
  size        = 3
}

Argument Reference

The following arguments are supported:

• region - (Optional) The region in which to create the volume. If omitted, the region argument of the provider is used. Changing this creates a new volume.

• size - (Required) The size of the volume to create (in gigabytes).

• enable_online_resize - (Optional) When this option is set it allows extending attached volumes. Note: updating size of an attached volume requires Cinder support for version 3.42 and a compatible storage driver.

• availability_zone - (Optional) The availability zone for the volume. Changing this creates a new volume.

• consistency_group_id - (Optional) The consistency group to place the volume in.

• description - (Optional) A description of the volume. Changing this updates the volume's description.

• image_id - (Optional) The image ID from which to create the volume. Changing this creates a new volume.

• metadata - (Optional) Metadata key/value pairs to associate with the volume. Changing this updates the existing volume metadata.

• name - (Optional) A unique name for the volume. Changing this updates the volume's name.

• snapshot_id - (Optional) The snapshot ID from which to create the volume. Changing this creates a new volume.

• source_replica - (Optional) The volume ID to replicate with.

• source_vol_id - (Optional) The volume ID from which to create the volume. Changing this creates a new volume.

• volume_type - (Optional) The type of volume to create. Changing this creates a new volume.

Attributes Reference

The following attributes are exported:

• region - See Argument Reference above.
• size - See Argument Reference above.
• name - See Argument Reference above.
• description - See Argument Reference above.
• availability_zone - See Argument Reference above.
• image_id - See Argument Reference above.
• source_vol_id - See Argument Reference above.
• snapshot_id - See Argument Reference above.
• metadata - See Argument Reference above.
• volume_type - See Argument Reference above.
• attachment - If a volume is attached to an instance, this attribute will display the Attachment ID, Instance ID, and the Device as the Instance sees it.

Import

Volumes can be imported using the id, e.g.

$ terraform import openstack_blockstorage_volume_v3.volume_1 ea257959-eeb1-4c10-8d33-26f0409a755d