Создание группы потребителей

Статья
02/03/2024

Создает новую группу потребителей. При создании группы потребителей можно указать следующие свойства в ConsumerGroupDescription. Если свойство не указано, Центры событий используют значение по умолчанию для этого свойства. См . раздел Свойства ConsumerGroupDescription.

Значение по умолчанию свойства ConsumerGroupDescription:

Имя свойства	По умолчанию
`UserMetadata`	(пусто)

Запрос

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

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

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

Ответ

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

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

Коды ответов

Код	Описание
201	Создан.
400	Недопустимый запрос.
401	Ошибка авторизации.
403	Превышена квота; Группа потребителей не создана.
409	Указанная группа потребителей уже существует (или указанный путь уже занят).
500	Внутренняя ошибка.

Текст ответа

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

Примеры

Запрос

Примечание

Вы также можете использовать маркер Azure Active Directory для заголовка авторизации , как указано в разделе Общие параметры и заголовки. Например: Authorization: Bearer <Azure AD token>.

PUT https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?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  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <content type="application/xml">  
      <ConsumerGroupDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      </ConsumerGroupDescription>  
   </content>  
</entry>

Ответ

HTTP/1.1 201 Created  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Server: Microsoft-HTTPAPI/2.0  
Date: Fri, 19 Feb 2016 01:52:50 GMT  
Content-Length: 776  
  
<?xml version="1.0" encoding="UTF-8"?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
   <id>https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?timeout=60&api-version=2014-01</id>  
   <title type="text">testCG</title>  
   <published>2016-02-19T01:52:50Z</published>  
   <updated>2016-02-19T01:52:50Z</updated>  
   <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub/consumergroups/testCG?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>2016-02-19T01:52:50.570652Z</CreatedAt>  
         <UpdatedAt>2016-02-19T01:52:50.570652Z</UpdatedAt>  
      </ConsumerGroupDescription>  
   </content>  
</entry>

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