Quickstart: Create a vaulted backup policy for Azure Data Lake Storage

This quickstart describes how to create a vaulted backup policy for Azure Data Lake Storage from the Azure portal.

Prerequisites

Before you create a vaulted backup policy for Azure Data Lake Storage, ensure that the following prerequisites are met:

• Identify or create a Backup vault to configure Azure Data Lake Storage backup.
• Review the supported scenarios for Azure Data Lake Storage backup.

Configure a vaulted backup policy for Azure Data Lake Storage using the Azure portal

A backup policy defines the schedule and frequency for backing up Azure Data Lake Storage. You can either create a backup policy from the Backup vault or create it on the go during the backup configuration.

To configure a vaulted backup policy for Azure Data Lake Storage from the Backup vault, follow these steps:

1. In the Azure portal, go to the Backup vault > Backup policies, and then select + Add.

2. On the Create Backup Policy pane, on the Basics tab, provide a name for the new policy on Policy name, and then select Datasource type as Azure Data Lake Storage.

   

3. On the Schedule + retention tab, under the Backup schedule section, set the Backup Frequency as Daily or Weekly and the schedule for creating recovery points for backups.

4. Under the Add retention section, edit the default retention rule or add new rules to specify the retention of recovery points.

5. Select Review + create.

6. After the review succeeds, select Create.

This quickstart describes how to create a vaulted backup policy for Azure Data Lake Storage backup using PowerShell.

Prerequisites

Before you create a vaulted backup policy for Azure Data Lake Storage, ensure that the following prerequisites are met:

• Install the Azure PowerShell version Az 14.6.0. Learn how to install Azure PowerShell.
• Identify or create a Backup vault to configure Azure Data Lake Storage backup.
• Review the supported scenarios for Azure Data Lake Storage backup.

Configure a vaulted backup policy for Azure Data Lake Storage using PowerShell

To configure a vaulted backup policy for Azure Data Lake Storage, run the following cmdlets:

1. To fetch the policy template, use the Get-AzDataProtectionPolicyTemplate cmdlet. This command fetches a default policy template for a given datasource type. Use this policy template to create a new policy.

   $defaultPol = Get-AzDataProtectionPolicyTemplate -DatasourceType AzureDataLakeStorage
   

2. To create a vaulted backup policy, define the schedule and retention for backups. The following example cmdlets create a backup policy with backup frequency every week on Friday and Tuesday at 10 AM and retention of three months.

   $schDates = @(
   (
   (Get-Date -Year 2023 -Month 08 -Day 18 -Hour 10 -Minute 0 -Second 0)
   ),
   (
   (Get-Date -Year 2023 -Month 08 -Day 22 -Hour 10 -Minute 0 -Second 0)
   ))
   $trigger =  New-AzDataProtectionPolicyTriggerScheduleClientObject -ScheduleDays $schDates -IntervalType Weekly -IntervalCount 1
   Edit-AzDataProtectionPolicyTriggerClientObject -Schedule $trigger -Policy $defaultPol
   
   $lifeCycleVault = New-AzDataProtectionRetentionLifeCycleClientObject -SourceDataStore VaultStore -SourceRetentionDurationType Months -SourceRetentionDurationCount 3
   Edit-AzDataProtectionPolicyRetentionRuleClientObject -Policy $defaultPol -Name Default -LifeCycles $lifeCycleVault -IsDefault $true
   New-AzDataProtectionBackupPolicy -SubscriptionId "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx" -ResourceGroupName "resourceGroupName" -VaultName "vaultName" -Name "MyPolicy" -Policy $defaultPol
   
   

This quickstart describes how to create a vaulted backup policy for Azure Data Lake Storage backup using Azure CLI.

Prerequisites

Before you create a vaulted backup policy for Azure Data Lake Storage, ensure that the following prerequisites are met:

• Identify or create a Backup vault to configure Azure Data Lake Storage backup.
• Review the supported scenarios for Azure Data Lake Storage backup.

Configure a vaulted backup policy for Azure Data Lake Storage using Azure CLI

To configure a vaulted backup policy for Azure Date Lake Storage backup, run the following commands:

1. To understand the backup policy components for Azure Data Lake Storage backup, fetch the policy template using the az dataprotection backup-policy get-default-policy-template command. The following command returns a default policy template for a given datasource type that you can use to create a new policy.

   az dataprotection backup-policy get-default-policy-template --datasource-type AzureDataLakeStorage > policy.json
   

2. After you save the policy JSON with all the required values, proceed to create a new policy from the policy object using the az dataprotection backup-policy create command.

   Az dataprotection backup-policy create -g adlsrg –vault-name TestBkpVault -n AdlsPolicy1  –policy policy.json
   

   The following example JSON is defined to configure a policy 30 days default retention for vaulted backup. The vaulted backup is scheduled for every day at 7:30 UTC.

   {
      "properties": {
         "policyRules": [
               {
                  "lifecycles": [
                     {
                           "deleteAfter": {
                              "objectType": "AbsoluteDeleteOption",
                              "duration": "P30D"
                           },
                           "targetDataStoreCopySettings": [],
                           "sourceDataStore": {
                              "dataStoreType": "VaultStore",
                              "objectType": "DataStoreInfoBase"
                           }
                     }
                  ],
                  "isDefault": true,
                  "name": "Default",
                  "objectType": "AzureRetentionRule"
               },
               {
                  "backupParameters": {
                     "backupType": "Discrete",
                     "objectType": "AzureBackupParams"
                  },
                  "trigger": {
                     "schedule": {
                           "repeatingTimeIntervals": [
                              "R/2025-10-13T07:00:00+00:00/P1D"
                           ],
                           "timeZone": "Coordinated Universal Time"
                     },
                     "taggingCriteria": [
                           {
                              "tagInfo": {
                                 "tagName": "Default",
                                 "id": "Default_"
                              },
                              "taggingPriority": 99,
                              "isDefault": true
                           }
                     ],
                     "objectType": "ScheduleBasedTriggerContext"
                  },
                  "dataStore": {
                     "dataStoreType": "VaultStore",
                     "objectType": "DataStoreInfoBase"
                  },
                  "name": "BackupDaily",
                  "objectType": "AzureBackupRule"
               }
         ],
         "datasourceTypes": [
               "Microsoft.Storage/storageAccounts/adlsBlobServices"
         ],
         "objectType": "BackupPolicy"
      },
      "id": "/subscriptions/ xxxxxxxx-xxxx-xxxx-xxxx /resourceGroups/ adlsrg/providers/Microsoft.DataProtection/backupVaults/ TestBkpVault/backupPolicies/AdlsPolicy1",
      "name": "AdlsPolicy1",
      "type": "Microsoft.DataProtection/backupVaults/backupPolicies"
   }