Obter metadados do runtime de partição

Artigo
08/05/2023

Devolve os metadados de uma partição especificada num Hub de Eventos. Veja Propriedades da Descrição da Partição.

Pedir

Método	URI do pedido
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}/partitions/{partitionId}`

Cabeçalhos do Pedido

Veja Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs ( Parâmetros comuns e cabeçalhos para cabeçalhos e parâmetros que são utilizados por todos os pedidos relacionados com os Hubs de Eventos).

Resposta

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

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

Códigos de Resposta

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

Corpo da Resposta

Se o pedido for bem-sucedido, o corpo da resposta contém a descrição da partição especificada. Se o pedido não for bem-sucedido, o corpo contém um código de erro e uma mensagem de erro.

Exemplos

Pedir

Nota

Também pode utilizar um token do Azure Active Directory para o cabeçalho Autorização , conforme indicado nos parâmetros e cabeçalhos 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

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>

Partilhar via