Oracle Cloud Infrastructure Documentation

Updating a Volume Group Backup

Update a volume group backup.

Note

To use backup retention features, you must configure the correct IAM policies. See Required IAM Policies for Backup Retention Features.

  • Edit a volume group backup using the console.

    • On the Volume Group Backups list page, find the volume group backup that you want to work with. If you need help finding the list page or the volume group backups, see Listing Volume Group Backups.
    • From the Actions menu (three dots), select Edit.

    Basic Information

    Edit basic information.

    Name: Edit the backup name. Avoid entering confidential information.

    Data Retention

    The options selected when the backup was created determine the data retention options available.

    No Retention Lock Enabled

    If Retention lock is disabled, select Set up retention period to set the retention period and enable the retention lock. See Creating a Volume Group Backup for options.

    Retention Lock Enabled

    If the Retention lock was enabled, the retention period cannot be reduced or removed. You can increase the duration of the retention period.

    Important

    When enabled, only users with the RETENTION_RULE_LOCK privilege may increase the retention period. No other backup modifications are permitted, except enabling or disabling indefinite hold. For example, display-name changes, tag updates, and encryption-key rotations are blocked. Retention Lock cannot be disabled and the backup remains protected until its retention period expires.

    Delete Prevention

    Controls whether the backup can be deleted based on its retention and delete prevention settings.

    Delete prevention: There are two options:
    • Retention period disabled: Prevents any user from deleting the backup, until Delete prevention is enabled.
    • Retention period enabled: Prevents deletion of the backup until the retention period is reached or Delete prevention is disabled.
    Important

    When enabled, only users with the RETENTION_RULE_PREVENT_DELETION privilege may increase or decrease the backup retention period.

    Indefinite Hold

    Keeps this backup until the hold is removed. Overrides delete prevention and data retention settings.

    Indefinite hold: When enabled, keeps the backup indefinitely until the hold is removed.

    Important

    Users with the RETENTION_RULE_INDEFINITE_HOLD privilege may enable or disable indefinite hold on a backup.

    Update Backup

    Select Save changes. The changes are saved.

  • Use the oci bv volume-group-backup update command and specify the --volume-group-backup-id parameter to update the volume group backup:

    oci bv volume-group-backup update --volume-group-backup-id <volume-group-backup_ID>

    For a complete list of parameters and values for CLI commands, see the CLI Command Reference.

  • Run the UpdateVolumeGroupBackup operation to update the volume group backup.