Protection Policies - Get

Service:

Recovery Services - Backup

API Version:

2024-10-01

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=2024-10-01

URI Parameters

Name	In	Required	Type	Description
policyName	path	True	string	Backup policy information to be fetched.
resourceGroupName	path	True	string	The name of the resource group where the recovery services vault is present.
subscriptionId	path	True	string	The subscription Id.
vaultName	path	True	string	The name of the recovery services vault.
api-version	query	True	string	Client Api Version.

Responses

Name	Type	Description
200 OK	ProtectionPolicyResource	OK
Other Status Codes	CloudError	Error response describing why the operation failed.

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 IaasVm Enhanced Protection Policy Details

Get Azure IaasVm Protection Policy Details

Get Azure IaasVm Enhanced Protection Policy Details

Sample request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/v2-daily-sample?api-version=2024-10-01

Sample response

Status code:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/v2-daily-sample",
  "name": "v2-daily-sample",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "instantRpRetentionRangeInDays": 30,
    "policyType": "V2",
    "snapshotConsistencyType": "OnlyCrashConsistent",
    "schedulePolicy": {
      "dailySchedule": {
        "scheduleRunTimes": [
          "2018-01-24T10:00:00Z"
        ]
      },
      "schedulePolicyType": "SimpleSchedulePolicyV2",
      "scheduleRunFrequency": "Daily"
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "dailySchedule": {
        "retentionTimes": [
          "2018-01-24T02:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Days"
        }
      }
    },
    "timeZone": "Pacific Standard Time",
    "protectedItemsCount": 0,
    "resourceGuardOperationRequests": null
  }
}

Get Azure IaasVm Protection Policy Details

Sample request

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/testPolicy1?api-version=2024-10-01

Sample response

Status code:

200

{
  "id": "/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/SwaggerTestRg/providers/Microsoft.RecoveryServices/vaults/NetSDKTestRsVault/backupPolicies/testPolicy1",
  "name": "testPolicy1",
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies",
  "properties": {
    "backupManagementType": "AzureIaasVM",
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunFrequency": "Daily",
      "scheduleRunTimes": [
        "2018-01-24T02:00:00Z"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "retentionPolicy": {
      "retentionPolicyType": "LongTermRetentionPolicy",
      "dailySchedule": {
        "retentionTimes": [
          "2018-01-24T02:00:00Z"
        ],
        "retentionDuration": {
          "count": 1,
          "durationType": "Days"
        }
      }
    },
    "timeZone": "Pacific Standard Time",
    "protectedItemsCount": 0
  }
}

Definitions

Name	Description
AzureFileShareProtectionPolicy	AzureStorage backup policy.
AzureIaaSVMProtectionPolicy	IaaS VM workload-specific backup policy.
AzureSqlProtectionPolicy	Azure SQL workload-specific backup policy.
AzureVmWorkloadProtectionPolicy	Azure VM (Mercury) workload-specific backup policy.
CloudError	An error response from the Container Instance service.
CloudErrorBody	An error response from the Container Instance service.
DailyRetentionFormat	Daily retention format.
DailyRetentionSchedule	Daily retention schedule.
DailySchedule
Day	Day of the week.
DayOfWeek
ErrorAdditionalInfo	The resource management error additional info.
GenericProtectionPolicy	Azure VM (Mercury) workload-specific backup policy.
HourlySchedule
IAASVMPolicyType
IaasVMSnapshotConsistencyType
InstantRPAdditionalDetails
LogSchedulePolicy	Log policy schedule.
LongTermRetentionPolicy	Long term retention policy.
LongTermSchedulePolicy	Long term policy schedule.
MabProtectionPolicy	Mab container-specific backup policy.
MonthlyRetentionSchedule	Monthly retention schedule.
MonthOfYear	List of months of year of yearly retention policy.
PolicyType	Type of backup policy type
ProtectionPolicyResource	Base class for backup policy. Workload-specific backup policies are derived from this class.
RetentionDuration	Retention duration.
RetentionDurationType	Retention duration type: days/weeks/months/years Used only if TieringMode is set to TierAfter
RetentionScheduleFormat	Retention schedule format type for monthly retention policy.
ScheduleRunType	Frequency of the schedule operation of this policy.
Settings	Common settings field for backup management
SimpleRetentionPolicy	Simple policy retention.
SimpleSchedulePolicy	Simple policy schedule.
SimpleSchedulePolicyV2	The V2 policy schedule for IaaS that supports hourly backups.
SnapshotBackupAdditionalDetails	Snapshot Backup related fields for WorkloadType SaPHanaSystem
SubProtectionPolicy	Sub-protection policy which includes schedule and retention
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
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
UserAssignedIdentityProperties	User assigned managed identity properties
UserAssignedManagedIdentityDetails	User assigned managed identity details
VaultRetentionPolicy	Vault retention policy for AzureFileShare
WeeklyRetentionFormat	Weekly retention format.
WeeklyRetentionSchedule	Weekly retention schedule.
WeeklySchedule
WeekOfMonth	List of weeks of month.
WorkloadType	Type of workload for the backup management
YearlyRetentionSchedule	Yearly retention schedule.

AzureFileShareProtectionPolicy

AzureStorage backup policy.

Name	Type	Description
backupManagementType	string: AzureStorage	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
protectedItemsCount	integer	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
retentionPolicy	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Retention policy with the details on backup copy retention ranges.
schedulePolicy	SchedulePolicy: LogSchedulePolicy LongTermSchedulePolicy SimpleSchedulePolicy SimpleSchedulePolicyV2	Backup schedule specified as part of backup policy.
timeZone	string	TimeZone optional input as string. For example: TimeZone = "Pacific Standard Time".
vaultRetentionPolicy	VaultRetentionPolicy	Retention policy with the details on hardened backup copy retention ranges.
workLoadType	WorkloadType	Type of workload for the backup management

AzureIaaSVMProtectionPolicy

IaaS VM workload-specific backup policy.

Name	Type	Description
backupManagementType	string: AzureIaasVM	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
instantRPDetails	InstantRPAdditionalDetails
instantRpRetentionRangeInDays	integer	Instant RP retention policy range in days
policyType	IAASVMPolicyType
protectedItemsCount	integer	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
retentionPolicy	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Retention policy with the details on backup copy retention ranges.
schedulePolicy	SchedulePolicy: LogSchedulePolicy LongTermSchedulePolicy SimpleSchedulePolicy SimpleSchedulePolicyV2	Backup schedule specified as part of backup policy.
snapshotConsistencyType	IaasVMSnapshotConsistencyType
tieringPolicy	<string,  TieringPolicy>	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: AzureSql	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
protectedItemsCount	integer	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
retentionPolicy	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Retention policy details.

AzureVmWorkloadProtectionPolicy

Azure VM (Mercury) workload-specific backup policy.

Name	Type	Description
backupManagementType	string: AzureWorkload	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	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
settings	Settings	Common settings for the backup management
subProtectionPolicy	SubProtectionPolicy[]	List of sub-protection policies which includes schedule and retention
workLoadType	WorkloadType	Type of workload for the backup management

CloudError

An error response from the Container Instance service.

Name	Type	Description
error	CloudErrorBody	The error object.

CloudErrorBody

An error response from the Container Instance service.

Name	Type	Description
additionalInfo	ErrorAdditionalInfo[]	The error additional info.
code	string	An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
details	CloudErrorBody[]	A list of additional details about the error.
message	string	A message describing the error, intended to be suitable for display in a user interface.
target	string	The target of the particular error. For example, the name of the property in error.

DailyRetentionFormat

Daily retention format.

Name	Type	Description
daysOfTheMonth	Day[]	List of days of the month.

DailyRetentionSchedule

Daily retention schedule.

Name	Type	Description
retentionDuration	RetentionDuration	Retention duration of retention Policy.
retentionTimes	string[]	Retention times of retention policy.

DailySchedule

Name	Type	Description
scheduleRunTimes	string[]	List of times of day this schedule has to be run.

Day

Day of the week.

Name	Type	Description
date	integer	Date of the month
isLast	boolean	Whether Date is last date of month

DayOfWeek

Name	Type	Description
Friday	string
Monday	string
Saturday	string
Sunday	string
Thursday	string
Tuesday	string
Wednesday	string

ErrorAdditionalInfo

The resource management error additional info.

Name	Type	Description
info	object	The additional info.
type	string	The additional info type.

GenericProtectionPolicy

Azure VM (Mercury) workload-specific backup policy.

Name	Type	Description
backupManagementType	string: GenericProtectionPolicy	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	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
subProtectionPolicy	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	Interval at which backup needs to be triggered. For hourly the value can be 4/6/8/12
scheduleWindowDuration	integer	To specify duration of the backup window
scheduleWindowStartTime	string	To specify start time of the backup window

IAASVMPolicyType

Name	Type	Description
Invalid	string
V1	string
V2	string

IaasVMSnapshotConsistencyType

Name	Type	Description
OnlyCrashConsistent	string

InstantRPAdditionalDetails

Name	Type	Description
azureBackupRGNamePrefix	string
azureBackupRGNameSuffix	string

LogSchedulePolicy

Log policy schedule.

Name	Type	Description
scheduleFrequencyInMins	integer	Frequency of the log schedule operation of this policy in minutes.
schedulePolicyType	string: LogSchedulePolicy	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	DailyRetentionSchedule	Daily retention schedule of the protection policy.
monthlySchedule	MonthlyRetentionSchedule	Monthly retention schedule of the protection policy.
retentionPolicyType	string: LongTermRetentionPolicy	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
weeklySchedule	WeeklyRetentionSchedule	Weekly retention schedule of the protection policy.
yearlySchedule	YearlyRetentionSchedule	Yearly retention schedule of the protection policy.

LongTermSchedulePolicy

Long term policy schedule.

Name	Type	Description
schedulePolicyType	string: LongTermSchedulePolicy	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	Number of items associated with this policy.
resourceGuardOperationRequests	string[]	ResourceGuard Operation Requests
retentionPolicy	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Retention policy details.
schedulePolicy	SchedulePolicy: LogSchedulePolicy LongTermSchedulePolicy SimpleSchedulePolicy SimpleSchedulePolicyV2	Backup schedule of backup policy.

MonthlyRetentionSchedule

Monthly retention schedule.

Name	Type	Description
retentionDuration	RetentionDuration	Retention duration of retention Policy.
retentionScheduleDaily	DailyRetentionFormat	Daily retention format for monthly retention policy.
retentionScheduleFormatType	RetentionScheduleFormat	Retention schedule format type for monthly retention policy.
retentionScheduleWeekly	WeeklyRetentionFormat	Weekly retention format for monthly retention policy.
retentionTimes	string[]	Retention times of retention policy.

MonthOfYear

List of months of year of yearly retention policy.

Name	Type	Description
April	string
August	string
December	string
February	string
Invalid	string
January	string
July	string
June	string
March	string
May	string
November	string
October	string
September	string

PolicyType

Type of backup policy type

Name	Type	Description
CopyOnlyFull	string
Differential	string
Full	string
Incremental	string
Invalid	string
Log	string
SnapshotCopyOnlyFull	string
SnapshotFull	string

ProtectionPolicyResource

Base class for backup policy. Workload-specific backup policies are derived from this class.

Name	Type	Description
eTag	string	Optional ETag.
id	string	Resource Id represents the complete path to the resource.
location	string	Resource location.
name	string	Resource name associated with the resource.
properties	ProtectionPolicy: AzureFileShareProtectionPolicy AzureIaaSVMProtectionPolicy AzureSqlProtectionPolicy AzureVmWorkloadProtectionPolicy GenericProtectionPolicy MabProtectionPolicy	ProtectionPolicyResource properties
tags	object	Resource tags.
type	string	Resource type represents the complete path of the form Namespace/ResourceType/ResourceType/...

RetentionDuration

Retention duration.

Name	Type	Description
count	integer	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	RetentionDurationType	Retention duration type of retention policy.

RetentionDurationType

Retention duration type: days/weeks/months/years Used only if TieringMode is set to TierAfter

Name	Type	Description
Days	string
Invalid	string
Months	string
Weeks	string
Years	string

RetentionScheduleFormat

Retention schedule format type for monthly retention policy.

Name	Type	Description
Daily	string
Invalid	string
Weekly	string

ScheduleRunType

Frequency of the schedule operation of this policy.

Name	Type	Description
Daily	string
Hourly	string
Invalid	string
Weekly	string

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	RetentionDuration	Retention duration of the protection policy.
retentionPolicyType	string: SimpleRetentionPolicy	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	HourlySchedule	Hourly Schedule of this Policy
schedulePolicyType	string: SimpleSchedulePolicy	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
scheduleRunDays	DayOfWeek[]	List of days of week this schedule has to be run.
scheduleRunFrequency	ScheduleRunType	Frequency of the schedule operation of this policy.
scheduleRunTimes	string[]	List of times of day this schedule has to be run.
scheduleWeeklyFrequency	integer	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	DailySchedule	Daily schedule of this policy
hourlySchedule	HourlySchedule	hourly schedule of this policy
schedulePolicyType	string: SimpleSchedulePolicyV2	This property will be used as the discriminator for deciding the specific types in the polymorphic chain of types.
scheduleRunFrequency	ScheduleRunType	Frequency of the schedule operation of this policy.
weeklySchedule	WeeklySchedule	Weekly schedule of this policy

SnapshotBackupAdditionalDetails

Snapshot Backup related fields for WorkloadType SaPHanaSystem

Name	Type	Description
instantRPDetails	string
instantRpRetentionRangeInDays	integer
userAssignedManagedIdentityDetails	UserAssignedManagedIdentityDetails	User assigned managed identity details

SubProtectionPolicy

Sub-protection policy which includes schedule and retention

Name	Type	Description
policyType	PolicyType	Type of backup policy type
retentionPolicy	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Retention policy with the details on backup copy retention ranges.
schedulePolicy	SchedulePolicy: LogSchedulePolicy LongTermSchedulePolicy SimpleSchedulePolicy SimpleSchedulePolicyV2	Backup schedule specified as part of backup policy.
snapshotBackupAdditionalDetails	SnapshotBackupAdditionalDetails	Snapshot Backup related fields for WorkloadType SaPHanaSystem
tieringPolicy	<string,  TieringPolicy>	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.

TieringMode

Tiering Mode to control automatic tiering of recovery points. Supported values are:

1. TierRecommended: Tier all recovery points recommended to be tiered
2. TierAfter: Tier all recovery points after a fixed period, as specified in duration + durationType below.
3. DoNotTier: Do not tier any recovery points

Name	Type	Description
DoNotTier	string
Invalid	string
TierAfter	string
TierRecommended	string

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	Number of days/weeks/months/years to retain backups in current tier before tiering. Used only if TieringMode is set to TierAfter
durationType	RetentionDurationType	Retention duration type: days/weeks/months/years Used only if TieringMode is set to TierAfter
tieringMode	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

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	UserAssignedIdentityProperties	User assigned managed identity properties

VaultRetentionPolicy

Vault retention policy for AzureFileShare

Name	Type	Description
snapshotRetentionInDays	integer
vaultRetention	RetentionPolicy: LongTermRetentionPolicy SimpleRetentionPolicy	Base class for retention policy.

WeeklyRetentionFormat

Weekly retention format.

Name	Type	Description
daysOfTheWeek	DayOfWeek[]	List of days of the week.
weeksOfTheMonth	WeekOfMonth[]	List of weeks of month.

WeeklyRetentionSchedule

Weekly retention schedule.

Name	Type	Description
daysOfTheWeek	DayOfWeek[]	List of days of week for weekly retention policy.
retentionDuration	RetentionDuration	Retention duration of retention Policy.
retentionTimes	string[]	Retention times of retention policy.

WeeklySchedule

Name	Type	Description
scheduleRunDays	DayOfWeek[]
scheduleRunTimes	string[]	List of times of day this schedule has to be run.

WeekOfMonth

List of weeks of month.

Name	Type	Description
First	string
Fourth	string
Invalid	string
Last	string
Second	string
Third	string

WorkloadType

Type of workload for the backup management

Name	Type	Description
AzureFileShare	string
AzureSqlDb	string
Client	string
Exchange	string
FileFolder	string
GenericDataSource	string
Invalid	string
SAPAseDatabase	string
SAPHanaDBInstance	string
SAPHanaDatabase	string
SQLDB	string
SQLDataBase	string
Sharepoint	string
SystemState	string
VM	string
VMwareVM	string

YearlyRetentionSchedule

Yearly retention schedule.

Name	Type	Description
monthsOfYear	MonthOfYear[]	List of months of year of yearly retention policy.
retentionDuration	RetentionDuration	Retention duration of retention Policy.
retentionScheduleDaily	DailyRetentionFormat	Daily retention format for yearly retention policy.
retentionScheduleFormatType	RetentionScheduleFormat	Retention schedule format for yearly retention policy.
retentionScheduleWeekly	WeeklyRetentionFormat	Weekly retention format for yearly retention policy.
retentionTimes	string[]	Retention times of retention policy.