Méthodes asynchrones
Suggérer des modifications
PDF
Certaines méthodes d'API sont asynchrones, ce qui signifie que l'opération qu'elles effectuent peut ne pas être terminée lorsque la méthode retourne. Les méthodes asynchrones renvoient un descripteur que vous pouvez interroger pour voir l'état de l'opération. Les informations d'état de certaines opérations peuvent inclure un pourcentage d'achèvement.
Lorsque vous effectuez une requête asynchrone, le résultat peut être l'un des types suivants :
-
DriveAdd: Le système ajoute un disque au cluster. -
BulkVolume: Le système effectue une opération de copie entre des volumes, comme une sauvegarde ou une restauration. -
Clone: Le système est en cours de clonage d'un volume. -
DriveRemoval: Le système copie les données d'un disque en préparation pour le retirer du cluster. -
RtfiPendingNode: Le système installe des logiciels compatibles sur un nœud avant de l'ajouter au cluster.
Noter les points suivants lors de l'utilisation de méthodes asynchrones ou de l'obtention de l'état d'une opération asynchrone en cours :
-
Les méthodes asynchrones sont indiquées dans la documentation de la méthode individuelle.
-
Les méthodes asynchrones renvoient un "asynchrones", qui est un descripteur connu par la méthode API émettrice. Vous pouvez utiliser la poignée pour interroger l'état ou le résultat de l'opération asynchrone.
-
Vous pouvez obtenir le résultat de méthodes asynchrones individuelles avec la méthode GetAsyncResult. Lorsque vous utilisez GetAsyncResult pour interroger une opération terminée, le système renvoie le résultat et purge automatiquement le résultat du système. Lorsque vous utilisez GetAsyncResult pour interroger une opération incomplète, le système renvoie le résultat mais ne le purge pas.
-
Vous pouvez obtenir l'état et les résultats de toutes les méthodes asynchrones en cours d'exécution ou terminées à l'aide de la méthode ListAsyncResults. Dans ce cas, le système ne purge pas les résultats des opérations terminées.