Creare hub di notifica
Data di pubblicazione: marzo 2016
Crea un nuovo hub notifiche, contenente le credenziali per i servizi di notifica tramite piattaforma supportati (WNS, APNS, GCM).
Richiesta
| Metodo | URI della richiesta | Versione HTTP |
|---|---|---|
| PUT | https://{Namespace}.ServiceBus.Windows.NET/{Notification Hub}? 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 |
|---|---|
| Content-Type | application/xml;type=entry;charset=utf-8 |
| 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
Il corpo della richiesta contiene una voce Atom con un elemento NotificationHubDescription, Ad esempio:
<?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>
Tenere presente che la proprietà relativa all'endpoint di ApnsCredential può essere impostata su "gateway.push.apple.com" per server di produzione oppure su "gateway.sandbox.push.apple.com" per server sandbox.
Tutti gli elementi figlio di NotificationHubDescription sono facoltativi.
Le credenziali WNS, APNS e GCM devono contenere tutte le proprietà indicate sopra. Le credenziali MPNS possono anche non contenere alcuna proprietà, i modo da consentire il push non autenticato per MPNS.
Risposta
Nella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.
Codici di risposta
| Codice | Descrizione |
|---|---|
| 201 | Argomento di notifica creato. |
| 400 | Corpo della richiesta non valido. Impossibile creare l'argomento di notifica perché il formato della richiesta non è corretto oppure la convalida non è riuscita. |
| 401 | Errore di autorizzazione. Chiave di accesso non corretta. |
| 403 | Quota superata. Troppi hub notifiche in questo spazio dei nomi. Hub notifiche non creato. |
| 409 | Il nodo contiene già un'altra entità. |
Per informazioni sui codici di stato, vedere Codici ed errori di stato.
Intestazioni della risposta
Nessuna.
Corpo della risposta
Elemento NotificationHubDescription con tutti i criteri definiti nel nodo corrente.