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

Статья
08/05/2023

Извлекает все метаданные, связанные с указанной группой потребителей. См. раздел Свойства 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>

Поделиться через