Répertorier les métadonnées du runtime de partition

Article
07/19/2023

Retourne les métadonnées de toutes les partitions sur un Event Hub. Consultez Propriétés de la description de la partition.

Requête

Méthode	URI de demande
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions`

En-têtes de requête

Consultez Paramètres et en-têtes communs 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
`SizeInBytes`	Oui, en lecture seule	int	2014-01	Taille approximative, en octets, de la partition Event Hubs.
`BeginSequenceNumber`	Oui, en lecture seule	string	2014-01	Numéro de séquence de début.
`EndSequenceNumber`	Oui, en lecture seule	string	2014-01	Numéro de séquence de fin.
`IncomingBytesPerSecond`	Oui, en lecture seule	string	2014-01	Taux approximatif d’événements entrants (en octets par seconde) pour la partition dans ce groupe de consommateurs.
`OutgoingBytesPerSecond`	Oui, en lecture seule	string	2014-01	Débit sortant approximatif (en octets par seconde) pour la partition dans ce groupe de consommateurs.
`LastEnqueuedOffset`	Oui, en lecture seule	string	2015-01	Décalage du dernier événement mis en file d’attente.
`LastEnqueuedTimeUtc`	Oui, en lecture seule	string	2015-01	Heure UTC à laquelle le dernier événement a été mis en file d’attente.

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 réussit, le corps de la réponse contient la description de toutes les partitions du hub d’événements spécifié. 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 paramètres et en-têtes communs. Par exemple : Authorization: Bearer <Azure AD token>.

GET https://your-namespace.servicebus.windows.net/your-event-hub//consumergroups/$Default/partitions/0?timeout=60&api-version=2015-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=your-sas-key&se=1456273000&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net

Réponse

HTTP/1.1 200 OK  
Content-Type: application/atom+xml;type=feed;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 23 Feb 2016 23:36:42 GMT  
Content-Length: 2252  
  
<?xml version="1.0" encoding="UTF-8"?>  
<feed xmlns="http://www.w3.org/2005/Atom">  
   <title type="text">Partitions</title>  
   <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions?timeout=60&api-version=2015-01</id>  
   <updated>2016-02-23T23:36:42Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions?timeout=60&api-version=2014-01" />  
   <entry xml:base="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions?timeout=60&api-version=2014-01">  
      <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions/0?api-version=2015-01</id>  
      <title type="text">0</title>  
      <published>2015-09-09T20:31:00Z</published>  
      <updated>2015-09-09T20:31:00Z</updated>  
      <link rel="self" href="partitions/0?api-version=2015-01" />  
      <content type="application/xml">  
         <PartitionDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
            <SizeInBytes>33554432</SizeInBytes>  
            <BeginSequenceNumber>0</BeginSequenceNumber>  
            <EndSequenceNumber>20044</EndSequenceNumber>  
            <IncomingBytesPerSecond>0</IncomingBytesPerSecond>  
            <OutgoingBytesPerSecond>0</OutgoingBytesPerSecond>  
            <LastEnqueuedOffset>2062040</LastEnqueuedOffset>  
            <LastEnqueuedTimeUtc>2016-02-23T03:22:27.024Z</LastEnqueuedTimeUtc>  
         </PartitionDescription>  
      </content>  
   </entry>  
   <entry xml:base="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions?timeout=60&api-version=2014-01">  
      <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions/1?api-version=2015-01</id>  
      <title type="text">1</title>  
      <published>2015-09-09T20:31:01Z</published>  
      <updated>2015-09-09T20:31:01Z</updated>  
      <link rel="self" href="partitions/1?api-version=2015-01" />  
      <content type="application/xml">  
         <PartitionDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
            <SizeInBytes>33554432</SizeInBytes>  
            <BeginSequenceNumber>0</BeginSequenceNumber>  
            <EndSequenceNumber>22907</EndSequenceNumber>  
            <IncomingBytesPerSecond>0</IncomingBytesPerSecond>  
            <OutgoingBytesPerSecond>0</OutgoingBytesPerSecond>  
            <LastEnqueuedOffset>2062040</LastEnqueuedOffset>  
            <LastEnqueuedTimeUtc>2016-02-23T03:22:27.024Z</LastEnqueuedTimeUtc>  
         </PartitionDescription>  
      </content>  
   </entry>  
</feed>

Partager via