Ottenere il gruppo di consumer

Articolo
07/19/2023

Recupera tutti i metadati associati al gruppo di consumer specificato. Vedere Proprietà ConsumerGroupDescription.

Richiesta

Metodo	URI richiesta
GET	`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
200	Operazione completata.
401	Errore di autorizzazione.
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 ha esito negativo, 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>.

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

Response.

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>

Condividi tramite