This is an archive version of the document. To get the most up-to-date information, see the current version.

About Retention Policy

A retention policy defines how long and under which retention type your data should be stored in a repository.

Veeam Backup for Microsoft 365 provides the following types of retention:

Select this type if you want to keep an item until the restore point of an item's version is within the retention coverage.

Select this type if you want to keep an item until its creation time or last modification time is within the retention coverage.

Item-Level Retention

Data removal from backup repositories with the item-level retention type occurs every time the creation time or last modification time of an item in a backup file goes beyond the retention coverage.

The following is an example that demonstrates three backup files; each file contains Microsoft 365 items per year where each item has its own last modification time.

For example, your retention policy is said to be applied at 10:20 AM on September 1, 2018. In such a scenario, Veeam Backup for Microsoft 365 will remove the Item 1 from the Backup 1 repository because the Item 1 exceeds the retention period (2 years in our example) by 20 minutes.

The next item to be removed is the Item 2 because its last modifications were made at 10:20 AM on November 11, 2016. That said, when a retention policy is being applied, for example, at 10:30 AM on November 11, 2018, Veeam Backup for Microsoft 365 removes the Item 2 because its age equals 2 years and 10 minutes which exceeds the specified threshold.

The same is repeated until no items left in a repository. After that, Veeam Backup for Microsoft 365 completely removes such a repository from the hard drive.

Note

Backup jobs do not process items the last modification time of which exceeds the specified retention period.

Understanding Retention Policy

Snapshot-Based Retention

Each item in a backup file may have its own different versions. A different version means that the user could have changed any attribute of an item in the production environment; for instance, he could have assigned a new category to an email in the mailbox. Such an action leads to a new version of an item to be created during the subsequent backup job session.

When a retention policy is applied in backup repositories with the snapshot-based retention type, Veeam Backup for Microsoft 365 removes versions of an item, but not an item itself. Data removal from backup occurs every time the restore point of an item's version in a backup file goes beyond the retention coverage. Eventually, if no more changes were made to an item, Veeam Backup for Microsoft 365 will remove all versions of an item except the latest one. The latest versions and items that were never changed stay in a backup repository with the snapshot-based retention type forever.

The following example represents two backup files consisting of three items each, where each item has its own backup date. Consider the Item 1 of Backup 1 storage to be an email message, the attributes of which have been modified three times in the production environment; each modification was made on different days (Mon, Tue, and Wed) and each modification was successfully backed up.

That said, there are three different versions of the Item 1 in a backup repository.

According to the example, if the retention policy is 1 year and said to be applied at 10:00 AM on September 12, 2018, then all the item versions that exceed the specified retention threshold will be removed from the backup repository. These versions are the Version 1 and Version 2.

The Version 3 is the latest and if no more versions will be created for the Item 1, it will be kept in Backup 1 storage along with initial versions of Item 2 and Item 3.

Note

Backup jobs process all available items regardless of their creation time or last modification time.

Understanding Retention Policy

Removing Items After Unsuccessful Backup Attempts

If during the subsequent backup job sessions Veeam Backup for Microsoft 365 fails to back up organization mailboxes, Microsoft SharePoint items, Microsoft OneDrive for Business items, or Microsoft Teams items, the product preserves the latest backup state of such items until the next successful backup is created.

The following is an example that demonstrates a backup of the mailbox A which is followed by 6 consecutive unsuccessful attempts (B though G) of backing up that same mailbox during the subsequent backup job sessions. The mailbox A will not be removed until this mailbox is successfully backed up during the attempt H.

Understanding Retention Policy

Removing Restore Points

Each version of an item can have its own restore point. The restore points of items are removed as soon as they are out of the retention coverage. Once the latest available restore point is removed, the parent item of such a restore point will be removed as well.

Consider the following example with four items (A through D) and two restore points (A1 and A2) both of which belong to the item A. The A1 restore point has already been removed since it was out of the retention scope, whereas the A2 restore point will only be removed after it goes out of the retention coverage (Example 1).

Once the latest restore point is out of the retention scope and, therefore, can safely be removed, the item A — the parent item of the latest restore point A2 — will be removed as well (Example 2).

Understanding Retention Policy

Backup Job Idleness

If a backup job has created a successful backup and then went idle for an indefinite period of time (for example, it become disabled), then all the data created by such a job will be removed once it is out of the retention coverage.

The following is an example in which the mailbox A has been removed because it was already out of the retention scope (Example 1), and the next mailbox to be removed is the mailbox B, the removal of which will happen once it goes beyond the retention coverage (Example 2).

The same is applicable to Microsoft SharePoint, Microsoft OneDrive for Business and Microsoft Teams.

Understanding Retention Policy

Related Topics

Specify Retention Policy Settings