---
title: "openstack_blockstorage_volume_v3"
description: ""
sidebar_position: 1
---

# openstack\_blockstorage\_volume\_v3

:::info

This instruction is a copy of the official OpenStack Terraform provider documentation from the [Terraform Registry](https://registry.terraform.io/providers/terraform-provider-openstack/openstack/latest/docs).

:::

Use this data source to retrieve information about an existing volume.

## Example Usage \{#example-usage}

```hcl
data "openstack_blockstorage_volume_v3" "volume_1" {
  name = "volume_1"
}
```

## Argument Reference \{#argument-reference}

* `region` - (Optional) The region in which to obtain the V3 Block Storage client. If omitted, the `region` argument of the provider is used.

* `name` – (Optional) The name of the volume.

* `status` – (Optional) The status of the volume.

* `metadata` – (Optional) Metadata key/value pairs associated with the volume.

## Attributes Reference \{#attributes-reference}

`id` is set to the ID of the found volume. In addition, the following attributes are exported:

* `region` – Refer to the Argument Reference section above.
* `name` – Refer to the Argument Reference section above.
* `status` – Refer to the Argument Reference section above.
* `metadata` – Refer to the Argument Reference section above.
* `volume_type` – The volume type.
* `bootable` – Indicates whether the volume is bootable.
* `size` – The size of the volume in GB.
* `source_volume_id` – The ID of the volume from which this volume was created.
* `multiattach` - Indicates if the volume can be attached to more than one server.
* `host` – The OpenStack host on which the volume is located.