Oracle Cloud Infrastructure Documentation

Editing a Block Volume's Settings

Edit the settings for a block volume in the Block Volume service.

You can edit the following settings for block volumes:

  • Volume name

  • Volume size

  • Volume performance

  • Autotune settings for dynamic performance scaling

  • Assigned backup policy for scheduled volume backups

  • Cross region replication

You can update these settings when volumes are online and attached to instances or when they're detached from instances.

This topic provides the basic steps for editing a volume. For instructions applicable to the specific volume setting that you're editing, and more information about that setting, click the links provided in the steps.

    1. Open the navigation menu  and select Storage. Under Block Storage, select Block Volumes.
    2. Under List scope, select the compartment that contains the block volume.
    3. In the Block Volumes list, select the the block volume that you want to edit.
    4. Select Edit.

    5. In the Edit volume panel, update the following settings for the volume as needed:

      • In the Name field, specify a different name for the volume.

      • In the Volume size (in GB) field of the Volume size and performance section, specify a larger size for the volume. See Resizing a Volume.

        After you increase a volume's size, you need to rescan the disk and extend the partition. See Rescanning the Disk for a Block Volume or Boot Volume and Extending the Partition for a Block Volume.

      • In the Default VPUs/GB field or using the VPUs/GB slider in the Target volume performance section, adjust the performance for the block volume while it's online, without any downtime. See Changing the Performance of a Volume.

      • In the Target volume performance section, enable or disable Performance based auto-tune or Detached volume auto-tune for dynamic performance scaling. See Dynamic Performance Scaling.

      • (Optional) Enable persistent reservations for the volume: In the Reservations section, switch on the Enable reservations toggle. For more information, see Persistent Reservations.

      • In the Backup policies section, select a user-defined or Oracle-defined backup policy for the volume. This policy configures volume backups to run automatically on a schedule and retain them based on the selected policy. See Policy-Based Backups. You can also enable scheduled cross-region backups, so that scheduled volume backups are automatically copied to a second region. See Scheduling Volume Backup Copies Across Regions.

      • In the Cross region replication section, configure ongoing automatic asynchronous replication of block volumes to other regions for disaster recovery scenarios. See Replicating a Volume.

    6. (Optional) Select Tags and add one or more tags to the block volume. If you have permissions to create a resource, then you also have permissions to apply free-form tags to that resource. To apply a defined tag, you must have permissions to use the tag namespace. For more information about tagging, see Resource Tags. If you're not sure whether to apply tags, skip this option or ask an administrator. You can apply tags later.

    7. Select Save changes.

  • Use the oci bv volume update command and required parameters to edit a block volume:

    oci bv volume update --volume-id volume_ocid  [OPTIONS]

    For a complete list of flags and variable options for CLI commands, see the Command Line Reference.

  • Run the UpdateVolume operation and specify the volumeId parameter in the request body and specify the autotunePolicies, blockVolumeReplicas, definedTags, displayName, freeformTags, isAutoTuneEnabled, isReservationsEnabled, sizeInGBs and/or vpusPerGB attributes of the UpdateVolumeDetails resource to edit a block volume's settings.