Protection Policies - Get
Provides the details of the backup policies associated to Recovery Services Vault. This is an asynchronous operation. Status of the operation can be fetched using GetPolicyOperationResult API.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupPolicies/{policyName}?api-version=2025-08-01URI Parameters
| Name | In | Required | Type | Description | 
|---|---|---|---|---|
| policy | path | True | string | Backup policy information to be fetched. | 
| resource | path | True | stringminLength: 1 maxLength: 90 | The name of the resource group. The name is case insensitive. | 
| subscription | path | True | stringminLength: 1 | The ID of the target subscription. | 
| vault | path | True | string | The name of the VaultResource | 
| api-version | query | True | stringminLength: 1 | The API version to use for this operation. | 
Responses
| Name | Type | Description | 
|---|---|---|
| 200 OK | Azure operation completed successfully. | |
| Other Status Codes | An unexpected error response. | 
Security
azure_auth
Azure Active Directory OAuth2 Flow.
					Type: 
					oauth2
					Flow: 
					implicit
					Authorization URL: 
					https://login.microsoftonline.com/common/oauth2/authorize
			
Scopes
| Name | Description | 
|---|---|
| user_impersonation | impersonate your user account | 
Examples
| Get Azure Iaas | 
| Get Azure Iaas | 
Get Azure IaasVm Enhanced Protection Policy Details 
			Sample request
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/v2-daily-sample?api-version=2025-08-01
Sample response
{
  "name": "v2-daily-sample",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/v2-daily-sample",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "instantRpRetentionRangeInDays": 30,
    "policyType": "V2",
    "protectedItemsCount": 0,
    "resourceGuardOperationRequests": null,
    "retentionPolicy": {
      "dailySchedule": {
        "retentionDuration": {
          "count": 1,
          "durationType": "Days"
        },
        "retentionTimes": [
          "2018-01-24T02:00:00Z"
        ]
      },
      "retentionPolicyType": "LongTermRetentionPolicy"
    },
    "schedulePolicy": {
      "dailySchedule": {
        "scheduleRunTimes": [
          "2018-01-24T10:00:00Z"
        ]
      },
      "schedulePolicyType": "SimpleSchedulePolicyV2",
      "scheduleRunFrequency": "Daily"
    },
    "snapshotConsistencyType": "OnlyCrashConsistent",
    "timeZone": "Pacific Standard Time"
  }
}Get Azure IaasVm Protection Policy Details 
			Sample request
GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/testPolicy1?api-version=2025-08-01
Sample response
{
  "name": "testPolicy1",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/testPolicy1",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "protectedItemsCount": 0,
    "retentionPolicy": {
      "dailySchedule": {
        "retentionDuration": {
          "count": 1,
          "durationType": "Days"
        },
        "retentionTimes": [
          "2018-01-24T02:00:00Z"
        ]
      },
      "retentionPolicyType": "LongTermRetentionPolicy"
    },
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Daily",
      "scheduleRunTimes": [
        "2018-01-24T02:00:00Z"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "timeZone": "Pacific Standard Time"
  }
}Definitions
| Name | Description | 
|---|---|
| Azure | AzureStorage backup policy. | 
| Azure | IaaS VM workload-specific backup policy. | 
| Azure | Azure SQL workload-specific backup policy. | 
| Azure | Azure VM (Mercury) workload-specific backup policy. | 
| created | The type of identity that created the resource. | 
| Daily | Daily retention format. | 
| Daily | Daily retention schedule. | 
| Daily | |
| Day | Day of the week. | 
| Day | |
| Error | Error Detail class which encapsulates Code, Message and Recommendations. | 
| Error | Error response | 
| Generic | Azure VM (Mercury) workload-specific backup policy. | 
| Hourly | |
| IAASVMPolicy | |
| Iaas | |
| Instant | |
| Log | Log policy schedule. | 
| Long | Long term retention policy. | 
| Long | Long term policy schedule. | 
| Mab | Mab container-specific backup policy. | 
| Monthly | Monthly retention schedule. | 
| Month | |
| Policy | Type of backup policy type | 
| Protection | Base class for backup policy. Workload-specific backup policies are derived from this class. | 
| Retention | Retention duration. | 
| Retention | Retention duration type of retention policy. | 
| Retention | Retention schedule format type for monthly retention policy. | 
| Schedule | Frequency of the schedule operation of this policy. | 
| Settings | Common settings field for backup management | 
| Simple | Simple policy retention. | 
| Simple | Simple policy schedule. | 
| Simple | The V2 policy schedule for IaaS that supports hourly backups. | 
| Snapshot | Snapshot Backup related fields for WorkloadType SaPHanaSystem | 
| Sub | Sub-protection policy which includes schedule and retention | 
| system | Metadata pertaining to creation and last modification of the resource. | 
| Tiering | Tiering Mode to control automatic tiering of recovery points. Supported values are: 
 | 
| Tiering | Tiering Policy for a target tier. If the policy is not specified for a given target tier, service retains the existing configured tiering policy for that tier | 
| User | User assigned managed identity properties | 
| User | User assigned managed identity details | 
| Vault | Vault retention policy for AzureFileShare | 
| Weekly | Weekly retention format. | 
| Weekly | Weekly retention schedule. | 
| Weekly | |
| Week | |
| Workload | Type of workload for the backup management | 
| Yearly | Yearly retention schedule. | 
AzureFileShareProtectionPolicy    
			
			AzureStorage backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: 
					Azure | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| retentionPolicy | RetentionPolicy: | Retention policy with the details on backup copy retention ranges. | 
| schedulePolicy | SchedulePolicy: | Backup schedule specified as part of backup policy. | 
| timeZone | string | TimeZone optional input as string. For example: TimeZone = "Pacific Standard Time". | 
| vaultRetentionPolicy | Retention policy with the details on hardened backup copy retention ranges. | |
| workLoadType | Type of workload for the backup management | 
AzureIaaSVMProtectionPolicy   
			
			IaaS VM workload-specific backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: 
					Azure | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| instantRPDetails | ||
| instantRpRetentionRangeInDays | integer (int32) | Instant RP retention policy range in days | 
| policyType | ||
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| retentionPolicy | RetentionPolicy: | Retention policy with the details on backup copy retention ranges. | 
| schedulePolicy | SchedulePolicy: | Backup schedule specified as part of backup policy. | 
| snapshotConsistencyType | ||
| tieringPolicy | 
				
		<string, 
		Tiering | Tiering policy to automatically move RPs to another tier Key is Target Tier, defined in RecoveryPointTierType enum. Tiering policy specifies the criteria to move RP to the target tier. | 
| timeZone | string | TimeZone optional input as string. For example: TimeZone = "Pacific Standard Time". | 
AzureSqlProtectionPolicy   
			
			Azure SQL workload-specific backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: 
					Azure | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| retentionPolicy | RetentionPolicy: | Retention policy details. | 
AzureVmWorkloadProtectionPolicy   
			
			Azure VM (Mercury) workload-specific backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: 
					Azure | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| makePolicyConsistent | boolean | Fix the policy inconsistency | 
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| settings | Common settings for the backup management | |
| subProtectionPolicy | List of sub-protection policies which includes schedule and retention | |
| workLoadType | Type of workload for the backup management | 
createdByType 
			
			The type of identity that created the resource.
| Value | Description | 
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key | 
DailyRetentionFormat  
			
			Daily retention format.
| Name | Type | Description | 
|---|---|---|
| daysOfTheMonth | Day[] | List of days of the month. | 
DailyRetentionSchedule  
			
			Daily retention schedule.
| Name | Type | Description | 
|---|---|---|
| retentionDuration | Retention duration of retention Policy. | |
| retentionTimes | string[] (date-time) | Retention times of retention policy. | 
DailySchedule 
			
			
				| Name | Type | Description | 
|---|---|---|
| scheduleRunTimes | string[] (date-time) | List of times of day this schedule has to be run. | 
Day
Day of the week.
| Name | Type | Description | 
|---|---|---|
| date | integer (int32) | Date of the month | 
| isLast | boolean | Whether Date is last date of month | 
DayOfWeek 
			
			
				| Value | Description | 
|---|---|
| Sunday | |
| Monday | |
| Tuesday | |
| Wednesday | |
| Thursday | |
| Friday | |
| Saturday | 
ErrorDetail 
			
			Error Detail class which encapsulates Code, Message and Recommendations.
| Name | Type | Description | 
|---|---|---|
| code | string | Error code. | 
| message | string | Error Message related to the Code. | 
| recommendations | string[] | List of recommendation strings. | 
ErrorResponse 
			
			Error response
| Name | Type | Description | 
|---|---|---|
| error | The error object. | 
GenericProtectionPolicy  
			
			Azure VM (Mercury) workload-specific backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| fabricName | string | Name of this policy's fabric. | 
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| subProtectionPolicy | List of sub-protection policies which includes schedule and retention | |
| timeZone | string | TimeZone optional input as string. For example: TimeZone = "Pacific Standard Time". | 
HourlySchedule 
			
			
				| Name | Type | Description | 
|---|---|---|
| interval | integer (int32) | Interval at which backup needs to be triggered. For hourly the value can be 4/6/8/12 | 
| scheduleWindowDuration | integer (int32) | To specify duration of the backup window | 
| scheduleWindowStartTime | string (date-time) | To specify start time of the backup window | 
IAASVMPolicyType 
			
			
				| Value | Description | 
|---|---|
| Invalid | |
| V1 | |
| V2 | 
IaasVMSnapshotConsistencyType   
			
			
				| Value | Description | 
|---|---|
| OnlyCrashConsistent | 
InstantRPAdditionalDetails  
			
			
				| Name | Type | Description | 
|---|---|---|
| azureBackupRGNamePrefix | string | |
| azureBackupRGNameSuffix | string | 
LogSchedulePolicy  
			
			Log policy schedule.
| Name | Type | Description | 
|---|---|---|
| scheduleFrequencyInMins | integer (int32) | Frequency of the log schedule operation of this policy in minutes. | 
| schedulePolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
LongTermRetentionPolicy   
			
			Long term retention policy.
| Name | Type | Description | 
|---|---|---|
| dailySchedule | Daily retention schedule of the protection policy. | |
| monthlySchedule | Monthly retention schedule of the protection policy. | |
| retentionPolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| weeklySchedule | Weekly retention schedule of the protection policy. | |
| yearlySchedule | Yearly retention schedule of the protection policy. | 
LongTermSchedulePolicy   
			
			Long term policy schedule.
| Name | Type | Description | 
|---|---|---|
| schedulePolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
MabProtectionPolicy  
			
			Mab container-specific backup policy.
| Name | Type | Description | 
|---|---|---|
| backupManagementType | string: MAB | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| protectedItemsCount | integer (int32) | Number of items associated with this policy. | 
| resourceGuardOperationRequests | string[] | ResourceGuard Operation Requests | 
| retentionPolicy | RetentionPolicy: | Retention policy details. | 
| schedulePolicy | SchedulePolicy: | Backup schedule of backup policy. | 
MonthlyRetentionSchedule  
			
			Monthly retention schedule.
| Name | Type | Description | 
|---|---|---|
| retentionDuration | Retention duration of retention Policy. | |
| retentionScheduleDaily | Daily retention format for monthly retention policy. | |
| retentionScheduleFormatType | Retention schedule format type for monthly retention policy. | |
| retentionScheduleWeekly | Weekly retention format for monthly retention policy. | |
| retentionTimes | string[] (date-time) | Retention times of retention policy. | 
MonthOfYear 
			
			
				| Value | Description | 
|---|---|
| Invalid | |
| January | |
| February | |
| March | |
| April | |
| May | |
| June | |
| July | |
| August | |
| September | |
| October | |
| November | |
| December | 
PolicyType 
			
			Type of backup policy type
| Value | Description | 
|---|---|
| Invalid | |
| Full | |
| Differential | |
| Log | |
| CopyOnlyFull | |
| Incremental | |
| SnapshotFull | |
| SnapshotCopyOnlyFull | 
ProtectionPolicyResource  
			
			Base class for backup policy. Workload-specific backup policies are derived from this class.
| Name | Type | Description | 
|---|---|---|
| eTag | string | Optional ETag. | 
| id | string | Fully qualified resource ID for the resource. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} | 
| ___location | string | The geo-___location where the resource lives | 
| name | string | The name of the resource | 
| properties | ProtectionPolicy: | ProtectionPolicyResource properties | 
| systemData | Azure Resource Manager metadata containing createdBy and modifiedBy information. | |
| tags | object | Resource tags. | 
| type | string | The type of the resource. E.g. "Microsoft.Compute/virtualMachines" or "Microsoft.Storage/storageAccounts" | 
RetentionDuration 
			
			Retention duration.
| Name | Type | Description | 
|---|---|---|
| count | integer (int32) | Count of duration types. Retention duration is obtained by the counting the duration type Count times. For example, when Count = 3 and DurationType = Weeks, retention duration will be three weeks. | 
| durationType | Retention duration type of retention policy. | 
RetentionDurationType  
			
			Retention duration type of retention policy.
| Value | Description | 
|---|---|
| Invalid | |
| Days | |
| Weeks | |
| Months | |
| Years | 
RetentionScheduleFormat  
			
			Retention schedule format type for monthly retention policy.
| Value | Description | 
|---|---|
| Invalid | |
| Daily | |
| Weekly | 
ScheduleRunType  
			
			Frequency of the schedule operation of this policy.
| Value | Description | 
|---|---|
| Invalid | |
| Daily | |
| Weekly | |
| Hourly | 
Settings
Common settings field for backup management
| Name | Type | Description | 
|---|---|---|
| isCompression | boolean | Workload compression flag. This has been added so that 'isSqlCompression' will be deprecated once clients upgrade to consider this flag. | 
| issqlcompression | boolean | SQL compression flag | 
| timeZone | string | TimeZone optional input as string. For example: TimeZone = "Pacific Standard Time". | 
SimpleRetentionPolicy  
			
			Simple policy retention.
| Name | Type | Description | 
|---|---|---|
| retentionDuration | Retention duration of the protection policy. | |
| retentionPolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
SimpleSchedulePolicy  
			
			Simple policy schedule.
| Name | Type | Description | 
|---|---|---|
| hourlySchedule | Hourly Schedule of this Policy | |
| schedulePolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| scheduleRunDays | List of days of week this schedule has to be run. | |
| scheduleRunFrequency | Frequency of the schedule operation of this policy. | |
| scheduleRunTimes | string[] (date-time) | List of times of day this schedule has to be run. | 
| scheduleWeeklyFrequency | integer (int32) | At every number weeks this schedule has to be run. | 
SimpleSchedulePolicyV2  
			
			The V2 policy schedule for IaaS that supports hourly backups.
| Name | Type | Description | 
|---|---|---|
| dailySchedule | Daily schedule of this policy | |
| hourlySchedule | hourly schedule of this policy | |
| schedulePolicyType | string: | This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types. | 
| scheduleRunFrequency | Frequency of the schedule operation of this policy. | |
| weeklySchedule | Weekly schedule of this policy | 
SnapshotBackupAdditionalDetails   
			
			Snapshot Backup related fields for WorkloadType SaPHanaSystem
| Name | Type | Description | 
|---|---|---|
| instantRPDetails | string | |
| instantRpRetentionRangeInDays | integer (int32) | |
| userAssignedManagedIdentityDetails | User assigned managed identity details | 
SubProtectionPolicy  
			
			Sub-protection policy which includes schedule and retention
| Name | Type | Description | 
|---|---|---|
| policyType | Type of backup policy type | |
| retentionPolicy | RetentionPolicy: | Retention policy with the details on backup copy retention ranges. | 
| schedulePolicy | SchedulePolicy: | Backup schedule specified as part of backup policy. | 
| snapshotBackupAdditionalDetails | Snapshot Backup related fields for WorkloadType SaPHanaSystem | |
| tieringPolicy | 
				
		<string, 
		Tiering | Tiering policy to automatically move RPs to another tier. Key is Target Tier, defined in RecoveryPointTierType enum. Tiering policy specifies the criteria to move RP to the target tier. | 
systemData 
			
			Metadata pertaining to creation and last modification of the resource.
| Name | Type | Description | 
|---|---|---|
| createdAt | string (date-time) | The timestamp of resource creation (UTC). | 
| createdBy | string | The identity that created the resource. | 
| createdByType | The type of identity that created the resource. | |
| lastModifiedAt | string (date-time) | The timestamp of resource last modification (UTC) | 
| lastModifiedBy | string | The identity that last modified the resource. | 
| lastModifiedByType | The type of identity that last modified the resource. | 
TieringMode 
			
			Tiering Mode to control automatic tiering of recovery points. Supported values are:
- TierRecommended: Tier all recovery points recommended to be tiered
- TierAfter: Tier all recovery points after a fixed period, as specified in duration + durationType below.
- DoNotTier: Do not tier any recovery points
| Value | Description | 
|---|---|
| Invalid | |
| TierRecommended | |
| TierAfter | |
| DoNotTier | 
TieringPolicy 
			
			Tiering Policy for a target tier. If the policy is not specified for a given target tier, service retains the existing configured tiering policy for that tier
| Name | Type | Description | 
|---|---|---|
| duration | integer (int32) | Number of days/weeks/months/years to retain backups in current tier before tiering. Used only if TieringMode is set to TierAfter | 
| durationType | Retention duration type: days/weeks/months/years Used only if TieringMode is set to TierAfter | |
| tieringMode | Tiering Mode to control automatic tiering of recovery points. Supported values are: 
 | 
UserAssignedIdentityProperties   
			
			User assigned managed identity properties
| Name | Type | Description | 
|---|---|---|
| clientId | string | The client ID of the assigned identity. | 
| principalId | string | The principal ID of the assigned identity. | 
UserAssignedManagedIdentityDetails    
			
			User assigned managed identity details
| Name | Type | Description | 
|---|---|---|
| identityArmId | string | The ARM id of the assigned identity. | 
| identityName | string | The name of the assigned identity. | 
| userAssignedIdentityProperties | User assigned managed identity properties | 
VaultRetentionPolicy  
			
			Vault retention policy for AzureFileShare
| Name | Type | Description | 
|---|---|---|
| snapshotRetentionInDays | integer (int32) | |
| vaultRetention | RetentionPolicy: | Base class for retention policy. | 
WeeklyRetentionFormat  
			
			Weekly retention format.
| Name | Type | Description | 
|---|---|---|
| daysOfTheWeek | List of days of the week. | |
| weeksOfTheMonth | List of weeks of month. | 
WeeklyRetentionSchedule  
			
			Weekly retention schedule.
| Name | Type | Description | 
|---|---|---|
| daysOfTheWeek | List of days of week for weekly retention policy. | |
| retentionDuration | Retention duration of retention Policy. | |
| retentionTimes | string[] (date-time) | Retention times of retention policy. | 
WeeklySchedule 
			
			
				| Name | Type | Description | 
|---|---|---|
| scheduleRunDays | ||
| scheduleRunTimes | string[] (date-time) | List of times of day this schedule has to be run. | 
WeekOfMonth 
			
			
				| Value | Description | 
|---|---|
| First | |
| Second | |
| Third | |
| Fourth | |
| Last | |
| Invalid | 
WorkloadType 
			
			Type of workload for the backup management
| Value | Description | 
|---|---|
| Invalid | |
| VM | |
| FileFolder | |
| AzureSqlDb | |
| SQLDB | |
| Exchange | |
| Sharepoint | |
| VMwareVM | |
| SystemState | |
| Client | |
| GenericDataSource | |
| SQLDataBase | |
| AzureFileShare | |
| SAPHanaDatabase | |
| SAPAseDatabase | |
| SAPHanaDBInstance | 
YearlyRetentionSchedule  
			
			Yearly retention schedule.
| Name | Type | Description | 
|---|---|---|
| monthsOfYear | List of months of year of yearly retention policy. | |
| retentionDuration | Retention duration of retention Policy. | |
| retentionScheduleDaily | Daily retention format for yearly retention policy. | |
| retentionScheduleFormatType | Retention schedule format for yearly retention policy. | |
| retentionScheduleWeekly | Weekly retention format for yearly retention policy. | |
| retentionTimes | string[] (date-time) | Retention times of retention policy. |