FabricClient.ClusterManagementClient.RemoveNodeStateAsync Méthode

Définition

Espace de noms:

System.Fabric

Assembly:

System.Fabric.dll

Paquet:

Microsoft.ServiceFabric v9.1.1833

Surcharges

RemoveNodeStateAsync(String)	Indique que les données persistantes d’un nœud sont perdues (par exemple, en raison d’une défaillance de disque ou d’une nouvelle image, etc.) et que Service Fabric doit traiter tous les services ou états sur ce nœud comme perdus et irrécupérables.
RemoveNodeStateAsync(String, TimeSpan, CancellationToken)	Indique qu’un nœud particulier (qui est en panne) a effectivement été perdu et que Service Fabric doit traiter les services ou l’état de ce nœud comme perdus et irrécupérables.

RemoveNodeStateAsync(String)

Indique que les données persistantes d’un nœud sont perdues (par exemple, en raison d’une défaillance de disque ou d’une nouvelle image, etc.) et que Service Fabric doit traiter tous les services ou états sur ce nœud comme perdus et irrécupérables.

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

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

Public Function RemoveNodeStateAsync (nodeName As String) As Task

Paramètres

nodeName

String

Nom du nœud qui a été définitivement perdu.

Retours

Task

Tâche qui représente l'opération.

Exceptions

FabricObjectClosedException

Consultez https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

TimeoutException

Consultez https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

FabricException

Consultez également https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

Remarques

Une fois qu’un nœud tombe en panne, Service Fabric effectue le suivi des réplicas des services persistants sur ce nœud, car ils ont un état sur ce nœud.

Dans les cas où l’administrateur sait que l’état persistant sur un nœud a été définitivement perdu, la RemoveNodeStateAsync(String) méthode doit être appelée ... pour informer Service Fabric que l’état sur le nœud a disparu (ou que le nœud ne peut jamais revenir avec l’état qu’il avait).

Cela indique à Service Fabric d’arrêter d’attendre que ce nœud (et tous les réplicas persistants sur ce nœud) soit récupéré.

REMARQUE : Cette API doit être appelée uniquement une fois qu’il a été déterminé que l’état sur ce nœud a été perdu.

À partir de Service Fabric 6.5, pour utiliser cette API pour des nœuds seed, transformez ces nœuds seed en nœuds classiques (non initiaux), puis appelez l’API afin de supprimer l’état des nœuds.

Si le cluster s'exécute sur Azure, Service Fabric tente automatiquement de transformer un nœud seed qui vient de s’arrêter en nœud non seed. Pour le permettre, assurez-vous que le nombre de nœuds non seed dans le type de nœud principal est supérieur au nombre de nœuds seed avec l’état Arrêté. Le cas échéant, ajoutez des nœuds supplémentaires au type de nœud principal.

Pour le cluster autonome, si le nœud initial vers le bas n’est pas censé revenir avec son état intact, supprimez le nœud du cluster. https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

Si cette API est appelée et que le nœud revient avec son état intact, il s’agit d’Undefined Behavior

RemoveNodeStateAsync(String, TimeSpan, CancellationToken)

Indique qu’un nœud particulier (qui est en panne) a effectivement été perdu et que Service Fabric doit traiter les services ou l’état de ce nœud comme perdus et irrécupérables.

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

Paramètres

nodeName

String

Nom du nœud qui a été définitivement perdu.

timeout

TimeSpan

L’intervalle de temps qui définit la durée maximale permet à cette opération de se poursuivre avant de retourner un TimeoutException.

cancellationToken

CancellationToken

Jeton d’annulation facultatif que l’opération observe. Il peut être utilisé pour envoyer une notification indiquant que l’opération doit être annulée. Notez que l’annulation est un avertissement et que l’opération peut toujours être terminée même si elle est annulée.

Retours

Task

Tâche qui représente l'opération.

Exceptions

FabricObjectClosedException

Consultez https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

TimeoutException

Consultez https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

FabricException

Consultez également https://azure.microsoft.com/documentation/articles/service-fabric-errors-and-exceptions/ pour la gestion des échecs FabricClient courants.

Remarques

Une fois qu’un nœud tombe en panne, Service Fabric effectue le suivi des réplicas des services persistants sur ce nœud, car ils ont un état sur ce nœud.

Dans les cas où l’administrateur sait qu’un nœud (et son état) a été définitivement perdu, la RemoveNodeStateAsync(String) méthode doit être appelée.

Cela indique à Service Fabric d’arrêter d’attendre que ce nœud (et tous les réplicas persistants sur ce nœud) soit récupéré.

REMARQUE : Cette API doit être appelée uniquement une fois qu’il a été déterminé que l’état sur ce nœud a été perdu.

À partir de Service Fabric 6.5, pour utiliser cette API pour des nœuds seed, transformez ces nœuds seed en nœuds classiques (non initiaux), puis appelez l’API afin de supprimer l’état des nœuds.

Si le cluster s'exécute sur Azure, Service Fabric tente automatiquement de transformer un nœud seed qui vient de s’arrêter en nœud non seed. Pour le permettre, assurez-vous que le nombre de nœuds non seed dans le type de nœud principal est supérieur au nombre de nœuds seed avec l’état Arrêté. Le cas échéant, ajoutez des nœuds supplémentaires au type de nœud principal.

Pour le cluster autonome, si le nœud initial vers le bas n’est pas censé revenir avec son état intact, supprimez le nœud du cluster. https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-cluster-windows-server-add-remove-nodes/

Si cette API est appelée et que le nœud revient avec son état intact, il s’agit d’Undefined Behavior