Создание концентратора уведомлений

Статья
05/26/2023

Создает новый центр уведомлений, содержащий учетные данные для поддерживаемых служб уведомлений платформы (WNS, APNS, GCM).

Запрос

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

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

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

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

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

Текст запроса содержит запись Atom с элементом NotificationHubDescription. Пример:

<?xml version="1.0" encoding="utf-8"?>
<entry xmlns="http://www.w3.org/2005/Atom">
<content type="application/xml">
    <NotificationHubDescription xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.microsoft.com/netservices/2010/10/servicebus/connect">
        <ApnsCredential>
            <Properties>
                <Property>
                    <Name>Endpoint</Name> 
                    <Value>gateway.push.apple.com</Value> 
                </Property>
                <Property>
                    <Name>ApnsCertificate</Name> 
                    <Value>{APNS certificate in Base64}</Value> 
                </Property>
                <Property>
                    <Name>CertificateKey</Name> 
                    <Value>{APNS certificate key}</Value> 
                </Property>
            </Properties>
        </ApnsCredential>
        <RegistrationTtl>P39D</RegistrationTtl> 
        <WnsCredential>
            <Properties>
                <Property>
                    <Name>PackageSid</Name> 
                    <Value>{PackageSid}</Value> 
                </Property>
                <Property>
                    <Name>SecretKey</Name> 
                    <Value>{SecretKey}</Value> 
                </Property>
            </Properties>
        </WnsCredential>
        <GcmCredential>
            <Properties>
                <Property>
                    <Name>GoogleApiKey</Name> 
                    <Value>{ApiKey}</Value> 
                </Property>
            </Properties>
        </GcmCredential>
        <MpnsCredential>
            <Properties>
                <Property>
                    <Name>MpnsCertificate</Name> 
                    <Value>{MPNS certificate in Base64}</Value> 
                </Property>
                <Property>
                    <Name>CertificateKey</Name> 
                    <Value>{MPNS certificate key}</Value> 
                </Property>
            </Properties>
        </MpnsCredential>
    </NotificationHubDescription>
</content></entry>

Свойство конечной точки ApnsCredential может иметь значение gateway.push.apple.com (для рабочих серверов) или gateway.sandbox.push.apple.com (для серверов песочницы).

Все дочерние элементы NotificationHubDescription являются необязательными.

Учетные данные WNS, APNS и GCM должны содержать все свойства, показанные выше. Учетные данные MPNS также не могут содержать свойств, которые обеспечивают отправку mpNS без проверки подлинности.

Ответ

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

Коды ответов

Код	Описание
201	Раздел уведомлений успешно создан.
400	Недопустимый текст запроса. Не удалось создать раздел уведомлений, так как запрос был сформирован неправильно (или не удалось выполнить проверку).
401	Ошибка авторизации. Неправильный ключ доступа.
403	Превышена квота; слишком много центров уведомлений в этом пространстве имен. Центр уведомлений не создан.
409	Узел уже содержит другую сущность.

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

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

Нет.

Текст ответа

Элемент NotificationHubDescription со всеми политиками, определенными в текущем узле.

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