Block Storage for VPC profiles

In the console

When you create a Block Storage volume in the IBM Cloud console, you can see the available profiles on two tabs.

• For IOPS tiers, you can see 3 tiles with the different performance levels. Select the one that best suits your needs.
• For Custom IOPS, you can specify the size of your volume and IOPS range based on the size of the volume. As you type the IOPS value, the console shows the acceptable range. You can also click the storage size link to see Table 3.

From the CLI

To view the list of available profiles by using the CLI, run the following command:

ibmcloud is volume-profiles

$ ibmcloud is volume-profiles
Listing volume profiles in region us-east under account TEST as user test.user@ibm.com...
Name              Family   
general-purpose   tiered   
5iops-tier        tiered   
10iops-tier       tiered   
custom            custom

To view details of the profile, run the ibmcloud is volume-profile command with the name of the profile that you are interested in seeing.

The following example shows the details of the 10iops-tier.

$ ibmcloud is volume-profile 10iops-tier
Getting volume profile 10iops-tier under account Test Account as user test.user@ibm.com...
                                          
Name                                   10iops-tier   
Family                                 tiered   
Adjustable IOPS                        false   
Boot capacity                          Max   Min      
                                       250   10      
                                          
Capacity                               Max    Min   Default   Step      
                                       4800   10    10        1      
                                          
IOPS                                   Max    Min   Default   Step      
                                       48000  10    10        1      

For more information about available command options, see ibmcloud is volume-profile.

With the API

To see the available profiles, make a GET /volume/profiles request.

curl -X GET \
$vpc_api_endpoint/v1/volume/profiles?$api_version&generation=2 \
-H "Authorization: $iam_token"

Before 24 September 2024, the API response included the fields name, href, family. Now the response is enhanced to include the following fields:

• boot_capacity denotes the capacity values that are permissible for boot volumes for each profile. The returned value is a range with minimum and maximum values that are specified for each profile.
  • For custom and tiered profiles, the range is 10 GB - 250 GB.
• capacity denotes the capacity values that are permissible for data volumes for each profile. The returned value is a range with minimum and maximum values that are specified for each profile.
  • For custom and tiered profiles, the range is 10 GB - 16 TB.
• adjustable_capacity_states indicates whether the capacity for the volume can be changed when the volume is not attached to a running virtual server instance. This field is informational. It describes the characteristics of the volume profile and cannot be changed.
  • For custom and tiered profiles, this value is attached.
• adjustable_iops_states indicates whether the IOPS for the volume can be changed when the volume is not attached to a running virtual server instance. This field is informational. It describes the characteristics of the volume profile and cannot be changed.
  • For the custom profiles, this value is attached.
  • For the tiered profiles, this value is empty because changes to IOPS are not supported in any state. If you want to change the IOPS value of a volume, you can change to another tiered profile.

To see details of a specific profile, make a GET /volume/profiles/ request with the profile name.

curl -X GET "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/10iops-tier?version=2024-09-24&generation=2"\
 -H "Authorization: $iam_token"

A successful response looks like the following example.

   {
  "boot_capacity": {
    "max": 250,
    "min": 10,
    "step": 1,
    "type": "dependent_range"
  },
  "capacity": {
    "max": 16000,
    "min": 10,
    "step": 1,
    "type": "dependent_range"
  },
  "family": "tiered",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/volume/profiles/10iops-tier",
  "iops": {
    "max": 48000,
    "min": 100,
    "step": 1,
    "type": "dependent_range"
  },
  "name": "10iops-tier",
  "adjustable_capacity_states": {
    "type": "fixed",
    "value": "attached"
  },
  "adjustable_iops_states": {
    "type": "fixed",
    "value": ""
  }
}

For more information about this method, see the API reference for listing all volume profiles and retrieving a volume profile.

With Terraform

1. To use Terraform, download the Terraform CLI and configure the IBM Cloud® Provider plug-in. For more information, see Getting started with Terraform.

2. 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"
   }
   

3. Import the list of available volume profiles as a read-only data source.

   data "ibm_is_volume_profiles" "example" {
   }
   

   For more information, see ibm_is_volume_profile.