Erstellen eines Benachrichtigungshubs
Veröffentlicht: Februar 2016
Erstellt einen neuen Benachrichtigungshub, der Anmeldeinformationen für die unterstützten Plattformbenachrichtigungsdienste (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 |
| Autorisierung | Gemäß der Shared Access Signature Authentifizierung mit generierte Token Servicebus, oder Servicebus Authentifizierung und Autorisierung über Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS). |
| x-ms-version | 2015-01 |
Anforderungstext
Der Anforderungstext enthält einen Atom-Eintrag mit einer NotificationHubDescription Element. 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="https://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>
Beachten Sie, dass der Endpoint-Eigenschaft des ApnsCredential kann entweder "gateway.push.apple.com" (für Produktionsserver) oder "gateway.sandbox.push.apple.com" (für sandkastenserver) sein.
Alle untergeordneten Elemente des NotificationHubDescription sind optional.
Die Anmeldeinformationen für WNS, APNS und GCM müssen alle oben genannten Eigenschaften enthalten. Anmeldeinformationen für MPNS können auch keine Eigenschaften enthalten. Dadurch wird der nicht authentifizierte Push für MPNS ermöglicht.
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 war (oder ein Überprüfungsfehler aufgetreten ist). |
| 401 | Autorisierungsfehler Der Zugriffsschlüssel war falsch. |
| 403 | Das Kontingent wurde überschritten. Es sind zu viele Benachrichtigungshubs in diesem Namespace vorhanden. Der Benachrichtigungshub wurde nicht erstellt. |
| 409 | Der Knoten enthält bereits eine andere Entität. |
Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.
Antwortheader
Keine.
Antworttext
Ein NotificationHubDescription -Element mit allen im aktuellen Knoten definierten Richtlinien.