Obtenir un hub d'événements

  • Article

Récupère toutes les métadonnées associées au hub d’événements spécifié. Consultez Propriétés EventHubDescription.

Requête

Méthode URI de demande
GET https://{serviceNamespace}.servicebus.windows.net/{eventHubPath}

En-têtes de requête

Consultez Paramètres et en-têtes courants pour les en-têtes et les paramètres utilisés par toutes les requêtes liées à Event Hubs.

response

La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.

Nom de l'élément Obligatoire Type Version Description
AuthorizationRules Oui, en lecture seule string 2014-01 Règles d’autorisation.
MessageRetentionInDays Oui, en lecture seule string 2014-01 Nombre de jours pendant lesquels conserver les événements pour ce hub d’événements.
Status Oui, en lecture seule string 2014-01 Status actuel du hub d’événements (activé ou désactivé).
CreatedAt Oui, en lecture seule string 2014-01 Heure exacte à laquelle le hub d’événements a été créé.
UpdatedAt Oui, en lecture seule string 2014-01 Heure exacte de mise à jour d’Event Hub.
PartitionCount Oui, en lecture seule string 2014-01 Nombre actuel de partitions sur le hub d’événements.
PartitionIds Oui, en lecture seule string 2014-01 Identificateurs pour les partitions créées pour Event Hub.

Codes de réponse

Code Description
200 Réussite.
401 Échec de l'autorisation.
500 Erreur interne.

Corps de la réponse

Si la demande aboutit, le corps de la réponse contient la description du hub d'événements interrogé. Si la demande échoue, le corps contient un code et un message d'erreur.

Exemples

Requête

Notes

Vous pouvez également utiliser un jeton Azure Active Directory pour l’en-tête d’autorisation , comme indiqué dans les en-têtes et paramètres communs. Par exemple : Authorization: Bearer <Azure AD token>.

GET https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
ContentType: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net

Réponse

HTTP/1.1 200 Created  
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  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
    <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&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">  
      <SizeInBytes>0</SizeInBytes>  
      <MessageRetentionInDays>2</MessageRetentionInDays>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <CreatedAt>2014-06-25T22:51:47.8656642</CreatedAt>  
      <UpdatedAt>2014-06-25T22:51:50.623Z</UpdatedAt>  
      <AccessedAt>0001-01-01T00:00:00Z</AccessedAt>  
      <PartitionCount>4</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>