Zrušit operaci

Článek
07/19/2023

Zruší operaci selhání vyvolanou uživatelem.

Následující rozhraní API spouštějí chybové operace, které mohou být zrušeny pomocí funkce CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Pokud je hodnota force nepravdivá, zadaná operace vyvolaná uživatelem se řádně zastaví a vyčistí. Pokud je hodnota force pravdivá, příkaz se přeruší a může zůstat nějaký vnitřní stav. Zadání hodnoty force jako true by mělo být použito opatrně. Volání tohoto rozhraní API s vynuceným nastavením na hodnotu true není povoleno, dokud toto rozhraní API již nebylo volána ve stejném testovacím příkazu s hodnotou force nastavenou na hodnotu false jako první, nebo pokud testovací příkaz již neobsahuje operationstate operationstate.RollingBack. Vysvětlení: OperationState.RollingBack znamená, že systém vyčistí vnitřní stav systému způsobený spuštěním příkazu. Pokud testovací příkaz způsobil ztrátu dat, neobnoví se data. Pokud například zavoláte StartDataLoss a pak zavoláte toto rozhraní API, systém pouze vyčistí interní stav ze spuštění příkazu. Neobnoví data cílového oddílu, pokud příkaz pokročil natolik, že způsobil ztrátu dat.

Důležitá poznámka: Pokud se toto rozhraní API vyvolá pomocí force==true, může zůstat pozadu interní stav.

Žádost

Metoda	Identifikátor URI žádosti
POST	`/Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}`

Parametry

Název	Typ	Vyžadováno	Umístění
`api-version`	řetězec	Ano	Dotaz
`OperationId`	string (uuid)	Ano	Dotaz
`Force`	boolean	Ano	Dotaz
`timeout`	integer (int64)	No	Dotaz

`api-version`

Typ: řetězec
Povinné: Ano
Výchozí:6.0

Verze rozhraní API. Tento parametr je povinný a jeho hodnota musí být 6.0.

Verze rozhraní REST API Service Fabric je založená na verzi modulu runtime, ve které bylo rozhraní API zavedeno nebo změněno. Modul runtime Service Fabric podporuje více než jednu verzi rozhraní API. Toto je nejnovější podporovaná verze rozhraní API. Pokud se předá nižší verze rozhraní API, může se vrácená odpověď lišit od odpovědi popsané v této specifikaci.

Modul runtime navíc přijímá všechny verze, které jsou vyšší než nejnovější podporovaná verze až do aktuální verze modulu runtime. Pokud je tedy nejnovější verze rozhraní API 6.0, ale modul runtime je 6.1, aby se usnadnil zápis klientů, modul runtime pro toto rozhraní API přijme verzi 6.1. Chování rozhraní API však bude podle zdokumentované verze 6.0.

`OperationId`

Typ: řetězec (uuid)
Povinné: Ano

Identifikátor GUID, který identifikuje volání tohoto rozhraní API. Toto se předá do odpovídajícího rozhraní GetProgress API.

`Force`

Typ: boolean
Povinné: Ano
Výchozí:false

Určuje, zda se má provést řádné vrácení zpět a vyčištění interního stavu systému upraveného provedením operace vyvolané uživatelem.

`timeout`

Typ: integer (int64)
Povinné: Ne
Výchozí:60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Časový limit serveru pro provedení operace v sekundách. Tento časový limit určuje dobu, po kterou je klient ochoten čekat na dokončení požadované operace. Výchozí hodnota tohoto parametru je 60 sekund.

Odpovědi

Stavový kód HTTP	Description	Schéma odpovědi
200 (OK)	Úspěšná operace vrátí stavový kód 200.
Všechny ostatní stavové kódy	Podrobná chybová odpověď.	Chyba infrastruktury

Sdílet prostřednictvím