Obtenir un hub d'événements

Article
08/05/2023

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>

Partager via