Enable Performance-Based Autotuning for Block Volumes

Sign in to your Oracle Cloud Infrastructure (OCI) account.

Navigate to Block Storage console available at https://cloud.oracle.com/block-storage/.

In the left navigation panel, choose Block Volumes, and select an OCI compartment from the Compartment dropdown menu, next to Applied filters, to list the Block Volumes provisioned in that compartment.

Click on the name (link) of the Block Volume that you want to examine, listed in the Name column.

Select the Details tab to access the general configuration information available for the selected volume.

In the Auto-tuned performance policies section, check the Performance based auto-tune attribute value to determine the operational state of the Performance-Based Autotuning feature. If the Performance based auto-tune value is set to Off, performance-based autotuning is not enabled for the selected Oracle Cloud Infrastructure (OCI) Block Volume.

Run iam compartment list command (Windows/macOS/Linux) with output query filters to list the ID of each compartment available in your Oracle Cloud Infrastructure (OCI) account:

oci iam compartment list
	--all
	--include-root
	--query 'data[]."id"'

The command output should return the requested OCI compartment identifiers (OCIDs):

[
	"ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.compartment.oc1..abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd"
]

Run bv volume list command (Windows/macOS/Linux) with the ID of the OCI compartment that you want to examine as the identifier parameter, the list the ID of each Block Volume provisioned in the selected OCI compartment:

oci bv volume list
	--compartment-id 'ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--all
	--query 'data[]."id"'

The command output should return the requested volume IDs:

[
	"ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcdabcd1234abcd1234abcd1234abcd1234abcd1234"
]

Run bv volume get command (Windows/macOS/Linux) with the name of the OCI Block Volume that you want to examine as the identifier parameter and custom output filters to determine if performance-based autotuning is enabled for the selected volume:

oci bv volume get
	--volume-id 'ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--query 'data."autotune-policies"[]'

The command output should return the autotune policies configured for the selected volume:

[
	{
		"autotune-type": "DETACHED_VOLUME"
	}
]

If the bv volume get command output returns an empty array, i.e., [], there are no autotune policies configured for your volume, therefore, performance-based autotuning is disabled for the selected OCI Block Volume. If the command output returns one or more autotune policies, as shown in the example above, check the "autotune-type" property value. If the "autotune-type" value is not set to "PERFORMANCE_BASED", performance-based autotuning is not enabled for the selected Oracle Cloud Infrastructure (OCI) Block Volume.

Sign in to your Oracle Cloud Infrastructure (OCI) account.

Navigate to Block Storage console available at https://cloud.oracle.com/block-storage/.

In the left navigation panel, choose Block Volumes, and select an OCI compartment from the Compartment dropdown menu, next to Applied filters, to list the Block Volumes provisioned in that compartment.

Click on the name (link) of the Block Volume that you want to configure, listed in the Name column.

Choose Edit from the page top menu and perform the following actions to enable and configure performance-based autotuning for the selected volume:

1. In the Target volume performance section, switch on the Performance based auto-tune button and select the default and maximum VPUs from the Default VPUs/GB and Maximum VPUs/GB dropdown lists. Once the configuration is applied, the performance feature will adjust the volume's performance automatically between the VPUs specified for Default VPUs/GB and Maximum VPUs/GB, inclusive. When turned on, Default VPUs/GB can't be set to 0 or 120 and Maximum VPUs/GB must be at least 10 VPUs/GB higher than Default VPUs/GB.
2. (Optional) Switch on the Detached volume auto-tune button to enable detached volume autotuning. Once enabled, this feature will change the volume's performance automatically to Lower Cost when it is detached. When reattached, its performance is automatically adjusted to the previous setting.
3. Choose Update to apply the configuration changes. This will enable the Performance-Based Autotuning feature for the selected OCI Block Volume.

Run iam compartment list command (Windows/macOS/Linux) with output query filters to list the ID of each compartment available in your Oracle Cloud Infrastructure (OCI) account:

oci iam compartment list
	--all
	--include-root
	--query 'data[]."id"'

The command output should return the requested OCI compartment identifiers (OCIDs):

[
	"ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.compartment.oc1..abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd1234abcd"
]

Run bv volume list command (Windows/macOS/Linux) with the ID of the OCI compartment that you want to examine as the identifier parameter, the list the ID of each Block Volume provisioned in the selected OCI compartment:

oci bv volume list
	--compartment-id 'ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--all
	--query 'data[]."id"'

The command output should return the requested volume IDs:

[
	"ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
	"ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcdabcd1234abcd1234abcd1234abcd1234abcd1234"
]

Run bv volume update command (Windows/macOS/Linux) with the name of the OCI Block Volume that you want to configure as the identifier parameter, to enable and configure performance-based autotuning (i.e., {"autotune-type": "PERFORMANCE_BASED", "maxVpusPerGB": \<VPUs/GB\>}), and enable detached volume autotuning (i.e., {"autotune-type": "DETACHED_VOLUME"}) for the selected volume:

oci bv volume update
	--volume-id 'ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd'
	--autotune-policies '[{"autotune-type": "PERFORMANCE_BASED", "maxVpusPerGB": 50}, {"autotune-type": "DETACHED_VOLUME"}]'

Type Y and press Enter for confirmation:

WARNING: Updates to defined-tags and freeform-tags and block-volume-replicas and autotune-policies will replace any existing values. Are you sure you want to continue? [y/N]: Y

The command output should return the configuration information available for the modified OCI Block Volume:

{
	"data": {
		"auto-tuned-vpus-per-gb": 10,
		"autotune-policies": [
		{
			"autotune-type": "DETACHED_VOLUME"
		},
		{
			"autotune-type": "PERFORMANCE_BASED",
			"max-vpus-per-gb": 50
		}
		],
		"availability-domain": "ABCD:AP-SYDNEY-1-AD-1",
		"block-volume-replicas": null,
		"cluster-placement-group-id": null,
		"compartment-id": "ocid1.tenancy.oc1..aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"defined-tags": {},
		"display-name": "cc-project5-instance-block-volume",
		"freeform-tags": {},
		"id": "ocid1.volume.oc1.ap-sydney-1.aaaabbbbccccddddabcd1234abcd1234abcd1234abcd1234abcd1234abcd",
		"is-auto-tune-enabled": true,
		"is-hydrated": true,
		"is-reservations-enabled": false,
		"kms-key-id": null,
		"lifecycle-state": "PROVISIONING",
		"size-in-gbs": 50,
		"size-in-mbs": 51200,
		"source-details": null,
		"system-tags": {},
		"time-created": "2025-10-15T10:00:00.778000+00:00",
		"volume-group-id": null,
		"vpus-per-gb": 10
	}
}