Перечисление групп потребителей
Извлекает все группы потребителей, связанные с указанным концентратором событий. См . раздел Свойства ConsumerGroupDescription.
Запрос
Метод | Универсальный код ресурса (URI) запроса |
---|---|
GET | https://{servicebusNamespace}.servicebus.windows.net/{eventHubPath}/consumergroups |
Заголовки запросов
Заголовки и параметры, используемые всеми запросами, связанными с Центрами событий, см. в разделе Общие параметры и заголовки .
Ответ
Ответ включает код состояния 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?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 OK
Content-Type: application/atom+xml;type=feed;charset=utf-8
Server: Microsoft-HTTPAPI/2.0
Date: Fri, 19 Feb 2016 01:40:40 GMT
Content-Length: 1179
<?xml version="1.0" encoding="UTF-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
<title type="text">ConsumerGroups</title>
<id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01</id>
<updated>2016-02-19T01:40:41Z</updated>
<link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01" />
<entry xml:base="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups?timeout=60&api-version=2014-01">
<id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/$Default?api-version=2014-01</id>
<title type="text">$Default</title>
<published>2015-09-09T20:31:00Z</published>
<updated>2015-09-09T20:31:00Z</updated>
<link rel="self" href="consumergroups/$Default?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-09T20:31:00.4479782</UpdatedAt>
</ConsumerGroupDescription>
</content>
</entry>
</feed>