Oracle Cloud Infrastructure Documentation

Updating a Schedule for a User-defined Backup Policy

Update a schedule in a user-defined (custom) backup policy in Block Volume.

Important

Retention rules enforced when editing an individual volume backup do not apply when editing a backup policy. Users can modify policy settings, including increasing or decreasing retention periods and enabling or disabling Retention Lock.
Note

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

  • Edit Schedule

    On the Edit schedule page, edit the following information.

    • Schedule Type: Select the backup frequency and then select values for associated options, such as hour of the day, day of the week, day of the month, and month of the year.
    • Backup type: Select Full or Incremental.
    • Timezone: Select UTC or Regional Data Center Time.

    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, the retention period and lock can be set. See Adding a Schedule to a User-defined Backup Policy.

    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.

    Prevent Deletion

    Controls whether the backup can be deleted based on its retention and Prevent deletion settings.

    Prevent deletion: The following options are available:
    • No retention period: Enabling Prevent deletion prevents any user from deleting the backup.
    • Configured retention period: Enabling Prevent deletion prevents deletion of the backup until the retention period is reached. The Prevent deletion option can be enabled or disabled.
    • A configured retention period and Retention lock is enabled. Prevent deletion is disabled.
    Important

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

    Update schedule

    After making your changes to the schedule, select Update.

  • Use the oci bv volume-backup-policy update command and specify the parameters to update the schedule for a volume backup policy:

    oci bv volume-backup-policy update --policy-id backup_policy_ID --schedules file://path/schedule_JSON.json

    For example:

    oci bv volume-backup-policy update --policy-id ocid1.volumebackuppolicy.oc1.phx.unique_ID --schedules file://~/input.json

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

  • Run the UpdateVolumeBackupPolicy operation and specify the policyId parameter and the definedTags, destinationRegion, displayName, freeformTags and/or schedules attributes in the UpdateVolumeBackupPolicyDetails resource to edit your backup policy schedule.