Vytvoření skupiny uživatelů

  • Článek

Vytvoří novou skupinu uživatelů. Při vytváření skupiny příjemců můžete v části ConsumerGroupDescription zadat následující vlastnosti. Pokud vlastnost není zadaná, použije služba Event Hubs pro tuto vlastnost výchozí hodnotu. Viz ConsumerGroupDescription – vlastnosti.

Výchozí hodnota ConsumerGroupDescription Properties:

Název vlastnosti Default
UserMetadata (prázdné)

Žádost

Metoda Identifikátor URI žádosti
PUT https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}

Hlavičky požadavku

Viz Běžné parametry a hlavičky pro hlavičky a parametry, které se používají ve všech požadavcích souvisejících se službou Event Hubs.

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Název elementu Požaduje se Typ Verze Popis
CreatedAt Ano, jen pro čtení řetězec 2014-01 Přesný čas vytvoření skupiny příjemců
UpdatedAt Ano, jen pro čtení řetězec 2014-01 Přesný čas, kdy byla skupina uživatelů aktualizována.

Kódy odpovědí

Kód Description
201 Vytvořen.
400 Chybný požadavek.
401 Autorizace se nezdařila.
403 Překročení kvóty; Skupina příjemců se nevytvořila.
409 Zadaná skupina příjemců již existuje (nebo je zadaná cesta již obsazená).
500 Vnitřní chyba.

Text odpovědi

Pokud je požadavek úspěšný, text odpovědi obsahuje popis zadané skupiny příjemců. Pokud požadavek není úspěšný, text obsahuje kód chyby a chybovou zprávu.

Příklady

Žádost

Poznámka

Můžete také použít token Azure Active Directory pro autorizační hlavičku, jak je uvedeno v části Běžné parametry a hlavičky. Příklad: 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 (Odpověď)

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>