Avviare l'aggiornamento dell'applicazione

  • Articolo

Avvia l'aggiornamento di un'applicazione nel cluster di Service Fabric.

Convalida i parametri di aggiornamento dell'applicazione offerta e avvia l'aggiornamento dell'applicazione se i parametri sono validi. Nota, ApplicationParameters non viene mantenuto in un aggiornamento dell'applicazione. Per mantenere i parametri dell'applicazione correnti, l'utente deve ottenere prima i parametri usando l'operazione GetApplicationInfo e passarli alla chiamata API di aggiornamento, come illustrato nell'esempio.

Richiesta

Metodo URI richiesta
POST /Applications/{applicationId}/$/Upgrade?api-version=6.0&timeout={timeout}

Parametri

Nome Tipo Necessario Posizione
applicationId string Sì Percorso
api-version string Sì Query
timeout integer (int64) No Query
ApplicationUpgradeDescription ApplicationUpgradeDescription sì Corpo

applicationId

Tipo: stringa
Obbligatorio: Sì

Identità dell'applicazione. Si tratta in genere del nome completo dell'applicazione senza lo schema URI "fabric:". A partire dalla versione 6.0, i nomi gerarchici sono delimitati dal carattere "~". Ad esempio, se il nome dell'applicazione è "fabric:/myapp/app1", l'identità dell'applicazione sarà "myapp~app1" nella versione 6.0 e successive e "myapp/app1" nelle versioni precedenti.

api-version

Tipo: stringa
Obbligatorio: Sì
Impostazione predefinita: 6.0

Versione dell'API. Questo parametro è obbligatorio e il relativo valore deve essere '6.0'.

La versione dell'API REST di Service Fabric è basata sulla versione di runtime in cui è stata introdotta o modificata l'API. Il runtime di Service Fabric supporta più versioni dell'API. Questa è la versione più recente supportata dell'API. Se viene passata una versione api inferiore, la risposta restituita può essere diversa da quella documentata in questa specifica.

Inoltre, il runtime accetta qualsiasi versione superiore alla versione supportata più recente fino alla versione corrente del runtime. Quindi, se la versione dell'API più recente è 6.0, ma se il runtime è 6.1, per semplificare la scrittura dei client, il runtime accetterà la versione 6.1 per tale API. Tuttavia, il comportamento dell'API sarà in base alla versione 6.0 documentata.

timeout

Tipo: integer (int64)
Obbligatorio: No
Impostazione predefinita: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Timeout del server per l'esecuzione dell'operazione in secondi. Questo timeout specifica la durata del tempo che il client è disposto a attendere il completamento dell'operazione richiesta. Il valore predefinito per questo parametro è 60 secondi.

ApplicationUpgradeDescription

Tipo: ApplicationUpgradeDescription
Obbligatorio: Sì

Parametri per un aggiornamento dell'applicazione.

Risposte

Codice di stato HTTP Descrizione Schema di risposta
200 (OK) Una risposta riuscita significa che l'aggiornamento dell'applicazione è stato avviato. Usare l'operazione GetApplicationUpgrade per ottenere lo stato dell'aggiornamento.
Tutti gli altri codici di stato Risposta dettagliata all'errore.
 FabricError

Esempio

Aggiornare un'applicazione mantenendo i parametri dell'applicazione correnti

Questo esempio illustra come avviare l'aggiornamento di un'applicazione in un cluster di Service Fabric.

Richiesta

POST http://localhost:19080/Applications/samples~CalculatorApp/$/Upgrade?api-version=6.0
Corpo
{
  "Name": "fabric:/samples/CalculatorApp",
  "TargetApplicationTypeVersion": "2.0",
  "Parameters": [
    {
      "Key": "CalculatorAppParameter1",
      "Value": "314"
    },
    {
      "Key": "CalculatorAppParameter2",
      "Value": "271"
    }
  ],
  "UpgradeKind": "Rolling",
  "RollingUpgradeMode": "Monitored",
  "MonitoringPolicy": {
    "FailureAction": "Rollback"
  }
}

Risposta 200

Corpo

Il corpo della risposta è vuoto.