Telepítés frissítése

Az Azure Notification Hubs támogatja a telepítés részleges frissítéseit az RFC6902 JSON-Patch szabványával.

Kérés

Metódus	Kérés URI-ja	HTTP-verzió
JAVÍTÁS	https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01	HTTP/1.1

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket ismerteti.

Kérelem fejléce	Leírás
Content-Type	application/json-patch+json
Engedélyezés	A Service Bus használatával történő közös hozzáférésű aláírás-hitelesítésben megadott módon létrehozott SAS-jogkivonat.
x-ms-version	2015-01

A kérés törzse

A következő javítási műveletek engedélyezettek:

JSON-Patch művelet	Telepítési tulajdonság	Leírás és minta
add	PushChannel	Frissítse a telepítés csatornáját. [ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ] Állítsa a expiredPushChannel értéket true értékre, ha a pushChannel módosult.
add	UserId (Felhasználóazonosító)	Frissítse vagy adja hozzá a felhasználói azonosító értékét. [ { "op": "add", "path": "/userId", "value": "Bob"} ]
add	Címke	Ha az érték tömb, adja hozzá a tömbben lévő összes címkét a meglévő címkékhez (még akkor is, ha nincs jelen). Ha az érték sztring, adjon hozzá címkét az aktuális tömbhöz (vagy hozzon létre egy új tömböt egyetlen értékkel, ha nincsenek címkék). [ { "op": "add", "path": "/tags", "value": "tag"} ]
add	Sablon (P2)	Teljes sablon frissítése vagy hozzáadása. [ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]
add	Sablontörzs/fejléc/lejárat/címkék	A sablon egyes részeinek frissítése vagy hozzáadása (vegye figyelembe, hogy a fejléceken lévő "hozzáadás" az aktuális fejlécobjektumot helyettesíti). A címkék hozzáadása ugyanazokkal a szemantikával rendelkezik, mint a natív címkék. [ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ] [ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]
add	secondaryTile csatorna	Frissítések a secondaryTile csatornát. [ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]
add	secondaryTile címke	Ugyanaz, mint a címkék frissítése, de az elérési út másodlagos csempére hivatkozik. [ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]
add	secondaryTile sablon	Ugyanaz, mint a normál sablonok, de az elérési út csempeazonosítóra hivatkozik.
add	secondaryTile template body/header/expiry/tags	Ugyanaz, mint a normál sablonok, de az elérési út csempeazonosítóra hivatkozik.
Eltávolítás	A fentieknek megfelelően	Töröl egy tulajdonságot, például a userID azonosítót vagy a címkék tömbjének egy elemét. Ha a címkék tulajdonság utolsó címkéje el lett távolítva, a teljes tulajdonság el lesz távolítva. [ { "op": "remove", "path": "/tags/myTag"} ]
Csere	A fentieknek megfelelően	Szemantikailag egyenértékű az eltávolítás+hozzáadás értéknek.

Reagálás

A válasz tartalmaz egy HTTP-állapotkódot és egy válaszfejléceket.

Válaszkódok

Code	Description
204	A telepítés sikeresen ki lett javítva
400	A telepítés nem javítható, mert a kérés helytelenül lett formázva.
401	Engedélyezési hiba. A hozzáférési kulcs helytelen volt.
403	Kvóta túllépve; túl sok regisztráció van ebben a névtérben. A regisztráció nem jött létre.
403	A kérelem elutasítva, mert az API-hívási sebesség túl magas.

Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.

Válaszfejlécek

Válaszfejléc	Description
Tartalomtípus	application/json-patch+json
Tartalom helye	A telepítés helye a következő formátumban: https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>

Választörzs

Nincsenek.

Lásd még:

Telepítés létrehozása vagy felülírása
Telepítés olvasása
Telepítés törlése