Lista partitionskörningsmetadata

Artikel
08/05/2023

Returnerar metadata för alla partitioner 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`

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 alla partitioner i den angivna händelsehubben. 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=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>

Dela via