Een Notification Hub maken

Artikel
05/26/2023

Hiermee maakt u een nieuwe Notification Hub, die referenties bevat voor de ondersteunde Platform Notification Services (WNS, APNS, GCM).

Aanvraag

Methode	Aanvraag-URI	HTTP-versie
PUT	`https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01`	HTTP/1.1

Aanvraagheaders

In de volgende tabel worden vereiste en optionele aanvraagheaders beschreven.

Aanvraagheader	Beschrijving
Content-Type	`application/xml;type=entry;charset=utf-8`
Autorisatie	SAS-token gegenereerd zoals opgegeven in Shared Access Signature Authentication met Service Bus.
x-ms-version	2015-01

Aanvraagbody

De aanvraagbody bevat een Atom-vermelding met een NotificationHubDescription-element. Bijvoorbeeld:

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

De eindpunteigenschap van ApnsCredential kan ( gateway.push.apple.com voor productieservers) of gateway.sandbox.push.apple.com (voor sandbox-servers) zijn.

Alle onderliggende elementen van NotificationHubDescription zijn optioneel.

WNS-, APNS- en GCM-referenties moeten alle eigenschappen bevatten die hierboven worden weergegeven. MPNS-referenties kunnen ook geen eigenschappen bevatten, waardoor niet-geverifieerd pushen voor MPNS mogelijk is.

Antwoord

Het antwoord bevat een HTTP-statuscode en een set antwoordheaders.

Antwoordcodes

Code	Description
201	Meldingsonderwerp is gemaakt.
400	Ongeldige aanvraagbody. Het meldingsonderwerp kan niet worden gemaakt omdat de aanvraag onjuist is ingedeeld (of omdat de validatie is mislukt).
401	Autorisatiefout. De toegangssleutel is onjuist.
403	Quotum overschreden; te veel Notification Hubs in deze naamruimte. Notification Hub is niet gemaakt.
409	Het knooppunt bevat al een andere entiteit.

Zie Status- en foutcodes voor meer informatie over statuscodes.

Antwoordheaders

Geen.

Hoofdtekst van de reactie

Een NotificationHubDescription-element met alle beleidsregels die zijn gedefinieerd in het huidige knooppunt.

Delen via