Auflisten von Consumergruppen

Artikel
07/19/2023

Ruft alle Consumergruppen ab, die dem angegebenen Event Hub zugeordnet sind. Weitere Informationen finden Sie unter ConsumerGroupDescription-Eigenschaften.

Anforderung

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

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.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Beschreibung aller Consumergruppen im angegebenen Event Hub. Wenn die Anforderung nicht erfolgreich ist, enthält der Text einen Fehlercode und eine Fehlermeldung.

Code	BESCHREIBUNG
200	Erfolg.
401	Autorisierungsfehler
500	Interner Fehler.

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?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 OK  
Content-Type: application/atom+xml;type=feed;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:40:40 GMT  
Content-Length: 1179  
  
<?xml version="1.0" encoding="UTF-8"?>  
<feed xmlns="http://www.w3.org/2005/Atom">  
   <title type="text">ConsumerGroups</title>  
   <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01</id>  
   <updated>2016-02-19T01:40:41Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01" />  
   <entry xml:base="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01">  
      <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default?api-version=2014-01</id>  
      <title type="text">$Default</title>  
      <published>2015-09-09T20:31:00Z</published>  
      <updated>2015-09-09T20:31:00Z</updated>  
      <link rel="self" href="consumergroups/$Default?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-09T20:31:00.4479782</UpdatedAt>  
         </ConsumerGroupDescription>  
      </content>  
   </entry>  
</feed>

Freigeben über