알림 허브 만들기

아티클
05/26/2023

지원되는 플랫폼 알림 서비스(WNS, APNS, GCM)용 자격 증명을 포함하는 새 알림 허브를 만듭니다.

요청

메서드	요청 URI	HTTP 버전
PUT	`https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01`	HTTP/1.1

요청 헤더

다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.

요청 헤더	Description
콘텐츠 형식	`application/xml;type=entry;charset=utf-8`
권한 부여	Service Bus를 사용한 공유 액세스 서명 인증에 지정된 대로 생성된 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의 엔드포인트 속성은 (프로덕션 서버의 경우) 또는 gateway.sandbox.push.apple.com (샌드박스 서버의 경우) 일 gateway.push.apple.com 수 있습니다.

NotificationHubDescription의 모든 자식 요소는 선택 사항입니다.

WNS, APNS 및 GCM 자격 증명은 위에 나와 있는 모든 속성을 포함해야 합니다. MPNS 자격 증명에는 MPNS에 대한 인증되지 않은 푸시를 사용하도록 설정하는 속성도 포함될 수 없습니다.

응답

응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.

응답 코드

코드	Description
201	알림 항목이 만들어졌습니다.
400	잘못된 요청 본문입니다. 요청의 형식이 잘못되었거나 유효성 검사가 실패하여 알림 항목을 만들 수 없습니다.
401	인증 실패 액세스 키가 잘못되었습니다.
403	할당량이 초과되었습니다. 이 네임스페이스에 알림 허브가 너무 많습니다. 알림 허브가 만들어지지 않았습니다.
409	노드에 이미 다른 엔터티가 포함되어 있습니다.

상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.

응답 헤더

없음

응답 본문

현재 노드에 정의된 모든 정책이 있는 NotificationHubDescription 요소입니다.

다음을 통해 공유