Microsoft Azure SDK for Python

This is the Microsoft Azure Data Protection Management Client Library. This package has been tested with Python 3.10+. For a more complete view of Azure libraries, see the azure sdk python release.

Disclaimer

Azure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer to https://github.com/Azure/azure-sdk-for-python/issues/20691

Getting started

Prerequisites

• Python 3.10+ is required to use this package.
• Azure subscription

Install the package

pip install azure-mgmt-dataprotection
pip install azure-identity

Authentication

By default, Microsoft Entra token authentication depends on correct configuration of the following environment variables.

• AZURE_CLIENT_ID for Azure client ID.
• AZURE_TENANT_ID for Azure tenant ID.
• AZURE_CLIENT_SECRET for Azure client secret.

In addition, Azure subscription ID can be configured via environment variable AZURE_SUBSCRIPTION_ID.

With above configuration, client can be authenticated by following code:

from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionMgmtClient
import os

sub_id = os.getenv("AZURE_SUBSCRIPTION_ID")
client = DataProtectionMgmtClient(credential=DefaultAzureCredential(), subscription_id=sub_id)

Examples

Code samples for this package can be found at:

• Search Data Protection Management on docs.microsoft.com
• Azure Python Mgmt SDK Samples Repo

Troubleshooting

Next steps

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

2.3.0b1 (2026-09-29)

Features Added

• Model AzureBackupDiscreteRecoveryPoint added property immutability_properties
• Model ImmutabilitySettings added property configuration
• Added enum BackupSolutionType
• Added model ImmutabilityConfiguration
• Added enum ImmutabilityType
• Added model PostgreSqlFlexibleServerBackupDatasourceParameters
• Added model RecoveryPointImmutabilityProperties

2.2.0 (2026-09-04)

Features Added

• Model BackupVault added property cost_management_settings
• Model DeletedBackupVault added property cost_management_settings
• Model PatchBackupVaultInput added property cost_management_settings
• Added model CostManagementSettings
• Added model GenericBackupDatasourceParameters
• Added model GenericRestoreDatasourceCriteria
• Added enum GranularityLevel
• Added model ResourceListSelectionCriteria

2.1.0 (2026-07-29)

Features Added

• Client DataProtectionMgmtClient added operation group deleted_backup_vaults
• Added model AdlsBlobBackupDatasourceParametersForAutoProtection
• Added model BlobBackupAutoProtectionRule
• Added model BlobBackupAutoProtectionSettings
• Added model BlobBackupDatasourceParametersForAutoProtection
• Added enum BlobBackupPatternType
• Added model BlobBackupRuleBasedAutoProtectionSettings
• Added enum BlobBackupRuleMode
• Added model DeletedBackupVault
• Added model DeletedBackupVaultResource
• Added model ResourceDeletionInfo
• Operation group BackupVaultsOperations added parameter x_ms_deleted_vault_id in method begin_create_or_update
• Added operation group DeletedBackupVaultsOperations

2.1.0b1 (2026-04-07)

Features Added

• Client DataProtectionMgmtClient added operation group deleted_backup_vaults
• Added model AdlsBlobBackupDatasourceParametersForAutoProtection
• Added model BlobBackupAutoProtectionRule
• Added model BlobBackupAutoProtectionSettings
• Added model BlobBackupDatasourceParametersForAutoProtection
• Added enum BlobBackupPatternType
• Added model BlobBackupRuleBasedAutoProtectionSettings
• Added enum BlobBackupRuleMode
• Added model DeletedBackupVault
• Added model DeletedBackupVaultResource
• Added model ResourceDeletionInfo
• Operation group BackupVaultsOperations added parameter x_ms_deleted_vault_id in method begin_create_or_update
• Added operation group DeletedBackupVaultsOperations

2.0.1 (2025-10-09)

Bugs Fixed

• Exclude generated_samples and generated_tests from wheel

2.0.0 (2025-09-22)

Features Added

• Model DataProtectionMgmtClient added parameter cloud_setting in method __init__
• Client DataProtectionMgmtClient added method send_request
• Model DppBaseResource added property system_data
• Model ItemPathBasedRestoreCriteria added property rename_to
• Model KubernetesClusterBackupDatasourceParameters added property included_volume_types
• Added enum AKSVolumeTypes
• Added enum ActionType
• Added model AdlsBlobBackupDatasourceParameters
• Added model CloudError
• Added model Operation
• Added model OperationDisplay
• Added enum Origin
• Added model ProxyResource
• Added model Resource
• Added model TrackedResource
• Added model ValidateForModifyBackupRequest
• Model BackupInstancesOperations added method begin_validate_for_modify_backup

Breaking Changes

• This version introduces new hybrid models which have dual dictionary and model nature. And please follow https://aka.ms/azsdk/python/migrate/hybrid-models for migration.
• Deleted or renamed model AzureBackupFindRestorableTimeRangesRequestResource
• Deleted or renamed model AzureBackupJobResourceList
• Deleted or renamed model AzureBackupRecoveryPointResourceList
• Deleted or renamed model BackupInstanceResourceList
• Deleted or renamed model BackupVaultResourceList
• Deleted or renamed model BaseBackupPolicyResourceList
• Deleted or renamed model ClientDiscoveryDisplay
• Deleted or renamed model ClientDiscoveryForLogSpecification
• Deleted or renamed model ClientDiscoveryForProperties
• Deleted or renamed model ClientDiscoveryForServiceSpecification
• Deleted or renamed model ClientDiscoveryResponse
• Deleted or renamed model ClientDiscoveryValueForSingleApi
• Deleted or renamed model DeletedBackupInstanceResourceList
• Deleted or renamed model DppBaseResourceList
• Deleted or renamed model DppBaseTrackedResource
• Deleted or renamed model DppProxyResource
• Deleted or renamed model DppTrackedResource
• Deleted or renamed model DppWorkerRequest
• Deleted or renamed model RecoveryPointsFilters
• Deleted or renamed model ResourceGuardProxyBaseResourceList
• Deleted or renamed model ResourceGuardResourceList
• Method BackupInstancesOperations.begin_create_or_update changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupInstancesOperations.begin_delete changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupInstancesOperations.begin_stop_protection changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupInstancesOperations.begin_suspend_backups changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupInstancesOperations.begin_trigger_restore changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupVaultsOperations.begin_create_or_update changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method BackupVaultsOperations.begin_update changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method DppResourceGuardProxyOperations.unlock_delete changed its parameter x_ms_authorization_auxiliary from positional_or_keyword to keyword_only
• Method FetchSecondaryRecoveryPointsOperations.list changed its parameter skip_token from positional_or_keyword to keyword_only
• Method RecoveryPointsOperations.list changed its parameter skip_token from positional_or_keyword to keyword_only

1.4.0 (2024-07-22)

Features Added

• Added operation group BackupInstancesExtensionRoutingOperations
• Model AzureBackupRecoveryPointBasedRestoreRequest has a new parameter resource_guard_operation_requests
• Model AzureBackupRecoveryTimeBasedRestoreRequest has a new parameter resource_guard_operation_requests
• Model AzureBackupRestoreRequest has a new parameter resource_guard_operation_requests
• Model AzureBackupRestoreWithRehydrationRequest has a new parameter resource_guard_operation_requests
• Model BackupInstance has a new parameter resource_guard_operation_requests
• Model BackupVault has a new parameter bcdr_security_level
• Model BackupVault has a new parameter resource_guard_operation_requests
• Model DeletedBackupInstance has a new parameter resource_guard_operation_requests
• Model KubernetesClusterRestoreCriteria has a new parameter resource_modifier_reference
• Model KubernetesClusterVaultTierRestoreCriteria has a new parameter resource_modifier_reference
• Model PatchBackupVaultInput has a new parameter resource_guard_operation_requests
• Model SecuritySettings has a new parameter encryption_settings
• Operation BackupInstancesOperations.begin_create_or_update has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupInstancesOperations.begin_delete has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupInstancesOperations.begin_stop_protection has a new optional parameter parameters
• Operation BackupInstancesOperations.begin_stop_protection has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupInstancesOperations.begin_suspend_backups has a new optional parameter parameters
• Operation BackupInstancesOperations.begin_suspend_backups has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupInstancesOperations.begin_trigger_restore has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupVaultsOperations.begin_create_or_update has a new optional parameter x_ms_authorization_auxiliary
• Operation BackupVaultsOperations.begin_update has a new optional parameter x_ms_authorization_auxiliary
• Operation DppResourceGuardProxyOperations.unlock_delete has a new optional parameter x_ms_authorization_auxiliary

1.3.0 (2023-12-18)

Features Added

• Added operation BackupInstancesOperations.begin_trigger_cross_region_restore
• Added operation BackupInstancesOperations.begin_validate_cross_region_restore
• Added operation group FetchCrossRegionRestoreJobOperations
• Added operation group FetchCrossRegionRestoreJobsOperations
• Added operation group FetchSecondaryRecoveryPointsOperations
• Model AzureBackupDiscreteRecoveryPoint has a new parameter recovery_point_state
• Model BackupVault has a new parameter replicated_regions
• Model JobExtendedInfo has a new parameter warning_details

1.2.0 (2023-07-21)

Features Added

• Model AzureBackupJob has a new parameter rehydration_priority
• Model AzureBackupRecoveryPointBasedRestoreRequest has a new parameter identity_details
• Model AzureBackupRecoveryTimeBasedRestoreRequest has a new parameter identity_details
• Model AzureBackupRestoreRequest has a new parameter identity_details
• Model AzureBackupRestoreWithRehydrationRequest has a new parameter identity_details
• Model BackupInstance has a new parameter identity_details
• Model BackupVault has a new parameter secure_score
• Model Datasource has a new parameter resource_properties
• Model DatasourceSet has a new parameter resource_properties
• Model DeletedBackupInstance has a new parameter identity_details
• Model DppIdentityDetails has a new parameter user_assigned_identities
• Model FeatureSettings has a new parameter cross_region_restore_settings
• Model KubernetesClusterBackupDatasourceParameters has a new parameter backup_hook_references
• Model KubernetesClusterRestoreCriteria has a new parameter restore_hook_references

1.1.0 (2023-06-16)

Features Added

• Added operation group DppResourceGuardProxyOperations

1.0.0 (2023-02-15)

Features Added

• Model AzureBackupDiscreteRecoveryPoint has a new parameter expiry_time
• Model BackupVault has a new parameter feature_settings
• Model PatchBackupVaultInput has a new parameter feature_settings
• Model TargetDetails has a new parameter target_resource_arm_id

Breaking Changes

• Client name is changed from DataProtectionClient to DataProtectionMgmtClient
• Model ResourceGuardResource no longer has parameter identity
• Removed operation group BackupInstancesExtensionRoutingOperations
• Removed operation group DppResourceGuardProxyOperations
• Renamed operation BackupVaultsOperations.delete to BackupVaultsOperations.begin_delete

1.0.0b4 (2023-01-17)

Features Added

• Added operation group BackupInstancesExtensionRoutingOperations
• Added operation group DppResourceGuardProxyOperations
• Model PolicyParameters has a new parameter backup_datasource_parameters_list
• Model ResourceGuardResource has a new parameter identity

Breaking Changes

• Model AzureBackupDiscreteRecoveryPoint no longer has parameter expiry_time
• Model BackupVault no longer has parameter feature_settings
• Model PatchBackupVaultInput no longer has parameter feature_settings
• Model TargetDetails no longer has parameter target_resource_arm_id

1.0.0b3 (2022-12-29)

Features Added

• Model AzureBackupDiscreteRecoveryPoint has a new parameter expiry_time
• Model BackupVault has a new parameter feature_settings
• Model PatchBackupVaultInput has a new parameter feature_settings
• Model TargetDetails has a new parameter target_resource_arm_id

Breaking Changes

• Model ResourceGuardResource no longer has parameter identity
• Removed operation group BackupInstancesExtensionRoutingOperations
• Removed operation group DppResourceGuardProxyOperations

1.0.0b2 (2022-10-11)

Features Added

• Added operation BackupInstancesOperations.begin_resume_backups
• Added operation BackupInstancesOperations.begin_resume_protection
• Added operation BackupInstancesOperations.begin_stop_protection
• Added operation BackupInstancesOperations.begin_suspend_backups
• Added operation BackupInstancesOperations.begin_sync_backup_instance
• Added operation BackupInstancesOperations.get_backup_instance_operation_result
• Added operation group BackupInstancesExtensionRoutingOperations
• Added operation group DeletedBackupInstancesOperations
• Added operation group DppResourceGuardProxyOperations
• Added operation group OperationStatusBackupVaultContextOperations
• Added operation group OperationStatusResourceGroupContextOperations
• Model AzureBackupRecoveryPointBasedRestoreRequest has a new parameter source_resource_id
• Model AzureBackupRecoveryTimeBasedRestoreRequest has a new parameter source_resource_id
• Model AzureBackupRestoreRequest has a new parameter source_resource_id
• Model AzureBackupRestoreWithRehydrationRequest has a new parameter source_resource_id
• Model BackupInstance has a new parameter validation_type
• Model BackupInstanceResource has a new parameter tags
• Model BackupVault has a new parameter is_vault_protected_by_resource_guard
• Model BackupVault has a new parameter monitoring_settings
• Model BackupVault has a new parameter security_settings
• Model PatchResourceRequestInput has a new parameter properties
• Model SecretStoreResource has a new parameter value

1.0.0b1 (2021-10-19)

• Initial Release