Tworzenie grupy odbiorców

Tworzy nową grupę odbiorców. Podczas tworzenia grupy odbiorców można określić następujące właściwości w sekcji ConsumerGroupDescription. Jeśli właściwość nie jest określona, usługa Event Hubs używa wartości domyślnej dla tej właściwości. Zobacz Właściwości consumerGroupDescription.

Wartość domyślna właściwości ConsumerGroupDescription:

Nazwa właściwości	Default
UserMetadata	(puste)

Żądanie

Metoda	Identyfikator URI żądania
PUT	https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}

Nagłówki żądań

Zobacz Typowe parametry i nagłówki nagłówków i parametrów , które są używane przez wszystkie żądania związane z usługą Event Hubs.

Reakcja

Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.

Nazwa elementu	Wymagany	Typ	Wersja	Opis
CreatedAt	Tak, tylko do odczytu	ciąg	2014-01	Dokładny czas utworzenia grupy odbiorców.
UpdatedAt	Tak, tylko do odczytu	ciąg	2014-01	Dokładny czas aktualizacji grupy odbiorców.

Kody odpowiedzi

Kod	Opis
201	Utworzone.
400	Nieprawidłowe żądanie.
401	Niepowodzenie autoryzacji.
403	Przekroczono limit przydziału; grupa odbiorców nie została utworzona.
409	Określona grupa odbiorców już istnieje (lub określona ścieżka jest już zajęta).
500	Błąd wewnętrzny.

Treść odpowiedzi

Jeśli żądanie zakończy się pomyślnie, treść odpowiedzi zawiera opis określonej grupy odbiorców. Jeśli żądanie nie powiedzie się, treść zawiera kod błędu i komunikat o błędzie.

Przykłady

Żądanie

Uwaga

Możesz również użyć tokenu usługi Azure Active Directory dla nagłówka autoryzacji , jak opisano w sekcji Common parameters and headers (Typowe parametry i nagłówki). Na przykład: 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>  
  

Odpowiedź

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>