更新安裝

Azure 通知中樞支援使用 RFC6902中JSON-Patch標準的部分更新安裝。

要求

方法	要求 URI	HTTP 版本
PATCH	https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01	HTTP/1.1

要求標頭

下表描述必要的和選用的要求標頭。

要求標頭	描述
Content-Type	application/json-patch+json
授權	使用 服務匯流排共用存取簽章驗證中所指定的 SAS 權杖。
x-ms-version	2015-01

要求本文

允許下列修補程式作業：

JSON-Patch作業	Installation 屬性	描述及範例
add	PushChannel	更新安裝的通道。 [ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ] 如果 pushChannel 已變更，請將 expiredPushChannel 放入 true。
add	UserId	更新或新增使用者識別碼值。 [ { "op": "add", "path": "/userId", "value": "Bob"} ]
add	標籤	如果 value 是 array，則即使不存在) ，仍會將陣列中的所有標記新增至現有的標籤 (。 如果 value 是字串，請將標籤新增至目前的陣列 (或建立具有單一值的新陣列，如果沒有標籤目前存在) 。 [ { "op": "add", "path": "/tags", "value": "tag"} ]
add	範本 (P2)	更新或新增整個範本。 [ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]
add	範本主體/標頭/到期/標記	更新或新增範本 (請注意，標頭上的 'add' 會取代目前的標頭物件) 。 附加標記的語意與原生標籤相同。 [ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ] [ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]
add	secondaryTile 通道	更新 secondaryTile 通道。 [ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]
add	secondaryTile 標籤	與標記更新相同，但路徑是指次要磚。 [ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]
add	secondaryTile 範本	與一般範本相同，但路徑是指 tileId。
add	secondaryTile 範本主體/標頭/到期/標記	與一般範本相同，但路徑是指 tileId。
移除	同上。	刪除屬性，例如 userID 或標記陣列的元素。 如果已移除 tags 屬性的最後一個標記，則會移除整個屬性。 [ { "op": "remove", "path": "/tags/myTag"} ]
取代	同上。	語意相當於 remove+add。

回應

回應包括 HTTP 狀態碼和一組回應標頭。

回應碼

程式碼	描述
204	已成功修補安裝
400	無法修補安裝，因為要求格式不正確。
401	授權失敗。 存取金鑰不正確。
403	超過配額;此命名空間中的註冊太多。 未建立註冊。
403	要求遭到拒絕，因為 API 呼叫率太高。

如需狀態碼的相關資訊，請參閱 狀態和錯誤碼。

回應標頭

回應標頭	描述
Content-Type	application/json-patch+json
內容位置	安裝的位置，格式如下： https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>

回應本文

無。

另請參閱

建立或覆寫安裝
讀取安裝
刪除安裝