만들거나 설치를 덮어쓸
만들거나 설치를 덮어씁니다.
요청
메서드 |
요청 URI |
HTTP 버전 |
---|---|---|
PUT |
https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01 |
HTTP/1.1 |
요청 헤더
다음 표에서 필수 및 선택적 요청 헤더에 설명 합니다.
응답 헤더 |
설명 |
---|---|
콘텐츠 형식 |
application/json |
권한 부여 |
공유 액세스 서명 인증에 지정 된 대로 생성 된 토큰 서비스 버스, 또는 서비스 버스 인증 및 권한 부여 Microsoft Azure Active Directory 액세스 제어(액세스 제어 서비스 또는 ACS라고도 함)합니다. |
x ms 버전 |
2015-01 |
요청 본문
다음 표에서 설치에 대 한 JSON 요청 본문의 속성을 설명 합니다.
이름 |
형식 |
필요한 |
읽기 전용 |
설명 |
---|---|---|---|---|
installationId |
문자열 |
예 |
아니요 |
전역 고유 식별자 문자열 |
lastActiveOn |
문자열 |
아니요 |
예 |
설치가 수행 된 시기 비활성화 PNS가 날짜입니다. |
만료 시간 |
문자열 |
아니요 |
예 |
이것은 W3C DTF, YYYY의에서 시간과 날짜를 포함 하는 문자열-MM-DDThh:mmTZD (예: 1997-07-16T19:20+01:00))에 등록이 만료 됩니다. 허브 수준에서 설정할 수 값에서 만들기 또는 업데이트 및 만료 되지 않도록 기본값 (9999-12-31T23:59:59). |
lastUpdate |
문자열 |
업데이트할 때 무시 됩니다. 읽을 때 반환 됩니다. |
예 |
이 설치에 마지막으로 업데이트의 W3C 형식의 날짜입니다. |
플랫폼 |
문자열 |
예 |
아니요 |
{Apns, wns, mpns, adm, gcm} 일 수 있습니다. |
pushChannel |
문자열 |
예 |
아니요 |
이 설치는 ApplicationTile ChannelUri WNS) (경우에 PNS 핸들입니다. |
expiredPushChannel |
부울 값 |
업데이트할 때 무시 됩니다. 읽을 때 반환 됩니다. |
예 |
PNS는 채널을 만료 하는 경우에 유용 합니다. |
태그 |
문자열의 배열 |
아니요 |
아니요 |
태그의 배열입니다. 태그는 허브 사양에 정의 된 문자열입니다. |
서식 파일 |
JSON 개체 |
아니요 |
아니요 |
템플릿 설명에 templateNames의 사전 나타내는 JSON 개체입니다. |
템플릿입니다. {name} |
문자열 |
아니요 |
아니요 |
서식 파일을 나타내는 JSON 개체입니다. |
템플릿입니다. {name}.body |
문자열 |
예. 하지만 현재 템플릿 |
아니요 |
알림 페이로드의 본문에 대 한 템플릿입니다. |
템플릿입니다. {name}.headers |
JSON 개체 |
아니요. Wns 또는 mpns 플랫폼은 경우에 사용할 수 있습니다. |
아니요 |
헤더 이름 및 값을 각 속성의 인 JSON 개체 템플릿의 식입니다. |
템플릿입니다. {name}.expiry |
문자열 |
아니요. 플랫폼은 apns 하는 경우에 사용할 수 있습니다. |
아니요 |
템플릿 식 W3D 날짜 형식으로 평가 합니다. |
템플릿입니다. {name}.tags |
문자열의 배열 |
아니요 |
아니요 |
이 서식 파일에 대 한 태그의 배열입니다. |
{1>secondarytiles |
JSON 개체 |
아니요. 플랫폼은 wns 하는 경우에 사용할 수 있습니다. |
아니요 |
TileId 및 {1>notificationhub 개체의 사전을 포함 하는 JSON 개체입니다. |
secondaryTile 합니다. {tileId} |
JSON 개체 |
아니요 |
아니요 |
보조 타일에 대 한 푸시 속성을 가진 JSON 개체입니다. |
secondaryTile 합니다. {tileId}.pushChannel |
문자열 |
예, tileId 있으면 |
아니요 |
보조 타일에 대해 ChannelUri를 제공 합니다. |
secondaryTile 합니다. {tileId}.tags |
문자열의 배열 |
아니요 |
아니요 |
보조 타일에 대 한 기본 알림에 태그입니다. |
secondaryTile 합니다. {tileId}.templates |
JSON 개체 |
아니요 |
아니요 |
동일 하지만 각 보조 타일에 대 한 템플릿 속성입니다. |
JSON에서 요소의 순서는 중요 하지 않습니다.
APNS, GCM, ADM. json에 대 한 값을 템플릿 본문
템플릿 본문 WNS 및 MPNS (원시 경우 제외)에 대 한 XML 이어야 합니다.
WNS에 대 한 템플릿을 X WNS 형식 헤더를 포함 해야 합니다.
MPNS에 대 한 서식 파일에서 설명 했 듯이 호환 헤더 있어야 Windows Phone 8에 대 한 푸시 알림을 보내는 방법은합니다.
다음 일부 JSON 예제입니다.
APNS에 등록 하는 예제:
{
"installationId": "12234",
"tags": ["foo", "bar"],
"platform": "apns",
"pushChannel": "ABCDEF-123456-…"
}
참고
Tags 요소는 선택 사항입니다.
템플릿과 없는 태그를 포함 하 여 WNS를 고유 하 게 등록 하는 예제:
{
"installationId": "12234",
"platform": "wns",
"pushChannel": "https://db3...",
"templates": {
"myTemplate" : {
body : '<toast><visual lang="en-US"><binding template="ToastTest01"><text id="1">$myTextProp1</text></binding></visual></tile>',
headers: { "X-WNS-Type": "wns/toast" },
"tags": ["foo", "bar"]
}
}
}
가능한 많은 요소의 스 켈 레 톤 나열
{
installationId: "",
expirationTime: "",
tags: ["foo", "bar"],
lastUpdate: “”,
user: "",
advertisingId: "",
appId: ""
platform: "",
pushChannel: "",
templates: {
"templateName1" : {
body: "",
headers: { "X-WNS-Type": "wns/tile" },
expiration: "",
tags: ["foo", "bar"]
}
}
secondaryTiles: {
"tileId1": {
pushChannel: "",
tags: ["foo", "bar"],
templates: {
"otherTemplate": {
bodyTemplate: "",
headers: { ... },
tags: ["foo"]
}
}
}
}
}
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함 됩니다.
응답 코드
코드 |
설명 |
---|---|
200 |
설치가는 성공적으로 만들었습니다. |
400 |
설치 요청 형식이 잘못 되었으므로 만들/덮어쓸 수 없습니다. |
401 |
권한 부여 실패입니다. 선택 키에 올바르지 않습니다. |
403 |
이 네임 스페이스-만들어지지 설치에서에서 설치 된 너무 많습니다. |
403 |
API 호출 속도가 너무 빨라 때문에 거부 된 요청입니다. |
상태 코드에 대 한 정보를 참조 하십시오. 상태 및 오류 코드합니다.
응답 헤더
응답 헤더 |
설명 |
---|---|
콘텐츠 형식 |
application/json |
콘텐츠 위치 |
형식에서 설치 위치: https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId> |
응답 본문
None입니다.