Создание или обновление регистрации
Создает или обновляет регистрацию в указанном расположении.
Запрос
Метод | Универсальный код ресурса (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, как показано в разделе Создание регистрации.