Microsoft Azure SDK for Python

这是Microsoft Azure IoT Hub配置服务的客户端库。此包已在Python 2.7，3.6+上进行了测试。有关Azure库的更全面视图，请参阅azure sdk python发布。

免责声明

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

使用说明

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

有关文档和参考资料，请参阅Python SDK 参考资料。本包的代码示例可在 docs.microsoft.com 的IoT Hub 配置服务中找到。不同 Azure 服务的代码示例可在 样本存储库中找到。

提供反馈

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

发布历史

1.1.0 (2022-02-07)

功能

• 模型 CertificateResponse 添加了新参数 system_data
• 模型 IotDpsPropertiesDescription 添加了新参数 enable_data_residency
• 模型 PrivateEndpointConnection 添加了新参数 system_data
• 模型 ProvisioningServiceDescription 添加了新参数 system_data

1.0.0 (2021-08-18)

功能

• 模型 CertificateBodyDescription 添加了新参数 is_verified

1.0.0b1 (2021-05-14)

这是 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 的类型注解。SDK 已为 mypy 准备就绪。
• 此客户端现在具有稳定和官方的异步支持。检查您的包中的 aio 命名空间以找到异步客户端。
• 此客户端现在原生支持 OpenCensus 或 OpenTelemetry 等跟踪库。有关概述，请参阅此跟踪快速入门

0.2.0 (2018-04-17)

一般破坏性更改

此版本使用下一代代码生成器，可能会引入破坏性更改。

• 模型签名现在只使用关键字参数语法。所有位置参数都必须重写为关键字参数。为了在大多数情况下保持自动完成，模型现在为 Python 2 和 Python 3 生成。Python 3 使用 "*" 语法用于关键字仅参数。
• 枚举类型现在使用 "str" 混合（类 AzureEnum(str, Enum)）以改进遇到未识别枚举值时的行为。尽管这不是破坏性更改，但区别很重要，此处有文档：[https://docs.pythonlang.cn/3/library/enum.html#others](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 兼容性

功能

• 新增 ApiVersion 2018-01-22

0.1.0 (2018-01-04)

• 初始发布