Microsoft Azure SDK for Python

这是Microsoft Azure Event Grid Management Client Library。此软件包已在Python 3.6+上进行测试。要查看Azure库的更完整视图，请参阅azure sdk python release。

免责声明

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

用法

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

有关文档和参考，请参阅Python SDK 参考文档。本包的代码示例可以在 docs.microsoft.com 上的事件网格管理部分找到。不同 Azure 服务的其他代码示例可在代码示例仓库中找到。

提供反馈

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

发行历史

10.2.0 (2022-06-20)

功能

• 添加了操作组 ChannelsOperations
• 添加了操作组 DomainEventSubscriptionsOperations
• 添加了操作组 DomainTopicEventSubscriptionsOperations
• 添加了操作组 PartnerConfigurationsOperations
• 添加了操作组 PartnerNamespacesOperations
• 添加了操作组 PartnerRegistrationsOperations
• 添加了操作组 PartnerTopicEventSubscriptionsOperations
• 添加了操作组 PartnerTopicsOperations
• 添加了操作组 TopicEventSubscriptionsOperations
• 添加了操作组 VerifiedPartnersOperations
• 模型 Domain 有一个新参数 data_residency_boundary
• 模型 DomainUpdateParameters 有一个新参数 data_residency_boundary
• 模型 Operation 有一个新参数 is_data_action
• 模型 Topic 有一个新参数 data_residency_boundary
• 模型 TopicUpdateParameters 有一个新参数 data_residency_boundary

10.2.0b2 (2022-05-30)

重大更改

• 操作 DomainEventSubscriptionsOperations.list 有一个新参数 filter
• 操作 DomainEventSubscriptionsOperations.list 有一个新参数 top
• 操作 DomainTopicEventSubscriptionsOperations.list 有一个新参数 filter
• 操作 DomainTopicEventSubscriptionsOperations.list 有一个新参数 top
• 操作 TopicEventSubscriptionsOperations.list 有一个新参数 filter
• 操作 TopicEventSubscriptionsOperations.list 有一个新参数 top

10.2.0b1 (2022-04-07)

功能

• 添加了操作组 ChannelsOperations
• 添加了操作组 DomainEventSubscriptionsOperations
• 添加了操作组 DomainTopicEventSubscriptionsOperations
• 添加了操作组 EventChannelsOperations
• 添加了操作组 PartnerConfigurationsOperations
• 添加了操作组 PartnerDestinationsOperations
• 添加了操作组 PartnerNamespacesOperations
• 添加了操作组 PartnerRegistrationsOperations
• 添加了操作组 PartnerTopicEventSubscriptionsOperations
• 添加了操作组 PartnerTopicsOperations
• 添加了操作组 TopicEventSubscriptionsOperations
• 添加了操作组 VerifiedPartnersOperations
• 模型 Domain 有一个新参数 data_residency_boundary
• 模型 Domain 有一个新参数 sku
• 模型 DomainUpdateParameters 有一个新参数 data_residency_boundary
• 模型 DomainUpdateParameters 有一个新参数 sku
• 模型 Operation 有一个新参数 is_data_action
• 模型 Topic 有一个新参数 data_residency_boundary
• 模型 Topic 有一个新参数 extended_location
• 模型 Topic 有一个新参数 kind
• 模型 Topic 有一个新参数 sku
• 模型 TopicUpdateParameters 有一个新参数 data_residency_boundary
• 模型 TopicUpdateParameters 有一个新参数 sku

10.1.0 (2021-12-13)

功能

• 添加了模型 NumberInRangeAdvancedFilter
• 添加了模型 StringNotContainsAdvancedFilter
• 添加了模型 NumberNotInRangeAdvancedFilter
• 添加了模型 IsNullOrUndefinedAdvancedFilter
• 添加了模型 IsNotNullAdvancedFilter
• 添加了模型 StringNotBeginsWithAdvancedFilter
• 添加了模型 StringNotEndsWithAdvancedFilter

10.0.0 (2021-10-21)

功能

• 模型 Domain 有一个新参数 disable_local_auth
• 模型 Domain 有一个新参数 auto_delete_topic_with_last_subscription
• 模型 Domain 有一个新参数 auto_create_topic_with_first_subscription
• 模型 Topic 有一个新参数 disable_local_auth
• 模型 DomainUpdateParameters 有一个新参数 disable_local_auth
• 模型 DomainUpdateParameters 有一个新参数 auto_delete_topic_with_last_subscription
• 模型 DomainUpdateParameters 有一个新参数 auto_create_topic_with_first_subscription
• 模型 ExtensionTopic 有一个新参数 system_data
• 模型 TopicUpdateParameters 有一个新参数 disable_local_auth

重大更改

• 模型 Domain 不再具有参数 sku
• 模型 Topic 不再具有参数 sku
• 模型 Topic 不再具有参数 extended_location
• 模型 Topic 不再具有参数 kind
• 模型 DomainUpdateParameters 不再具有参数 sku
• 模型 TopicUpdateParameters 不再具有参数 sku
• 移除了操作组 EventChannelsOperations
• 移除了操作组 PartnerRegistrationsOperations
• 移除了操作组 PartnerTopicEventSubscriptionsOperations
• 移除了操作组 PartnerNamespacesOperations
• 移除了操作组 PartnerTopicsOperations

9.0.0 (2021-05-24)

功能

• 模型 EventHubEventSubscriptionDestination 有一个新参数 delivery_attribute_mappings
• 模型 StorageQueueEventSubscriptionDestination 有一个新参数 queue_message_time_to_live_in_seconds
• 模型 TopicTypeInfo 有一个新参数 supported_scopes_for_source
• 模型 Topic 有一个新参数 extended_location
• 模型 Topic 有一个新参数 kind
• 模型 Topic 有一个新参数 system_data
• 模型 Topic 有一个新参数 identity
• 模型 Topic 有一个新参数 sku
• 模型 EventSubscriptionFilter 有一个新参数 enable_advanced_filtering_on_arrays
• 模型 AzureFunctionEventSubscriptionDestination 新增参数 delivery_attribute_mappings
• 模型 EventSubscriptionUpdateParameters 新增参数 dead_letter_with_resource_identity
• 模型 EventSubscriptionUpdateParameters 新增参数 delivery_with_resource_identity
• 模型 ServiceBusQueueEventSubscriptionDestination 新增参数 delivery_attribute_mappings
• 模型 DomainTopic 新增参数 system_data
• 模型 DomainUpdateParameters 有一个新参数 sku
• 模型 DomainUpdateParameters 新增参数 identity
• 模型 HybridConnectionEventSubscriptionDestination 新增参数 delivery_attribute_mappings
• 模型 TopicUpdateParameters 有一个新参数 sku
• 模型 TopicUpdateParameters 新增参数 identity
• 模型 ServiceBusTopicEventSubscriptionDestination 新增参数 delivery_attribute_mappings
• 模型 Domain 有一个新参数 sku
• 模型 Domain 新增参数 system_data
• 模型 Domain 新增参数 identity
• 模型 EventSubscription 新增参数 dead_letter_with_resource_identity
• 模型 EventSubscription 新增参数 system_data
• 模型 EventSubscription 新增参数 delivery_with_resource_identity
• 模型 WebHookEventSubscriptionDestination 新增参数 delivery_attribute_mappings
• 添加操作 TopicsOperations.begin_regenerate_key
• 添加操作 EventSubscriptionsOperations.get_delivery_attributes
• 添加了操作组 PartnerRegistrationsOperations
• 添加操作组 SystemTopicsOperations
• 添加了操作组 EventChannelsOperations
• 添加了操作组 PartnerNamespacesOperations
• 添加操作组 ExtensionTopicsOperations
• 添加了操作组 PartnerTopicsOperations
• 添加了操作组 PartnerTopicEventSubscriptionsOperations
• 添加操作组 SystemTopicEventSubscriptionsOperations

重大更改

• 移除操作 TopicsOperations.regenerate_key

8.0.0 (2020-12-21)

重大更改

• 操作 TopicsOperations.regenerate_key 具有新的签名
• 操作 DomainsOperations.regenerate_key 具有新的签名

8.0.0b1 (2020-10-31)

这是测试预览版本。有关详细变更日志，请参阅等效的稳定版本 3.0.0rc8（https://pypi.ac.cn/project/azure-mgmt-eventgrid/3.0.0rc8/）

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

一般破坏性变化

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

  • azure.common.credentials 或 msrestazure.azure_active_directory 实例不再受支持，请使用 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 这样的跟踪库。请参阅此跟踪快速入门以获取概述。

3.0.0rc8 (2020-06-05)

重大更改

• 模型 EventSubscriptionUpdateParameters 不再具有参数 dead_letter_with_resource_identity
• 模型 EventSubscriptionUpdateParameters 不再具有参数 delivery_with_resource_identity
• 模型 DomainUpdateParameters 不再具有参数 sku
• 模型 DomainUpdateParameters 不再具有参数 identity
• 模型 Domain 不再具有参数 sku
• 模型 Domain 不再具有参数 identity
• 模型 EventSubscription 不再具有参数 dead_letter_with_resource_identity
• 模型 EventSubscription 不再具有参数 delivery_with_resource_identity
• 模型 TopicUpdateParameters 不再具有参数 sku
• 模型TopicUpdateParameters不再具有参数identity
• 模型 Topic 不再具有参数 sku
• 模型Topic不再具有参数identity
• 移除了操作组ExtensionTopicsOperations
• 移除了操作组 PartnerNamespacesOperations
• 移除了操作组 PartnerRegistrationsOperations
• 移除了操作组 PartnerTopicsOperations
• 移除了操作组SystemTopicEventSubscriptionsOperations
• 移除了操作组SystemTopicsOperations
• 移除了操作组 PartnerTopicEventSubscriptionsOperations
• 移除了操作组 EventChannelsOperations

3.0.0rc7（2020-05-14）

功能

• 模型PartnerTopic新增参数expiration_time_if_not_activated_utc
• 模型PartnerTopic新增参数partner_topic_friendly_description
• 模型EventChannel新增参数partner_topic_readiness_state
• 模型EventChannel新增参数expiration_time_if_not_activated_utc
• 模型EventChannel新增参数partner_topic_friendly_description
• 模型PartnerRegistration新增参数partner_customer_service_number
• 模型PartnerRegistration新增参数partner_customer_service_extension
• 模型PartnerRegistration新增参数long_description
• 模型PartnerRegistration新增参数customer_service_uri

重大更改

• 模型EventChannelFilter新增签名

3.0.0rc6（2020-04-03）

功能

• 模型PartnerRegistrationUpdateParameters新增参数tags
• 模型EventChannel新增参数filter

重大更改

• 操作PrivateEndpointConnectionsOperations.update新增签名
• 操作SystemTopicEventSubscriptionsOperations.list_by_system_topic新增签名
• 操作PartnerTopicEventSubscriptionsOperations.list_by_partner_topic新增签名

3.0.0rc5（2020-03-19）

功能

• 模型Domain新增参数public_network_access
• 模型 Domain 新增参数 identity
• 模型Domain新增参数private_endpoint_connections
• 模型 Domain 有一个新参数 sku
• 模型DomainUpdateParameters新增参数public_network_access
• 模型 DomainUpdateParameters 新增参数 identity
• 模型 DomainUpdateParameters 有一个新参数 sku
• 模型TopicUpdateParameters新增参数public_network_access
• 模型 TopicUpdateParameters 新增参数 identity
• 模型 TopicUpdateParameters 有一个新参数 sku
• 模型 EventSubscriptionUpdateParameters 新增参数 dead_letter_with_resource_identity
• 模型 EventSubscriptionUpdateParameters 新增参数 delivery_with_resource_identity
• 模型Topic新增参数public_network_access
• 模型 Topic 有一个新参数 identity
• 模型Topic新增参数private_endpoint_connections
• 模型 Topic 有一个新参数 sku
• 模型 EventSubscription 新增参数 dead_letter_with_resource_identity
• 模型 EventSubscription 新增参数 delivery_with_resource_identity
• 新增操作组PrivateLinkResourcesOperations
• 添加操作组 SystemTopicsOperations
• 新增操作组PrivateEndpointConnectionsOperations
• 添加了操作组 PartnerTopicsOperations
• 添加了操作组 PartnerNamespacesOperations
• 添加了操作组 PartnerTopicEventSubscriptionsOperations
• 添加了操作组 PartnerRegistrationsOperations
• 添加操作组 ExtensionTopicsOperations
• 添加操作组 SystemTopicEventSubscriptionsOperations
• 添加了操作组 EventChannelsOperations

重大更改

• 模型Domain不再具有参数allow_traffic_from_all_ips
• 模型DomainUpdateParameters不再具有参数allow_traffic_from_all_ips
• 模型TopicUpdateParameters不再具有参数allow_traffic_from_all_ips
• 模型Topic不再具有参数allow_traffic_from_all_ips

3.0.0rc4（2020-01-17）

功能

• 模型DomainUpdateParameters新增参数allow_traffic_from_all_ips
• 模型DomainUpdateParameters新增参数inbound_ip_rules
• 模型TopicUpdateParameters新增参数allow_traffic_from_all_ips
• 模型TopicUpdateParameters新增参数inbound_ip_rules

重大更改

• 操作DomainsOperations.update新增签名
• 操作TopicsOperations.update新增签名

3.0.0rc3（2020-01-12）

功能

• 模型Domain新增参数allow_traffic_from_all_ips
• 模型Domain新增参数inbound_ip_rules
• 模型Topic新增参数allow_traffic_from_all_ips
• 模型Topic新增参数inbound_ip_rules
• 模型TopicTypeInfo新增参数source_resource_format

3.0.0rc2（2019-11-11）

功能

• 模型WebHookEventSubscriptionDestination新增参数azure_active_directory_tenant_id

3.0.0rc1（2019-10-24）

功能

• 模型Domain新增参数input_schema
• 模型Domain新增参数input_schema_mapping
• 模型Domain新增参数metric_resource_id
• 模型EventSubscription新增参数event_delivery_schema
• 模型Topic新增参数input_schema
• 模型Topic新增参数input_schema_mapping
• 模型Topic新增参数metric_resource_id
• 模型WebHookEventSubscriptionDestination新增参数preferred_batch_size_in_kilobytes
• 模型WebHookEventSubscriptionDestination新增参数azure_active_directory_application_id_or_uri
• 模型WebHookEventSubscriptionDestination新增参数max_events_per_batch
• 模型EventSubscriptionUpdateParameters新增参数event_delivery_schema

通用重大变更

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

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

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

2.1.0 (2019-05-22)

2.1.0rc1 版本中的所有预览功能在此 2.1.0 稳定版本中并未全部确认。特别是，以下功能现在仍然仅在 2.1.0rc1 中可用

• 输入映射/交付架构。
• 所有操作中的 "label" 过滤参数。

所有其他功能现在被认为是稳定的生产可用。这包括

• 域名，包括添加/删除域名主题的所有相关操作。
• 分页/过滤。
• 服务总线队列作为目标。
• 高级过滤，这是在先前的预览版本中引入的。
• 显示和选择默认事件类型而不是 'all'。

2.1.0rc1（2019-03-11）

免责声明

仅存在于 2.0.0rc2 且不存在于 2.0.0 的预览功能已移植到此版本。

此版本还添加了以下预览功能：- 手动添加/删除域名主题。- 列表操作的分页/搜索过滤。- 将服务总线队列添加为目标。

2.0.0 (2019-02-01)

免责声明

2.0.0rc2 版本中的所有预览功能在此 2.0.0 稳定版本中并未全部确认。特别是，以下功能现在仍然仅在 2.0.0rc2 中可用

• 域名。
• 高级过滤支持。
• 事件订阅过期日期。
• 输入映射和事件交付架构。

所有其他功能现在被认为是稳定的生产可用。这包括

• 死信目标。
• 存储队列作为目标。
• 混合连接作为目标。
• 重试策略。
• 手动握手。

2.0.0rc2（2018-10-24）

功能

• 模型 EventSubscriptionFilter 有一个新参数 advanced_filters
• 模型 EventSubscriptionUpdateParameters 有一个新参数 expiration_time_utc
• 模型 EventSubscription 有一个新参数 expiration_time_utc
• 添加了操作 EventSubscriptionsOperations.list_by_domain_topic
• 添加了操作组 DomainTopicsOperations
• 添加了操作组 DomainsOperations

内部 API 版本是 2018-09-15-preview

2.0.0rc1（2018-05-04）

功能

• 主题的输入映射
• 主题的 CloudEvents 支持
• 可自定义的交付架构
• 将事件发送到 Azure 存储队列和 Azure 混合连接
• 死信处理
• 重试策略
• 手动订阅验证握手验证。

内部 API 版本是 2018-05-01-preview

1.0.0 (2018-04-26)

一般重大变更

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

• 模型签名现在仅使用关键字参数语法。所有位置参数必须重写为关键字参数。为了在大多数情况下保持自动完成，现在为 Python 2 和 Python 3 生成模型。Python 3 使用 "*" 语法进行关键字-only 参数。
• 枚举类型现在使用 "str" 混合（类 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 将不再引发异常，而是立即执行回调。

功能

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

0.4.0 (2018-01-16)

重大更改

• EventSubscription 创建已重命名为 create_or_update。
• 基于 2018-01-01 API 版本重新生成的 SDK。
• 删除了 OperationOrigin 枚举。操作源现在是一个字符串。

0.3.0 (2017-11-02)

功能

• 支持更新主题属性。

0.2.0 (2017-09-13)

重大更改

• 使用 WebHookEventSubscriptionDestination 用于 webhook 端点 URL。
• 基于 2017-09-15-preview 版本重新生成。

0.1.1 (2017-08-17)

错误修复

• 修复了一些删除调用中的意外异常。

0.1.0 (2017-08-17)

• 首次发布