Auto-tune Volume Performance

The Block Volume service has three elastic performance configuration options:

  • Balanced

  • Higher Performance

  • Lower Cost

For more information about these settings, see Block Volume Elastic Performance. 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 volume performance setting is Balanced. You can change this default performance setting when you create the volume, see Creating a Volume. You can also change the default 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 default 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 default 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 default performance setting.

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

  • Current Performance: This is the volume’s effective performance. If the auto-tune performance feature is disabled for the volume, Current Performance will always be what is specified in the Default Performance, regardless of whether the volume is attached or detached. If the auto-tune performance feature is enabled for the volume, Current Performance will be adjusted to Lower Cost when the volume is detached. Note that Current Performance won’t show the performance setting as Lower Cost until the performance adjustment is complete.

  • Default 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-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 Default 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  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.

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 Default Performance setting right away.

  • Attaching a volume with the auto-tune performance feature enabled may take longer than attaching a volume with it off, as the Block Volume service adjusts the performance before the volume attachment completes.

  • If you change the Default Performance for a detached volume with the auto-tune performance feature enabled, the Current 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.

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. Under Core Infrastructure, go to Block Storage and 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. Under Core Infrastructure, go to Compute and 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.