FabricClient.TestManagementClient.CancelTestCommandAsync Methode

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Paket:

Microsoft.ServiceFabric v9.1.1833

Überlädt

CancelTestCommandAsync(Guid, Boolean)	Bricht einen Testbefehl ab.
CancelTestCommandAsync(Guid, Boolean, CancellationToken)	Bricht einen Testbefehl ab.
CancelTestCommandAsync(Guid, Boolean, TimeSpan)	Bricht einen Testbefehl ab.
CancelTestCommandAsync(Guid, Boolean, TimeSpan, CancellationToken)	Bricht einen Testbefehl ab.

CancelTestCommandAsync(Guid, Boolean)

Bricht einen Testbefehl ab.

public System.Threading.Tasks.Task CancelTestCommandAsync (Guid operationId, bool force);

member this.CancelTestCommandAsync : Guid * bool -> System.Threading.Tasks.Task

Public Function CancelTestCommandAsync (operationId As Guid, force As Boolean) As Task

Parameter

operationId

Guid

Gibt die operationId des abzubrechenden Testbefehls an.

force

Boolean

Gibt an, ob ein ordnungsgemäßes Rollback und sauber internen Systemstatus ausgeführt werden soll, der durch Ausführen des Testbefehls geändert wurde. Siehe Hinweise.

Gibt zurück

Task

Eine Aufgabe.

Hinweise

Wenn force false ist, wird der angegebene Testbefehl ordnungsgemäß beendet und bereinigt. Wenn „force“ auf „true“ festgelegt ist, wird der Befehl abgebrochen und möglicherweise wird ein interner Zustand beibehalten. „force“ sollte nur mit Bedacht auf „true“ festgelegt werden. Das Aufrufen von CancelTestCommandAsync() mit force set auf true ist erst zulässig, wenn CancelTestCommandAsync() für denselben Testbefehl mit erzwingen erster Einstellung aufgerufen wurde, oder es sei denn, der Testbefehl verfügt bereits über einen TestCommandProgressState von TestCommandProgressState.RollingBack. Klarstellung: TestCommandProgressState.RollingBack bedeutet, dass das System den internen Systemzustand bereinigt, der durch die Ausführung des Befehls verursacht wird. Es werden keine Daten wiederhergestellt, wenn der Testbefehl einen Datenverlust verursacht hätte. Wenn Sie beispielsweise StartPartitionDataLossAsync() aufrufen, dann CancelTestCommandAsync() aufrufen, sauber das System nur den internen Zustand auf, wenn der Befehl ausgeführt wird. Die Daten der Zielpartition werden nicht wiederhergestellt, wenn der Befehl weit genug fortgeschritten ist, um einen Datenverlust zu verursachen.

Wichtiger Hinweis: Wenn diese API mit „force==true“ aufgerufen wird, bleibt möglicherweise der interne Zustand zurück. CleanTestStateAsync() sollte aufgerufen werden, um den zustand zu entfernen, der möglicherweise zurückgelassen wurde.

Der FaultAnalysisService muss für die Verwendung dieser API aktiviert sein.

CancelTestCommandAsync(Guid, Boolean, CancellationToken)

Bricht einen Testbefehl ab.

public System.Threading.Tasks.Task CancelTestCommandAsync (Guid operationId, bool force, System.Threading.CancellationToken cancellationToken);

member this.CancelTestCommandAsync : Guid * bool * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CancelTestCommandAsync (operationId As Guid, force As Boolean, cancellationToken As CancellationToken) As Task

Parameter

operationId

Guid

Gibt die operationId des abzubrechenden Testbefehls an.

force

Boolean

Gibt an, ob ein ordnungsgemäßes Rollback und sauber internen Systemstatus ausgeführt werden soll, der durch Ausführen des Testbefehls geändert wurde. Siehe Hinweise.

cancellationToken

CancellationToken

Diesem Token kann signalisiert werden, dass dieser Vorgang abgebrochen wird, bevor er abgeschlossen wird.

Gibt zurück

Task

Eine Aufgabe.

Hinweise

Wenn force false ist, wird der angegebene Testbefehl ordnungsgemäß beendet und bereinigt. Wenn „force“ auf „true“ festgelegt ist, wird der Befehl abgebrochen und möglicherweise wird ein interner Zustand beibehalten. „force“ sollte nur mit Bedacht auf „true“ festgelegt werden. Das Aufrufen von CancelTestCommandAsync() mit force set auf true ist erst zulässig, wenn CancelTestCommandAsync() für denselben Testbefehl mit erzwingen erster Einstellung aufgerufen wurde, oder es sei denn, der Testbefehl verfügt bereits über einen TestCommandProgressState von TestCommandProgressState.RollingBack. Klarstellung: TestCommandProgressState.RollingBack bedeutet, dass das System den internen Systemzustand bereinigt, der durch die Ausführung des Befehls verursacht wird. Es werden keine Daten wiederhergestellt, wenn der Testbefehl einen Datenverlust verursacht hätte. Wenn Sie beispielsweise StartPartitionDataLossAsync() aufrufen, dann CancelTestCommandAsync() aufrufen, sauber das System nur den internen Zustand auf, wenn der Befehl ausgeführt wird. Die Daten der Zielpartition werden nicht wiederhergestellt, wenn der Befehl weit genug fortgeschritten ist, um einen Datenverlust zu verursachen.

Wichtiger Hinweis: Wenn diese API mit „force==true“ aufgerufen wird, bleibt möglicherweise der interne Zustand zurück. CleanTestStateAsync() sollte aufgerufen werden, um den zustand zu entfernen, der möglicherweise zurückgelassen wurde.

Der FaultAnalysisService muss für die Verwendung dieser API aktiviert sein.

CancelTestCommandAsync(Guid, Boolean, TimeSpan)

Bricht einen Testbefehl ab.

public System.Threading.Tasks.Task CancelTestCommandAsync (Guid operationId, bool force, TimeSpan timeout);

member this.CancelTestCommandAsync : Guid * bool * TimeSpan -> System.Threading.Tasks.Task

Public Function CancelTestCommandAsync (operationId As Guid, force As Boolean, timeout As TimeSpan) As Task

Parameter

operationId

Guid

Gibt die operationId des abzubrechenden Testbefehls an.

force

Boolean

Gibt an, ob ein ordnungsgemäßes Rollback und sauber internen Systemstatus ausgeführt werden soll, der durch Ausführen des Testbefehls geändert wurde. Siehe Hinweise.

timeout

TimeSpan

Das Timeout, das für den API-Aufruf verwendet werden soll.

Gibt zurück

Task

Eine Aufgabe.

Hinweise

Wenn force false ist, wird der angegebene Testbefehl ordnungsgemäß beendet und bereinigt. Wenn „force“ auf „true“ festgelegt ist, wird der Befehl abgebrochen und möglicherweise wird ein interner Zustand beibehalten. „force“ sollte nur mit Bedacht auf „true“ festgelegt werden. Das Aufrufen von CancelTestCommandAsync() mit force set auf true ist erst zulässig, wenn CancelTestCommandAsync() für denselben Testbefehl mit erzwingen erster Einstellung aufgerufen wurde, oder es sei denn, der Testbefehl verfügt bereits über einen TestCommandProgressState von TestCommandProgressState.RollingBack. Klarstellung: TestCommandProgressState.RollingBack bedeutet, dass das System den internen Systemzustand bereinigt, der durch die Ausführung des Befehls verursacht wird. Es werden keine Daten wiederhergestellt, wenn der Testbefehl einen Datenverlust verursacht hätte. Wenn Sie beispielsweise StartPartitionDataLossAsync() aufrufen, dann CancelTestCommandAsync() aufrufen, sauber das System nur den internen Zustand auf, wenn der Befehl ausgeführt wird. Die Daten der Zielpartition werden nicht wiederhergestellt, wenn der Befehl weit genug fortgeschritten ist, um einen Datenverlust zu verursachen.

Wichtiger Hinweis: Wenn diese API mit „force==true“ aufgerufen wird, bleibt möglicherweise der interne Zustand zurück. CleanTestStateAsync() sollte aufgerufen werden, um den zustand zu entfernen, der möglicherweise zurückgelassen wurde.

Der FaultAnalysisService muss für die Verwendung dieser API aktiviert sein.

CancelTestCommandAsync(Guid, Boolean, TimeSpan, CancellationToken)

Bricht einen Testbefehl ab.

public System.Threading.Tasks.Task CancelTestCommandAsync (Guid operationId, bool force, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.CancelTestCommandAsync : Guid * bool * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function CancelTestCommandAsync (operationId As Guid, force As Boolean, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameter

operationId

Guid

Gibt die operationId des abzubrechenden Testbefehls an.

force

Boolean

Gibt an, ob ein ordnungsgemäßes Rollback und sauber internen Systemstatus ausgeführt werden soll, der durch Ausführen des Testbefehls geändert wurde. Siehe Hinweise.

timeout

TimeSpan

Das Timeout, das für den API-Aufruf verwendet werden soll.

cancellationToken

CancellationToken

Diesem Token kann signalisiert werden, dass dieser Vorgang abgebrochen wird, bevor er abgeschlossen wird.

Gibt zurück

Task

Eine Aufgabe.

Hinweise

Wenn force false ist, wird der angegebene Testbefehl ordnungsgemäß beendet und bereinigt. Wenn „force“ auf „true“ festgelegt ist, wird der Befehl abgebrochen und möglicherweise wird ein interner Zustand beibehalten. „force“ sollte nur mit Bedacht auf „true“ festgelegt werden. Das Aufrufen von CancelTestCommandAsync() mit force set auf true ist erst zulässig, wenn CancelTestCommandAsync() für denselben Testbefehl mit erzwingen erster Einstellung aufgerufen wurde, oder es sei denn, der Testbefehl verfügt bereits über einen TestCommandProgressState von TestCommandProgressState.RollingBack. Klarstellung: TestCommandProgressState.RollingBack bedeutet, dass das System den internen Systemzustand bereinigt, der durch die Ausführung des Befehls verursacht wird. Es werden keine Daten wiederhergestellt, wenn der Testbefehl einen Datenverlust verursacht hätte. Wenn Sie beispielsweise StartPartitionDataLossAsync() aufrufen, dann CancelTestCommandAsync() aufrufen, sauber das System nur den internen Zustand auf, wenn der Befehl ausgeführt wird. Die Daten der Zielpartition werden nicht wiederhergestellt, wenn der Befehl weit genug fortgeschritten ist, um einen Datenverlust zu verursachen.

Wichtiger Hinweis: Wenn diese API mit „force==true“ aufgerufen wird, bleibt möglicherweise der interne Zustand zurück. CleanTestStateAsync() sollte aufgerufen werden, um den zustand zu entfernen, der möglicherweise zurückgelassen wurde.

Der FaultAnalysisService muss für die Verwendung dieser API aktiviert sein.