Ottenere la versione del cluster

Articolo
07/19/2023

Ottenere la versione corrente del cluster di Service Fabric.

Se si verifica un aggiornamento del cluster, questa API restituirà la versione più bassa (precedente) delle versioni di runtime del cluster corrente e di destinazione.

Richiesta

Metodo	URI richiesta
GET	`/$/GetClusterVersion?api-version=6.4&timeout={timeout}`

Parametri

Nome	Tipo	Necessario	Posizione
`api-version`	string	Sì	Query
`timeout`	integer (int64)	No	Query

`api-version`

Tipo: stringa
Obbligatorio: Sì
Impostazione predefinita: 6.4

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

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 versione è 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 più recente dell'API è 6.0 e il runtime è 6.1, 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.

Risposte

Codice di stato HTTP	Descrizione	Schema di risposta
200 (OK)	Un'operazione riuscita restituirà il codice di stato 200 e le informazioni sulla versione del cluster richieste.	ClusterVersion
Tutti gli altri codici di stato	Risposta dettagliata all'errore.	FabricError

Esempio