Udostępnij za pośrednictwem

Tworzenie grupy odbiorców

  • Artykuł

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>