Erstellen einer Consumergruppe

Artikel
02/03/2024

Erstellt eine neue Consumergruppe. Beim Erstellen einer Consumergruppe können Sie die folgenden Eigenschaften in ConsumerGroupDescription angeben. Wenn keine Eigenschaft angegeben wird, verwendet Event Hubs den Standardwert für diese Eigenschaft. Weitere Informationen finden Sie unter ConsumerGroupDescription-Eigenschaften.

Standardwert der ConsumerGroupDescription-Eigenschaften:

Eigenschaftenname	Standard
`UserMetadata`	(leer)

Anforderung

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

Anforderungsheader

Weitere Informationen finden Sie unter Allgemeine Parameter und Header für Header und Parameter, die von allen Anforderungen im Zusammenhang mit Event Hubs verwendet werden.

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
201	Erstellt.
400	Ungültige Anforderung.
401	Autorisierungsfehler
403	Kontingent überschritten; Consumergruppe nicht erstellt.
409	Die angegebene Consumergruppe ist bereits vorhanden (oder der angegebene Pfad ist bereits belegt).
500	Interner Fehler.

Antworttext

Wenn die Anforderung erfolgreich ist, enthält der Antworttext die Beschreibung der angegebenen Consumergruppe. Wenn die Anforderung nicht erfolgreich ist, enthält der Text einen Fehlercode und eine Fehlermeldung.

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>.

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>

Antwort

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>

Freigeben über