Создание или обновление сущности

  • Статья

Создает или обновляет сущность обмена сообщениями.

Запрос

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

Путь к сущности может быть несколькими сегментами с сегментами, разделенными "/". Весь путь составляет имя сущностей. Несколько сущностей могут совместно использовать одни и те же сегменты префикса.

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

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

Заголовок запроса Описание
Авторизация Указывает маркер подписанного URL-адреса (SAS) с правами "Управление". Дополнительные сведения см. в статье Проверка подлинности служебной шины с помощью подписанных URL-адресов .
Content-Type Задано значение application/atom+xml;type=entry;charset=utf-8.
If-Match Установите данный заголовок как "*" для обновления сущности. Необходимо указать все значения свойств, которые являются необходимыми для обновленной сущности. Не заданные значения получат значения по умолчанию для службы. Если данный заголовок отсутствует, вызов обновления возвращает ошибку, указывающую, что данная сущность уже существует.

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

Текст запроса должен содержать допустимую xml-запись Atom, которая внедряет описание создаваемой сущности.

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns='http://www.w3.org/2005/Atom'>  
  <content type='application/xml'>  
    {description}  
  </content>  
</entry>

При этом {description} описывает очередь или раздел для сущностей верхнего уровня, а также подписку или правило относительно их родительских сущностей.

Например, очередь описывается с помощью QueueDescription элемента . Поэтому полезные данные XML для создания или обновления очереди могут принимать следующую форму, при которой все опущенные свойства принимают значения по умолчанию:

<?xml version="1.0" encoding="utf-8" ?>  
<entry xmlns="http://www.w3.org/2005/Atom">  
  <content type="application/xml">  
    <QueueDescription xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
       <LockDuration>T1M</LockDuration>
    </QueueDescription>
  </content>  
</entry>

Дополнительные сведения о сущностях и их связи с путями см. в разделе Обзор .

Ответ

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

Коды ответов

Примечание

При обновлении сущности с именем, содержащим специальные или закодированные символы (например, "test? Name=value&"), которое кодируется в test%3FName%3Dvalue%26), будет создано неавторизованное исключение (401).

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

Дополнительные сведения о кодах состояния см. в разделе Коды состояния и ошибок.

Заголовки откликов

Нет.

Текст ответа

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