Creare un gruppo di consumer

Articolo
02/07/2024

Crea un nuovo gruppo di consumer. Quando si crea un gruppo di consumer, è possibile specificare le proprietà seguenti in ConsumerGroupDescription. Se una proprietà non è specificata, Hub eventi usa il valore predefinito per tale proprietà. Vedere Proprietà ConsumerGroupDescription.

Valore predefinito delle proprietà ConsumerGroupDescription:

Nome proprietà	Default
`UserMetadata`	(vuoto)

Richiesta

Metodo	URI richiesta
PUT	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}`

Intestazioni richiesta

Vedere Parametri e intestazioni comuni per intestazioni e parametri usati da tutte le richieste correlate a Hub eventi.

Risposta

Nella risposta sono inclusi un codice di stato HTTP, un set di intestazioni per la risposta e il corpo di una risposta.

Nome dell'elemento	Obbligatoria	Tipo	Versione	Descrizione
`CreatedAt`	Sì, di sola lettura	string	2014-01	Ora esatta in cui è stato creato il gruppo di consumer.
`UpdatedAt`	Sì, di sola lettura	string	2014-01	Ora esatta dell'aggiornamento del gruppo di consumer.

Codici di risposta

Codice	Descrizione
201	Creazione riuscita.
400	Richiesta non valida.
401	Errore di autorizzazione.
403	Quota superata; il gruppo consumer non è stato creato.
409	Il gruppo di consumer specificato esiste già (o il percorso specificato è già occupato).
500	Errore interno.

Corpo della risposta

Se la richiesta ha esito positivo, il corpo della risposta contiene la descrizione del gruppo di consumer specificato. Se la richiesta non ha esito positivo, il corpo contiene un codice di errore e un messaggio di errore.

Esempio

Richiesta

Nota

È anche possibile usare un token di Azure Active Directory per l'intestazione Di autorizzazione come indicato nei parametri e nelle intestazioni comuni. Ad esempio: 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>

Response.

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>

Condividi tramite