#Create a New Backup Scope for Cosmos DB

The Cosmos DB service supports two modes for backup scope configuration:

• SaaS infrastructure mode - Provides centralized management, automation, and robust data protection to empower organizations with scalable, policy-driven backup solutions. For details, refer to Use the SaaS Infrastructure Mode.

• CAP Gateway mode - Reduces network latency while enhancing backup performance. Simply create a CAP Gateway and use this mode for your backup operations. For details, refer to Use the CAP Gateway Mode and Manage CAP Gateways.

For details on choosing a backup mode, you can see How to choose a backup mode: SaaS infrastructure mode VS CAP Gateway mode in the Best Practices section.

#Use the SaaS Infrastructure Mode

To create a new backup scope, follow the steps below:

1. Go to the Backup page on the new UI.

2. Click on the Cosmos DB service tile or click the More actions button on the upper-right corner of the Cosmos DB service tile and click Configure backup scope from the drop-down list.

3. In the Configure backup scope for Cosmos DB page, all the existing backup scopes for Cosmos DB are listed in the table. You can use the search box to search for the backup scopes by name and manage the columns to adjust the view of the backup scopes.

4. Click the Create button.

5. In the Choose a mode for Cosmos DB page, select SaaS infrastructure mode and click Continue. The Create a new backup scope panel appears.

6. In the Select databases step, select the tenant that you want to protect in this backup scope from the drop-down list and select the databases that you want to include into this backup scope. You can use Filters to find the databases you want to protect or use the Search box to search for the databases via the keywords in the name. The number of your selection will be displayed on the row of the tenant name.

7. Click Next and you will go to the Configure storage based on region step to configure a storage profile for each region. You can select a storage type and then select storage profiles. You can use an existing storage profile or create a new storage profile to store the backup data for the databases in the same region. For details on configuring storage location, refer to Manage Your Storage.

8. After you finish the storage configuration for each region, click Next to configure the scope information, schedule, and data retention settings. Refer to the following:

   • Scope information - Enter a name and description for the scope you are creating. The description is optional.

   • Schedule - Select days, weeks, months, or years as the unit of time for the backup interval, enter a number in the text box after Every, and then configure the start time for your first backup job.

   • Notification - Check the notification profiles which will be applied to the backup scope.

   • Retention policy - Configure when to prune the backup data from the storage location. Note that if you are using AvePoint storage, the retention policy for backup data is subject to your agreement and you can configure a custom retention period up to the retention policy in your subscription. If you are using AvePoint default storage with unlimited retention period, the Unlimited option is selected automatically in the list. If you want to use a custom retention period, select Custom from the list, enter a number in the text box and select weeks, months, or years from the drop-down list. The retention period cannot be less than 2 weeks. Note that if you have a retention policy with a fixed year in your subscription, the maximum retention period that you can configure will be displayed under this field.

     NOTE

     When you configure the retention period for backup data using the Year unit, the Configure Full Backup Frequency section will appear. You can then select a number from the drop-down list to set the full backup frequency. If the retention period is set to more than three months using the Month or Week unit, the full backup frequency will automatically be set to three months and cannot be changed. For retention periods of less than three months, the full backup frequency will be adjusted accordingly and cannot be modified.

9. Click Next to review your settings.

10. Click Save to save this backup scope. The backup for the databases in this backup scope will roll out as scheduled. For more details about monitoring the backups, refer to Monitor Your Backup.

#Use the CAP Gateway Mode

To create a new backup scope, follow the steps below:

1. Go to the Backup page on the new UI.

2. Click on the Cosmos DB service tile or click the More actions button on the upper-right corner of the Cosmos DB service tile and click Configure backup scope from the drop-down list.

3. In the Configure backup scope for Cosmos DB page, all the existing backup scopes for Cosmos DB are listed in the table. You can use the search box to search for the backup scopes by name and manage the columns to adjust the view of the backup scopes.

4. Click the Create button.

5. In the Choose a mode for Cosmos DB page, select CAP Gateway mode and click Continue. The Create a new backup scope panel appears.

6. In the Select databases step, select the tenant that you want to protect in this backup scope from the drop-down list and select the databases that you want to include into this backup scope. You can use Filters to find the databases you want to protect or use the Search box to search for the databases via the keywords in the name. The number of your selection will be displayed on the row of the tenant name.

7. Click Next and you will go to the Configure storage and gateways based on region step to configure a storage profile and CAP Gateway for each region. You can select a storage type and then select storage profiles.

   • You can use an existing storage profile or create a new storage profile to store the backup data for the databases in the same region. For details on configuring storage location, refer to Manage Your Storage.

   • For details on configuring CAP gateways, refer to Manage CAP Gateways.

8. After you finish the storage configuration for each region, click Next to configure the scope information, schedule, and data retention settings. Refer to the following:

   • Scope information - Enter a name and description for the scope you are creating. The description is optional.

   • Schedule - Select days, weeks, months, or years as the unit of time for the backup interval, enter a number in the text box after Every, and then configure the start time for your first backup job.

   • Notification - Check the notification profiles which will be applied to the backup scope.

   • Retention policy - Configure when to prune the backup data from the storage location. Note that if you are using AvePoint storage, the retention policy for backup data is subject to your agreement and you can configure a custom retention period up to the retention policy in your subscription. If you are using AvePoint default storage with unlimited retention period, the Unlimited option is selected automatically in the list. If you want to use a custom retention period, select Custom from the list, enter a number in the text box and select weeks, months, or years from the drop-down list. The retention period cannot be less than 2 weeks. Note that if you have a retention policy with a fixed year in your subscription, the maximum retention period that you can configure will be displayed under this field.

     NOTE

     When you configure the retention period for backup data using the Year unit, the Configure Full Backup Frequency section will appear. You can then select a number from the drop-down list to set the full backup frequency. If the retention period is set to more than three months using the Month or Week unit, the full backup frequency will automatically be set to three months and cannot be changed. For retention periods of less than three months, the full backup frequency will be adjusted accordingly and cannot be modified.

9. Click Next to review your settings.

10. Click Save to save this backup scope. The backup for the databases in this backup scope will roll out as scheduled. For more details about monitoring the backups, refer to Monitor Your Backup.