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.