Microsoft Azure SDK for Python

这是Microsoft Azure Recovery Services客户端库。此包已与Python 3.8+进行测试。有关Azure库的更完整视图，请参阅azure sdk python发行。

免责声明

Azure SDK Python对Python 2.7的支持已于2022年1月1日结束。有关更多信息和建议，请参阅https://github.com/Azure/azure-sdk-for-python/issues/20691

入门

先决条件

• 使用此包需要Python 3.8+。
• Azure订阅

安装包

pip install azure-mgmt-recoveryservices
pip install azure-identity

身份验证

默认情况下，Azure Active Directory 令牌认证依赖于以下环境变量的正确配置。

• AZURE_CLIENT_ID 用于 Azure 客户端 ID。
• AZURE_TENANT_ID 用于 Azure 租户 ID。
• AZURE_CLIENT_SECRET 用于 Azure 客户端密钥。

此外，可以通过环境变量 AZURE_SUBSCRIPTION_ID 配置 Azure 订阅 ID。

配置以上后，可以通过以下代码进行客户端认证

from azure.identity import DefaultAzureCredential
from azure.mgmt.recoveryservices import RecoveryServicesClient
import os

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

示例

此包的代码示例可在

• 在 docs.microsoft.com 上搜索恢复服务
• Azure Python Mgmt SDK 示例存储库

故障排除

下一步

提供反馈

如果您遇到任何错误或建议，请在此项目的 问题 部分提交问题。

发布历史

3.0.0 (2024-04-22)

新增功能

• Model AzureMonitorAlertSettings 新增参数 alerts_for_all_failover_issues
• Model AzureMonitorAlertSettings 新增参数 alerts_for_all_replication_issues
• Model ClassicAlertSettings 新增参数 email_notifications_for_site_recovery
• Model SoftDeleteSettings 新增参数 enhanced_security_state
• Model VaultProperties 新增参数 bcdr_security_level
• Model VaultProperties 新增参数 resource_guard_operation_requests
• 操作 VaultsOperations.begin_create_or_update 新增可选参数 x_ms_authorization_auxiliary
• 操作 VaultsOperations.begin_update 新增可选参数 x_ms_authorization_auxiliary

破坏性变更

• 将操作 VaultsOperations.delete 重命名为 VaultsOperations.begin_delete

2.5.0 (2023-09-05)

新增功能

• Model SecuritySettings 新增参数 multi_user_authorization
• Model SecuritySettings 新增参数 soft_delete_settings
• Model VaultProperties 新增参数 secure_score

2.4.0 (2023-05-20)

新增功能

• Model VaultProperties 新增参数 restore_settings

2.3.0 (2023-02-15)

其他变更

• 将 api-version 升级到 2023-01-01

2.2.0 (2022-11-30)

新增功能

• 添加操作 RecoveryServicesOperations.capabilities
• Model PrivateEndpointConnection 新增参数 group_ids
• Model VaultProperties 新增参数 public_network_access
• Model VaultProperties 新增参数 security_settings

2.1.0 (2022-07-28)

功能

• Model PrivateEndpointConnectionVaultProperties 新增参数 location
• Model PrivateEndpointConnectionVaultProperties 新增参数 name
• Model PrivateEndpointConnectionVaultProperties 新增参数 type
• Model ResourceCertificateAndAadDetails 新增参数 aad_audience
• Model Sku 新增参数 capacity
• Model Sku 新增参数 family
• Model Sku 新增参数 size
• Model VaultProperties 新增参数 backup_storage_version
• Model VaultProperties 新增参数 monitoring_settings
• Model VaultProperties 新增参数 move_details
• Model VaultProperties 新增参数 move_state
• Model VaultProperties 新增参数 redundancy_settings

2.0.0 (2021-07-12)

功能

• Model PatchTrackedResource 新增参数 etag
• Model Resource 新增参数 etag
• Model VaultProperties 新增参数 encryption
• Model PatchVault 新增参数 etag
• Model Sku 新增参数 tier
• Model VaultExtendedInfoResource 新增参数 etag
• Model ResourceCertificateAndAadDetails 新增参数 service_resource_id
• Model Vault 新增参数 system_data
• Model Vault 新增参数 etag
• Model IdentityData 新增参数 user_assigned_identities
• Model TrackedResource 新增参数 etag
• 添加操作 VaultsOperations.begin_update
• 添加操作 VaultsOperations.begin_create_or_update
• 添加操作组 RecoveryServicesClientOperationsMixin

破坏性变更

• Model PatchTrackedResource 不再具有参数 e_tag
• Model Resource 不再具有参数 e_tag
• Model PatchVault 不再具有参数 e_tag
• Model VaultExtendedInfoResource 不再具有参数 e_tag
• 模型保险库不再具有参数 e_tag
• 模型跟踪资源不再具有参数 e_tag
• 已移除操作 VaultsOperations.create_or_update
• 已移除操作 VaultsOperations.update

1.0.0 (2020-12-17)

功能

• 模型 PatchVault 新增参数 identity

1.0.0b1 (2020-11-10)

这是beta预览版本。

此版本使用下一代代码生成器，它引入了重要的破坏性更改，但也引入了重要的新功能（如统一身份验证和异步编程）。

一般破坏性更改

• 凭证系统已被完全重构成

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 azure-identity 类：[https://pypi.ac.cn/project/azure-identity/](https://pypi.ac.cn/project/azure-identity/)
  • credentials 参数已重命名为 credential

• 客户端上不再存在 config 属性，配置应作为 kwarg 传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关支持选项的完整列表，请参阅[azure-core 初始化文档中接受的参数](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

• 不再可以导入 version 模块，请使用 __version__ 代替

• 曾经返回 msrest.polling.LROPoller 的操作现在返回 azure.core.polling.LROPoller，并以 begin_ 前缀。

• 异常树已简化，大多数异常现在是 azure.core.exceptions.HttpResponseError（已删除 CloudError）。

• 大多数操作 kwarg 都已更改。其中一些最显著的

  • raw 已被移除。等效功能可以通过使用 cls 找到，这是一个回调，将提供对内部 HTTP 响应的访问权限，适用于高级用户
  • 有关支持选项的完整列表，请参阅[azure-core 请求文档中接受的参数](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/core/azure-core/CLIENT_LIBRARY_DEVELOPER.md#available-policies)

一般新功能

• 支持使用 typing 进行类型注解。SDKs 已准备好进行 mypy。
• 此客户端现在对异步支持稳定且官方。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。查看此[跟踪快速入门](https://github.com/Azure/azure-sdk-for-python/tree/main/sdk/core/azure-core-tracing-opentelemetry)以获取概述。

0.5.0 (2020-04-21)

功能

• 模型 Vault 新增参数 identity
• 模型 VaultProperties 新增参数 private_endpoint_state_for_backup
• 模型 VaultProperties 新增参数 private_endpoint_connections
• 模型 VaultProperties 新增参数 private_endpoint_state_for_site_recovery
• 添加了操作组 PrivateLinkResourcesOperations

一般破坏性更改

此版本使用下一代代码生成器，它可能会引入破坏性更改。总之，一些模块被错误地可见/可导入，并且已被重命名。这解决了由于使用本不应使用的类而引起的一些问题。

• 无法从 azure.mgmt.recoveryservices.cost_management_client 导入 RecoveryServicesClient（从 azure.mgmt.recoveryservices 的导入与之前相同）
• RecoveryServicesClientConfiguration 的导入已从 azure.mgmt.recoveryservices.cost_management_client 移动到 azure.mgmt.recoveryservices
• 无法使用 azure.mgmt.recoveryservices.models.my_class 从 "models" 子模块导入模型 MyClass（从 azure.mgmt.recoveryservices.models 的导入与之前相同）
• 无法使用 azure.mgmt.recoveryservices.operations.my_class_operations 从 operations 子模块导入操作类 MyClassOperations（从 azure.mgmt.recoveryservices.operations 的导入与之前相同）

最后但并非最不重要的是，HTTP 连接池现在默认启用。您应始终将客户端用作上下文管理器，或调用 close()，或每个进程使用不超过一个客户端。

0.4.0 (2019-04-05)

功能

• 添加了操作 recovery_services.check_name_availability

0.3.0 (2018-05-25)

破坏性变更

• 已移除操作组 BackupVaultConfigsOperations（已移动到 azure-mgmt-recoveryservicesbackup）
• 已移除操作组 BackupStorageConfigsOperations（已移动到 azure-mgmt-recoveryservicesbackup）

功能

• 客户端类可以用作上下文管理器，以保持底层 HTTP 会话打开以提高性能

一般重大变更

此版本使用下一代代码生成器，可能会引入重大变更。

• 模型签名现在只使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，模型现在为 Python 2 和 Python 3 生成。Python 3 使用 "*" 语法进行关键字参数。
• 枚举类型现在使用 "str" 混合（class AzureEnum(str, Enum)）来改进遇到未知枚举值时的行为。虽然这不是重大变更，但区分很重要，并在此处记录：https://docs.pythonlang.cn/3/library/enum.html#others 简要概述
  • 应完全避免使用 "is"。
  • "format" 将返回字符串值，其中 "%s" 字符串格式化将返回 NameOfEnum.stringvalue。应首选格式化语法。
• 新的长时间运行操作
  • 返回类型从 msrestazure.azure_operation.AzureOperationPoller 更改为 msrest.polling.LROPoller。外部 API 保持不变。
  • 返回类型现在始终为 msrest.polling.LROPoller，无论使用哪些可选参数。
  • 使用 raw=True 时的行为已更改。现在不再直接返回初始调用结果作为 ClientRawResponse，而是返回 LROPoller，无需轮询。轮询后，最终资源将作为 ClientRawResponse 返回。
  • 新的 polling 参数。默认行为是 Polling=True，将使用 ARM 算法进行轮询。当 Polling=False 时，将返回初始调用的响应，而不进行轮询。
  • polling 参数接受 msrest.polling.PollingMethod 子类的实例。
  • add_done_callback 在轮询完成后调用时将不再引发异常，而是立即执行回调。

错误修复

• 与 wheel 0.31.0 的 sdist 兼容性

0.2.0 (2017-10-16)

错误修复

• blob_duration 现在是 str（从 iso-8601）
• "service_specification" 已重命名为 "properties.service_specification"
• 修复操作列表

0.1.1 (2019-03-12)

• 更新 msrestazure 包的可接受版本，以解决 Azure/azure-cli#6973。

0.1.0 (2017-07-20)

• 初始发布