ID di installazione dall'installazione aggiornamento

  • Articolo

 <_caps3a_sxs _xmlns3a_caps="https://schemas.microsoft.com/build/caps/2013/11"><_caps3a_sxstarget locale="it-IT">Hub di notifica di Azure supporta aggiornamenti parziali a un'installazione utilizzando lo standard Patch JSON in RFC6902https://tools.ietf.org/html/rfc6902.RichiestaMetodoURI della richiestaVersione HTTPPATCHhttps://{Namespace}.ServiceBus.Windows.NET/{NotificationHub}/Installations/{ID}?API-Version=2015-01HTTP/1.1Intestazioni della richiestaNella seguente tabella vengono descritte le intestazioni di richiesta obbligatorie e facoltative.Intestazione della richiestaDescrizioneContent-TypeApplication/json-patch + jsonAutorizzazioneToken generato come specificato nell'autenticazione della firma di accesso condiviso con Bus di servizio oppure nell'autenticazione e nell'autorizzazione di Bus di servizio con Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o ACS).x-ms-version2015-01Corpo della richiestaSono consentite le operazioni seguenti patch:Operazione Patch JSONProprietà di installazioneDescrizione ed esempioaggiungiPushChannelAggiornare il canale di un'installazione.[ { "op": "add", "path": "/pushChannel", "value": "aaaaaaa"} ]Inserire expiredPushChannel su true se pushChannel viene modificato.aggiungiAppId/utente/AdvertisingIdAggiornare o aggiungere utente, AppId, il valore di AdvId.[ { "op": "add", "path": "/user", "value": "elio"} ] aggiungiTagSe il valore è una matrice, aggiungere tutti i tag nella matrice di tag esistenti (anche se non è presente). Se il valore è una stringa, aggiungere tag alla matrice corrente (o creare una nuova matrice con valore singolo, se i tag non sono attualmente presenti).[ { "op": "add", "path": "/tags", "value": "tag"} ]aggiungiModello (P2)Aggiornare o aggiungere l'intero modello.[ { "op": "add", "path": "/templates/myTemplate", "value": '{"body": "…", "tags": ["tag"]}'} ]aggiungiModello/intestazione/scadenza/tag bodyAggiornare o aggiungere parti del modello (si noti che aggiungono intestazioni sostituisce intestazioni corrente). Aggiungere tag ha la stessa semantica di tag nativo.[ { "op": "add", "path": "/templates/myTemplate/body", "value": '{"aps": …}'} ][ { "op": "add", "path": "/templates/myTemplate/headers", "value": '{"X-WNS-Type": "wns/toast"}'} ]aggiungicanale secondaryTileAggiorna il canale secondaryTile.[ { "op": "add", "path": "/secondaryTiles/myTile/pushChannel", "value": "aaaaaaa"} ]aggiungitag secondaryTileEquivale a tag aggiornamento ma percorso fa riferimento al riquadro secondario.[ { "op": "add", "path": "/secondaryTiles/myTile/tags", "value": '["fooTag"]'} ]aggiungimodello secondaryTileCome i modelli normali ma percorso fa riferimento a ID di riquadro.aggiungisecondaryTile modello/intestazione/scadenza/tag body Come i modelli normali ma percorso fa riferimento a ID di riquadro.RemoveCome nel caso precedenteElimina una proprietà o un elemento della matrice di tag. Se viene rimosso l'ultimo tag della proprietà tag viene rimossa l'intera proprietà.[ { "op": "remove", "path": "/tags/myTag"} ]SostituireCome nel caso precedenteSemanticamente equivalente a rimuovere + Aggiungi.RispostaNella risposta sono inclusi un codice di stato HTTP e un set di intestazioni per la risposta.Codici di rispostaCodiceDescrizione204L'installazione è stata corretta correttamente 400L'installazione potrebbe non essere corretto in quanto la richiesta non è corretto.401Errore di autorizzazione. Chiave di accesso non corretta.403Quota superata. Troppe registrazioni in questo spazio dei nomi. Registrazione non creata.403Richiesta rifiutata perché la frequenza di chiamata API è troppo elevata.Per informazioni sui codici di stato, vedere Codici ed errori di statohttps://msdn.microsoft.com/library/windowsazure/dd179357.aspx.Intestazioni della rispostaIntestazione della rispostaDescrizioneContent-typeApplication/json-patch + jsonContent-LocationPercorso di installazione nel formato:https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>Corpo della rispostaNessuna.Creare o sovrascrivere l'installazioneInstallazione di letturaEliminare l'installazione<_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 Bus di servizio, or Bus di servizio authentication and authorization with Microsoft Azure Active Directory Access Control (anche noto come Servizio di controllo di accesso o 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