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

Artículo
07/19/2023

Devuelve los metadatos de todas las particiones de 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`

Encabezados de solicitud

Consulte 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 de entrada 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 todas las particiones del centro de eventos especificado. 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 encabezados y parámetros 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=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>

Compartir a través de