Creare un hub di notifica

Articolo
05/26/2023

Crea un nuovo hub di notifica, che contiene le credenziali per i servizi di notifica della piattaforma supportati (WNS, APNS, GCM).

Richiesta

Metodo	URI richiesta	Versione HTTP
PUT	`https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01`	HTTP/1.1

Intestazioni della richiesta

Nella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.

Intestazione della richiesta	Descrizione
Content-Type	`application/xml;type=entry;charset=utf-8`
Autorizzazione	Token di firma di accesso condiviso generato come specificato in Autenticazione della firma di accesso condiviso con il bus di servizio.
x-ms-version	2015-01

Testo della richiesta

Il corpo della richiesta contiene una voce Atom con un elemento NotificationHubDescription. Ad esempio:

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

La proprietà endpoint di ApnsCredential può essere gateway.push.apple.com (per i server di produzione) o gateway.sandbox.push.apple.com (per i server sandbox).

Tutti gli elementi figlio di NotificationHubDescription sono facoltativi.

Le credenziali WNS, APNS e GCM devono contenere tutte le proprietà illustrate in precedenza. Le credenziali MPNS possono anche non contenere proprietà, che abilitano il push non autenticato per MPNS.

Risposta

Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.

Codici di risposta

Codice	Descrizione
201	Argomento di notifica creato correttamente.
400	Corpo della richiesta non valido. Impossibile creare l'argomento di notifica perché la richiesta non è valida o la convalida non è riuscita.
401	Errore di autorizzazione. La chiave di accesso non è corretta.
403	Quota superata; Troppi hub di notifica in questo spazio dei nomi. Hub di notifica non creato.
409	Il nodo contiene già un'altra entità.

Per informazioni sui codici di stato, vedere Codici di stato e di errore.

Intestazioni di risposta

Nessuno.

Corpo della risposta

Elemento NotificationHubDescription con tutti i criteri definiti nel nodo corrente.

Share via