Abrufen von Metadaten zur Partitionslaufzeit

Artikel
08/05/2023

Gibt die Metadaten für eine angegebene Partition 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/{partitionId}`

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 der angegebenen Partition. 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=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Tue, 23 Feb 2016 23:34:13 GMT  
Content-Length: 910  
  
<?xml version="1.0" encoding="UTF-8"?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <id>sb://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions/0?timeout=60&api-version=2014-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="sb://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default/partitions/0?timeout=60&api-version=2014-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>

Freigeben über