Pobieranie grupy odbiorców

Artykuł
08/05/2023

Pobiera wszystkie metadane skojarzone z określoną grupą odbiorców. Zobacz Właściwości consumerGroupDescription.

Żądanie

Metoda	Identyfikator URI żądania
GET	`https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}`

Nagłówki żądań

Zobacz Typowe parametry i nagłówki dla nagłówków i parametrów używanych 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
200	Powodzenie.
401	Niepowodzenie autoryzacji.
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 artykule Common parameters and headers (Typowe parametry i nagłówki). Na przykład: 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

Odpowiedź

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>

Share via