Získání skupiny uživatelů

  • Článek

Načte všechna metadata přidružená k zadané skupině příjemců. Viz ConsumerGroupDescription – vlastnosti.

Žádost

Metoda Identifikátor URI žádosti
GET 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é používají všechny požadavky související 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 příjemců aktualizována.

Kódy odpovědí

Kód Description
200 Úspěch.
401 Chyba autorizace.
500 Vnitřní chyba.

Text odpovědi

Pokud je požadavek úspěšný, tělo odpovědi obsahuje popis zadané skupiny příjemců. Pokud požadavek není úspěšný, tělo 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>.

GET https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$default?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

Response (Odpověď)

HTTP/1.1 200 Created  
Transfer-Encoding: chunked  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Wed, 25 Jun 2014 22:43:27 GMT  
  
HTTP/1.1 200 OK  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:40:20 GMT  
Content-Length: 776  
  
<?xml version="1.0" encoding="UTF-8"?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <id>sb://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$default?timeout=60&api-version=2014-01</id>  
   <title type="text">$Default</title>  
   <published>2015-09-09T20:31:00Z</published>  
   <updated>2015-09-09T21:16:12Z</updated>  
   <link rel="self" href="sb://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$default?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>2015-09-09T20:31:00.4479782</CreatedAt>  
         <UpdatedAt>2015-09-09T21:16:12.0432889</UpdatedAt>  
      </ConsumerGroupDescription>  
   </content>  
</entry>