Aktualisieren Sie die Installation vom Installations-ID

  • Artikel

 <_caps3a_sxs _xmlns3a_caps="https://schemas.microsoft.com/build/caps/2013/11"><_caps3a_sxstarget locale="de-DE">Azure Notification Hubs unterstützt partielle Updates zu einer Installation mit der Standard-JSON-Patch in RFC6902https://tools.ietf.org/html/rfc6902.AnforderungMethodeAnforderungs-URIHTTP-VersionPATCHhttps://{Namespace}.Servicebus.Windows.NET/{NotificationHub}/Installations/{ID}?API-Version=2015-01HTTP/1.1AnforderungsheaderIn der folgenden Tabelle werden erforderliche und optionale Anforderungsheader beschrieben.AnforderungsheaderBeschreibungContent-TypeApplication/Json-Patch + jsonAutorisierungGemäß der Shared Access Signature Authentifizierung mit generierte Token Servicebus, oder Servicebus Authentifizierung und Autorisierung über Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS).x-ms-version2015-01AnforderungstextDie folgenden Patch-Vorgänge sind zulässig:JSON-Patch-VorgangInstallationseigenschaftBeschreibung und BeispielHinzufügenPushChannelAktualisieren Sie den Kanal einer Installation.[ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ]Setzen Sie ExpiredPushChannel auf true, wenn der PushChannel geändert wird.HinzufügenAppId/Benutzer/AdvertisingIdAktualisieren Sie, oder fügen Sie Benutzer, AppId, AdvId Wert hinzu.[ { "op": "add", "path": "/user", "value": "elio"} ] HinzufügenTagFügen Sie falls der Wert des Arrays, alle Tags im Array vorhandene Tags (auch wenn nicht vorhanden hinzu). Wenn der Wert eine Zeichenfolge ist, aktuelle Array fügen Sie Tag hinzu (oder erstellen Sie ein neues Array mit einzelnen Wert, wenn keine Tags derzeit vorhanden sind).[ { "op": "add", "path": "/tags", "value": "tag"} ]HinzufügenVorlage (P2)Aktualisieren oder die gesamte Vorlage hinzufügen.[ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]HinzufügenText/Header/Ablauf/Kategorien-VorlageAktualisieren oder Teile der Vorlage (Beachten Sie, die "Header ersetzt aktuellen Header Objekt hinzufügen") hinzufügen. Tags hinzufügen weist dieselbe Semantik wie systemeigene Tags.[ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ][ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]HinzufügenSecondaryTile-KanalAktualisiert den SecondaryTile-Kanal.[ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]HinzufügenSecondaryTile-tagWie Tags Update jedoch Pfad bezieht sich auf sekundäre Kachel.[ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]HinzufügenSecondaryTile-VorlageWie bei normalen Vorlagen jedoch Pfad bezieht sich auf TileId.Hinzufügen"secondarytile" Vorlage Text/Header/Ablauf /-tags Wie bei normalen Vorlagen jedoch Pfad bezieht sich auf TileId.RemoveSiehe obenLöscht eine Eigenschaft oder ein Element des Arrays Tags. Entfernen das letzte Tag der Tags-Eigenschaft wird die gesamte Eigenschaft entfernt.[ { "op": "remove", "path": "/tags/myTag"} ]ErsetzenSiehe obenSemantisch äquivalent zu entfernen und hinzufügen.AntwortDie Antwort enthält den HTTP-Statuscode und einen Satz von Antwortheadern.AntwortcodesCodeBeschreibung204Die Installation wurde erfolgreich korrigiert. 400Die Installation konnte nicht gepatcht werden, da die Anforderung falsch formatiert war.401Autorisierungsfehler Der Zugriffsschlüssel war falsch.403Das Kontingent wurde überschritten. Es sind zu viele Registrierungen in diesem Namespace vorhanden. Die Registrierung wurde nicht erstellt.403Die Anforderung abgelehnt, da der API-Aufruf Rate zu hoch ist.Informationen zu Statuscodes finden Sie unter Status- und Fehlercodeshttps://msdn.microsoft.com/library/windowsazure/dd179357.aspx.AntwortheaderAntwortheaderBeschreibungContent-typeApplication/Json-Patch + jsonContent-LocationDer Speicherort der Installation im Format:https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>AntworttextKeine.Erstellen oder Installation überschreibenLesen Sie die InstallationLöschen Sie die Installation<_caps3a_sxssource locale="en-US">Azure Notification Hubs supports partial updates to an installation using the JSON-Patch standard in RFC6902https://tools.ietf.org/html/rfc6902.RequestMethodRequest URIHTTP versionPATCHhttps://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01HTTP/1.1Request HeadersThe following table describes required and optional request headers.Request HeaderDescriptionContent-Typeapplication/json-patch+jsonAuthorizationToken generated as specified in Shared Access Signature Authentication with Servicebus, or Servicebus authentication and authorization with Zugriffssteuerung für Microsoft Azure Active Directory (auch Zugriffssteuerungsdienst oder ACS).x-ms-version2015-01Request BodyThe following patch operations are allowed:JSON-Patch operationInstallation PropertyDescription and sampleaddPushChannelUpdate the channel of an installation.[ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ]Put expiredPushChannel to true if pushChannel is changed.addUser/AppId/AdvertisingIdUpdate or add user, AppId, AdvId value.[ { "op": "add", "path": "/user", "value": "elio"} ] addTagIf value is array, add all tags in array to existing tags (even if not present). If value is a string, add tag to current array (or create a new array with single value, if not tags are currently present).[ { "op": "add", "path": "/tags", "value": "tag"} ]addTemplate (P2)Update or add whole template.[ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]addTemplate body/header/expiry/tagsUpdate or add parts of template (note that ‘add’ on headers replaces current headers object). Add on tags has the same semantics as native tags.[ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ][ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]addsecondaryTile channelUpdates the secondaryTile channel.[ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]addsecondaryTile tagSame as tags update but path refers to secondary tile.[ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]addsecondaryTile templateSame as normal templates but path refers to tileId.addsecondaryTile template body/header/expiry/tags Same as normal templates but path refers to tileId.RemoveAs aboveDeletes a property or an element of the tags array. If the last tag of the tags property is removed the whole property is removed.[ { "op": "remove", "path": "/tags/myTag"} ]ReplaceAs aboveSemantically equivalent to remove+add.ResponseThe response includes an HTTP status code and a set of response headers.Response CodesCodeDescription204The installation was patched successfully 400The installation could not be patched because the request was malformed.401Authorization failure. The access key was incorrect.403Quota exceeded; too many registrations in this namespace. Registration not created.403Request rejected because API call rate is too high.For information about status codes, see Status and Error Codeshttps://msdn.microsoft.com/library/windowsazure/dd179357.aspx.Response HeadersResponse HeaderDescriptionContent-typeapplication/json-patch+jsonContent-LocationThe location of the installation in the format:https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>Response BodyNone.Create or Overwrite InstallationRead InstallationDelete Installation