Changing the Performance of a Volume
The Block Volume service enables you to dynamically configure the performance level for block volumes and boot volumes, for more information, see Block Volume Performance.
If you configure performance level for a block volume to the ultra high performance level the volume attachment should be multipath-enabled. You may need to take additional steps to optmize the volume's performance, for more information, see Attaching Ultra High Performance Volumes. This does not apply to boot volumes configured for the ultra high performance level.
When you change a block volume's performance to ultra high performance from any other performance level you need to detach and then reattach the volume. See Detaching a Volume and Attaching a Block Volume to an Instance.
Required IAM Service Policy
To use Oracle Cloud Infrastructure, you must be granted security access in a policy by an administrator. This access is required whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you get a message that you don't have permission or are unauthorized, verify with your administrator what type of access you have and which compartment to work in.
For administrators: The policy in Let volume admins manage block volumes, backups, and volume groups lets the specified group do everything with block volumes and backups, but not launch instances.
Limitations
When you adjust the VPUs/GB setting for a volume, the volume's lifecycle state transitions to Provisioning while service updates the settings. During this process, you can't attach the volume to an instance or perform other volume operations. After this process is complete, the volume lifecycle state transitions back to Available. At this point, you can attach the volume to an instance.
-
You can only change the performance level on three volumes concurrently per tenancy.
Using the Console
The default volume performance setting for existing block volumes or when you create a new block volume is Balanced. You can change the default setting when you create a new block volume, see Creating a Block Volume. You can also change the volume performance setting for an existing block volume using the steps in the following procedure.
- Open the navigation menu and click Storage. Under Block Storage, click Block Volumes.
-
Click the block volume that you want to change the performance for.
- Click Edit.
- Using the VPUs/GB slider, specify the performance setting you want to change to. You can also specify the VPUs/GB value for the performance setting in Default VPUs/GB.
-
Click Save Changes.
- Open the navigation menu and click Storage. Under Block Storage, click Block Volumes. In the Block Storage menu on the sidebar, click Boot Volumes.
-
Click the boot volume that you want to change the performance for.
- Click Edit Size or Performance.
- Click the volume performance option you want to change to.
-
Click Save Changes.
If you are changing the boot volume's performance to the Ultra High Performance level, see Boot Volumes and Ultra High Performance for additional details.
Using the CLI
For information about using the CLI, see Command Line Interface (CLI).
Use the volume update
operation or the boot-volume update
operation with vpus-per-gb
parameter to update a block volume's elastic performance setting. The vpus-per-gb
parameter is where you specify the volume performance units (VPUs). VPUs represent the volume performance settings, with the following allowed values:
-
0
: Represents the Lower Cost setting, applies to block volumes only. -
10
: Represents the Balanced setting, applies to both block volumes and boot volumes. -
20
: Represents the Higher Performance setting, applies to both block volumes and boot volumes. -
30
to120
: Represents the Ultra High Performance setting, applies to both block volumes and boot volumes.
For example:
oci bv volume update --volume-id <volume_ID> --vpus-per-gb 20
If you are changing a boot volume's performance to the Ultra High Performance level, see Boot Volumes and Ultra High Performance for additional details.
Using the API
For information about using the API and signing requests, see REST API documentation and Security Credentials. For information about SDKs, see SDKs and the CLI.
Block Volumes
To update a block volume's performance setting, use the following operation:
The volume performance setting is specified in volume performance units (VPUs) in the
vpusPerGB
attribute of UpdateVolumeDetails.
Following are the allowed values for vpusPerGB
:
-
0
: Represents the Lower Cost setting, applies to block volumes only. -
10
: Represents the Balanced setting, applies to both block volumes and boot volumes. -
20
: Represents the Higher Performance setting, applies to both block volumes and boot volumes. -
30
to120
: Represents the Ultra High Performance setting, applies to both block volumes and boot volumes.
Boot Volumes
To update a boot volume's performance setting, use the following operation:
The volume performance setting is specified in the vpusPerGB
attribute of UpdateBootVolumeDetails.
Following are the allowed values for vpusPerGB
:
-
0
: Represents the Lower Cost setting, applies to block volumes only. -
10
: Represents the Balanced setting, applies to both block volumes and boot volumes. -
20
: Represents the Higher Performance setting, applies to both block volumes and boot volumes. -
30
to120
: Represents the Ultra High Performance setting, applies to both block volumes and boot volumes.
If you are changing the boot volume's performance to the Ultra High Performance level, see Boot Volumes and Ultra High Performance for additional details.