| copyright | lastupdated | keywords | subcollection | ||
|---|---|---|---|---|---|
|
2025-01-22 |
vpc |
{{site.data.keyword.attribute-definition-list}}
{: #viewing-block-storage}
View details about a {{site.data.keyword.block_storage_is_short}} volume or summary information about all volumes. {: shortdesc}
{: #viewvols} {: ui}
List all {{site.data.keyword.block_storage_is_short}} volumes and view details for a single volume. View attached {{site.data.keyword.block_storage_is_short}} volume details in instance details. View all snapshots that were created from the {{site.data.keyword.block_storage_is_short}} volume.
{: #viewvols-ui}
Go to the list of {{site.data.keyword.block_storage_is_short}} volumes. In the {{site.data.keyword.cloud_notm}} console{: external}, click the Navigation menu icon 
> Infrastructure 
> Storage > Block Storage volumes.
By default, {{site.data.keyword.block_storage_is_short}} volumes are displayed in sets of 10 for all resource groups in your region. Change this preset by clicking the Page Control down arrow and increase the list to 20 or 50 volumes. Use the Page Control arrows to go to the following page or return. In the list of all {{site.data.keyword.block_storage_is_short}} volumes, you see the following information.
| Field | Description |
|---|---|
| Region | The region where these volumes are located, for example, US South. Click the down arrow to see volumes in a different region in which you have an account. |
| Name | Click the name of the volume to see individual volume details. |
| Status | Status of the volume, which functions as the default filter for all rows. |
| Location | Availability zone in your region, inherited from the VPC (for example, US South 1). |
| Size | Size of the volume you specified, in GBs. |
| Attachment type | Data, for a secondary volume attached to an instance, boot when attached as a boot volume, or blank for an unattached volume. |
| Health | Health monitors the overall health of the volume, such as I/O performance and data consistency. Volume health statuses are OK or degraded. Volumes in a degraded state have degraded performance, capacity, or experience connection problems. Volumes being restored from a snapshot also show a degraded state. The service displays a possible reason for the degraded state so that you can resolve any issues. For more information, see {{site.data.keyword.block_storage_is_short}} volume health states. |
| Encryption | Encryption with IBM-managed keys is enabled by default on all volumes. You can also use your own root keys in a {{site.data.keyword.keymanagementserviceshort}} or {{site.data.keyword.hscrypto}} instance to protect your data. For more information, see Creating {{site.data.keyword.block_storage_is_short}} volumes with customer-managed encryption. |
| Tags | Number of user tags that are applied to the volume. Click the number in this column to view or edit the tags in the new window. If no tags were applied to the volume, click Add tags and add them in the new window. User tags can associate the volume with a backup policy for creating backups of the volume. For more information, see Adding user tags that are associated with a backup policy to a volume in the console. |
| Actions | Click Actions  to display a menu of context-specific actions you can take. |
| {: caption="Details about all volumes" caption-side="bottom"} |
Actions menu selections change depending on whether the volume is a boot volume, an attached data volume, or an unattached data volume.
- When the volume that you're viewing is a boot volume, the available actions are Create image, Create snapshot, and Detach from instance.
- When the volume that you're viewing is an attached data volume, the available actions are Create snapshot, Detach from instance, and Delete.
- When the volume that you're viewing is an unattached data volume, the available actions are Attach to instance, and Delete.
For more information about these actions, see the following topics:
- Creating an image from a volume in the console
- Creating a snapshot in the console
- Detaching a volume from a virtual server instance
- Attaching a volume to a virtual server instance
- Deleting a volume in the console.
{: #view-vol-details-ui}
To view details about a {{site.data.keyword.block_storage_is_short}} volume, go to the list of all {{site.data.keyword.block_storage_is_short}} volumes and select a volume.
Next to the name of the volume is the volume status and tags that are associated with this volume. User tags identify the resource. When user tags are associated with a backup policy, they are used for creating backup snapshots of the volume. With Access management tags, you can create flexible resource groupings for managing access. For more information about these tags, see Working with tags.
{: #view-vol-details-overview}
The page has 3 tabs. By default, the Overview tab is selected for volume details.
| Field | Description |
|---|---|
| Volume details | |
| Name | The name of the volume you specified when you created the volume. Click the Edit icon  to edit the volume name. The volume name can be up to 63 lowercase alpha-numeric characters and include the hyphen (-), and must begin with a lowercase letter. Volume names must be unique for the account and for the region. |
| Volume ID | System-generated volume ID. |
| Health | Health monitors the overall health of the volume, such as I/O performance and data consistency. Volume health statuses are OK or degraded. Volumes in a degraded state have less than OK performance and capacity, or they experience connection problems. Volumes that are being restored from a snapshot also show a degraded state. The service displays a possible reason for the degraded state so you can resolve it. For more information, see {{site.data.keyword.block_storage_is_short}} volume health states. |
| Resource group | Resource group defined when you set up your VPC. Resource groups manage access to resources but do not affect billing or monitoring. |
| Attachment type | Data, for a secondary volume attached to an instance, boot when attached as a boot volume, or blank for an unattached volume. |
| Created date | System-generated date when the volume was created. |
| Location | Availability zone in your region. |
| Size | Size of the volume you specified. When the volume is attached to a virtual server instance and the volume is not at maximum capacity for its range, you can click the icon to expand the volume. For more information, see expanding {{site.data.keyword.block_storage_is_short}} volume capacity (Beta). |
| Profile | IOPS tier or custom IOPS profile. Click the icon to adjust IOPS by selecting a different profile. |
| Max IOPS | The maximum IOPS value for a predefined IOPS tier or the value you specified for custom IOPS. |
| Throughput | The field shows the allocated bandwidth of the storage volume, which is measured in Gigabits per second (Gbps). Throughput is calculated as the result of the number of IOPS the volume is provisioned for times the throughput multiplier. Depending on the volume profile, the throughput multiplier can be 16 KB or 256 KB. |
| Encryption | Encryption with IBM-managed keys is enabled by default on all volumes. You can also use your own root keys to protect your data. The Encryption field shows the name of the key management service (KMS) you provisioned (for example, {{site.data.keyword.keymanagementserviceshort}}) and customer-managed. For more information, see Creating {{site.data.keyword.block_storage_is_short}} volumes with customer-managed encryption. |
| Encryption Instance | Optional. A link to the provisioned KMS instance for a customer-managed encryption volume. |
| Key | Optional. The name and copiable ID of the root key that is used to encrypt the passphrase, which secures a customer-managed encryption volume. |
| Backup policies | The number of backup policies that are associated with the volume. Click the number link to go to the backup policies tab. |
| Snapshots | The number of snapshots that were created of the volume. Click the number link to go to the Snapshots and Backups tab. |
| Attached virtual server | Volumes attached to a virtual server instance are listed here. Click Attach to select an instance to attach this volume. For more information, see Attaching a volume to an instance. |
| Status | This field tracks the overall lifecycle state of the volume, which ranges from volume creation to volume deletion. Attachment status, for example, is attached when the volume is attached to an instance and attaching when in progress. |
| Name | Click the name of the virtual server instance to see instance details. |
| Auto delete | When enabled, the volume is automatically deleted when you delete the instance. Click the toggle to enable automatic deletion. |
| Backup policies | Shows backup policies that are associated with this volume. To associate backup policies, you can add a backup policy's tags for target resources to this volume. Click Apply to select a backup policy, then apply its tags for the target resource to the volume. |
| {: caption="Volume details" caption-side="bottom"} |
The Actions menu selections change depending on whether the volume is a boot volume, an attached data volume, or an unattached data volume.
- Create snapshot - you can create a snapshot from an attached data volume or a boot volume. For more information, see Create a snapshot in the console.
- Create image - you can create an image from a boot volume. For more information, see Creating an image from a volume in the console.
- Expand volume - you can Increase the size of an attached volume in increments of 1 GB. For more information see Increasing capacity of a data volume and Increasing capacity of a boot volume.
- Edit IOPS profile - you can change the performance characteristics of an attached data volume by increasing or decreasing IOPS by editing the IOPS profile. |
- Delete - you can delete an unattached volume. For more information, see Deleting a data volume in the console.
To view a list of snapshots of this volume that were created manually or by a backup policy, click the Snapshots and Backups tab.
{: #view-snapshots-for-volume}
If you created snapshots of a {{site.data.keyword.block_storage_is_short}} boot or data volume, you can see the snapshots on the second tab of the volume details page.
Click the Snapshots and Backups tab to see the list of snapshots that includes information such as the name, status, size, encryption type, and the creation date of the snapshots. The list also shows whether the snapshot was created by the user or by a backup policy. The snapshots display in descending order, with the most recently created snapshot in first place.
You can see details for a snapshot, create a snapshot, and manage snapshots from the Volume details page. For example, from the Actions menu , you can delete the most recent snapshot. For more information, see one of the following topics:
{: #view-backup-policies-for-volume}
View all backup policies associated with a {{site.data.keyword.block_storage_is_short}} volume on the 3rd tab of the volume details page. All policies that have the user tag that is applied to this volume are listed.
Click the Backup policies tab. All policies that have the user tag that is applied to this volume are listed. The list provides the following information:
| Field | Description |
|---|---|
| Policy name | Click the policy name to go to that backup policy. |
| Status | Status of the backup policy. |
| Last run time | The last scheduled run of the backup policy that created a backup. |
| {: caption="Backup policies associated with a {{site.data.keyword.block_storage_is_short}} volume." caption-side="bottom"} |
You can click Attach to apply a new backup policy to this volume. In the side panel, select a backup policy from the menu, and select the policy tags to apply to the volume. You can also view the plan details that can help you decide whether to use that policy. If satisfied, click Apply policy and tags.
When you want to add volumes to a policy, add user tags to the volume that are in the backup policy's tags for target resources. When you remove tags from a volume that are in a backup policy, the volume is no longer backed up by that policy.
For more information, see Applying backup policies to resources.
{: #view-vol-details-instance-ui}
You can also view information about an attached {{site.data.keyword.block_storage_is_short}} volume from the Virtual server instance details page:
-
In the {{site.data.keyword.cloud_notm}} console{: external}, click the Navigation menu icon
> Infrastructure 
> Compute > Virtual server instances and select an instance. -
Under Attached Block Storage volumes, click the name of a volume to go to the volume details page.
{: #viewing-block-storage-cli} {: cli}
View details about a {{site.data.keyword.block_storage_is_short}} volume or summary information about all volumes from the CLI.
Before you can use the CLI, you must install the IBM Cloud CLI and the VPC CLI plug-in. For more information, see the CLI prerequisites. {: requirement}
{: #viewall-vol-cli}
Run the following command to list summary information about all volumes:
ibmcloud is volumes [--json]{: pre}
Specifying the resource group ID or name filters the list to volumes that belong to a resource group. When you omit this argument, it defaults to all resource groups. You can also view all volumes in a particular availability zone. By default, the first 25 volumes are displayed per page.
The following example shows all volumes for all resource groups in your availability zone.
$ ibmcloud is volumes
Listing volumes in all resource groups and region us-east under account Test Account as user [email protected]...
ID Name Status Capacity IOPS Profile Attachment state Attachment type Zone Resource group
r014-0a7c28f3-3612-46e6-b874-51136c7f1def concurrent-vol-09afy4vz700 unusable 20 3000 general-purpose unattached - us-east-1 defaults
r014-faefcc1d-f899-4688-ae97-67e5079da702 concurrent-vol-1s26tgtqg70 unusable 20 3000 general-purpose unattached - us-east-1 defaults
r014-f0e809bf-9afb-4006-b2a8-274f81f0f34e concurrent-vol-8xif5f1tid0 unusable 20 3000 general-purpose unattached - us-east-1 defaults
r014-b8e23307-e93e-4f7b-918f-7b2c2b14b132 concurrent-vol-gpwucqfpni0 available 20 3000 general-purpose attached data us-east-1 defaults
r014-a64beeee-be50-4c03-8cee-639106cea1e2 concurrent-vol-mh16478vln0 available 20 3000 general-purpose attached data us-east-1 defaults
r014-f14f8d39-2cf3-4f5d-b366-1d234f1c74aa concurrent-vol-n7fcoxmb860 available 20 3000 general-purpose attached data us-east-1 defaults
r014-84ff8138-4f4f-434b-bdc3-45d1aaaa4329 csi-boot-vol-pgb1-oqpm7een available 100 3000 general-purpose attached boot us-east-1 Default
r014-a1f6b311-6e4b-4e27-a216-a0b602471268 csi-boot-vol-qgbi-h76dy77d available 100 3000 general-purpose attached boot us-east-1 Default
r014-158e904d-0d48-4090-b6c1-57617c1fcc20 csi-boot-vol-txmz-54wzen5m available 100 3000 general-purpose attached boot us-east-1 Default
r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac demo-volume-update available 100 3000 general-purpose attached data us-east-1 defaults
r014-eef16365-17e3-4627-bc8b-c7c3dd1d6a81 kj-test-ro-boot-1629867631000 available 100 3000 general-purpose attached boot us-east-1 defaults {: screen}
For more information about available command options, see ibmcloud is volumes.
{: #viewvol-cli}
Run the following command to show details about a specific volume. You can use the volume's name or ID to identify the volume.
ibmcloud is volume VOLUME_ID [--json]{: pre}
See the following example.
$ ibmcloud is volume demo-volume-update
Getting volume demo-volume-update under account Test Account as user [email protected]...
ID r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Name demo-volume-update
CRN crn:v1:bluemix:public:is:us-east-1:a/a1234567::volume:r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac
Status available
Attachment state attached
Capacity 100
IOPS 3000
Bandwidth(Mbps) 393
Profile general-purpose
Encryption key -
Encryption provider_managed
Resource group defaults
Created 2023-06-29T16:14:59+00:00
Zone us-east-1
Health State ok
Volume Attachment Instance Reference Attachment type Instance ID Instance name Auto delete Attachment ID Attachment name
data 0757_11f5db7f-35a1-4678-bcbd-c85204e09507 kj-test-ro false 0757-4dfc4384-c4b5-497e-bab3-6415f9c4d44b otp
Active true
Adjustable Capacity States attached
Adjustable IOPS States
Busy false
Tags - {: screen}
In the example, the volume is attached to a virtual server instance, so the names and IDs of the volume attachment and instance are also displayed in the command output. The Active property is true because the virtual server instance to which the volume is attached is running. The busy property with the value false indicates that this volume is not performing an operation that must be serialized.
For more information about available command options, see ibmcloud is volume.
{: #viewing-block-storage-api} {: api}
View {{site.data.keyword.block_storage_is_short}} volumes programmatically by making calls to the VPC REST APIs. You can list all volumes and view details for a specific volume.
Before you begin, make sure that you set up your API environment.
{: #viewall-vol-api}
Make a GET /volumes call to list summary information about all volumes. See the following example.
curl -X GET "$vpc_api_endpoint/v1/volumes?version=2025-01-212&generation=2" \
-H "Authorization: $iam_token"{: pre}
A successful response looks like the following example. This example shows three data volumes. The first in the list is attached to an instance.
[
{
"active": false,
"adjustable_iops_supported": false,
"attachment_state": "unattached",
"bandwidth": 393,
"busy": false,
"capacity": 100,
"created_at": "2025-01-22T00:54:01.000Z",
"crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::volume:r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
"encryption": "provider_managed",
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
"id": "r006-5ed4006b-3dac-4c95-8eeb-4aa9a85cbd34",
"iops": 3000,
"name": "my-data-volume",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
"name": "general-purpose"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"source_snapshot": {
"crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot:r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
"href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
"id": "r006-8428038a-a399-4894-8c84-c8d7a4a75fae",
"name": "wdc-fst-rstore-c6a092f34118-4505",
"resource_type": "snapshot"
},
"status": "available",
"status_reasons": [],
"adjustable_capacity_states": [
"attached"
],
"user_tags": [
"env:prod",
"env:test"
],
"volume_attachments": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
"name": "us-south-2"
}
},
{
"active": false,
"adjustable_iops_supported": false,
"attachment_state": "attached",
"bandwidth": 393,
"busy": false,
"capacity": 100,
"created_at": "2024-04-01T16:48:16.000Z",
"crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::volume:r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
"encryption": "provider_managed",
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
"id": "r006-b5f15a27-ee2b-4d49-9344-9f3c17d42903",
"iops": 3000,
"name": "my-vsi--boot-volume-1711989834000",
"operating_system": {
"architecture": "amd64",
"dedicated_host_only": false,
"display_name": "Ubuntu Linux® 20.04 LTS Focal Fossa Minimal Install (amd64)",
"family": "Ubuntu Linux",
"gpu_supported": [],
"href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/ubuntu-20-04-amd64",
"name": "ubuntu-20-04-amd64",
"resource_type": "operating_system",
"vendor": "Canonical",
"version": "20.04 LTS Focal Fossa Minimal Install"
},
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
"name": "general-purpose"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"source_image": {
"crn": "crn:v1:bluemix:public:is:us-south:a/811f8abfbd32425597dc7ba40da98fa6::image:r006-0e578411-53ab-44ba-a0f8-d003d0011993",
"href": "https://us-south.iaas.cloud.ibm.com/v1/images/r006-0e578411-53ab-44ba-a0f8-d003d0011993",
"id": "r006-0e578411-53ab-44ba-a0f8-d003d0011993",
"name": "ibm-redhat-8-6-minimal-amd64-7",
"resource_type": "image"
},
"status": "available",
"status_reasons": [],
"adjustable_capacity_states": [
"attached"
],
"user_tags": [
"backup-policy-tag"
],
"volume_attachments": [
{
"delete_volume_on_instance_delete": true,
"device": {
"id": ""
},
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d/volume_attachments/0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
"id": "0717-0fbaf561-6390-48a4-bb28-240b20ded36e",
"instance": {
"crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::instance:0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
"id": "0717_70aa00c6-65c9-4523-8a43-893c6fa0d87d",
"name": "my-vsi-test",
"resource_type": null
},
"name": "perfectly-parting-humble-skewer",
"type": "boot"
}
],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
"name": "us-south-1"
}
},
{
"active": false,
"adjustable_iops_supported": false,
"attachment_state": "unattached",
"bandwidth": 393,
"busy": false,
"capacity": 10,
"created_at": "2021-09-10T15:56:30.000Z",
"crn": "crn:v1:bluemix:public:is:us-south-3:a/a1234567::volume:r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
"encryption": "provider_managed",
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
"id": "r006-ed2b09db-36da-4cd1-b862-fed933465fcc",
"iops": 3000,
"name": "my-other-data-volume",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
"name": "general-purpose"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
"id": "6edefe513d934fdd872e78ee6a8e73ef",
"name": "defaults"
},
"status": "available",
"status_reasons": [],
"adjustable_capacity_states": [
"attached"
],
"user_tags": [],
"volume_attachments": [],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-3",
"name": "us-south-3"
}
}
]{: codeblock}
{: #viewvol-details-api}
Make a GET /volumes/{id} call to see details of a volume. See the following example.
curl -X GET "$vpc_api_endpoint/v1/volumes/$volume_id?version=2025-01-21&generation=2" \
-H "Authorization: $iam_token"{: pre}
A successful response provides details of the volume, including capacity and IOPS, the volume status, and whether the volume is attached to an instance.
{
"active": true,
"bandwidth": 128,
"busy": false,
"capacity": 100,
"created_at": "2022-12-09T06:26:17Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"health_reasons": [],
"health_state": "ok",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
"id": "ccbe6fe1-5680-4865-94d3-687076a38293",
"iops": 1000,
"name": "my-volume-1",
"profile": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/general-purpose",
"name": "general-purpose"
},
"resource_group": {
"href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/4bbce614c13444cd8fc5e7e878ef8e21",
"id": "4bbce614c13444cd8fc5e7e878ef8e21",
"name": "Default"
},
"status": "available",
"status_reasons": [],
"user_tags": [],
"volume_attachments": [
{
"delete_volume_on_instance_delete": true,
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/33bd5872-7034-462b-9f3e-d400c49d347a/volume_attachments/b31c1a5a-122a-4e32-a10b-f2c31271de85",
"id": "b31c1a5a-122a-4e32-a10b-f2c31271de85",
"instance": {
"crn": "crn:[...]",
"href": "https://us-south.iaas.cloud.ibm.com/v1/instances/33bd5872-7034-462b-9f3e-d400c49d347a",
"id": "33bd5872-7034-462b-9f3e-d400c49d347a",
"name": "instance-1",
"resource_type": "instance"
},
"name": "volume-attachment-1",
"type": "data"
}
],
"zone": {
"href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
"name": "us-south-2"
}
}{: codeblock}
{: #viewvol-boot}
When you request to view details of boot volumes, a couple of extra properties are returned in the response for GET /volumes and GET /volumes/{id} requests.
-
The
activeproperty indicates whether the virtual server instance to which a volume is attached is running or stopped. Whenactive = true, the instance is running and operations that require a running instance such as creating an image from the boot volume also work. -
The
busyproperty indicates whether this volume is performing an operation that must be serialized. If an operation requires serialization, the operation fails unless this property isfalse.
See the following example.
"active": "true",
"busy": "false",
"capacity": 100,
"created_at": "2022-12-08T06:26:17Z",
"crn": "crn:[...]",
"encryption": "provider_managed",
"href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/ccbe6fe1-5680-4865-94d3-687076a38293",
"id": "ccbe6fe1-5680-4865-94d3-687076a38293",
"iops": 300,
"name": "boot-volume-1",
.
.
.{: codeblock}
{: #viewing-block-storage-terraform} {: terraform}
You can use Terraform to view information about your {{site.data.keyword.block_storage_is_short}} volumes.
To use Terraform, download the Terraform CLI and configure the {{site.data.keyword.cloud_notm}} Provider plug-in. For more information, see Getting started with Terraform. {: requirement}
VPC infrastructure services use a specific regional endpoint, which targets to us-south by default. If your VPC is created in another region, make sure to target the appropriate region in the provider block in the provider.tf file.
See the following example of targeting a region other than the default us-south.
provider "ibm" {
region = "eu-de"
}{: screen}
{: #viewall-vol-terraform}
Import the list of volumes that belong to an account as a read-only data source. You can filter by volume name, zone name, attachment state, encryption type, operating system family (applicable for boot volumes) or operating system architecture (applicable for boot volumes).
data "ibm_is_volumes" "example" {
}{: codeblock}
The attributes that are exported include the total count of volumes and the list of volumes. The nested attributes include volume ID, name, creation date, size, IOPS, CRN, access and user tags, profile, encryption type and key, lifecycle state, health state and reason, operating system, and other attributes.
For more information, see ibm_is_volumes{: external}.
{: #viewvol-details-terraforn}
Import the details of a volume as a read-only data source. You must identify the volume by ID or name.
data "ibm_is_volume" "example1" {
name = ibm_is_volume.example.name
}{: codeblock}
The attributes that are exported include the total count of volumes and the list of volumes. The nested attributes include volume ID, name, creation date, size, IOPS, CRN, access and user tags, profile, encryption type and key, lifecycle state, health state and reason, operating system, and other attributes.
For more information, see ibm_is_volume{: external}.
{: #next-step-viewing-block-storage}
Create more volumes or manage your existing {{site.data.keyword.block_storage_is_short}} volumes.