Microsoft Azure SDK for Python

这是Microsoft Azure Storage Sync客户端库。

Azure资源管理器（ARM）是下一代管理API，用于替换旧版Azure服务管理（ASM）。

此软件包已与Python 2.7、3.5、3.6、3.7和3.8进行过测试。

有关旧版Azure服务管理（ASM）库，请参阅azure-servicemanagement-legacy库。

有关更完整的Azure库集，请参阅azure sdk python发布。

用法

要了解如何使用此包，请参阅快速入门指南

有关文档和参考，请参阅Python SDK 参考文档。此包的代码示例可在docs.microsoft.com上的存储同步管理找到。不同Azure服务的附加代码示例可在示例存储库找到。

提供反馈

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

发行历史

1.0.0 (2021-04-07)

• GA 版本

1.0.0b1 (2020-12-03)

这是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 初始化文档中的参数接受

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

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

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

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

  • raw 已删除。等效功能可以通过使用 cls 找到，这是一个回调，将提供给高级用户访问内部HTTP响应
  • 有关受支持选项的完整列表，请参阅azure-core 请求文档中的参数接受

一般新功能

• 支持使用 typing 的类型注解。SDKs 为 mypy 准备就绪。
• 此客户端现在提供稳定和官方的异步支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持像 OpenCensus 或 OpenTelemetry 这样的跟踪库。有关概述，请参阅此跟踪快速入门。

0.2.0 (2020-01-09)

功能

• 模型 ServerEndpoint 有了新的参数 recall_status
• 模型 ServerEndpoint 有了新的参数 cloud_tiering_status
• 模型 CloudEndpointCreateParameters 有了新的参数 friendly_name
• 添加了 CloudEndpointsOperations.trigger_change_detection 操作
• 添加了 OperationStatusOperations 操作组

一般破坏性变化

本版本使用了一款下一代代码生成器，如果从某些导入中引入，可能会引入破坏性更改。简而言之，一些模块的可见性/导入不正确，并已重命名。这解决了由于使用本来不应该使用的类引起的一些问题。现在无法从 azure.mgmt.storagesync.storage_sync_management_client 导入 StorageSyncManagementClient（从 azure.mgmt.storagesync 导入仍然像以前一样工作） StorageSyncManagementClientConfiguration 的导入已从 azure.mgmt.storagesync.storage_sync_management_client 移动到 azure.mgmt.storagesync。来自 "models" 子模块的模型 MyClass 现在无法使用 azure.mgmt.storagesync.models.my_class 进行导入（从 azure.mgmt.storagesync.models 导入仍然像以前一样工作） 操作类 MyClassOperations 来自操作子模块，现在无法使用 azure.mgmt.storagesync.operations.my_class_operations 进行导入（从 azure.mgmt.storagesync.operations 导入仍然像以前一样工作） 最后但同样重要的是，HTTP 连接池现在默认启用。您应始终将客户端用作上下文管理器，或调用 close()，或每个进程使用不超过一个客户端。

0.1.0 (2019-04-05)

• 初始发布