Compartir a través de

Creación de un grupo de consumidores

  • Artículo

Crea un nuevo grupo de consumidores. Al crear un grupo de consumidores, puede especificar las siguientes propiedades en ConsumerGroupDescription. Si no se especifica una propiedad, Event Hubs usa el valor predeterminado para esa propiedad. Consulte Propiedades de ConsumerGroupDescription.

Valor predeterminado de ConsumerGroupDescription Properties:

Nombre de propiedad Valor predeterminado
UserMetadata (vacío)

Solicitud

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

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
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
201 Creado.
400 Solicitud incorrecta.
401 Error de autorización.
403 Cuota superada; grupo de consumidores no creado.
409 El grupo de consumidores especificado ya existe (o la ruta de acceso especificada ya está ocupada).
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 se realiza correctamente, 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>.

PUT https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?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  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <content type="application/xml">  
      <ConsumerGroupDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      </ConsumerGroupDescription>  
   </content>  
</entry>

Respuesta

HTTP/1.1 201 Created  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:52:50 GMT  
Content-Length: 776  
  
<?xml version="1.0" encoding="UTF-8"?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?timeout=60&api-version=2014-01</id>  
   <title type="text">testCG</title>  
   <published>2016-02-19T01:52:50Z</published>  
   <updated>2016-02-19T01:52:50Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?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>2016-02-19T01:52:50.570652Z</CreatedAt>  
         <UpdatedAt>2016-02-19T01:52:50.570652Z</UpdatedAt>  
      </ConsumerGroupDescription>  
   </content>  
</entry>