Skip to content

Latest commit

 

History

History
131 lines (76 loc) · 3.17 KB

enable-continuous-backup-a37de84.md

File metadata and controls

131 lines (76 loc) · 3.17 KB
Raw

Enable Continuous Backup

Enable continuous backups of an Amazon S3 bucket to safeguard data from accidental deletion of objects. With continuous backups enabled, a backup job runs daily and creates a recovery point for restoration.

Prerequisites

  • The Object Store instance must be the standard plan. Continuous backups are not supported for the s3-standard plan, which was deprecated in Q4 2023. For more information, see Service Plan update to 'standard'.
  • Versioning must be enabled on the instance before enabling continuous backup. If versioning is disabled, AWS will not allow configuring continuous backup.

Restriction:

  • Once continuous backups are enabled, they cannot be disabled. You can, however, change the retention period.
  • During an instance update operation, you cannot set any other configuration parameters while enabling continuous backups or setting the retention period.

Context

Continuous backup is disabled by default.

Continuous backup will take up to 2 hours to get started. Time taken to finish the first backup depends upon the amount of data in terms of number of objects and the size of objects.

Note:

When an objectstore instance is deleted, continuous backups are disabled and existing backups are deleted. The Amazon S3 bucket with the existing data is retained for a period of 14 days; see Backup and Restore.

Continuous backups come with additional cost. There will be increased storage cost due to the backup-related storage. This will be reflected in the existing storage_in_GB metric.

Procedure

Enable backups using the create-service call or later using the update-service call:

cf create-service <service_instance_name> -c '{"backupEnabled":true,"backupRetentionPeriod":<n>}'

cf update-service <service_instance_name> -c '{"backupEnabled":true,"backupRetentionPeriod":<n>}'

Configuration Parameters

Parameter

Type

Required

Description

backupEnabled

boolean

yes

Enables Continuous Backup.

backupRetentionPeriod

integer

no

Number of days backup is retained, between 1 and 35. If not provided, Object Store Service sets a retention period of 14 days by default.

The command above accomplishes the following:

  • Enables continuous backup on the source bucket.
  • Configures the expiration rule to automatically delete a backup older than n number of days.

Note:

You can also use this command to update the retention period for an existing backup configuration.

Related Information

https://docs.aws.amazon.com/aws-backup/latest/devguide/s3-backups.html