Obtención de metadatos del entorno de ejecución de partición

Artículo
08/05/2023

Devuelve los metadatos de una partición especificada en un centro de eventos. Consulte Propiedades de descripción de partición.

Solicitud

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

Encabezados de solicitud

Consulte Common parameters and headers for headers and parameters that are used by all requests related to Event Hubs (Parámetros y encabezados comunes para encabezados y parámetros que usan todas las solicitudes relacionadas con Event Hubs).

Response

La respuesta incluye un código de estado HTTP, un conjunto de encabezados de respuesta y un cuerpo de respuesta.

Nombre del elemento	Obligatorio	Tipo	Versión	Descripción
`SizeInBytes`	Sí, solo lectura	int	2014-01	Tamaño aproximado, en bytes, de la partición de Event Hubs.
`BeginSequenceNumber`	Sí, solo lectura	string	2014-01	Número de secuencia inicial.
`EndSequenceNumber`	Sí, solo lectura	string	2014-01	Número de secuencia final.
`IncomingBytesPerSecond`	Sí, solo lectura	string	2014-01	Velocidad entrante aproximada de eventos (en bytes por segundo) para la partición de este grupo de consumidores.
`OutgoingBytesPerSecond`	Sí, solo lectura	string	2014-01	Velocidad de salida aproximada (en bytes por segundo) para la partición de este grupo de consumidores.
`LastEnqueuedOffset`	Sí, solo lectura	string	2015-01	Desplazamiento del último evento en cola.
`LastEnqueuedTimeUtc`	Sí, solo lectura	string	2015-01	Hora UTC a la que se puso en cola el último evento.

Códigos de respuesta

Código	Descripción
200	Correcto.
401	Error de autorización.
500	Error interno.

Cuerpo de la respuesta

Si la solicitud se realiza correctamente, el cuerpo de la respuesta contiene la descripción de la partición especificada. Si la solicitud no es correcta, el cuerpo contiene un código de error y un mensaje de error.

Ejemplos

Solicitud

Nota:

También puede usar un token de Azure Active Directory para el encabezado authorization , como se indica en los parámetros y encabezados comunes. Por ejemplo: 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

Respuesta

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>

Compartir a través de