Avbryt åtgärd

Artikel
07/19/2023

Avbryter en användarinducerad felåtgärd.

Följande API:er startar felåtgärder som kan avbrytas med hjälp av CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Om force är false stoppas och rensas den angivna användarinducerade åtgärden på ett smidigt sätt. Om force är sant avbryts kommandot och ett internt tillstånd kan lämnas kvar. Att ange kraft som true ska användas med försiktighet. Det går inte att anropa det här API:et med force set till true förrän det här API:et redan har anropats på samma testkommando med kraft inställd på false först, eller såvida inte testkommandot redan har en OperationState of OperationState.RollingBack. Förtydligande: OperationState.RollingBack innebär att systemet rensar det interna systemtillståndet som orsakas av att kommandot körs. Det återställer inte data om testkommandot skulle orsaka dataförlust. Om du till exempel anropar StartDataLoss och anropar det här API:et rensar systemet bara det interna tillståndet från att köra kommandot. Den återställer inte målpartitionens data om kommandot har förlopp tillräckligt långt för att orsaka dataförlust.

Viktigt: Om det här API:et anropas med force==true kan det interna tillståndet lämnas kvar.

Förfrågan

Metod	URI för förfrågan
POST	`/Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}`

Parametrar

Namn	Typ	Obligatorisk	Location
`api-version`	sträng	Ja	Söka i data
`OperationId`	sträng (uuid)	Ja	Söka i data
`Force`	boolean	Ja	Söka i data
`timeout`	heltal (int64)	No	Söka i data

`api-version`

Typ: sträng
Obligatoriskt: Ja
Standard: 6.0

Versionen av API:et. Den här parametern krävs och dess värde måste vara "6.0".

Service Fabric REST API-versionen baseras på körningsversionen där API:et introducerades eller ändrades. Service Fabric Runtime stöder mer än en version av API:et. Det här är den senaste versionen av API:et som stöds. Om en lägre API-version skickas kan det returnerade svaret skilja sig från det som beskrivs i den här specifikationen.

Dessutom accepterar körningen alla versioner som är högre än den senaste versionen som stöds fram till den aktuella versionen av körningen. Så om den senaste API-versionen är 6.0, men om körningen är 6.1, för att göra det enklare att skriva klienterna, accepterar körningen version 6.1 för det API:et. Beteendet för API:et kommer dock att vara enligt den dokumenterade 6.0-versionen.

`OperationId`

Typ: sträng (uuid)
Obligatoriskt: Ja

Ett GUID som identifierar ett anrop av det här API:et. Detta skickas till motsvarande GetProgress API

`Force`

Typ: booleskt
Obligatoriskt: Ja
Standard: false

Anger om du vill återställa och rensa det interna systemtillståndet som ändrats genom att köra den användarinducerade åtgärden.

`timeout`

Typ: heltal (int64)
Obligatoriskt: Nej
Standard: 60
InclusiveMaximum: 4294967295
InclusiveMinimum: 1

Serverns timeout för att utföra åtgärden i sekunder. Den här tidsgränsen anger hur lång tid klienten är villig att vänta på att den begärda åtgärden ska slutföras. Standardvärdet för den här parametern är 60 sekunder.

Svar

HTTP-statuskod	Description	Svarsschema
200 (OK)	En lyckad åtgärd returnerar statuskoden 200.
Alla andra statuskoder	Det detaljerade felsvaret.	FabricError

Dela via