Vytvoření skupiny uživatelů

Článek
02/07/2024

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>

Sdílet prostřednictvím