설치 업데이트
Azure Notification Hubs는 RFC6902의 JSON-Patch 표준을 사용하여 설치에 대한 부분 업데이트를 지원합니다.
요청
| 메서드 | 요청 URI | HTTP 버전 |
|---|---|---|
| 패치 | https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01 |
HTTP/1.1 |
요청 헤더
다음 표에서는 필수 요청 헤더와 선택적 요청 헤더에 대해 설명합니다.
| 요청 헤더 | Description |
|---|---|
| 콘텐츠 형식 | application/json-patch+json |
| 권한 부여 | Service Bus를 사용한 공유 액세스 서명 인증에 지정된 대로 생성된 SAS 토큰입니다. |
| x-ms-version | 2015-01 |
요청 본문
다음 패치 작업이 허용됩니다.
| JSON-Patch 작업 | Installation 속성 | 설명 및 샘플 |
|---|---|---|
| add | PushChannel | 설치 채널을 업데이트합니다.
pushChannel이 변경된 경우 expiredPushChannel을 true로 설정합니다. |
| add | UserId | 사용자 ID 값을 업데이트하거나 추가합니다.
|
| add | 태그 | value가 배열인 경우 배열의 모든 태그를 기존 태그에 추가합니다(존재하지 않더라도). value가 문자열인 경우 현재 배열에 태그를 추가하거나 현재 태그가 없는 경우 단일 값으로 새 배열을 만듭니다.
|
| add | 템플릿(P2) | 전체 템플릿을 업데이트하거나 추가합니다.
|
| add | 템플릿 본문/헤더/만료/태그 | 템플릿의 일부를 업데이트하거나 추가합니다(헤더의 'add'는 현재 헤더 개체를 대체합니다). 태그에 추가에는 네이티브 태그와 동일한 의미 체계가 있습니다.
|
| add | secondaryTile 채널 | 보조 타일 채널을 업데이트.
|
| add | secondaryTile 태그 | 태그 업데이트와 동일하지만 경로는 보조 타일을 참조합니다.
|
| add | secondaryTile 템플릿 | 일반 템플릿과 동일하지만 경로는 tileId를 참조합니다. |
| add | secondaryTile 템플릿 본문/헤더/만료/태그 | 일반 템플릿과 동일하지만 경로는 tileId를 참조합니다. |
| 제거 | 위와 동일합니다. | userID와 같은 속성 또는 태그 배열의 요소를 삭제합니다. 태그 속성의 마지막 태그가 제거되면 전체 속성이 제거됩니다.
|
| 바꾸기 | 위와 동일합니다. | 의미상 remove+add에 해당합니다. |
응답
응답에는 HTTP 상태 코드 및 응답 헤더 집합이 포함되어 있습니다.
응답 코드
| 코드 | Description |
|---|---|
| 204 | 설치가 성공적으로 패치되었습니다. |
| 400 | 요청 형식이 잘못되었기 때문에 설치를 패치할 수 없습니다. |
| 401 | 인증 실패 액세스 키가 잘못되었습니다. |
| 403 | 할당량이 초과되었습니다. 이 네임스페이스에 등록이 너무 많습니다. 등록이 만들어지지 않았습니다. |
| 403 | API 호출 속도가 너무 높기 때문에 요청이 거부되었습니다. |
상태 코드에 대한 자세한 내용은 상태 및 오류 코드를 참조하세요.
응답 헤더
| 응답 헤더 | Description |
|---|---|
| Content-type | application/json-patch+json |
| 콘텐츠-위치 | 설치 위치 형식: https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId> |
응답 본문
없음