Sdílet prostřednictvím


Vytvoříte centrum oznámení.

Vytvoří nové centrum oznámení, které obsahuje přihlašovací údaje pro podporovanou službu Oznámení platformy (WNS, APNS, GCM).

Žádost

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01 HTTP/1.1

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Typ obsahu application/xml;type=entry;charset=utf-8
Autorizace Token SAS vygenerovaný podle specifikace v části Ověřování pomocí sdíleného přístupového podpisu pomocí služby Service Bus.
x-ms-version 2015-01

Text požadavku

Text požadavku obsahuje položku Atom s elementem NotificationHubDescription. Příklad:

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

Vlastnost koncového bodu ApnsCredential může být buď gateway.push.apple.com (pro produkční servery), nebo gateway.sandbox.push.apple.com (pro servery sandboxu).

Všechny podřízené elementy NotificationHubDescription jsou volitelné.

Přihlašovací údaje WNS, APNS a GCM musí obsahovat všechny vlastnosti uvedené výše. Přihlašovací údaje MPNS také můžou obsahovat žádné vlastnosti, které umožňují neověřené nabízení pro MPNS.

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Kódy odpovědí

Kód Popis
201 Téma oznámení se úspěšně vytvořilo.
400 Neplatný text požadavku. Téma oznámení nebylo možné vytvořit, protože požadavek byl poškozený (nebo se ověření nezdařilo).
401 Autorizace se nezdařila. Přístupový klíč byl nesprávný.
403 Překročení kvóty; příliš mnoho center oznámení v tomto oboru názvů. Centrum oznámení se nevytvořilo.
409 Uzel již obsahuje jinou entitu.

Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Žádné

Text odpovědi

Prvek NotificationHubDescription se všemi zásadami definovanými v aktuálním uzlu.