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 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 to Ultra High Performance Volumes.

Note

When you change the volume 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 Volume.

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.

If you're new to policies, see Getting Started with Policies and Common Policies. For reference material about writing policies for instances, cloud networks, or other Core Services API resources, see Details for the Core Services.

Limitations

  • You can only change the performance level on three volumes concurrently per tenancy.

  • When changing volume performance for boot volumes, you can only select the Balanced or Higher Performance options.

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 Volume. You can also change the volume performance setting for an existing block volume using the steps in the following procedure.

To change the volume performance for an existing block volume
  1. Open the navigation menu and click Storage. Under Block Storage, click Block Volumes.
  2. Click the block volume that you want to change the performance for.

  3. Click Edit.
  4. Click the volume performance option you want to change to.
  5. Click Save Changes.

When you create an instance, the volume performance setting for the instance's boot volume is set to Balanced. You can change this setting to Higher Performance after the instance has been launched.

To change the volume performance for an existing boot volume
  1. Open the navigation menu and click Storage. Under Block Storage, click Block Volumes. In the Block Storage menu on the sidebar, click Boot Volumes.
  2. Click the boot volume that you want to change the performance for.

  3. Click Edit Size or Performance.
  4. Click the volume performance option you want to change to.
  5. Click Save Changes.

Note

Multipath-enabled attachments are not supported for boot volumes. If you set the performance level for a boot volume to ultra high performance, the performance scale factor will follow the VPU/GB scale for ultra high performance, however the performance maximums will be capped at the higher performance level maximums of 50,000 IOPS and 680 MBPS per volume.

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 Lower Cost setting, applies to block volumes only.
  • 10: Represents Balanced setting, applies to both block volumes and boot volumes.
  • 20: Represents Higher Performance setting, applies to both block volumes and boot volumes.
  • 30 to 120: Represents Higher Performance setting, applies to block volumes only.

For example:

oci bv volume update --volume-id <volume_ID> --vpus-per-gb 20

Using the API

For information about using the API and signing requests, see REST APIs and Security Credentials. For information about SDKs, see Software Development Kits and Command Line Interface.

Block Volumes

To update a block volume's performance setting, use the following operation:

The volume performance setting is specified in the vpusPerGB attribute of UpdateVolumeDetails. Allowed values are 0, 10, and 20.

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. Allowed values are 10 and 20.