Rimuovere lo stato del nodo

Articolo
08/05/2023

Notifica a Service Fabric che lo stato persistente in un nodo è stato rimosso o perso definitivamente.

Ciò implica che non è possibile ripristinare lo stato persistente di tale nodo, come in genere si verifica se il contenuto di un disco rigido è stato cancellato o se un disco rigido si arresta in modo anomalo. Il nodo deve essere inattivo perché l'operazione abbia esito positivo. Questa operazione consente a Service Fabric di sapere che le repliche in tale nodo non esistono più e che deve smettere di attendere che tali repliche tornino disponibili. Non eseguire questo cmdlet se lo stato del nodo non è stato rimosso e il nodo può tornare disponibile con lo stato intatto. A partire da Service Fabric 6.5, per usare questa API per i nodi di inizializzazione, modificare i nodi di inizializzazione in nodi regolari (non iniziali) e quindi richiamare questa API per rimuovere lo stato del nodo. Se il cluster è in esecuzione in Azure, dopo che il nodo di inizializzazione viene disattivato, Service Fabric tenterà di modificarlo automaticamente in un nodo non di inizializzazione. A questo scopo, assicurarsi che il numero di nodi non di inizializzazione nel tipo di nodo primario non sia minore del numero di nodi di inizializzazione down. Se necessario, aggiungere altri nodi al tipo di nodo primario per ottenere questo risultato. Per il cluster autonomo, se il nodo di inizializzazione down non è previsto che venga eseguito il backup con lo stato intatto, rimuovere il nodo dal cluster, vedere https://docs.microsoft.com/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes

Richiesta

Metodo	URI richiesta
POST	`/Nodes/{nodeName}/$/RemoveNodeState?api-version=6.0&timeout={timeout}`

Parametri

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

`nodeName`

Tipo: stringa
Obbligatorio: Sì

Il nome del nodo.

`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.

Risposte

Codice di stato HTTP	Descrizione	Schema di risposta
200 (OK)	Un'operazione riuscita restituirà il codice di stato 200.
Tutti gli altri codici di stato	Risposta dettagliata all'errore.	FabricError

Condividi tramite