FabricClient.ClusterManagementClient.DeactivateNodeAsync Methode

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Paket:

Microsoft.ServiceFabric v9.1.1833

Überlädt

DeactivateNodeAsync(String, NodeDeactivationIntent)	Deaktiviert einen bestimmten Knoten mit dem angegebenen NodeDeactivationIntent.
DeactivateNodeAsync(String, NodeDeactivationIntent, TimeSpan, CancellationToken)	Deaktiviert einen bestimmten Knoten mit dem angegebenen NodeDeactivationIntent.

DeactivateNodeAsync(String, NodeDeactivationIntent)

Deaktiviert einen bestimmten Knoten mit dem angegebenen NodeDeactivationIntent.

public System.Threading.Tasks.Task DeactivateNodeAsync (string nodeName, System.Fabric.NodeDeactivationIntent deactivationIntent);

member this.DeactivateNodeAsync : string * System.Fabric.NodeDeactivationIntent -> System.Threading.Tasks.Task

Public Function DeactivateNodeAsync (nodeName As String, deactivationIntent As NodeDeactivationIntent) As Task

Parameter

nodeName

String

Der Name des zu deaktivierenden Knotens.

deactivationIntent

NodeDeactivationIntent

Die NodeDeactivationIntent zum Deaktivieren des Knotens.

Gibt zurück

Task

Ein Task, der die asynchrone Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung häufiger FabricClient-Fehler finden Sie unter https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ .

TimeoutException

Informationen zur Behandlung häufiger FabricClient-Fehler finden Sie unter https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ .

FabricException

Siehe auch https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ zur Behandlung häufiger FabricClient-Fehler.

Hinweise

Wenn diese API abgeschlossen ist, bedeutet dies, dass die Absicht zum Deaktivieren vom System registriert wurde. Dies bedeutet nicht, dass die Deaktivierung abgeschlossen ist. Der Fortschritt des Vorgangs kann mithilfe der GetNodeListAsync() API bestimmt werden.

Sobald die Deaktivierung ausgeführt wird, kann die Deaktivierungsabsicht "erhöht" aber nicht verringert werden (beispielsweise kann ein Knoten, der mit der Pause-Absicht deaktiviert wurde, mit Restart weiter deaktiviert werden, aber nicht umgekehrt. Knoten können jederzeit nach ihrer Deaktivierung reaktiviert ActivateNodeAsync(String) werden. Wenn die Deaktivierung nicht abgeschlossen ist, wird die Deaktivierung dadurch abgebrochen. Ein Knoten, der während der Deaktivierung heruntergefahren und wieder hochgefahren wird, muss immer noch reaktiviert werden, bevor Dienste auf diesem Knoten platziert werden.

Service Fabric stellt sicher, dass die Deaktivierung ein "sicherer" Prozess ist. Es führt mehrere Sicherheitsüberprüfungen (siehe SafetyCheckKind) durch, um sicherzustellen, dass keine Verfügbarkeit oder Daten verloren gehen.

DeactivateNodeAsync(String, NodeDeactivationIntent, TimeSpan, CancellationToken)

Deaktiviert einen bestimmten Knoten mit dem angegebenen NodeDeactivationIntent.

public System.Threading.Tasks.Task DeactivateNodeAsync (string nodeName, System.Fabric.NodeDeactivationIntent deactivationIntent, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.DeactivateNodeAsync : string * System.Fabric.NodeDeactivationIntent * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function DeactivateNodeAsync (nodeName As String, deactivationIntent As NodeDeactivationIntent, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameter

nodeName

String

Der Name des zu deaktivierenden Knotens.

deactivationIntent

NodeDeactivationIntent

Die NodeDeactivationIntent zum Deaktivieren des Knotens.

timeout

TimeSpan

Der Zeitraum, der die maximale Zeitspanne definiert, ermöglicht es, dass dieser Vorgang fortgesetzt werden kann, bevor ein TimeoutExceptionzurückgegeben wird.

cancellationToken

CancellationToken

Das optionale Abbruchtoken, das der Vorgang beobachtet. Sie kann verwendet werden, um eine Benachrichtigung zu senden, dass der Vorgang abgebrochen werden soll. Beachten Sie, dass der Abbruch eine Empfehlung ist und dass der Vorgang auch dann abgeschlossen werden kann, wenn er abgebrochen wird.

Gibt zurück

Task

Ein Task, der die asynchrone Bestätigung der Anforderung darstellt.

Ausnahmen

FabricObjectClosedException

Informationen zur Behandlung häufiger FabricClient-Fehler finden Sie unter https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ .

TimeoutException

Informationen zur Behandlung häufiger FabricClient-Fehler finden Sie unter https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ .

FabricException

Siehe auch https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ zur Behandlung häufiger FabricClient-Fehler.

Hinweise

Wenn diese API abgeschlossen ist, bedeutet dies, dass die Absicht zum Deaktivieren vom System registriert wurde. Dies bedeutet nicht, dass die Deaktivierung abgeschlossen ist. Der Fortschritt des Vorgangs kann mithilfe der GetNodeListAsync() API bestimmt werden.

Sobald die Deaktivierung ausgeführt wird, kann die Deaktivierungsabsicht "erhöht" aber nicht verringert werden (beispielsweise kann ein Knoten, der mit der Pause-Absicht deaktiviert wurde, mit Restart weiter deaktiviert werden, aber nicht umgekehrt. Knoten können jederzeit nach ihrer Deaktivierung reaktiviert ActivateNodeAsync(String) werden. Wenn die Deaktivierung nicht abgeschlossen ist, wird die Deaktivierung dadurch abgebrochen. Ein Knoten, der während der Deaktivierung heruntergefahren und wieder hochgefahren wird, muss immer noch reaktiviert werden, bevor Dienste auf diesem Knoten platziert werden.

Service Fabric stellt sicher, dass die Deaktivierung ein "sicherer" Prozess ist. Es führt mehrere Sicherheitsüberprüfungen (siehe SafetyCheckKind) durch, um sicherzustellen, dass keine Verfügbarkeit oder Daten verloren gehen.