Získání skupiny uživatelů
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>