FabricClient.ClusterManagementClient.RemoveNodeStateAsync Methode

Definition

Namespace:

System.Fabric

Assembly:

System.Fabric.dll

Paket:

Microsoft.ServiceFabric v9.1.1833

Überlädt

RemoveNodeStateAsync(String)	Gibt an, dass die persistenten Daten eines Knotens verloren gehen (z. B. aufgrund eines Datenträgerfehlers oder eines Reimages usw.), und dass Service Fabric alle Dienste oder Zustände auf diesem Knoten als verloren und nicht wiederherstellbar behandeln sollte.
RemoveNodeStateAsync(String, TimeSpan, CancellationToken)	Gibt an, dass ein bestimmter Knoten (der ausgefallen ist) tatsächlich verloren gegangen ist, und dass Service Fabric alle Dienste oder Zustände auf diesem Knoten als verloren und nicht wiederherstellbar behandeln sollte.

RemoveNodeStateAsync(String)

Gibt an, dass die persistenten Daten eines Knotens verloren gehen (z. B. aufgrund eines Datenträgerfehlers oder eines Reimages usw.), und dass Service Fabric alle Dienste oder Zustände auf diesem Knoten als verloren und nicht wiederherstellbar behandeln sollte.

public System.Threading.Tasks.Task RemoveNodeStateAsync (string nodeName);

member this.RemoveNodeStateAsync : string -> System.Threading.Tasks.Task

Public Function RemoveNodeStateAsync (nodeName As String) As Task

Parameter

nodeName

String

Der Name des Knotens, der dauerhaft verloren gegangen ist.

Gibt zurück

Task

Eine Aufgabe, die den Vorgang 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

Nachdem ein Knoten ausgefallen ist, verfolgt Service Fabric replikate persistenter Dienste auf diesem Knoten nach, da sie den Status auf diesem Knoten haben.

In Fällen, in denen der Administrator weiß, dass der persistente Zustand auf einem Knoten dauerhaft verloren gegangen ist, sollte die RemoveNodeStateAsync(String) Methode aufgerufen werden ... , um Service Fabric zu benachrichtigen, dass der Status auf dem Knoten nicht mehr vorhanden ist (oder dass der Knoten nie wieder den Zustand aufweist, den er hatte).

Dadurch wird Service Fabric angewiesen, nicht mehr darauf zu warten, dass dieser Knoten (und alle dauerhaften Replikate auf diesem Knoten) wiederhergestellt werden.

HINWEIS: Diese API darf nur aufgerufen werden, nachdem festgestellt wurde, dass der Zustand auf diesem Knoten verloren gegangen ist.

Damit Sie diese API für Startknoten verwenden können, ändern Sie ab Service Fabric 6.5 die Startknoten in normale (Nicht-Start-) Knoten, und rufen Sie dann diese API auf, um den Knotenzustand zu entfernen.

Wenn der Cluster unter Azure ausgeführt wird, versucht Service Fabric, nachdem der Startknoten heruntergefahren ist, ihn automatisch in einen Nicht-Startknoten zu ändern. Stellen Sie dazu sicher, dass die Anzahl der Nicht-Startknoten im primären Knotentyp nicht kleiner ist als die Anzahl der Down-Startknoten. Fügen Sie zu diesem Zweck bei Bedarf weitere Knoten zum primären Knotentyp hinzu.

Wenn für eigenständige Cluster nicht erwartet wird, dass der Status des Down-Startknotens wieder intakt ist, entfernen Sie den Knoten aus dem Cluster. https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

Wenn diese API aufgerufen wird und der Knoten mit intaktem Zustand zurückkommt, lautet er Nicht definiertes Verhalten.

RemoveNodeStateAsync(String, TimeSpan, CancellationToken)

Gibt an, dass ein bestimmter Knoten (der ausgefallen ist) tatsächlich verloren gegangen ist, und dass Service Fabric alle Dienste oder Zustände auf diesem Knoten als verloren und nicht wiederherstellbar behandeln sollte.

public System.Threading.Tasks.Task RemoveNodeStateAsync (string nodeName, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.RemoveNodeStateAsync : string * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function RemoveNodeStateAsync (nodeName As String, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Parameter

nodeName

String

Der Name des Knotens, der dauerhaft verloren gegangen ist.

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

Eine Aufgabe, die den Vorgang 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

Nachdem ein Knoten ausgefallen ist, verfolgt Service Fabric replikate persistenter Dienste auf diesem Knoten nach, da sie den Status auf diesem Knoten haben.

In Fällen, in denen der Administrator weiß, dass ein Knoten (und sein Zustand) dauerhaft verloren gegangen ist, sollte die RemoveNodeStateAsync(String) -Methode aufgerufen werden.

Dadurch wird Service Fabric angewiesen, nicht mehr darauf zu warten, dass dieser Knoten (und alle dauerhaften Replikate auf diesem Knoten) wiederhergestellt werden.

HINWEIS: Diese API darf nur aufgerufen werden, nachdem festgestellt wurde, dass der Zustand auf diesem Knoten verloren gegangen ist.

Damit Sie diese API für Startknoten verwenden können, ändern Sie ab Service Fabric 6.5 die Startknoten in normale (Nicht-Start-) Knoten, und rufen Sie dann diese API auf, um den Knotenzustand zu entfernen.

Wenn der Cluster unter Azure ausgeführt wird, versucht Service Fabric, nachdem der Startknoten heruntergefahren ist, ihn automatisch in einen Nicht-Startknoten zu ändern. Stellen Sie dazu sicher, dass die Anzahl der Nicht-Startknoten im primären Knotentyp nicht kleiner ist als die Anzahl der Down-Startknoten. Fügen Sie zu diesem Zweck bei Bedarf weitere Knoten zum primären Knotentyp hinzu.

Wenn für eigenständige Cluster nicht erwartet wird, dass der Status des Down-Startknotens wieder intakt ist, entfernen Sie den Knoten aus dem Cluster. https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

Wenn diese API aufgerufen wird und der Knoten mit intaktem Zustand zurückkommt, lautet er Nicht definiertes Verhalten.