Listar metadados de runtime de partição

Artigo
07/19/2023

Devolve os metadados de todas as partições 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`

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 de todas as partições do Hub de Eventos especificado. 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=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>

Partilhar via