Creare o aggiornare le credenziali PNS dello spazio dei nomi

Articolo
11/18/2016

Il livello di spazio dei nomi Push Notification Services (PNS) API sono progettati per le applicazioni di grandi dimensioni che si estendono su più hub. Consentono agli sviluppatori di facilmente leggere e aggiornare le impostazioni di PNS unificate per gli hub più sotto lo stesso spazio dei nomi in una sola volta. Quando le credenziali PNS sono state impostate a livello di spazio dei nomi utilizzando questo endpoint, tutti gli hub dello spazio dei nomi utilizzerà le credenziali fornite con le impostazioni dello spazio dei nomi. Creazioni di hub dello spazio dei nomi con le credenziali PNS non è consentite.

In questo argomento è un riferimento per impostare le credenziali PNS unificate per uno spazio dei nomi. Quando le credenziali PNS sono impostate a livello di hub prima, l'endpoint non sarà disponibile.

Richiesta

Metodo	URI della richiesta	Versione HTTP
PUT	https://Management.Core.Windows.NET/ {ID sottoscrizione} / services/ServiceBus/Namespaces / {spazio dei nomi} /NotificationHubPnsCredentials/? 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
Autorizzazione	Token generato come specificato nell'autenticazione della firma di accesso condiviso con Bus di servizio oppure nell'autenticazione e nell'autorizzazione di Bus di servizio con Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o ACS).
x-ms-version	2015-01

Corpo della richiesta

Credenziali XML da utilizzare per tutti gli hub di notifica dello spazio dei nomi.

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

Risposta

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

Codici di risposta

Codice	Descrizione
200	Le credenziali impostate correttamente.
400	Corpo della richiesta non valido. Impossibile leggere le impostazioni perché la richiesta non valida (o la convalida non riuscita).
401	Errore di autorizzazione. Chiave di accesso non corretta.
403	Quota superata.
404	Spazio dei nomi non trovato.

Per informazioni sui codici di stato, vedere Codici ed errori di stato.

Intestazioni della risposta

Nessuna.

Corpo della risposta