Hämta partitionskörningsmetadata

Artikel
08/05/2023

Returnerar metadata för en angiven partition på en händelsehubb. Se Egenskaper för partitionsbeskrivning.

Förfrågan

Metod	URI för förfrågan
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions/{partitionId}`

Rubriker för begäran

Se Vanliga parametrar och rubriker för rubriker och parametrar som används av alla begäranden som är relaterade till Event Hubs.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Elementnamn	Krävs	Typ	Version	Beskrivning
`SizeInBytes`	Ja, skrivskyddad	int	2014-01	Den ungefärliga storleken i byte för Event Hubs-partitionen.
`BeginSequenceNumber`	Ja, skrivskyddad	sträng	2014-01	Det inledande sekvensnumret.
`EndSequenceNumber`	Ja, skrivskyddad	sträng	2014-01	Slutsekvensnumret.
`IncomingBytesPerSecond`	Ja, skrivskyddad	sträng	2014-01	Den ungefärliga inkommande händelsefrekvensen (i byte per sekund) för partitionen i den här konsumentgruppen.
`OutgoingBytesPerSecond`	Ja, skrivskyddad	sträng	2014-01	Den ungefärliga utgående hastigheten (i byte per sekund) för partitionen i den här konsumentgruppen.
`LastEnqueuedOffset`	Ja, skrivskyddad	sträng	2015-01	Förskjutningen av den senaste köade händelsen.
`LastEnqueuedTimeUtc`	Ja, skrivskyddad	sträng	2015-01	Tiden i UTC då den senaste händelsen angavs.

Svarskoder

Kod	Description
200	Åtgärden lyckades.
401	Auktoriseringsfel.
500	Internt fel.

Svarstext

Om begäran lyckas innehåller svarstexten beskrivningen av den angivna partitionen. Om begäran inte lyckas innehåller brödtexten en felkod och ett felmeddelande.

Exempel

Förfrågan

Anteckning

Du kan också använda en Azure Active Directory-token för auktoriseringshuvudet enligt beskrivningen i Vanliga parametrar och rubriker. Exempel: 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

Response

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>

Dela via