Создание концентратора событий

Статья
07/19/2023

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

Свойства

В дополнение к перечисленным ниже свойствам можно указать дополнительные свойства, которые отображаются в описании концентратора событий, но игнорируются службой.

Указывать свойства требуется в нижеследующем порядке. Любое свойство, указанное вне порядка, интерпретируется как свойство пользователя. Это свойство будет отображаться дважды в описании концентратора событий: один раз со значением, заданным пользователем, и один раз со значением по умолчанию, которое используется Центрами событий.

Имя свойства	Доступно с версии API	Значение по умолчанию	Описание свойства
`MessageRetentionInDays`	2014-01	0	Описание
`Authorization`	2014-01	(пусто)	Описание
`Status`	2014-01	Активен	Описание
`UserMetadata`	2014-01	(пусто)	Описание
`PartitionCount`	2014-01	16	Описание

Запрос

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

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

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

Текст запроса

Запись Atom с описанием, внедренным в содержимое. Пример:

<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {EventHubDescription}  
  </content>  
</entry>

Ответ

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

Коды ответов

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

Текст ответа

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

Примеры

Запрос

Примечание

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

PUT https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=tYu8qdH563Pc96Lky0SFs5PhbGnljF7mLYQwCZmk9M0%3d&se=1403736877&skn=RootManageSharedAccessKey  
Content-Type: application/atom+xml;type=entry;charset=utf-8  
Host: your-namespace.servicebus.windows.net  
Content-Length: 264  
Expect: 100-continue  
Connection: Keep-Alive  
  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
    </EventHubDescription>  
  </content>  
</entry>

Ответ

HTTP/1.1 201 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  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
    <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01"/>  
  <content type="application/xml">  
    <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

Следующий запрос HTTP создает узел уведомлений с пользовательскими настройками:

PUT https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01 HTTP/1.1  
Authorization: SharedAccessSignature sr=your-namespace.servicebus.windows.net&sig=your-sas-key&se=1403736877&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'>  
    <EventHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
      <PartitionCount>8</PartitionCount>  
    </EventHubDescription>  
  </content>  
</entry>

Центры событий возвращают следующий ответ:

HTTP/1.1 201 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  
  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <id>https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01</id>  
  <title type="text">your-event-hub</title>  
  <published>2014-06-25T22:43:16Z</published>  
  <updated>2014-06-25T22:43:27Z</updated>  
  <author>  
    <name>your-namespace</name>  
  </author>  
  <link rel="self" href="https://your-namespace.servicebus.windows.net/your-event-hub?timeout=60&api-version=2014-01"/>  
  <content type="application/xml">  
    <EventHubDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">  
      <MessageRetentionInDays>3</MessageRetentionInDays>   
      <SizeInBytes>0</SizeInBytes>  
      <AuthorizationRules></AuthorizationRules>  
      <Status>Active</Status>  
      <PartitionCount>16</PartitionCount>  
      <EntityAvailabilityStatus>Available</EntityAvailabilityStatus>  
    </EventHubDescription>  
  </content>  
</entry>

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