通知ハブを作成する

  • [アーティクル]

新しい通知ハブを作成します。これには、サポートされるプラットフォーム通知サービス (WNS、APNS、GCM) の資格情報が含まれます。

Request

Method 要求 URI HTTP バージョン
PUT https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01 HTTP/1.1

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
Content-Type application/xml;type=entry;charset=utf-8
承認 Service Bus を使用した Shared Access Signature Authentication で指定されたとおりに生成された SAS トークン。
x-ms-version 2015-01

要求本文

要求本文には、NotificationHubDescription 要素を含む Atom エントリが含まれています。 次に例を示します。

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

ApnsCredential の endpoint プロパティには、(運用サーバーの場合) または gateway.sandbox.push.apple.com (サンドボックス サーバーの場合) のいずれかをgateway.push.apple.com指定できます。

NotificationHubDescription のすべての子要素は省略可能です。

WNS、APNS、GCM の資格情報には、上記のすべてのプロパティが含まれている必要があります。 MPNS 資格情報には、MPNS の認証されていないプッシュを有効にするプロパティを含めることもできます。

Response

応答には、HTTP 状態コードおよび一連の応答ヘッダーが含まれています。

応答コード

コード 説明
201 通知トピックは正常に作成されました。
400 要求本文が無効。 要求の形式が正しくない (または検証に失敗した) ため、通知トピックを作成できませんでした。
401 認証エラー。 アクセス キーが正しくありませんでした。
403 クォータを超過しました。この名前空間にある通知ハブが多すぎます。 通知ハブが作成されません。
409 ノードには既に別のエンティティが含まれています。

状態コードの詳細については、「 状態コードとエラー コード」を参照してください。

応答ヘッダー

[なし] :

応答本文

現在のノードで定義されているすべてのポリシーを含む NotificationHubDescription 要素。