openstack_blockstorage_volume_v3

For your information

These instructions are a copy of the official OpenStack Terraform provider documentation in the Terraform Registry.

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. Ifomitted, the region argument of the provider is used. Changing thiscreates 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 extendingattached volumes. Note: updating size of an attached volume requires Cindersupport 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 volumein.
description - (Optional) A description of the volume. Changing this updatesthe 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 thevolume'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.
multiattach - (Optional) Allow the volume to be attached to more than one Compute instance.
scheduler_hints - (Optional) Provide the Cinder scheduler with hints on whereto instantiate a volume in the OpenStack cloud. The available hints are described below.

The scheduler_hints block supports:

different_host - (Optional) The volume should be scheduled on adifferent host from the set of volumes specified in the list provided.
same_host - (Optional) A list of volume UUIDs. The volume should bescheduled on the same host as another volume specified in the list provided.
local_to_instance - (Optional) An instance UUID. The volume should be bescheduled on the same host as the instance.
query - (Optional) A conditional query that a back-end must pass in order to host a volume. The query must use the JsonFilter syntaxwhich is described here. At this time, only simple queries are supported. Compound queries using and, or, or not are not supported. An example of a simple query is:
```
[“=”, “$backend_id”, “rbd:vol@ceph#cloud”]
```
additional_properties - (Optional) Arbitrary key/value pairs of additionalproperties to pass to the scheduler.

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 willdisplay the Attachment ID, Instance ID, and the Device as the Instancesees it.
multiattach - See Argument Reference above.

Import

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

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