Leggere le credenziali PNS dello spazio dei nomi
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. Quando le credenziali PNS sono impostate a livello di hub prima, l'endpoint non sarà disponibile.
In questo argomento è un riferimento per ottenere 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 |
|---|---|---|
| GET | 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
Nessuna.
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codici di risposta
| Codice | Descrizione |
|---|---|
| 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
Oggetto NotificationHubPnsCredentials elemento che definisce le credenziali per tutti gli hub 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>
Vedere anche
Creare o aggiornare le credenziali PNS dello spazio dei nomi
Metodi delle API REST