Microsoft Azure SDK for Python

这是 Microsoft Azure Notification Hubs 管理客户端库。此包已在 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上的Notification Hubs 管理部分找到。有关不同Azure服务的其他代码示例，请参阅示例存储库

提供反馈

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

发行历史

8.0.0 (2022-01-06)

重大更改

• NamespacesOperations中的list_keys返回类型已从SharedAccessAuthorizationRuleListResult更改为ResourceListKeys

7.0.0 (2020-12-22)

• GA版本

7.0.0b1 (2020-10-28)

这是测试预览版本。

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

一般性重大更改

• 凭证系统已完全重构成

  • 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属性不再存在，配置应作为关键字参数传递。例如：MyClient(credential, subscription_id, enable_logging=True)。有关受支持的选项的完整集合，请参阅azure-core初始化文档中的参数接受

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

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

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

• 大多数操作关键字参数都发生了变化。其中一些最显著的

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

一般性新功能

• 支持使用typing进行类型注解。SDK已准备就绪用于mypy。
• 此客户端现在稳定且官方支持异步操作。检查您的包中的aio命名空间以找到异步客户端。
• 此客户端现在原生支持类似OpenCensus或OpenTelemetry的跟踪库。有关概述，请参阅此跟踪快速入门

2.1.0 (2019-04-30)

功能

• 添加了操作NotificationHubsOperations.patch
• 添加了操作NotificationHubsOperations.debug_send

2.0.0 (2018-05-25)

功能

• 模型NamespaceResource有一个新的参数updated_at
• 模型NamespaceResource有一个新的参数metric_id
• 模型NamespaceResource有一个新的参数data_center
• 模型NamespaceCreateOrUpdateParameters有一个新的参数updated_at
• 模型NamespaceCreateOrUpdateParameters有一个新的参数metric_id
• 模型NamespaceCreateOrUpdateParameters有一个新的参数data_center
• 添加了操作NotificationHubsOperations.check_notification_hub_availability
• 添加了操作组Operations
• 客户端类可以用作上下文管理器，以保持底层HTTP会话打开以提高性能

重大更改

• 操作NotificationHubsOperations.create_or_update_authorization_rule有一个新的签名
• 操作NamespacesOperations.create_or_update_authorization_rule有一个新的签名
• 删除了操作 NotificationHubsOperations.check_availability（已由 NotificationHubsOperations.check_notification_hub_availability 替换）
• Model SharedAccessAuthorizationRuleResource 有新的签名
• Model SharedAccessAuthorizationRuleProperties 有新的签名
• Model SharedAccessAuthorizationRuleCreateOrUpdateParameters 有新的签名
• 删除了操作组 NameOperations（已由 NotificationHubsOperations.check_notification_hub_availability 替换）
• 删除了操作组 HubsOperations（已合并到 NotificationHubsOperations）

一般破坏性更改

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

• 模型签名现在只使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法进行关键字参数。
• 枚举类型现在使用 "str" 混合（class AzureEnum(str, Enum)）以改进遇到未识别枚举值时的行为。虽然这不是破坏性更改，但区别很重要，这里进行了说明：[Python 枚举文档](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 在轮询完成后调用时将不再引发异常，而是立即执行回调。

错误修复

• sdist 与 wheel 0.31.0 的兼容性

1.0.0 (2017-06-27)

• 新增 API 版本 2017-04-01
• 预期有破坏性更改，从不稳定客户端迁移

此 wheel 包是用 azure wheel 扩展构建的

0.30.0 (2016-10-05)

• 预览版。基于 API 版本 2016-03-01。