Share via

List Event Hubs

  • Article

Retrieves all metadata associated with all Event Hubs within a specified Event Hubs namespace. See EventHubDescription Properties.

Request

Method Request URI
GET https://{servicebusNamespace}.servicebus.windows.net/$Resources/Eventhubs

Request Headers

See Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs.

Response

The response includes an HTTP status code, a set of response headers, and a response body.

Element name Required Type Version Description
AuthorizationRules Yes, read-only string 2014-01 The authorization rules.
MessageRetentionInDays Yes, read-only string 2014-01 The number of days to retain the events for this event hub.
Status Yes, read-only string 2014-01 The current status of the event hub (enabled or disabled).
CreatedAt Yes, read-only string 2014-01 The exact time the event hub was created.
UpdatedAt Yes, read-only string 2014-01 The exact time the event hub was updated.
PartitionCount Yes, read-only string 2014-01 The current number of partitions on the event hub.
PartitionIds Yes, read-only string 2014-01 Identifiers for partitions created for the event hub.

Response Codes

Code Description
200 Success.
401 Authorization failure.
500 Internal error.

Response Body

If the request is successful, the response body contains the description of all the event hHubs under the queried Event Hubs namespace. If the request isn't successful, the body contains an error code and error message.

Examples

Request

Note

You can also use an Azure Active Directory token for the Authorization header as noted in the Common parameters and headers. For example: Authorization: Bearer <Azure AD token>.

GET https://your-namespace.servicebus.windows.net/ $Resources/Eventhubs?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=your-sas-key&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net

Response

HTTP/1.1 200 OK  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
<?xml version="1.0" encoding="UTF-8"?>  
<feed xmlns="http://www.w3.org/2005/Atom">  
   <title type="text">EventHubs</title>  
   <id>https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01</id>  
   <updated>2016-02-19T22:56:38Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01" />  
   <entry xml:base="https://your-namespace.servicebus.windows.net/$Resources/Eventhubs?timeout=60&api-version=2014-01">  
      <id>https://your-namespace.servicebus.windows.net/your-event-hub?api-version=2014-01</id>  
      <title type="text">your-event-hub</title>  
      <published>2015-09-09T20:30:51Z</published>  
      <updated>2015-09-09T21:16:12Z</updated>  
      <author>  
         <name>your-namespace</name>  
      </author>  
      <link rel="self" href="../your-event-hub?api-version=2014-01" />  
      <content type="application/xml">  
         <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
            <MessageRetentionInDays>1</MessageRetentionInDays>  
            <AuthorizationRules>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Send</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>send</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Listen</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>listen</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
               <AuthorizationRule i:type="SharedAccessAuthorizationRule">  
                  <ClaimType>SharedAccessKey</ClaimType>  
                  <ClaimValue>None</ClaimValue>  
                  <Rights>  
                     <AccessRights>Manage</AccessRights>  
                     <AccessRights>Send</AccessRights>  
                     <AccessRights>Listen</AccessRights>  
                  </Rights>  
                  <CreatedTime>2015-09-09T21:16:11.7216934Z</CreatedTime>  
                  <ModifiedTime>2015-09-09T21:16:11.7216934Z</ModifiedTime>  
                  <KeyName>manage</KeyName>  
                  <PrimaryKey>your-primary-key</PrimaryKey>  
                  <SecondaryKey>your-secondary-key</SecondaryKey>  
               </AuthorizationRule>  
            </AuthorizationRules>  
            <Status>Active</Status>  
            <CreatedAt>2015-09-09T20:30:51.083</CreatedAt>  
            <UpdatedAt>2015-09-09T21:16:12.057</UpdatedAt>  
            <PartitionCount>2</PartitionCount>  
            <PartitionIds xmlns:d2p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">  
               <d2p1:string>0</d2p1:string>  
               <d2p1:string>1</d2p1:string>  
            </PartitionIds>  
         </EventHubDescription>  
      </content>  
   </entry>  
</feed>