Skapa en meddelandehubb

Artikel
05/26/2023

Skapar en ny meddelandehubb som innehåller autentiseringsuppgifter för plattformsmeddelandetjänster som stöds (WNS, APNS, GCM).

Förfrågan

Metod	URI för förfrågan	HTTP-version
PUT	`https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01`	HTTP/1.1

Begärandehuvuden

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
Content-Type	`application/xml;type=entry;charset=utf-8`
Auktorisering	SAS-token som genereras enligt specifikationen i Signaturautentisering för delad åtkomst med Service Bus.
x-ms-version	2015-01

Begärandetext

Begärandetexten innehåller en Atom-post med ett NotificationHubDescription-element. Exempel:

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

Slutpunktsegenskapen för ApnsCredential kan vara antingen gateway.push.apple.com (för produktionsservrar) eller gateway.sandbox.push.apple.com (för sandbox-servrar).

Alla underordnade element i NotificationHubDescription är valfria.

WNS-, APNS- och GCM-autentiseringsuppgifterna måste innehålla alla egenskaper som visas ovan. MPNS-autentiseringsuppgifter kan inte heller innehålla några egenskaper som aktiverar oautentiserad push-överföring för MPNS.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod och en uppsättning svarshuvuden.

Svarskoder

Kod	Description
201	Meddelandeavsnittet har skapats.
400	Ogiltig begärandetext. Det gick inte att skapa meddelandeavsnittet eftersom begäran var felaktig (eller verifieringen misslyckades).
401	Auktoriseringsfel. Åtkomstnyckeln var felaktig.
403	Kvoten har överskridits. för många meddelandehubbar i det här namnområdet. Meddelandehubben har inte skapats.
409	Noden innehåller redan en annan entitet.

Information om statuskoder finns i Status och Felkoder.

Svarshuvuden

Inga.

Själva svaret

Ett NotificationHubDescription-element med alla principer som definierats i den aktuella noden.

Dela via