Criar grupo de consumidores

Artigo
02/03/2024

Cria um novo grupo de consumidores. Ao criar um grupo de consumidores, você pode especificar as propriedades a seguir em ConsumerGroupDescription. Se uma propriedade não for especificada, os Hubs de Eventos usarão o valor padrão para essa propriedade. Consulte Propriedades ConsumerGroupDescription.

Valor padrão das propriedades ConsumerGroupDescription:

Nome da propriedade	Padrão
`UserMetadata`	(vazio)

Solicitação

Método	URI da solicitação
PUT	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}`

Cabeçalhos de solicitação

Confira Parâmetros e cabeçalhos comuns para cabeçalhos e parâmetros usados por todas as solicitações relacionadas aos Hubs de Eventos.

Resposta

A resposta inclui um código de status HTTP, um conjunto de cabeçalhos de resposta e um corpo de resposta.

Nome do elemento	Obrigatório	Tipo	Versão	Descrição
`CreatedAt`	Sim, somente leitura	string	2014-01	A hora exata em que o grupo de consumidores foi criado.
`UpdatedAt`	Sim, somente leitura	string	2014-01	A hora exata em que o grupo de consumidores foi atualizado.

Códigos de resposta

Código	Descrição
201	Criado.
400	Solicitação inválida.
401	Falha de autorização.
403	Cota excedida; grupo de consumidores não criado.
409	O grupo de consumidores especificado já existe (ou o caminho especificado já está ocupado).
500	Erro interno.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá a descrição do grupo de consumidores especificado. Se a solicitação não for bem-sucedida, o corpo conterá um código de erro e uma mensagem de erro.

Exemplos

Solicitação

Observação

Você também pode usar um token do Azure Active Directory para o cabeçalho De autorização , conforme observado nos cabeçalhos e parâmetros comuns. Por exemplo: 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>

Resposta

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>

Compartilhar via