Obter metadados de runtime de partição

Artigo
08/05/2023

Retorna os metadados de uma partição especificada em um Hub de Eventos. Consulte Propriedades de descrição da partição.

Solicitação

Método	URI da solicitação
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions/{partitionId}`

Cabeçalhos de solicitação

Confira Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por todas as solicitações relacionadas aos Hubs de Eventos.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Nome do elemento	Obrigatório	Tipo	Versão	Descrição
`SizeInBytes`	Sim, somente leitura	INT	2014-01	O tamanho aproximado, em bytes, da partição dos Hubs de Eventos.
`BeginSequenceNumber`	Sim, somente leitura	string	2014-01	O número da sequência inicial.
`EndSequenceNumber`	Sim, somente leitura	string	2014-01	O número da sequência final.
`IncomingBytesPerSecond`	Sim, somente leitura	string	2014-01	A taxa de entrada aproximada de eventos (em bytes por segundo) para a partição nesse grupo de consumidores.
`OutgoingBytesPerSecond`	Sim, somente leitura	string	2014-01	A taxa de saída aproximada (em bytes por segundo) para a partição nesse grupo de consumidores.
`LastEnqueuedOffset`	Sim, somente leitura	string	2015-01	O deslocamento do último evento enfileirado.
`LastEnqueuedTimeUtc`	Sim, somente leitura	string	2015-01	A hora em UTC em que o último evento foi enfileirado.

Códigos de resposta

Código	Descrição
200	Êxito.
401	Falha de autorização.
500	Erro interno.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá a descrição da partição especificada. Se a solicitação não tiver êxito, o corpo conterá um código de erro e uma mensagem de erro.

Exemplos

Solicitação

Observação

Você também pode usar um token do Azure Active Directory para o cabeçalho De autorização , conforme observado nos cabeçalhos e parâmetros comuns. Por exemplo: 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

Resposta

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>

Compartilhar via