Erstellen eines Notification Hubs

Artikel
05/26/2023

Erstellt einen neuen Notification Hub, der Anmeldeinformationen für die unterstützten Platform Notification Services (WNS, APNS, GCM) enthält.

Anforderung

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

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	BESCHREIBUNG
Content-Type	`application/xml;type=entry;charset=utf-8`
Authorization	SAS-Token generiert, wie in Shared Access Signature Authentication with Service Bus angegeben.
x-ms-version	2015-01

Anforderungstext

Der Anforderungstext enthält einen Atom-Eintrag mit einem NotificationHubDescription-Element. Zum Beispiel:

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

Die Endpunkteigenschaft von ApnsCredential kann entweder gateway.push.apple.com (für Produktionsserver) oder gateway.sandbox.push.apple.com (für Sandboxserver) sein.

Alle untergeordneten Elemente von NotificationHubDescription sind optional.

WNS-, APNS- und GCM-Anmeldeinformationen müssen alle oben gezeigten Eigenschaften enthalten. MPNS-Anmeldeinformationen können auch keine Eigenschaften enthalten, die nicht authentifizierte Pushvorgänge für MPNS ermöglichen.

Antwort

Die Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.

Antwortcodes

Code	BESCHREIBUNG
201	Das Benachrichtigungsthema wurde erfolgreich erstellt.
400	Ungültiger Anfragetext. Das Benachrichtigungsthema konnte nicht erstellt werden, weil die Anforderung falsch formatiert wurde (oder die Überprüfung fehlgeschlagen ist).
401	Autorisierungsfehler Der Zugriffsschlüssel war falsch.
403	Kontingent überschritten; zu viele Notification Hubs in diesem Namespace. Notification Hub nicht erstellt.
409	Der Knoten enthält bereits eine andere Entität.

Informationen zu status Codes finden Sie unter Status- und Fehlercodes.

Antwortheader

Keine

Antworttext

Ein NotificationHubDescription-Element mit allen Richtlinien, die im aktuellen Knoten definiert sind.

Freigeben über