Criar um hub de notificação

Artigo
05/26/2023

Cria um novo hub de notificação, que contém credenciais para os Serviços de Notificação de Plataforma com suporte (WNS, APNS, GCM).

Solicitação

Método	URI da solicitação	Versão HTTP
PUT	`https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01`	HTTP/1.1

Cabeçalhos da solicitação

A tabela a seguir descreve os cabeçalhos de solicitação obrigatórios e opcionais.

Cabeçalho da solicitação	Descrição
Tipo de conteúdo	`application/xml;type=entry;charset=utf-8`
Autorização	Token SAS gerado conforme especificado na Autenticação de Assinatura de Acesso Compartilhado com o Barramento de Serviço.
x-ms-version	2015-01

Corpo da solicitação

O corpo da solicitação contém uma entrada Atom com um elemento NotificationHubDescription. Por exemplo:

<?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>

A propriedade de ponto de extremidade de ApnsCredential pode ser gateway.push.apple.com (para servidores de produção) ou gateway.sandbox.push.apple.com (para servidores de área restrita).

Todos os elementos filho de NotificationHubDescription são opcionais.

As credenciais WNS, APNS e GCM devem conter todas as propriedades mostradas acima. As credenciais do MPNS também não podem conter propriedades, que permitem push não autenticado para MPNS.

Resposta

A resposta inclui um código de status HTTP e um conjunto de cabeçalhos de resposta.

Códigos de resposta

Código	Descrição
201	Tópico de notificação criado com êxito.
400	Corpo da solicitação inválido. Não foi possível criar o tópico de notificação porque a solicitação foi malformada (ou a validação falhou).
401	Falha de autorização. A chave de acesso estava incorreta.
403	Cota excedida; muitos hubs de notificação neste namespace. Hub de notificação não criado.
409	O nó já contém outra entidade.

Para obter informações sobre status códigos, consulte Códigos de status e erro.

Cabeçalhos de resposta

Nenhum.

Corpo da resposta

Um elemento NotificationHubDescription com todas as políticas definidas no nó atual.

Share via