azure-mgmt-dataprotection 2.0.1
Microsoft Azure Dataprotection Management Client Library for Python
Requires Python: >=3.9
Keywords: azure, azure sdk

# Microsoft Azure SDK for Python

This is the Microsoft Azure Data Protection Management Client Library.
This package has been tested with Python 3.9+.
For a more complete view of Azure libraries, see the [azure sdk python release](https://aka.ms/azsdk/python/all).

## _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.9+ is required to use this package.
- [Azure subscription](https://azure.microsoft.com/free/)

### Install the package

```bash
pip install azure-mgmt-dataprotection
pip install azure-identity
```

### Authentication

By default, [Azure Active Directory](https://aka.ms/awps/aad) 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:

```python
from azure.identity import DefaultAzureCredential
from azure.mgmt.dataprotection import DataProtectionClient
import os

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

## Examples

Code samples for this package can be found at:
- [Search Data Protection Management](https://docs.microsoft.com/samples/browse/?languages=python&term=Getting%20started%20-%20Managing&terms=Getting%20started%20-%20Managing) on docs.microsoft.com
- [Azure Python Mgmt SDK Samples Repo](https://aka.ms/azsdk/python/mgmt/samples)


## Troubleshooting

## Next steps

## Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the
[Issues](https://github.com/Azure/azure-sdk-for-python/issues)
section of the project. 

# Release History

## 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