FabricClient.ServiceManagementClient.RestartReplicaAsync Méthode

Définition

Espace de noms:

System.Fabric

Assembly:

System.Fabric.dll

Paquet:

Microsoft.ServiceFabric v9.1.1833

Surcharges

RestartReplicaAsync(String, Guid, Int64)	Redémarre un réplica de service d’un service persistant exécuté sur un nœud.
RestartReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)	Redémarre un réplica de service d’un service persistant exécuté sur un nœud. Prend également un intervalle de délai d’expiration, qui est le temps maximal pendant lequel le système autorise cette opération à se poursuivre avant de retourner TimeoutException et le jeton d’annulation que l’opération observe.

RestartReplicaAsync(String, Guid, Int64)

Redémarre un réplica de service d’un service persistant exécuté sur un nœud.

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId);

member this.RestartReplicaAsync : string * Guid * int64 -> System.Threading.Tasks.Task

Public Function RestartReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long) As Task

Paramètres

nodeName

String

Nom du nœud.

partitionId

Guid

Identificateur de partition.

replicaOrInstanceId

Int64

Identificateur de l'instance.

Retours

Task

Tâche représentant l’accusé de réception de la demande.

Exceptions

FabricObjectClosedException

Consultez https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

TimeoutException

Consultez https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

FabricException

ReplicaDoesNotExistest retourné si l’ID réplica ou instance n’est pas en cours d’exécution sur le nœud.

InvalidReplicaStateForReplicaOperationest retourné si l’ID réplica ou instance ne peut pas être redémarré ou supprimé pour le moment, car il est dans un état non valide. Par exemple, le réplica est déjà en cours de fermeture.

InvalidReplicaOperationest retourné si le réplica n’appartient pas à un service persistant avec état. Seuls les réplicas persistants avec état peuvent être redémarrés.

Consultez également https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

ArgumentException

Si nodeName est null ou vide.

Remarques

AVERTISSEMENT : Aucune vérification de sécurité n’est effectuée lorsque cette API est utilisée. Une utilisation incorrecte de cette API peut entraîner une perte de disponibilité des services avec état.

Le délai d’expiration par défaut est d’une minute pendant laquelle le système autorise cette opération à se poursuivre avant de retourner TimeoutException.

RestartReplicaAsync(String, Guid, Int64, TimeSpan, CancellationToken)

Redémarre un réplica de service d’un service persistant exécuté sur un nœud. Prend également un intervalle de délai d’expiration, qui est le temps maximal pendant lequel le système autorise cette opération à se poursuivre avant de retourner TimeoutException et le jeton d’annulation que l’opération observe.

public System.Threading.Tasks.Task RestartReplicaAsync (string nodeName, Guid partitionId, long replicaOrInstanceId, TimeSpan timeout, System.Threading.CancellationToken cancellationToken);

member this.RestartReplicaAsync : string * Guid * int64 * TimeSpan * System.Threading.CancellationToken -> System.Threading.Tasks.Task

Public Function RestartReplicaAsync (nodeName As String, partitionId As Guid, replicaOrInstanceId As Long, timeout As TimeSpan, cancellationToken As CancellationToken) As Task

Paramètres

nodeName

String

Nom du nœud.

partitionId

Guid

Identificateur de partition.

replicaOrInstanceId

Int64

Identificateur de l'instance.

timeout

TimeSpan

L’intervalle de temps qui définit la durée maximale permet à cette opération de continuer 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 avis et que l’opération peut toujours être terminée même si elle est annulée.

Retours

Task

Tâche représentant l’accusé de réception de la demande.

Exceptions

FabricObjectClosedException

Consultez https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

TimeoutException

Consultez https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

FabricException

ReplicaDoesNotExistest retourné si l’ID réplica ou instance n’est pas en cours d’exécution sur le nœud.

InvalidReplicaStateForReplicaOperationest retourné si l’ID réplica ou instance ne peut pas être redémarré ou supprimé pour le moment, car il est dans un état non valide. Par exemple, le réplica est déjà en cours de fermeture.

InvalidReplicaOperationest retourné si le réplica n’appartient pas à un service persistant avec état. Seuls les réplicas persistants avec état peuvent être redémarrés.

Consultez également https://docs.microsoft.com/en-us/azure/service-fabric/service-fabric-errors-and-exceptions pour gérer les échecs FabricClient courants.

ArgumentException

Si nodeName est null ou vide.

Remarques

AVERTISSEMENT : Aucune vérification de sécurité n’est effectuée lorsque cette API est utilisée. Une utilisation incorrecte de cette API peut entraîner une perte de disponibilité des services avec état.