Erstellen oder Aktualisieren von Namespace-PNS-Anmeldeinformationen

Artikel
11/18/2016

Veröffentlicht: Februar 2016

Namespace-Ebene Push Notification Services (PNS) APIs dienen für große apps, die über mehrere Hubs erstrecken. Sie können Entwickler einfach zu lesen und zu unified PNS-Einstellungen für mehrere Hubs unter dem gleichen Namespace gleichzeitig aktualisieren. Beim PNS-Anmeldeinformationen auf Namespaceebene, die mit diesem Endpunkt festgelegt wurden, werden alle Hubs im Namespace mit den Namespaceeinstellungen bereitgestellten Anmeldeinformationen verwenden. Hub-Objekten in den Namespace mit PNS-Anmeldeinformationen wird nicht zulässig.

Dieses Thema ist eine Referenz für die einheitlichen PNS-Anmeldeinformationen für einen Namespace festlegen. Wenn PNS-Anmeldeinformationen zuerst auf hubebene festgelegt sind, wird dieser Endpunkt nicht mehr verfügbar sein.

Anforderung

Methode	Anforderungs-URI	HTTP-Version
PUT	https://Management.Core.Windows.NET/ {Abonnement-ID} / Services/ServiceBus/Namespaces / {Namespacename} /NotificationHubPnsCredentials/? api-Version = 2015-01	HTTP/1.1

Anforderungsheader

In der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.

Anforderungsheader	Beschreibung
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

XML-Anmeldeinformationen für alle benachrichtigungshubs im Namespace verwendet werden soll.

<NotificationHubPnsCredentials 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> </NotificationHubPnsCredentials>

Antwort

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

Antwortcodes

Code	Beschreibung
200	Anmeldeinformationen festgelegt erfolgreich.
400	Ungültiger Anfragetext. Die Einstellung konnte nicht gelesen 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.
404	Namespace nicht gefunden.

Informationen zu Statuscodes finden Sie unter Status- und Fehlercodes.

Antwortheader

Keine.

Antworttext