RestoreContext.RestoreAsync Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Surcharges
| RestoreAsync(RestoreDescription) |
Restaure une sauvegarde décrite par RestoreDescription. |
| RestoreAsync(RestoreDescription, CancellationToken) |
Restaurez une sauvegarde décrite par RestoreDescription. |
RestoreAsync(RestoreDescription)
Restaure une sauvegarde décrite par RestoreDescription.
public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription);member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription -> System.Threading.Tasks.TaskPublic Function RestoreAsync (restoreDescription As RestoreDescription) As TaskParamètres
- restoreDescription
- RestoreDescription
Description de la demande de restauration.
Retours
Tâche qui représente l’opération de restauration asynchrone.
Exceptions
Indique que le dossier de sauvegarde d’entrée ne contient pas de sauvegarde complète. Pour qu’un dossier de sauvegarde puisse être restauré, il doit contenir exactement une sauvegarde complète et un nombre quelconque de sauvegardes incrémentielles.
Indique que l’un des arguments n’est pas valide. Par exemple, lors de la restauration d’un service fiable si RestorePolicy a la valeur Safe, mais que le dossier de sauvegarde d’entrée contient une version de l’état antérieure à l’état conservé dans le réplica actuel.
Lors de la restauration d’un service Actor, cette exception est levée si spécifiée BackupFolderPath est vide.
Indique que le répertoire de restauration fourni n’existe pas.
Indique que le réplica se ferme.
Indique que l’opération de restauration actuelle n’est pas valide. Par exemple, le ServicePartitionKind de la partition à partir de laquelle la sauvegarde a été effectuée est différent de celui de la partition actuelle en cours de restauration.
Indique que les fichiers de sauvegarde attendus dans le répertoire de restauration fourni sont introuvables.
Indique que l’opération de restauration a rencontré une erreur inattendue ou que les fichiers de sauvegarde du répertoire de restauration ne sont pas valides. La ErrorCode propriété indique le type d’erreur qui s’est produite.
- InvalidBackup Indique que les fichiers de sauvegarde fournis dans le répertoire de restauration sont des fichiers manquants ou ont des fichiers inattendus supplémentaires.
- InvalidRestoreData Indique que les fichiers de métadonnées (restore.dat) présents dans le répertoire de restauration sont endommagés ou contiennent des informations non valides.
- InvalidBackupChain Indique que la chaîne de sauvegarde (c’est-à-dire une sauvegarde complète et aucune ou plusieurs sauvegardes incrémentielles contiguës qui ont été effectuées après celle-ci) fournie dans le répertoire de restauration est rompue.
- DuplicateBackups Indique que la chaîne de sauvegarde (c’est-à-dire une sauvegarde complète et aucune ou plusieurs sauvegardes incrémentielles contiguës qui ont été effectuées après elle) fournie dans le répertoire de restauration contient des sauvegardes en double.
- RestoreSafeCheckFailed Si Safe est spécifié dans le cadre de RestoreDescription, cela indique que la sauvegarde fournie pour la restauration contient des données plus anciennes que celles actuellement présentes dans le service.
Remarques
Cette API doit être appelée à partir de la méthode OnDataLossAsync. Une seule API RestoreAsync peut être en vol par réplica à un moment donné.
Notez que les exceptions levées par cette API diffèrent selon le fournisseur d’état sous-jacent. Les exceptions actuellement documentées pour cette API s’appliquent uniquement aux fournisseurs d’état prêtes à l’emploi fournis par Service Fabric pour Reliable Services et Reliable Actors.
Les exceptions suivantes sont levées par cette API lorsqu’elle est appelée dans Reliable Service :
Les exceptions suivantes sont levées par cette API lorsqu’elle est appelée dans Actor Service avec KvsActorStateProvider comme fournisseur d’état (qui est le fournisseur d’état par défaut pour Reliable Actors) :
- ArgumentException
- DirectoryNotFoundException
- FabricObjectClosedException
- InvalidOperationException
- FileNotFoundException
- FabricException
S’applique à
RestoreAsync(RestoreDescription, CancellationToken)
Restaurez une sauvegarde décrite par RestoreDescription.
public System.Threading.Tasks.Task RestoreAsync (Microsoft.ServiceFabric.Data.RestoreDescription restoreDescription, System.Threading.CancellationToken cancellationToken);member this.RestoreAsync : Microsoft.ServiceFabric.Data.RestoreDescription * System.Threading.CancellationToken -> System.Threading.Tasks.TaskPublic Function RestoreAsync (restoreDescription As RestoreDescription, cancellationToken As CancellationToken) As TaskParamètres
- restoreDescription
- RestoreDescription
Description de la demande de restauration.
- cancellationToken
- CancellationToken
Jeton pour surveiller les requêtes d'annulation.
Retours
Tâche qui représente l’opération de restauration asynchrone.
Exceptions
Indique que le dossier de sauvegarde d’entrée ne contient pas de sauvegarde complète. Pour qu’un dossier de sauvegarde puisse être restauré, il doit contenir exactement une sauvegarde complète et un nombre quelconque de sauvegardes incrémentielles.
Indique que l’un des arguments n’est pas valide. Par exemple, lors de la restauration d’un service fiable si RestorePolicy a la valeur Safe, mais que le dossier de sauvegarde d’entrée contient une version de l’état antérieure à l’état conservé dans le réplica actuel.
Lors de la restauration d’un service Actor, cette exception est levée si spécifiée BackupFolderPath est vide.
Indique que le répertoire de restauration fourni n’existe pas.
Indique que le réplica se ferme.
Indique que l’opération de restauration actuelle n’est pas valide. Par exemple, le ServicePartitionKind de la partition à partir de laquelle la sauvegarde a été effectuée est différent de celui de la partition actuelle en cours de restauration.
Indique que les fichiers de sauvegarde attendus dans le répertoire de restauration fourni sont introuvables.
Indique que l’opération de restauration a rencontré une erreur inattendue ou que les fichiers de sauvegarde du répertoire de restauration ne sont pas valides. La ErrorCode propriété indique le type d’erreur qui s’est produite.
- InvalidBackup Indique que les fichiers de sauvegarde fournis dans le répertoire de restauration sont des fichiers manquants ou ont des fichiers inattendus supplémentaires.
- InvalidRestoreData Indique que les fichiers de métadonnées (restore.dat) présents dans le répertoire de restauration sont endommagés ou contiennent des informations non valides.
- InvalidBackupChain Indique que la chaîne de sauvegarde (c’est-à-dire une sauvegarde complète et aucune ou plusieurs sauvegardes incrémentielles contiguës qui ont été effectuées après celle-ci) fournie dans le répertoire de restauration est rompue.
- DuplicateBackups Indique que la chaîne de sauvegarde (c’est-à-dire une sauvegarde complète et aucune ou plusieurs sauvegardes incrémentielles contiguës qui ont été effectuées après elle) fournie dans le répertoire de restauration contient des sauvegardes en double.
- RestoreSafeCheckFailed Si Safe est spécifié dans le cadre de RestoreDescription, cela indique que la sauvegarde fournie pour la restauration contient des données plus anciennes que celles actuellement présentes dans le service.
Remarques
Cette API doit être appelée à partir de la méthode OnDataLossAsync. Une seule API RestoreAsync peut être en vol par réplica à un moment donné.
Notez que les exceptions levées par cette API diffèrent selon le fournisseur d’état sous-jacent. Les exceptions actuellement documentées pour cette API s’appliquent uniquement aux fournisseurs d’état prêtes à l’emploi fournis par Service Fabric pour Reliable Services et Reliable Actors.
Les exceptions suivantes sont levées par cette API lorsqu’elle est appelée dans Reliable Service :
Les exceptions suivantes sont levées par cette API lorsqu’elle est appelée dans Actor Service avec KvsActorStateProvider comme fournisseur d’état (qui est le fournisseur d’état par défaut pour Reliable Actors) :
- ArgumentException
- DirectoryNotFoundException
- FabricObjectClosedException
- InvalidOperationException
- FileNotFoundException
- FabricException
S’applique à
Azure SDK for .NET