Condividi tramite

Rimuovi replica

  • Articolo

Rimuove una replica del servizio in esecuzione in un nodo.

Questa API consente di simulare un errore di replica di Service Fabric rimuovendo una replica da un cluster di Service Fabric. La rimozione chiude la replica, la passa al ruolo Nessuno e quindi rimuove tutte le informazioni sullo stato della replica dal cluster. Questa API verifica il percorso di rimozione dello stato della replica e simula il percorso permanente di errore del report tramite le API del client. Avviso: quando si usa questa API non viene eseguito alcun controllo di sicurezza. L'uso non corretto di questa API può causare la perdita di dati per i servizi con stato. Il flag forceRemove ha anche effetto su tutte le altre repliche ospitate nello stesso processo.

Richiesta

Metodo URI richiesta
POST /Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout}

Parametri

Nome Tipo Necessario Posizione
nodeName string Sì Percorso
partitionId string (uuid) Sì Percorso
replicaId string Sì Percorso
api-version string Sì Query
ForceRemove boolean No Query
timeout integer (int64) No Query

nodeName

Tipo: stringa
Obbligatorio: Sì

Il nome del nodo.

partitionId

Tipo: stringa (uuid)
Obbligatorio: Sì

L'identità della partizione.

replicaId

Tipo: stringa
Obbligatorio: Sì

Identificatore della replica.

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.

ForceRemove

Tipo: booleano
Obbligatorio: No

Consente di rimuovere un servizio o un'applicazione di Service Fabric in modo forzato senza passare attraverso la sequenza di arresto normale. Questo parametro può essere usato per eliminare in modo forzato un'applicazione o un servizio per il quale l'operazione di eliminazione è prossima al timeout a causa di problemi nel codice del servizio che impediscono la normale chiusura delle repliche.

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. Un'operazione riuscita significa che il comando di riavvio è stato ricevuto dalla replica nel nodo ed è nel processo di riavvio.
Tutti gli altri codici di stato Risposta dettagliata all'errore.
 FabricError