Oracle Cloud Infrastructure Documentation

Changing the Performance of a Volume

The Block Volume service's elastic performance feature enables you to dynamically configure the volume performance for block volumes and boot volumes, for more information, see Block Volume Elastic Performance.

Required IAM Service Policy

To use Oracle Cloud Infrastructure, you must be given the required type of access in a policy  written by an administrator, whether you're using the Console or the REST API with an SDK, CLI, or other tool. If you try to perform an action and get a message that you don’t have permission or are unauthorized, confirm with your administrator the type of access you've been granted and which compartment  you should 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 elastic performance configuration 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 elastic 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 elastic performance setting for an existing block volume using the steps in the following procedure.

To change the volume performance for an existing block volume

When you create an instance, the elastic 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

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 elastic 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.

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 elastic performance setting, use the following operation:

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

Boot Volumes

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

The elastic performance setting is specified in the vpusPerGB attribute of UpdateBootVolumeDetails. Allowed values are 10 and 20.