Bewerking annuleren

Artikel
08/05/2023

Hiermee annuleert u een door de gebruiker veroorzaakte foutbewerking.

De volgende API's starten foutbewerkingen die kunnen worden geannuleerd met behulp van CancelOperation: StartDataLoss, StartQuorumLoss, StartPartitionRestart, StartNodeTransition.

Als kracht onwaar is, wordt de opgegeven door de gebruiker geïnduceerde bewerking probleemloos gestopt en opgeschoond. Als kracht waar is, wordt de opdracht afgebroken en kan een interne status achterblijven. Het opgeven van kracht als waar moet zorgvuldig worden gebruikt. Het aanroepen van deze API met force ingesteld op true is pas toegestaan als deze API al is aangeroepen op dezelfde testopdracht waarbij force eerst is ingesteld op false, of tenzij de testopdracht al operationState van OperationState.RollingBack heeft. Verduidelijking: OperationState.RollingBack betekent dat het systeem de interne systeemstatus opschoont die wordt veroorzaakt door het uitvoeren van de opdracht. Er worden geen gegevens hersteld als de testopdracht gegevensverlies zou veroorzaken. Als u bijvoorbeeld StartDataLoss aanroept en vervolgens deze API aanroept, wordt de interne status alleen opgeschoond van het uitvoeren van de opdracht. De gegevens van de doelpartitie worden niet hersteld als de opdracht ver genoeg is gevorderd om gegevensverlies te veroorzaken.

Belangrijke opmerking: als deze API wordt aangeroepen met force==true, kan de interne status achterblijven.

Aanvraag

Methode	Aanvraag-URI
POST	`/Faults/$/Cancel?api-version=6.0&OperationId={OperationId}&Force={Force}&timeout={timeout}`

Parameters

Naam	Type	Vereist	Locatie
`api-version`	tekenreeks	Ja	Query’s uitvoeren
`OperationId`	tekenreeks (uuid)	Ja	Query’s uitvoeren
`Force`	booleaans	Ja	Query’s uitvoeren
`timeout`	geheel getal (int64)	Nee	Query’s uitvoeren

`api-version`

Type: tekenreeks
Vereist: Ja
Standaardinstelling: 6.0

De versie van de API. Deze parameter is vereist en de waarde moet '6.0' zijn.

Service Fabric REST API-versie is gebaseerd op de runtimeversie waarin de API is geïntroduceerd of gewijzigd. Service Fabric-runtime ondersteunt meer dan één versie van de API. Dit is de nieuwste ondersteunde versie van de API. Als een lagere API-versie wordt doorgegeven, kan het geretourneerde antwoord afwijken van het antwoord dat in deze specificatie wordt beschreven.

Daarnaast accepteert de runtime elke versie die hoger is dan de meest recente ondersteunde versie tot de huidige versie van de runtime. Dus als de nieuwste API-versie 6.0 is, maar als de runtime 6.1 is, accepteert de runtime versie 6.1 voor die API om het eenvoudiger te maken om de clients te schrijven. Het gedrag van de API is echter volgens de gedocumenteerde versie 6.0.

`OperationId`

Type: tekenreeks (uuid)
Vereist: Ja

Een GUID die een aanroep van deze API identificeert. Dit wordt doorgegeven aan de bijbehorende GetProgress-API

`Force`

Type: booleaanse waarde
Vereist: Ja
Standaardinstelling: false

Hiermee wordt aangegeven of de interne systeemstatus die is gewijzigd, probleemloos moet worden teruggedraaid en opgeschoond door de gebruiker geïnduceerde bewerking uit te voeren.

`timeout`

Type: geheel getal (int64)
Vereist: Nee
Standaardinstelling: 60
InclusiveMaximum: 4294967295
InclusiefMinimum: 1

De time-out van de server voor het uitvoeren van de bewerking in seconden. Deze time-out geeft de tijdsduur aan die de client bereid is te wachten totdat de aangevraagde bewerking is voltooid. De standaardwaarde voor deze parameter is 60 seconden.

Antwoorden

HTTP-statuscode	Beschrijving	Antwoordschema
200 (OK)	Een geslaagde bewerking retourneert de statuscode 200.
Alle andere statuscodes	Het gedetailleerde foutantwoord.	FabricError

Delen via