- This is a GA of the
EventGridConsumerClient, theEventGridConsumerClientsupports the following operations for Cloud Events in Event Grid Namespace:receive,release,acknowledge,rejectandrenew_locks. - The
EventGridPublisherClientnow supports the Event Grid Namespace tier. Initialize the client with the namespace endpoint, and thenamespace_topickwarg to send Cloud Events to an Event Grid Namespace topic.
This is a Beta of the EventGridClient
- Fixed serialization issues with CloudEvent and CNCF Cloud Event
- This is a Beta of the EventGridClient
- EventGridClient
sendcan be used for both Event Grid Namespace Resources and Event Grid Basic Resources.- Added a kwarg
levelin the EventGridClient constructor. The default value isStandardwhich creates a client for an Event Grid Namespace Resource.
- Added a kwarg
- EventGridClient
- Removed the
AcknowledgeOptions,ReleaseOptions,RejectOptions, andRenewLockOptionsmodels.lock_tokenscan now be specified as akwargon the operation. - Renamed
publish_cloud_eventstosend.
- Added new enum values to
SystemEventNamesrelated to Azure Communication Services.
- Fixed a bug where the Api Version was being hardcoded to
2018-01-01on any request sent to the service.
- Added new enum values to
SystemEventNamesrelated to Azure Api Center.
This version and all future versions will require Python 3.8+.
- Added new enums values to
SystemEventNamesrelated to Azure Storage and Azure VMware Solution.
- Beta EventGridClient features were added on top of the last GA version of EventGrid.
- Added new features to the EventGridClient that supports
publish_cloud_events,receive_cloud_events,acknowledge_cloud_events,release_cloud_events, andreject_cloud_eventsoperations. These features include arenew_cloud_event_locksoperation, as well as arelease_with_delayparameter on therelease_cloud_eventsoperation. - The
lock_tokensparameter inreject_cloud_events,release_cloud_events, andacknowledge_cloud_eventswas renamed toreject_options,release_options, andacknowledge_options. - The
binary_modekeyword argument onpublish_cloud_eventswas added to allow for binary mode support when publishing single Cloud Events. - Added new models to support these new operations on EventGridClient.
- Added new features to the EventGridClient that supports
- Added new enum values to
SystemEventnamesrelated to Azure Resource Notifications.
- Added new enum values to
SystemEventNamesrelated to Azure Communication Services and Azure Resource Notifications.
- Added new enum values to
SystemEventNamesrelated to Azure App Configuration and Azure EventGrid.
- Beta EventGridClient features were removed for this and future GA versions.
- Added new enum values to
SystemEventNamesrelated to Azure Container Services.
- Added a new EventGridClient that supports
publish_cloud_events,receive_cloud_events,acknowledge_cloud_events,release_cloud_events, andreject_cloud_eventsoperations. - Added new models to support these new operations on EventGridClient.
- Added new enum values to
SystemEventNamesrelated to Storage Tasks, Azure Communication Services and Azure HealthcareApis.
- Added new enum values to
SystemEventNamesrelated to Azure Communication Services, DataBox and ApiManagementGateway APIs.
SystemEventNamesenums for APIManagement were incorrectly capitalized, changedApitoAPI.
- Removed
msrestdependency andsixdependency - Added
isodatedependency
- This version and all future versions will require Python 3.7+.
- Added new enum values to
SystemEventNamesrelated to health care APIs.
- Added support for publishing events to a channel.
- Added support for publishing events to a channel.
- This version and all future versions will require Python 3.6+. Python 2.7 is no longer supported.
- Added new enum values to
SystemEventNamesrelated to health care APIs.
- The
sendAPI will raise on exceptions.
- Added support for publishing native CNCF cloudevents (https://pypi.org/project/cloudevents/).
- Added new enum values to
SystemEvents.
- Added a new enum value
Microsoft.ContainerService.NewKubernetesVersionAvailabletoSystemEvents. - Added a
from_jsonmethod which now accepts storage QueueMessage, eventhub's EventData or ServiceBusMessage or simply json bytes to return anEventGridEvent
- Bumped
msrestdependency to0.6.21to align with mgmt package.
EventGridPublisherClientnow supports Azure Active Directory (AAD) for authentication.
New Features
- Added new event names related to blob inventory to the
SystemEventNamesenum.
Bug Fixes
- Replaced the
ServiceBusDeadletterMessagesAvailableWithNoListenerEventNamewith the right value.
New Features
- Added new event names to the
SystemEventNamesenum.
Bug Fixes
- Improved the
repronEventGridEventto show more meaningful text.
New Features
- Added new SystemEventNames
AcsChatThreadParticipantRemovedEventName,AcsChatThreadParticipantAddedEventNameandAcsRecordingFileStatusUpdatedEventName.
Note: This is the first stable release of our efforts to create a user-friendly and Pythonic client library for Azure EventGrid. Users migrating from v1.x are advised to view the migration guide.
New Features
azure-eventgridpackage now supportsazure.core.messaging.CloudEventwhich honors the CNCF CloudEvent spec.azure.eventgrid.SystemEventNamescan be used to get the event model type mapping for system events.- Implements the
EventGridPublisherClientfor the publish flow for EventGrid Events, CloudEvents and Custom schema events.
Breaking Changes
azure.eventgrid.modelsnamespace along with all the models in it are now removed.:- JSON documentation on the events is available here: https://docs.microsoft.com/azure/event-grid/system-topics
azure.eventgrid.SystemEventNamesprovides the list of available events name for easy switching.
azure.eventgrid.event_grid_client.EventGridClientis now removed in favor ofazure.eventgrid.EventGridPublisherClient.azure.eventgrid.event_grid_client.EventGridClientConfigurationis now removed.
Disclaimer: v2.0.0 is functionally equivalent to v4.0.0. Users are advised to use v4.0.0 instead of this.
Breaking Changes
~azure.eventgrid.CloudEventis now removed in favor of~azure.core.messaging.CloudEvent.- All the
SystemEventNamesrelated to Azure Communication Service starting withACS****are renamed toAcs***to honor pascal case.
Features
- Added support for two new
SystemEvents-ServiceBusDeadletterMessagesAvailablePeriodicNotificationsEventDataandServiceBusActiveMessagesAvailablePeriodicNotificationsEventData
Breaking Changes
EventGridSharedAccessSignatureCredentialis deprecated in favor ofAzureSasCredential.azure.eventgrid.modelsnamespace along with all the models in it are now removed.azure.eventgrid.SystemEventNamescan be used to get the event model type mapping.topic_hostnameis renamed toendpointin theEventGridPublisherClient.azure.eventgrid.generate_shared_access_signaturemethod is now renamed togenerate_sas.EventGridConsumeris now removed. Please see the samples to see how events can be deserialized.CustomEventmodel is removed. Dictionaries must be used to send a custom schema.
Bug Fixes
EventGridEventhas two additional required positional parameters namely,dataanddata_version.EventGridPublisherClientnow appropriately throws aValueErrorif an invalid credential is passed during initialization.
Bug Fixes
TypeErroris raised when bytes are passed to anEventGridEvent.
Feature
- Added support for Keyvault Event Types
- Added distributed tracing support for CloudEvents
Features
- Added support for Azure Communication Services event types.
Features
- Version (2.0.0b1) is the first preview of our efforts to create a user-friendly and Pythonic client library for Azure EventGrid. For more information about this, and preview releases of other Azure SDK libraries, please visit https://azure.github.io/azure-sdk/releases/latest/python.html.
- Added Support for
CloudEvents. - Implements the
EventGridPublisherClientfor the publish flow for EventGrid Events, CloudEvents and CustomEvents. - Implements the
EventGridConsumerfor the consume flow of the events.
- Event Schemas for new event types from IotHub, Media Services, Container Registry, Maps, and AppConfiguration services.
- Event Schemas for new events (IotHub DeviceConnected and DeviceDisconnected events, Resource events related to actions), and breaking changes to the schema for IotHub DeviceCreated event and IotHub DeviceDeleted event.
- Event Schemas for EventGrid subscription validation event, Azure Media events, and ServiceBus events.
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 preferred.
- New Long Running Operation:
- Return type changes from
msrestazure.azure_operation.AzureOperationPollertomsrest.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 asClientRawResponse, without polling, now this returns an LROPoller. After polling, the final resource will be returned as aClientRawResponse. - New
pollingparameter. The default behavior isPolling=Truewhich will poll using ARM algorithm. WhenPolling=False, the response of the initial call will be returned without polling. pollingparameter accepts instances of subclasses ofmsrest.polling.PollingMethod.add_done_callbackwill no longer raise if called after polling is finished, but will instead execute the callback right away.
- Return type changes from
Features
- Client class can be used as a context manager to keep the underlying HTTP session open for performance
- Support for consuming Azure Container Registry events and Azure IoT Hub events published to Event Grid.
- Initial Release