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


Создание или обновление регистрации

Создает или обновляет регистрацию в указанном расположении.

Запрос

Метод Универсальный код ресурса (URI) запроса параметр "Версия HTTP"
PUT https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>?api-version=2015-01 HTTP/1.1

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

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

Заголовок запроса Описание
Content-Type application/atom+xml;type=entry;charset=utf-8
Авторизация Маркер SAS создается, как указано в разделе Проверка подлинности подписанного URL-адреса с помощью служебной шины.
x-ms-version 2015-01

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

Запись Atom с описанием, внедренным в содержимое, как в разделе Создание регистрации.

Ответ

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

Коды ответов

Код Описание
201 Регистрация успешно обновлена.
400 Недопустимый текст запроса. Не удалось создать регистрацию, так как запрос был сформирован неправильно.
401 Ошибка авторизации. Неправильный ключ доступа.
403 Превышена квота; слишком много регистраций в этом пространстве имен. Регистрация не создана.
404 В этом расположении нет центра уведомлений.
409 Запрос отклонен, так как частота операций регистрации слишком высока.
410 Не удается использовать указанное расположение. Используйте другой идентификатор регистрации.

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

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

Заголовок ответа Описание
Content-type application/atom+xml;type=entry;charset=utf-8
ETag {weak ETag}

Текст ответа

После успешного выполнения возвращается проверенная запись Atom, как показано в разделе Создание регистрации.