Microsoft Azure SDK for Python

This is the Microsoft Azure EventGrid Management Client Library. This package has been tested with Python 2.7, 3.5, 3.6, 3.7 and 3.8. For a more complete view of Azure libraries, see the azure sdk python release.

Usage

To learn how to use this package, see the quickstart guide

For docs and references, see Python SDK References Code samples for this package can be found at EventGrid Management on docs.microsoft.com. Additional code samples for different Azure services are available at Samples Repo

Provide Feedback

If you encounter any bugs or have suggestions, please file an issue in the Issues section of the project.

Release History

9.0.0 (2021-05-24)

Features

• Model EventHubEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Model StorageQueueEventSubscriptionDestination has a new parameter queue_message_time_to_live_in_seconds
• Model TopicTypeInfo has a new parameter supported_scopes_for_source
• Model Topic has a new parameter extended_location
• Model Topic has a new parameter kind
• Model Topic has a new parameter system_data
• Model Topic has a new parameter identity
• Model Topic has a new parameter sku
• Model EventSubscriptionFilter has a new parameter enable_advanced_filtering_on_arrays
• Model AzureFunctionEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Model EventSubscriptionUpdateParameters has a new parameter dead_letter_with_resource_identity
• Model EventSubscriptionUpdateParameters has a new parameter delivery_with_resource_identity
• Model ServiceBusQueueEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Model DomainTopic has a new parameter system_data
• Model DomainUpdateParameters has a new parameter sku
• Model DomainUpdateParameters has a new parameter identity
• Model HybridConnectionEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Model TopicUpdateParameters has a new parameter sku
• Model TopicUpdateParameters has a new parameter identity
• Model ServiceBusTopicEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Model Domain has a new parameter sku
• Model Domain has a new parameter system_data
• Model Domain has a new parameter identity
• Model EventSubscription has a new parameter dead_letter_with_resource_identity
• Model EventSubscription has a new parameter system_data
• Model EventSubscription has a new parameter delivery_with_resource_identity
• Model WebHookEventSubscriptionDestination has a new parameter delivery_attribute_mappings
• Added operation TopicsOperations.begin_regenerate_key
• Added operation EventSubscriptionsOperations.get_delivery_attributes
• Added operation group PartnerRegistrationsOperations
• Added operation group SystemTopicsOperations
• Added operation group EventChannelsOperations
• Added operation group PartnerNamespacesOperations
• Added operation group ExtensionTopicsOperations
• Added operation group PartnerTopicsOperations
• Added operation group PartnerTopicEventSubscriptionsOperations
• Added operation group SystemTopicEventSubscriptionsOperations

Breaking changes

• Removed operation TopicsOperations.regenerate_key

8.0.0 (2020-12-21)

Breaking changes

• Operation TopicsOperations.regenerate_key has a new signature
• Operation DomainsOperations.regenerate_key has a new signature

8.0.0b1 (2020-10-31)

This is beta preview version. For detailed changelog please refer to equivalent stable version 3.0.0rc8(https://pypi-hypernode.com/project/azure-mgmt-eventgrid/3.0.0rc8/)

This version uses a next-generation code generator that introduces important breaking changes, but also important new features (like unified authentication and async programming).

General breaking changes

• Credential system has been completly revamped:

  • azure.common.credentials or msrestazure.azure_active_directory instances are no longer supported, use the azure-identity classes instead: https://pypi-hypernode.com/project/azure-identity/
  • credentials parameter has been renamed credential

• The config attribute no longer exists on a client, configuration should be passed as kwarg. Example: MyClient(credential, subscription_id, enable_logging=True). For a complete set of supported options, see the parameters accept in init documentation of azure-core

• You can't import a version module anymore, use __version__ instead

• Operations that used to return a msrest.polling.LROPoller now returns a azure.core.polling.LROPoller and are prefixed with begin_.

• Exceptions tree have been simplified and most exceptions are now azure.core.exceptions.HttpResponseError (CloudError has been removed).

• Most of the operation kwarg have changed. Some of the most noticeable:

  • raw has been removed. Equivalent feature can be found using cls, a callback that will give access to internal HTTP response for advanced user
  • For a complete set of supported options, see the parameters accept in Request documentation of azure-core

General new features

• Type annotations support using typing. SDKs are mypy ready.
• This client has now stable and official support for async. Check the aio namespace of your package to find the async client.
• This client now support natively tracing library like OpenCensus or OpenTelemetry. See this tracing quickstart for an overview.

3.0.0rc8 (2020-06-05)

Breaking changes

• Model EventSubscriptionUpdateParameters no longer has parameter dead_letter_with_resource_identity
• Model EventSubscriptionUpdateParameters no longer has parameter delivery_with_resource_identity
• Model DomainUpdateParameters no longer has parameter sku
• Model DomainUpdateParameters no longer has parameter identity
• Model Domain no longer has parameter sku
• Model Domain no longer has parameter identity
• Model EventSubscription no longer has parameter dead_letter_with_resource_identity
• Model EventSubscription no longer has parameter delivery_with_resource_identity
• Model TopicUpdateParameters no longer has parameter sku
• Model TopicUpdateParameters no longer has parameter identity
• Model Topic no longer has parameter sku
• Model Topic no longer has parameter identity
• Removed operation group ExtensionTopicsOperations
• Removed operation group PartnerNamespacesOperations
• Removed operation group PartnerRegistrationsOperations
• Removed operation group PartnerTopicsOperations
• Removed operation group SystemTopicEventSubscriptionsOperations
• Removed operation group SystemTopicsOperations
• Removed operation group PartnerTopicEventSubscriptionsOperations
• Removed operation group EventChannelsOperations

3.0.0rc7 (2020-05-14)

Features

• Model PartnerTopic has a new parameter expiration_time_if_not_activated_utc
• Model PartnerTopic has a new parameter partner_topic_friendly_description
• Model EventChannel has a new parameter partner_topic_readiness_state
• Model EventChannel has a new parameter expiration_time_if_not_activated_utc
• Model EventChannel has a new parameter partner_topic_friendly_description
• Model PartnerRegistration has a new parameter partner_customer_service_number
• Model PartnerRegistration has a new parameter partner_customer_service_extension
• Model PartnerRegistration has a new parameter long_description
• Model PartnerRegistration has a new parameter customer_service_uri

Breaking changes

• Model EventChannelFilter has a new signature

3.0.0rc6 (2020-04-03)

Features

• Model PartnerRegistrationUpdateParameters has a new parameter tags
• Model EventChannel has a new parameter filter

Breaking changes

• Operation PrivateEndpointConnectionsOperations.update has a new signature
• Operation SystemTopicEventSubscriptionsOperations.list_by_system_topic has a new signature
• Operation PartnerTopicEventSubscriptionsOperations.list_by_partner_topic has a new signature

3.0.0rc5 (2020-03-19)

Features

• Model Domain has a new parameter public_network_access
• Model Domain has a new parameter identity
• Model Domain has a new parameter private_endpoint_connections
• Model Domain has a new parameter sku
• Model DomainUpdateParameters has a new parameter public_network_access
• Model DomainUpdateParameters has a new parameter identity
• Model DomainUpdateParameters has a new parameter sku
• Model TopicUpdateParameters has a new parameter public_network_access
• Model TopicUpdateParameters has a new parameter identity
• Model TopicUpdateParameters has a new parameter sku
• Model EventSubscriptionUpdateParameters has a new parameter dead_letter_with_resource_identity
• Model EventSubscriptionUpdateParameters has a new parameter delivery_with_resource_identity
• Model Topic has a new parameter public_network_access
• Model Topic has a new parameter identity
• Model Topic has a new parameter private_endpoint_connections
• Model Topic has a new parameter sku
• Model EventSubscription has a new parameter dead_letter_with_resource_identity
• Model EventSubscription has a new parameter delivery_with_resource_identity
• Added operation group PrivateLinkResourcesOperations
• Added operation group SystemTopicsOperations
• Added operation group PrivateEndpointConnectionsOperations
• Added operation group PartnerTopicsOperations
• Added operation group PartnerNamespacesOperations
• Added operation group PartnerTopicEventSubscriptionsOperations
• Added operation group PartnerRegistrationsOperations
• Added operation group ExtensionTopicsOperations
• Added operation group SystemTopicEventSubscriptionsOperations
• Added operation group EventChannelsOperations

Breaking changes

• Model Domain no longer has parameter allow_traffic_from_all_ips
• Model DomainUpdateParameters no longer has parameter allow_traffic_from_all_ips
• Model TopicUpdateParameters no longer has parameter allow_traffic_from_all_ips
• Model Topic no longer has parameter allow_traffic_from_all_ips

3.0.0rc4 (2020-01-17)

Features

• Model DomainUpdateParameters has a new parameter allow_traffic_from_all_ips
• Model DomainUpdateParameters has a new parameter inbound_ip_rules
• Model TopicUpdateParameters has a new parameter allow_traffic_from_all_ips
• Model TopicUpdateParameters has a new parameter inbound_ip_rules

Breaking changes

• Operation DomainsOperations.update has a new signature
• Operation TopicsOperations.update has a new signature

3.0.0rc3 (2020-01-12)

Features

• Model Domain has a new parameter allow_traffic_from_all_ips
• Model Domain has a new parameter inbound_ip_rules
• Model Topic has a new parameter allow_traffic_from_all_ips
• Model Topic has a new parameter inbound_ip_rules
• Model TopicTypeInfo has a new parameter source_resource_format

3.0.0rc2 (2019-11-11)

Features

• Model WebHookEventSubscriptionDestination has a new parameter azure_active_directory_tenant_id

3.0.0rc1 (2019-10-24)

Features

• Model Domain has a new parameter input_schema
• Model Domain has a new parameter input_schema_mapping
• Model Domain has a new parameter metric_resource_id
• Model EventSubscription has a new parameter event_delivery_schema
• Model Topic has a new parameter input_schema
• Model Topic has a new parameter input_schema_mapping
• Model Topic has a new parameter metric_resource_id
• Model WebHookEventSubscriptionDestination has a new parameter preferred_batch_size_in_kilobytes
• Model WebHookEventSubscriptionDestination has a new parameter azure_active_directory_application_id_or_uri
• Model WebHookEventSubscriptionDestination has a new parameter max_events_per_batch
• Model EventSubscriptionUpdateParameters has a new parameter event_delivery_schema

General Breaking Changes

This version uses a next-generation code generator that might introduce breaking changes. In summary, some modules were incorrectly visible/importable and have been renamed. This fixed several issues caused by usage of classes that were not supposed to be used in the first place.

• EventGridManagementClient cannot be imported from azure.mgmt.eventgrid.event_grid_management_client anymore (import from azure.mgmt.eventgrid works like before)
• EventGridManagementClientConfiguration import has been moved from azure.mgmt.eventgrid.event_grid_management_client to azure.mgmt.eventgrid
• A model MyClass from a "models" sub-module cannot be imported anymore using azure.mgmt.eventgrid.models.my_class (import from azure.mgmt.eventgrid.models works like before)
• An operation class MyClassOperations from an operations sub-module cannot be imported anymore using azure.mgmt.eventgrid.operations.my_class_operations (import from azure.mgmt.eventgrid.operations works like before)

Last but not least, HTTP connection pooling is now enabled by default. You should always use a client as a context manager, or call close(), or use no more than one client per process.

2.1.0 (2019-05-22)

Not all preview features of the 2.1.0rc1 were confirmed in this 2.1.0 stable version. In particular, the following features will still be available only in the 2.1.0rc1 for now:

• Input mapping/Delivery Schema.
• "label" filtering parameter in all operations

All other features are now considerd stable to use in production. This includes:

• Domains, which include all domain related operation including adding/deleting domain topics manually.
• Pagination/filtering
• Servicebus queue as destination
• Advanced filtering, which was introduced in previous preview version.
• Showing and selecting default event types instead of ‘all’

2.1.0rc1 (2019-03-11)

Disclaimer

Preview features that were on 2.0.0rc2 only and not on 2.0.0 has been ported in this version.

This version also adds the following preview features: - Manual Add/delete of domain topics. - Pagination/search filtering for list operations. - Adding service bus queue as destination

2.0.0 (2019-02-01)

Disclaimer

Not all preview features of the 2.0.0rc2 were confirmed in this 2.0.0 stable version. In particular, the following features will still be available only in the 2.0.0rc2 for now:

• Domains.
• Advanced filters support.
• Event subscription expiration date
• Input mapping and event delivery schema.

All other features are now considerd stable to use in production. This includes:

• Deadletter destination.
• Storage queue as destination.
• Hybrid connection as destination.
• Retry policy.
• Manual handshake.

2.0.0rc2 (2018-10-24)

Features

• Model EventSubscriptionFilter has a new parameter advanced_filters
• Model EventSubscriptionUpdateParameters has a new parameter expiration_time_utc
• Model EventSubscription has a new parameter expiration_time_utc
• Added operation EventSubscriptionsOperations.list_by_domain_topic
• Added operation group DomainTopicsOperations
• Added operation group DomainsOperations

Internal API version is 2018-09-15-preview

2.0.0rc1 (2018-05-04)

Features

• input mappings for topics
• CloudEvents support for topics
• customizable delivery schemas
• delivering events to Azure Storage queue and Azure hybrid connections
• deadlettering
• retry policies
• manual subscription validation handshake validation.

Internal API version is 2018-05-01-preview

1.0.0 (2018-04-26)

General Breaking changes

This version uses a next-generation code generator that might introduce breaking changes.

• Model signatures now use only keyword-argument syntax. All positional arguments must be re-written as keyword-arguments. To keep auto-completion in most cases, models are now generated for Python 2 and Python 3. Python 3 uses the "*" syntax for keyword-only arguments.
• Enum types now use the "str" mixin (class AzureEnum(str, Enum)) to improve the behavior when unrecognized enum values are encountered. While this is not a breaking change, the distinctions are important, and are documented here: https://docs.python.org/3/library/enum.html#others At a glance:
  • "is" should not be used at all.
  • "format" will return the string value, where "%s" string formatting will return NameOfEnum.stringvalue. Format syntax should be prefered.
• New Long Running Operation:
  • Return type changes from msrestazure.azure_operation.AzureOperationPoller to msrest.polling.LROPoller. External API is the same.
  • Return type is now always a msrest.polling.LROPoller, regardless of the optional parameters used.
  • The behavior has changed when using raw=True. Instead of returning the initial call result as ClientRawResponse, without polling, now this returns an LROPoller. After polling, the final resource will be returned as a ClientRawResponse.
  • New polling parameter. The default behavior is Polling=True which will poll using ARM algorithm. When Polling=False, the response of the initial call will be returned without polling.
  • polling parameter accepts instances of subclasses of msrest.polling.PollingMethod.
  • add_done_callback will no longer raise if called after polling is finished, but will instead execute the callback right away.

Features

• Client class can be used as a context manager to keep the underlying HTTP session open for performance

0.4.0 (2018-01-16)

Breaking changes

• EventSubscription create is renamed to create_or_update.
• Regenerated SDK based on 2018-01-01 API version.
• OperationOrigin enum is removed. Origin of the operation is now a string.

0.3.0 (2017-11-02)

Features

• Support for updating Topic properties

0.2.0 (2017-09-13)

Breaking changes

• Use WebHookEventSubscriptionDestination for webhook endpoint URLs.
• Regenerated based on 2017-09-15-preview version

0.1.1 (2017-08-17)

Bugfixes

• Fix unexpected exception in some delete call

0.1.0 (2017-08-17)

• Initial Release