Получение группы потребителей

  • Статья

Извлекает все метаданные, связанные с указанной группой потребителей. См. раздел Свойства ConsumerGroupDescription.

Запрос

Метод Универсальный код ресурса (URI) запроса
GET https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups/{consumergroupName}

Заголовки запросов

Заголовки и параметры, используемые всеми запросами, связанными с Центрами событий, см. в разделе Общие параметры и заголовки .

Ответ

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Имя элемента Обязательно Тип Версия Описание
CreatedAt Да, только для чтения строка 2014-01 Точное время создания группы потребителей.
UpdatedAt Да, только для чтения строка 2014-01 Точное время обновления группы потребителей.

Коды ответов

Код Описание
200 Успешно.
401 Ошибка авторизации.
500 Внутренняя ошибка.

Текст ответа

Если запрос выполнен успешно, текст ответа содержит описание указанной группы потребителей. Если запрос выполнен неудачно, в ответе содержится код ошибки и текст сообщения об ошибке.

Примеры

Запрос

Примечание

Вы также можете использовать маркер Azure Active Directory для заголовка авторизации , как указано в разделе Общие параметры и заголовки. Например: 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

Ответ

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>