Package: azure-mgmt-recoveryservices
Microsoft Azure SDK for PythonThis is the Microsoft Azure Recovery Services Client Library.
This package has been tested with Python 3.7+.
For a more complete view of Azure libraries, see theazure sdk python release.DisclaimerAzure SDK Python packages support for Python 2.7 has ended 01 January 2022. For more information and questions, please refer tohttps://github.com/Azure/azure-sdk-for-python/issues/20691Getting startedPrerequisitesPython 3.7+ is required to use this package.Azure subscriptionInstall the packagepipinstallazure-mgmt-recoveryservices
pipinstallazure-identityAuthenticationBy default,Azure Active Directorytoken authentication depends on correct configure of following environment variables.AZURE_CLIENT_IDfor Azure client ID.AZURE_TENANT_IDfor Azure tenant ID.AZURE_CLIENT_SECRETfor Azure client secret.In addition, Azure subscription ID can be configured via environment variableAZURE_SUBSCRIPTION_ID.With above configuration, client can be authenticated by following code:fromazure.identityimportDefaultAzureCredentialfromazure.mgmt.recoveryservicesimportRecoveryServicesClientimportossub_id=os.getenv("AZURE_SUBSCRIPTION_ID")client=RecoveryServicesClient(credential=DefaultAzureCredential(),subscription_id=sub_id)ExamplesCode samples for this package can be found at:Search Recovery Serviceson docs.microsoft.comAzure Python Mgmt SDK Samples RepoTroubleshootingNext stepsProvide FeedbackIf you encounter any bugs or have suggestions, please file an issue in theIssuessection of the project.Release History2.5.0 (2023-09-05)Features AddedModel SecuritySettings has a new parameter multi_user_authorizationModel SecuritySettings has a new parameter soft_delete_settingsModel VaultProperties has a new parameter secure_score2.4.0 (2023-05-20)Features AddedModel VaultProperties has a new parameter restore_settings2.3.0 (2023-02-15)Other ChangesUpgraded api-version to2023-01-012.2.0 (2022-11-30)Features AddedAdded operation RecoveryServicesOperations.capabilitiesModel PrivateEndpointConnection has a new parameter group_idsModel VaultProperties has a new parameter public_network_accessModel VaultProperties has a new parameter security_settings2.1.0 (2022-07-28)FeaturesModel PrivateEndpointConnectionVaultProperties has a new parameter locationModel PrivateEndpointConnectionVaultProperties has a new parameter nameModel PrivateEndpointConnectionVaultProperties has a new parameter typeModel ResourceCertificateAndAadDetails has a new parameter aad_audienceModel Sku has a new parameter capacityModel Sku has a new parameter familyModel Sku has a new parameter sizeModel VaultProperties has a new parameter backup_storage_versionModel VaultProperties has a new parameter monitoring_settingsModel VaultProperties has a new parameter move_detailsModel VaultProperties has a new parameter move_stateModel VaultProperties has a new parameter redundancy_settings2.0.0 (2021-07-12)FeaturesModel PatchTrackedResource has a new parameter etagModel Resource has a new parameter etagModel VaultProperties has a new parameter encryptionModel PatchVault has a new parameter etagModel Sku has a new parameter tierModel VaultExtendedInfoResource has a new parameter etagModel ResourceCertificateAndAadDetails has a new parameter service_resource_idModel Vault has a new parameter system_dataModel Vault has a new parameter etagModel IdentityData has a new parameter user_assigned_identitiesModel TrackedResource has a new parameter etagAdded operation VaultsOperations.begin_updateAdded operation VaultsOperations.begin_create_or_updateAdded operation group RecoveryServicesClientOperationsMixinBreaking changesModel PatchTrackedResource no longer has parameter e_tagModel Resource no longer has parameter e_tagModel PatchVault no longer has parameter e_tagModel VaultExtendedInfoResource no longer has parameter e_tagModel Vault no longer has parameter e_tagModel TrackedResource no longer has parameter e_tagRemoved operation VaultsOperations.create_or_updateRemoved operation VaultsOperations.update1.0.0 (2020-12-17)FeaturesModel PatchVault has a new parameter identity1.0.0b1 (2020-11-10)This is beta preview version.This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).General breaking changesCredential system has been completly revamped:azure.common.credentialsormsrestazure.azure_active_directoryinstances are no longer supported, use theazure-identityclasses instead:https://pypi.org/project/azure-identity/credentialsparameter has been renamedcredentialTheconfigattribute no longer exists on a client, configuration should be passed as kwarg. Example:MyClient(credential, subscription_id, enable_logging=True). For a complete set of
supported options, see theparameters accept in init documentation of azure-coreYou can't import aversionmodule anymore, use__version__insteadOperations that used to return amsrest.polling.LROPollernow returns aazure.core.polling.LROPollerand are prefixed withbegin_.Exceptions tree have been simplified and most exceptions are nowazure.core.exceptions.HttpResponseError(CloudErrorhas been removed).Most of the operation kwarg have changed. Some of the most noticeable:rawhas been removed. Equivalent feature can be found usingcls, a callback that will give access to internal HTTP response for advanced userFor a complete set of
supported options, see theparameters accept in Request documentation of azure-coreGeneral new featuresType annotations support usingtyping. SDKs are mypy ready.This client has now stable and official support for async. Check theaionamespace of your package to find the async client.This client now support natively tracing library like OpenCensus or OpenTelemetry. See thistracing quickstartfor an overview.0.5.0 (2020-04-21)FeaturesModel Vault has a new parameter identityModel VaultProperties has a new parameter private_endpoint_state_for_backupModel VaultProperties has a new parameter private_endpoint_connectionsModel VaultProperties has a new parameter private_endpoint_state_for_site_recoveryAdded operation group PrivateLinkResourcesOperationsGeneral Breaking ChangesThis version uses a next-generation code generator thatmightintroduce breaking changes. In summary, some modules were incorrectly
visible/importable and have been renamed. This fixed several issues
caused by usage of classes that were not supposed to be used in the
first place.RecoveryServicesClient cannot be imported fromazure.mgmt.recoveryservices.cost_management_clientanymore (import fromazure.mgmt.recoveryservicesworks like before)RecoveryServicesClientConfiguration import has been moved fromazure.mgmt.recoveryservices.cost_management_clienttoazure.mgmt.recoveryservicesA modelMyClassfrom a "models" sub-module cannot be imported
anymore usingazure.mgmt.recoveryservices.models.my_class(import fromazure.mgmt.recoveryservices.modelsworks like before)An operation classMyClassOperationsfrom anoperationssub-module cannot be imported anymore usingazure.mgmt.recoveryservices.operations.my_class_operations(import fromazure.mgmt.recoveryservices.operationsworks like before)Last but not least, HTTP connection pooling is now enabled by default.
You should always use a client as a context manager, or call close(), or
use no more than one client per process.0.4.0 (2019-04-05)FeaturesAdded operation recovery_services.check_name_availability0.3.0 (2018-05-25)Breaking ChangesRemoved operation group BackupVaultConfigsOperations (moved to
azure-mgmt-recoveryservicesbackup)Removed operation group BackupStorageConfigsOperations (moved to
azure-mgmt-recoveryservicesbackup)FeaturesClient class can be used as a context manager to keep the underlying
HTTP session open for performanceGeneral Breaking changesThis version uses a next-generation code generator thatmightintroduce breaking changes.Model signatures now use only keyword-argument syntax. All
positional arguments must be re-written as keyword-arguments. To
keep auto-completion in most cases, models are now generated for
Python 2 and Python 3. Python 3 uses the "*" syntax for
keyword-only arguments.Enum types now use the "str" mixin (class AzureEnum(str, Enum)) to
improve the behavior when unrecognized enum values are encountered.
While this is not a breaking change, the distinctions are important,
and are documented here:https://docs.python.org/3/library/enum.html#othersAt a glance:"is" should not be used at all."format" will return the string value, where "%s" string
formatting will returnNameOfEnum.stringvalue. Format syntax
should be prefered.New Long Running Operation:Return type changes frommsrestazure.azure_operation.AzureOperationPollertomsrest.polling.LROPoller. External API is the same.Return type is nowalwaysamsrest.polling.LROPoller,
regardless of the optional parameters used.The behavior has changed when usingraw=True. Instead of
returning the initial call result asClientRawResponse,
without polling, now this returns an LROPoller. After polling,
the final resource will be returned as aClientRawResponse.Newpollingparameter. The default behavior isPolling=Truewhich will poll using ARM algorithm. WhenPolling=False, the response of the initial call will be
returned without polling.pollingparameter accepts instances of subclasses ofmsrest.polling.PollingMethod.add_done_callbackwill no longer raise if called after
polling is finished, but will instead execute the callback right
away.BugfixesCompatibility of the sdist with wheel 0.31.00.2.0 (2017-10-16)Bugfixesblob_duration is now a str (from iso-8601)"service_specification" is renamed
"properties.service_specification"Fix operations list0.1.1 (2019-03-12)Updating permissible versions of the msrestazure package to unblockAzure/azure-cli#6973.0.1.0 (2017-07-20)Initial Release