Auflisten von Partitionslaufzeitmetadaten

Artikel
07/19/2023

Gibt die Metadaten für alle Partitionen auf einem Event Hub zurück. Weitere Informationen finden Sie unter Eigenschaften der Partitionsbeschreibung.

Anforderung

Methode	Anforderungs-URI
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions`

Anforderungsheader

Weitere Informationen finden Sie unter Allgemeine Parameter und Header für Header und Parameter, die von allen Anforderungen im Zusammenhang mit Event Hubs verwendet werden.

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Elementname	Erforderlich	type	Version	BESCHREIBUNG
`SizeInBytes`	Ja, schreibgeschützt	INT	2014-01	Die ungefähre Größe der Event Hubs-Partition in Bytes.
`BeginSequenceNumber`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die Anfangssequenznummer.
`EndSequenceNumber`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die Endsequenznummer.
`IncomingBytesPerSecond`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die ungefähre eingehende Rate von Ereignissen (in Bytes pro Sekunde) für die Partition in dieser Consumergruppe.
`OutgoingBytesPerSecond`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Die ungefähre Ausgehende Rate (in Bytes pro Sekunde) für die Partition in dieser Consumergruppe.
`LastEnqueuedOffset`	Ja, schreibgeschützt	Zeichenfolge	2015-01	Der Offset des letzten queuierten Ereignisses.
`LastEnqueuedTimeUtc`	Ja, schreibgeschützt	Zeichenfolge	2015-01	Die Uhrzeit in UTC, zu der das letzte Ereignis in Warteschlange gestellt wurde.

Antwortcodes

Code	BESCHREIBUNG
200	Erfolg.
401	Autorisierungsfehler
500	Interner Fehler.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Beschreibung aller Partitionen des angegebenen Event Hub. Wenn die Anforderung nicht erfolgreich ausgeführt wird, enthält der Textkörper einen Fehlercode und eine Fehlernachricht.

Beispiele

Anforderung

Hinweis

Sie können auch ein Azure Active Directory-Token für den Autorisierungsheader verwenden, wie in den Allgemeinen Parametern und Headern angegeben. Beispiel: 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

Antwort

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>

Freigeben über