Обновление узла уведомлений

Статья
07/19/2023

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

Свойства

Имя свойства	Доступно с версии API	По умолчанию	Описание свойства
MessageRetentionInDays	2014-01	0	MessageRetentionInDays

Запрос

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

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

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

Дополнительные заголовки запросов

Заголовок запроса	Обязательный или необязательный	Описание
If-Match	Обязательно	Задайте для этого заголовка значение "*", чтобы обновить концентратор событий. Необходимо указать все необходимые значения свойств в обновленном концентраторе событий; Для всех не указанных значений устанавливаются значения службы по умолчанию. Если этот заголовок отсутствует, вызов обновления возвращает ошибку, указывающую на то, что этот концентратор событий уже существует.

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

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

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

Ответ

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

Коды ответов

Код	Описание
200	Успешно.
400	Недопустимый запрос.
401	Ошибка авторизации.
409	Конфликт из-за отсутствия заголовка If-Match .
500	Внутренняя ошибка.

Текст ответа

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

Имя элемента	Описание
`AuthorizationRules`	Правила авторизации.
`MessageRetentionInDays`	Количество дней для хранения событий для этого концентратора событий.
`Status`	Текущее состояние концентратора событий (включено или отключено).
`CreatedAt`	Точное время создания концентратора событий.
`UpdatedAt`	Точное время обновления концентратора событий.
`PartitionCount`	Текущее количество секций в концентраторе событий.
`PartitionIds`	Идентификаторы секций, созданных для концентратора событий.

Примеры

Запрос

Примечание

Вы также можете использовать маркер 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
If-Match: *
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">  
      <MessageRetentionInDays>3</MessageRetentionInDays>  
    </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>  
    </EventHubDescription>  
  </content>  
</entry>