Tworzenie centrum powiadomień

Tworzy nowe centrum powiadomień, które zawiera poświadczenia dla obsługiwanych usług powiadomień platformy (WNS, APNS, GCM).

Żądanie

Metoda	Identyfikator URI żądania	Wersja PROTOKOŁU HTTP
PUT	https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01	HTTP/1.1

Nagłówki żądań

W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.

Nagłówek żądania	Opis
Content-Type	application/xml;type=entry;charset=utf-8
Autoryzacja	Token SAS wygenerowany zgodnie z określoną w artykule Uwierzytelnianie za pomocą sygnatury dostępu współdzielonego za pomocą usługi Service Bus.
x-ms-version	2015-01

Treść żądania

Treść żądania zawiera wpis Atom z elementem NotificationHubDescription. Na przykład:

<?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="http://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>

Właściwość punktu końcowego apnsCredential może być gateway.push.apple.com (dla serwerów produkcyjnych) lub gateway.sandbox.push.apple.com (dla serwerów piaskownicy).

Wszystkie elementy podrzędne elementu NotificationHubDescription są opcjonalne.

Poświadczenia usług WNS, APNS i GCM muszą zawierać wszystkie właściwości pokazane powyżej. Poświadczenia MPNS nie mogą również zawierać żadnych właściwości, które umożliwiają nieuwierzytelnione wypychanie do sieci MPNS.

Reakcja

Odpowiedź zawiera kod stanu HTTP i zestaw nagłówków odpowiedzi.

Kody odpowiedzi

Kod	Opis
201	Pomyślnie utworzono temat powiadomień.
400	Nieprawidłowa treść żądania. Nie można utworzyć tematu powiadomień, ponieważ żądanie zostało nieprawidłowo sformułowane (lub walidacja nie powiodła się).
401	Niepowodzenie autoryzacji. Klucz dostępu był niepoprawny.
403	Przekroczono limit przydziału; zbyt wiele centrów powiadomień w tej przestrzeni nazw. Centrum powiadomień nie zostało utworzone.
409	Węzeł zawiera już inną jednostkę.

Aby uzyskać informacje o kodach stanu, zobacz Status and Error Codes (Kody stanu i błędów).

Nagłówki odpowiedzi

Brak.

Treść odpowiedzi

Element NotificationHubDescription ze wszystkimi zasadami zdefiniowanymi w bieżącym węźle.