Usuń replikęRemove Replica

Usuwa replikę usługi działającą w węźle.Removes a service replica running on a node.

Ten interfejs API symuluje awarię Service Fabric repliki przez usunięcie repliki z klastra Service Fabric.This API simulates a Service Fabric replica failure by removing a replica from a Service Fabric cluster. Usunięcie spowoduje zamknięcie repliki, przejście repliki do roli brak, a następnie usunięcie wszystkich informacji o stanie repliki z klastra.The removal closes the replica, transitions the replica to the role None, and then removes all of the state information of the replica from the cluster. Ten interfejs API testuje ścieżkę usuwania stanu repliki i symuluje trwałą ścieżkę błędów raportów za pomocą interfejsów API klienta.This API tests the replica state removal path, and simulates the report fault permanent path through client APIs. Ostrzeżenie — podczas korzystania z tego interfejsu API nie są wykonywane żadne kontrole bezpieczeństwa.Warning - There are no safety checks performed when this API is used. Nieprawidłowe użycie tego interfejsu API może prowadzić do utraty danych dla usług stanowych.Incorrect use of this API can lead to data loss for stateful services. Dodatkowo flaga forceRemove ma wpływ na wszystkie inne repliki hostowane w tym samym procesie.In addition, the forceRemove flag impacts all other replicas hosted in the same process.

RequestRequest

MetodaMethod Identyfikator URI żądaniaRequest URI
POSTPOST /Nodes/{nodeName}/$/GetPartitions/{partitionId}/$/GetReplicas/{replicaId}/$/Delete?api-version=6.0&ForceRemove={ForceRemove}&timeout={timeout}

ParametryParameters

NazwaName TypType WymaganyRequired LokalizacjaLocation
nodeName ciągstring TakYes ŚcieżkaPath
partitionId ciąg (UUID)string (uuid) TakYes ŚcieżkaPath
replicaId ciągstring TakYes ŚcieżkaPath
api-version ciągstring TakYes ZapytanieQuery
ForceRemove wartość logicznaboolean NieNo ZapytanieQuery
timeout Liczba całkowita (Int64)integer (int64) NieNo ZapytanieQuery

nodeName

Typ: ciągType: string
Wymagane: takRequired: Yes

Nazwa węzła.The name of the node.


partitionId

Typ: ciąg (UUID)Type: string (uuid)
Wymagane: takRequired: Yes

Tożsamość partycji.The identity of the partition.


replicaId

Typ: ciągType: string
Wymagane: takRequired: Yes

Identyfikator repliki.The identifier of the replica.


api-version

Typ: ciągType: string
Wymagane: takRequired: Yes
Wartość domyślna:6.0Default: 6.0

Wersja interfejsu API.The version of the API. Ten parametr jest wymagany, a jego wartość musi być równa "6,0".This parameter is required and its value must be '6.0'.

Wersja interfejsu API REST Service Fabric jest oparta na wersji środowiska uruchomieniowego, w której interfejs API został wprowadzony lub został zmieniony.Service Fabric REST API version is based on the runtime version in which the API was introduced or was changed. Środowisko uruchomieniowe Service Fabric obsługuje więcej niż jedną wersję interfejsu API.Service Fabric runtime supports more than one version of the API. Jest to najnowsza obsługiwana wersja interfejsu API.This is the latest supported version of the API. Jeśli zostanie przekazana mniejsza wersja interfejsu API, zwracana odpowiedź może się różnić od tego, co zostało opisane w tej specyfikacji.If a lower API version is passed, the returned response may be different from the one documented in this specification.

Dodatkowo środowisko uruchomieniowe akceptuje wszystkie wersje, które są wyższe niż Najnowsza obsługiwana wersja do bieżącej wersji środowiska uruchomieniowego.Additionally the runtime accept any version that is higher than the latest supported version up to the current version of the runtime. Dlatego jeśli Najnowsza wersja interfejsu API to 6,0, ale jeśli środowisko uruchomieniowe ma wartość 6,1, w celu ułatwienia zapisywania klientów środowisko uruchomieniowe będzie akceptować wersję 6,1 dla tego interfejsu API.So if the latest API version is 6.0, but if the runtime is 6.1, in order to make it easier to write the clients, the runtime will accept version 6.1 for that API. Zachowanie interfejsu API będzie jednak tak samo jak w przypadku udokumentowanej wersji 6,0.However the behavior of the API will be as per the documented 6.0 version.


ForceRemove

Typ: wartość logicznaType: boolean
Wymagane: nieRequired: No

Usuń wymuszanie Service Fabric aplikacji lub usługi bez przechodzenia przez łagodną sekwencję zamykania.Remove a Service Fabric application or service forcefully without going through the graceful shutdown sequence. Tego parametru można użyć, aby wymusić usunięcie aplikacji lub usługi, dla której limit czasu usuwania jest spowodowany przez problemy w kodzie usługi, które uniemożliwiają płynne zamknięcie replik.This parameter can be used to forcefully delete an application or service for which delete is timing out due to issues in the service code that prevents graceful close of replicas.


timeout

Typ: Integer (Int64)Type: integer (int64)
Wymagane: nieRequired: No
Wartość domyślna:60Default: 60
InclusiveMaximum:4294967295InclusiveMaximum: 4294967295
InclusiveMinimum:1InclusiveMinimum: 1

Limit czasu serwera na potrzeby wykonywania operacji w sekundach.The server timeout for performing the operation in seconds. Ten limit czasu określa czas, przez jaki klient chce czekać na zakończenie wymaganej operacji.This timeout specifies the time duration that the client is willing to wait for the requested operation to complete. Wartość domyślna tego parametru to 60 sekund.The default value for this parameter is 60 seconds.

OdpowiedziResponses

Kod stanu HTTPHTTP Status Code OpisDescription Response SchemaResponse Schema
200 (OK)200 (OK) Operacja zakończona powodzeniem zwróci kod stanu 200.A successful operation will return 200 status code. Operacja zakończona powodzeniem oznacza, że polecenie restart zostało odebrane przez replikę w węźle i jest w trakcie ponownego uruchamiania.A successful operation means that the restart command was received by the replica on the node and it is in the process of restarting.
Wszystkie inne kody stanuAll other status codes Szczegółowa odpowiedź na błąd.The detailed error response.
FabricErrorFabricError