Értesítési központ létrehozása

Létrehoz egy új értesítési központot, amely a támogatott platformértesítési szolgáltatások (WNS, APNS, GCM) hitelesítő adatait tartalmazza.

Kérés

Metódus	Kérés URI-ja	HTTP-verzió
PUT	https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01	HTTP/1.1

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
Content-Type	application/xml;type=entry;charset=utf-8
Engedélyezés	A Service Bus közös hozzáférésű jogosultságkód-hitelesítésében megadottak szerint létrehozott SAS-jogkivonat.
x-ms-version	2015-01

A kérés törzse

A kérelemtörzs egy NotificationHubDescription elemet tartalmazó Atom-bejegyzést tartalmaz. Például:

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

Az ApnsCredential végponttulajdonsága lehet gateway.push.apple.com (éles kiszolgálók esetén) vagy gateway.sandbox.push.apple.com (tesztkörnyezeti kiszolgálók esetében).

A NotificationHubDescription összes gyermekeleme nem kötelező.

A WNS, az APNS és a GCM hitelesítő adatainak tartalmazniuk kell a fent látható összes tulajdonságot. Az MPNS hitelesítő adatai nem tartalmazhatnak tulajdonságokat, amelyek lehetővé teszik a hitelesítés nélküli leküldést az MPNS-hez.

Reagálás

A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.

Válaszkódok

Code	Description
201	Az értesítési témakör létrehozása sikerült.
400	Érvénytelen kérelemtörzs. Az értesítési témakör nem hozható létre, mert a kérés helytelen formátumú (vagy az érvényesítés sikertelen volt).
401	Engedélyezési hiba. A hozzáférési kulcs helytelen volt.
403	Kvóta túllépve; túl sok értesítési központ található ebben a névtérben. Az értesítési központ nem jött létre.
409	A csomópont már tartalmaz egy másik entitást.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

Nincsenek.

Választörzs

Egy NotificationHubDescription elem az aktuális csomópontban definiált összes szabályzattal.