Ottenere i metadati del runtime di partizione

Articolo
07/19/2023

Restituisce i metadati per una partizione specificata in un hub eventi. Vedere Proprietà Descrizione partizione.

Richiesta

Metodo	URI richiesta
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions/{partitionId}`

Intestazioni richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati da tutte le richieste correlate a Hub eventi.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Nome dell'elemento	Obbligatoria	Tipo	Versione	Descrizione
`SizeInBytes`	Sì, di sola lettura	INT	2014-01	Dimensioni approssimative, in byte, della partizione di Hub eventi.
`BeginSequenceNumber`	Sì, di sola lettura	string	2014-01	Numero di sequenza iniziale.
`EndSequenceNumber`	Sì, di sola lettura	string	2014-01	Numero di sequenza finale.
`IncomingBytesPerSecond`	Sì, di sola lettura	string	2014-01	Frequenza approssimativa in ingresso degli eventi (in byte al secondo) per la partizione in questo gruppo di consumer.
`OutgoingBytesPerSecond`	Sì, di sola lettura	string	2014-01	Frequenza approssimativa in uscita (in byte al secondo) per la partizione in questo gruppo di consumer.
`LastEnqueuedOffset`	Sì, di sola lettura	string	2015-01	Offset dell'ultimo evento accodato.
`LastEnqueuedTimeUtc`	Sì, di sola lettura	string	2015-01	Ora in formato UTC in cui è stato accodato l'ultimo evento.

Codici di risposta

Codice	Descrizione
200	Operazione completata.
401	Errore di autorizzazione.
500	Errore interno.

Corpo della risposta

Se la richiesta ha esito positivo, il corpo della risposta contiene la descrizione della partizione specificata. Se la richiesta ha esito negativo, il corpo contiene un codice di errore e un messaggio di errore.

Esempio

Richiesta

Nota

È anche possibile usare un token di Azure Active Directory per l'intestazione Authorization , come indicato nelle intestazioni e parametri comuni. Ad esempio: 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>

Condividi tramite