Auto-tune Volume Performance

The Block Volume service has the following performance level options:

  • Balanced

  • Higher Performance

  • Ultra High Performance

  • Lower Cost

For more information about these settings, see Block Volume Performance Levels. The auto-tune feature enables you to configure your block volumes and boot volumes to use the optimal performance setting based on whether the volume is attached or detached from an instance.

When you create a volume, the default target performance setting is Balanced. You can change the target performance setting when you create the volume, see Creating a Volume. You can also change the target performance setting on an existing volume, see Changing the Performance of a Volume. When the performance auto-tune feature is disabled, your volume’s performance will always be the target performance setting. If performance auto-tune is enabled, when your block volume is attached to one or more instances, the volume’s performance will be the target performance setting. When the volume is detached, the Block Volume service will adjust the performance setting to Lower Cost for both block volumes and boot volumes. When the volume is reattached, the performance is adjusted back to the target performance setting.

When viewing the Block Volume Details or Boot Volume Details pages in the Console, the applicable fields are:

  • Target Performance: This is the volume’s performance setting that you specify when you create the volume or when you change the performance setting for an existing volume. When the volume is attached, regardless of whether the auto-tune performance feature is enabled or not, this is the volume’s performance.

  • Auto-tuned Performance: This is the volume’s effective performance. If the auto-tune performance feature is enabled for the volume, Auto-tuned Performance will be adjusted to Lower Cost when the volume is detached. Note that Auto-tuned Performance won’t show the performance setting as Lower Cost until the performance adjustment is complete.

  • Auto-tune Performance: This field indicates whether the auto-tune performance feature is enabled for the volume. When it is off, the volume’s effective performance is always the same as what is specified for Target Performance. When it is on, the volume performance is adjusted to Lower Cost when the volume is detached.

See Timing Limits and Considerations for details about when these settings take effect.

Required IAM 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.

Timing Limits and Considerations

The following list identifies some timing considerations you should be aware of when using the performance auto-tune feature.

  • When you enable the auto-tune performance feature for a detached volume, the Block Volume service starts the performance adjustment to Lower Cost after 14 days.

  • When you enable the auto-tune performance feature for an attached volume, the Block Volume service starts the performance adjustment to Lower Cost 14 days after you detach the volume.

  • If you disable the auto-tune performance feature while a volume is detached, Block Volume service starts the performance adjustment to the Target Performance setting right away.

  • If you change the Target Performance for a detached volume with the auto-tune performance feature enabled, the Auto-tuned Performance for the volume will remain Lower Cost until you reattach the volume.

  • If you clone a detached volume with the auto-tune performance feature enabled, the Block Volume service starts the performance adjustment to Lower Cost after 14 days.

  • To optimize performance for a volume configured for Ultra High Performance, the volume attachment needs to be enabled for multipath. When you reattach a volume that has had the performance auto-tuned to Lower Cost, but the volume is configured for Ultra High Performance, you need to confirm that the attachment is multipath-enabled after the volume is reattached. For more information, see:

Using the Console

The following procedures describe how to enable the auto-tune performance feature in the Console.

To enable the auto-tune performance feature for a 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 enable the auto-tune performance feature for.

  3. Click Edit.
  4. In the Volume Size and Performance section, click the AUTO-TUNE PERFORMANCE slider so that it changes from Off to On.
  5. Click Save Changes.

To enable the auto-tune performance feature for a 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 enable the auto-tune performance feature for.

  3. Click Edit.
  4. In the Volume Size and Performance section, click the AUTO-TUNE PERFORMANCE slider so that it changes from Off to On.
  5. Click Save Changes.

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 enable or disable the auto-tune performance feature for a block volume, use the following operation:

The auto-tune performance setting is specified in the isAutoTuneEnabled attribute of UpdateVolumeDetails.

Boot Volumes

To enable or disable the auto-tune performance feature for a boot volume, use the following operation:

The auto-tune performance setting is specified in the isAutoTuneEnabled attribute of UpdateBootVolumeDetails.