Compartir a través de

Obtener grupo de consumidores

  • Artículo

Recupera todos los metadatos asociados al grupo de consumidores especificado. Consulte Propiedades consumerGroupDescription.

Solicitud

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

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
CreatedAt Sí, solo lectura string 2014-01 Hora exacta en que se creó el grupo de consumidores.
UpdatedAt Sí, solo lectura string 2014-01 Hora exacta en que se actualizó el grupo de consumidores.

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 del grupo de consumidores 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 parámetros y encabezados comunes. Por ejemplo: Authorization: Bearer <Azure AD token>.

GET https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$default?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=https%3A%2F%2Fyour-namespace.servicebus.windows.net%2F&sig=your-sas-key&se=1455847106&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net

Respuesta

HTTP/1.1 200 Created  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
HTTP/1.1 200 OK  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:40:20 GMT  
Content-Length: 776  
  
<?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?timeout=60&api-version=2014-01</id>  
   <title type="text">$Default</title>  
   <published>2015-09-09T20:31:00Z</published>  
   <updated>2015-09-09T21:16:12Z</updated>  
   <link rel="self" href="sb://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$default?timeout=60&api-version=2014-01" />  
   <content type="application/xml">  
      <ConsumerGroupDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
         <CreatedAt>2015-09-09T20:31:00.4479782</CreatedAt>  
         <UpdatedAt>2015-09-09T21:16:12.0432889</UpdatedAt>  
      </ConsumerGroupDescription>  
   </content>  
</entry>