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 doesn't have RDFE REST APIs at this time.

Important

If you are using "Classic" or RDFE management APIs, they are obsolete and retired as of 11/1/2021 and should no longer be used.

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 namespaces, event hubs, and consumer groups. They are useful in scenarios that enable global authentication, rather than at the namespace or entity level.

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

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 can use:

See also