Azure Event Hubs REST API

Azure Event Hubs is a highly scalable data ingress service that ingests millions of events per second so that you can process and analyze the massive amounts of data produced by your connected devices and applications. Once data is collected into an Event Hub, it can be transformed and stored using any real-time analytics provider or batching/storage adapters.

The REST APIs fall into the following categories:

  • Azure Resource Manager: APIs that perform resource manager operations, and have /providers/Microsoft.EventHub/ as part of the request URI.
  • Event Hubs service: APIs that enable operations directly on the Event Hubs service, and have <namespaceName>.servicebus.windows.net/ in the request URI.
  • "Classic" or RDFE management: APIs that provide programmatic access to much of the functionality available through the Azure portal. These APIs have management.core.windows.net in the URI. Event Hubs does not have RDFE REST APIs at this time.

REST operation groups

The Event Hubs REST API provides operations for working with the following resources.

Azure Resource Manager

Resource manager APIs are management APIs that perform operations on Event Hubs entities, such as event hubs, namespaces, and consumer groups. They are useful in scenarios that enable global authentication, rather than at the namespace or entity level.

Operation group Description
Consumer Groups Provides operations for working with Event Hubs consumer groups.
Event Hubs Operations for managing Event Hubs.
Namespaces Operations for managing Event Hubs namespaces.

Event Hubs service

Event Hubs service APIs access the Event Hubs service directly, and perform various management operations at the entity level, rather than at the namespace level (such as publisher policy operations and sending events. These APIs use SAS authentication.

At this time, the Event Hubs service APIs are documented on Microsoft.com as well as on MSDN.

See also