알림 허브 만들기
지원되는 플랫폼 알림 서비스(WNS, APNS, GCM)용 자격 증명을 포함하는 새 알림 허브를 만듭니다.
요청
| 방법 | 요청 URI | HTTP 버전 |
|---|---|---|
| PUT | https://{namespace}.servicebus.windows.net/{Notification Hub}?api-version=2015-01 | HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | 설명 |
|---|---|
| 콘텐츠-유형 | application/xml;type=entry;charset=utf-8 |
| 권한 부여 | 공유 액세스 서명 인증 된에 지정된대로 생성 한 토큰 서비스 버스, 또는 서비스 버스 인증 및 권한 부여와 Microsoft Azure Active Directory 액세스 제어(액세스 제어 서비스 또는 ACS라고도 함)합니다. |
| x-ms-version | 2015-01 |
요청 본문
요청 본문에 포함 된 Atom 항목이 NotificationHubDescription 요소입니다. 예를 들면 다음과 같습니다.
<?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="https://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 ". apple.com" (프로덕션 서버) 또는 "gateway.sandbox.push.apple.com" (샌드박스 서버용) 일 수 있습니다.
모든 자식 요소 NotificationHubDescription 는 선택 사항입니다.
WNS, APNS 및 GCM 자격 증명은 위에 나와 있는 모든 속성을 포함해야 합니다. MPNS 자격 증명은 속성을 포함하지 않을 수도 있으므로 MPNS에 대한 인증되지 않은 푸시를 사용할 수 있습니다.
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
| 코드 | 설명 |
|---|---|
| 201 | 알림 항목이 만들어졌습니다. |
| 400 | 잘못된 요청 본문입니다. 요청의 형식이 잘못되었거나 유효성 검사가 실패하여 알림 항목을 만들 수 없습니다. |
| 401 | 인증 실패 액세스 키가 잘못되었습니다. |
| 403 | 할당량이 초과되었습니다. 이 네임스페이스에 알림 허브가 너무 많습니다. 알림 허브가 만들어지지 않았습니다. |
| 409 | 노드에 이미 다른 엔터티가 포함되어 있습니다. |
상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드.
응답 헤더
없음.
응답 본문
A NotificationHubDescription 현재 노드에 정의 된 모든 정책이 요소입니다.