Telepítés frissítése

Cikk
05/26/2023

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

Megosztás a következőn keresztül: