Consumergruppe abrufen

Artikel
08/05/2023

Ruft alle Metadaten ab, die der angegebenen Consumergruppe zugeordnet sind. Weitere Informationen finden Sie unter ConsumerGroupDescription-Eigenschaften.

Anforderung

Methode	Anforderungs-URI
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}`

Anforderungsheader

Informationen zu Headern und Parametern, die von allen Anforderungen im Zusammenhang mit Event Hubs verwendet werden, finden Sie unter Allgemeine Parameter und Header .

Antwort

Die Antwort enthält den HTTP-Statuscode, einen Satz von Antwortheadern und einen Antworttext.

Elementname	Erforderlich	type	Version	BESCHREIBUNG
`CreatedAt`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Der genaue Zeitpunkt, zu dem die Consumergruppe erstellt wurde.
`UpdatedAt`	Ja, schreibgeschützt	Zeichenfolge	2014-01	Der genaue Zeitpunkt, zu dem die Consumergruppe aktualisiert wurde.

Antwortcodes

Code	BESCHREIBUNG
200	Erfolg.
401	Autorisierungsfehler
500	Interner Fehler.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Beschreibung der angegebenen Consumergruppe. Wenn die Anforderung nicht erfolgreich ausgeführt wird, enthält der Textkörper einen Fehlercode und eine Fehlernachricht.

Beispiele

Anforderung

Hinweis

Sie können auch ein Azure Active Directory-Token für den Autorisierungsheader verwenden, wie in den allgemeinen Parametern und Headern angegeben. Beispiel: 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

Antwort

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>

Freigeben über