Een consumentengroep maken

Hiermee maakt u een nieuwe consumentengroep. Wanneer u een consumentengroep maakt, kunt u de volgende eigenschappen opgeven in ConsumerGroupDescription. Als er geen eigenschap is opgegeven, gebruikt Event Hubs de standaardwaarde voor die eigenschap. Zie ConsumerGroupDescription Properties (Eigenschappen van ConsumerGroupDescription).

Standaardwaarde van ConsumerGroupDescription Properties:

Eigenschapsnaam	Standaard
UserMetadata	(leeg)

Aanvraag

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

Aanvraagheaders

Zie Algemene parameters en headers voor headers en parameters die worden gebruikt door alle aanvragen met betrekking tot Event Hubs.

Antwoord

Het antwoord bevat een HTTP-statuscode, een set antwoordheaders en een antwoordtekst.

Elementnaam	Vereist	Type	Versie	Beschrijving
CreatedAt	Ja, alleen-lezen	tekenreeks	2014-01	De exacte tijd waarop de consumentengroep is gemaakt.
UpdatedAt	Ja, alleen-lezen	tekenreeks	2014-01	De exacte tijd waarop de consumentengroep is bijgewerkt.

Antwoordcodes

Code	Description
201	Gemaakt.
400	Ongeldige aanvraag.
401	Autorisatiefout.
403	Quotum overschreden; consumentengroep niet gemaakt.
409	De opgegeven consumentengroep bestaat al (of het opgegeven pad is al bezet).
500	Interne fout.

Hoofdtekst van antwoord

Als de aanvraag is geslaagd, bevat de hoofdtekst van het antwoord de beschrijving van de opgegeven consumentengroep. Als de aanvraag niet is geslaagd, bevat de hoofdtekst een foutcode en een foutbericht.

Voorbeelden

Aanvraag

Notitie

U kunt ook een Azure Active Directory-token gebruiken voor de autorisatieheader , zoals vermeld in de Algemene parameters en headers. Bijvoorbeeld: 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>