Restaurer des partages de fichiers Azure avec l'interface de ligne de commande Azure
L’interface de ligne de commande Azure permet de gérer les ressources Azure. Elle constitue un excellent outil pour générer une automatisation personnalisée afin d'utiliser des ressources Azure. Cet article explique comment restaurer l’intégralité d’un partage de fichiers ou des fichiers spécifiques à partir d’un point de restauration créé par Sauvegarde Azure à l’aide de l'interface de ligne de commande Azure. Vous pouvez également effectuer ces étapes avec Azure PowerShell ou dans le portail Azure.
À la fin de ce tutoriel, vous aurez appris à effectuer les opérations ci-dessous avec l'interface de ligne de commande Azure :
- Afficher les points de restauration d’un partage de fichiers Azure sauvegardé
- Restaurer un partage de fichiers Azure complet
- restaurer des fichiers ou dossiers individuels ;
Notes
Sauvegarde Azure prend désormais en charge la restauration de plusieurs fichiers ou dossiers vers l’emplacement d’origine ou un autre emplacement à l’aide d’Azure CLI. Pour en savoir plus, reportez-vous à la section Restaurer plusieurs fichiers ou dossiers à l’emplacement d’origine ou à un autre emplacement de ce document.
Prérequis
Cet article suppose que vous disposez déjà d’un partage de fichiers Azure sauvegardé par Sauvegarde Azure. Si ce n'est pas le cas, consultez Sauvegarder des partages de fichiers Azure avec l’interface de ligne de commande afin de configurer la sauvegarde pour vos partages de fichiers. Pour cet article, vous allez utiliser les ressources suivantes :
| Partage de fichiers | Compte de stockage | Région | Détails |
|---|---|---|---|
| azurefiles | afsaccount | USAEst | Source d’origine sauvegardée à l’aide de Sauvegarde Azure |
| azurefiles1 | afaccount1 | USAEst | Source de destination utilisée pour la récupération à un autre emplacement |
Vous pouvez utiliser une structure similaire pour vos partages de fichiers afin de tester les différents types de restauration expliqués dans cet article.
Préparation de votre environnement pour Azure CLI
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
- Ce tutoriel nécessite la version 2.0.18 ou ultérieure d’Azure CLI. Si vous utilisez Azure Cloud Shell, la version la plus récente est déjà installée.
Extraire des points de récupération pour le partage de fichiers Azure
Utilisez l’applet de commande az backup recoverypoint list pour lister tous les points de récupération du partage de fichiers sauvegardé.
L’exemple suivant extrait la liste des points de récupération du partage de fichiers azurefiles dans le compte de stockage afsaccount.
az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --backup-management-type azurestorage --item-name "AzureFileShare;azurefiles" --workload-type azurefileshare --out table
Vous pouvez également exécuter la cmdlet précédente en utilisant le nom convivial pour le conteneur (container) et l’élément (item) en fournissant les deux paramètres supplémentaires suivants :
- --backup-management-type: azurestorage
- --workload-type: azurefileshare
az backup recoverypoint list --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --item-name azurefiles --workload-type azurefileshare --out table
Le jeu de résultats correspond à une liste de points de récupération avec des détails d’heure et de cohérence pour chaque point de restauration.
Name Time Consistency
------------------ ------------------------- --------------------
932887541532871865 2020-01-05T07:08:23+00:00 FileSystemConsistent
932885927361238054 2020-01-05T07:08:10+00:00 FileSystemConsistent
932879614553967772 2020-01-04T21:33:04+00:00 FileSystemConsistent
L’attribut Name figurant dans la sortie correspond au nom du point de récupération qui peut être utilisé comme valeur pour le paramètre --rp-name dans les opérations de récupération.
Récupération de partage complet avec l'interface de ligne de commande Azure
Vous pouvez utiliser cette option de restauration pour restaurer l’intégralité du partage de fichiers dans l’emplacement d’origine ou dans un autre emplacement.
Définissez les paramètres suivants pour effectuer des opérations de restauration :
- --container-name : nom du compte de stockage hébergeant le partage de fichiers d’origine sauvegardé. Pour récupérer le nom ou nom convivial de votre conteneur, utilisez la commande az backup container list.
- --item-name : nom du partage de fichiers d’origine sauvegardé que vous souhaitez utiliser pour l’opération de restauration. Pour récupérer le nom ou nom convivial de votre élément sauvegardé, utilisez la commande az backup item list.
Restaurer l’intégralité d’un partage à l’emplacement d’origine
En cas de restauration à l’emplacement d’origine, vous n’avez pas besoin de spécifier les paramètres liés à la cible. Seul Résoudre le conflit doit être fourni.
L’exemple suivant utilise la cmdlet az backup restore restore-azurefileshare avec le mode de restauration défini sur originallocation pour restaurer le partage de fichiers azurefiles à l’emplacement d’origine. Vous utilisez le point de récupération 932883129628959823 obtenu à l'étape Extraire des points de récupération pour le partage de fichiers Azure :
az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932887541532871865 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --resolve-conflict overwrite --out table
Name ResourceGroup
------------------------------------ ---------------
6a27cc23-9283-4310-9c27-dcfb81b7b4bb azurefiles
L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.
Restaurer l’intégralité d’un partage dans un autre emplacement
Vous pouvez utiliser cette option pour restaurer un partage de fichiers dans un autre emplacement et conserver le partage de fichiers d’origine tel quel. Spécifiez les paramètres suivants pour la récupération dans un autre emplacement :
- --target-storage-account : Compte de stockage sur lequel le contenu sauvegardé est restauré. Le compte de stockage cible doit se trouver au même emplacement que le coffre.
- --target-file-share : Partage de fichiers du compte de stockage cible sur lequel le contenu sauvegardé est restauré.
- --target-folder : Dossier situé sous le partage de fichiers sur lequel les données sont restaurées. Si le contenu sauvegardé doit être restauré dans le dossier racine, indiquez les valeurs du dossier cible sous forme de chaîne vide.
- --resolve-conflict : Instruction en cas de conflit avec les données restaurées. Accepte Remplacer ou Ignorer.
L’exemple suivant utilise az backup restore restore-azurefileshare avec un mode de restauration comme alternatelocation pour restaurer le partage de fichiers azurefiles du compte de stockage afsaccount sur le partage de fichiers azurefiles1 du compte de stockage afaccount1.
az backup restore restore-azurefileshare --vault-name azurefilesvault --resource-group azurefiles --rp-name 932883129628959823 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --out table
Name ResourceGroup
------------------------------------ ---------------
babeb61c-d73d-4b91-9830-b8bfa83c349a azurefiles
L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.
Récupération au niveau de l'élément
Vous pouvez utiliser cette option de restauration pour restaurer des fichiers ou dossiers individuels à l’emplacement d’origine ou dans un autre emplacement.
Définissez les paramètres suivants pour effectuer des opérations de restauration :
- --container-name : nom du compte de stockage hébergeant le partage de fichiers d’origine sauvegardé. Pour récupérer le nom ou nom convivial de votre conteneur, utilisez la commande az backup container list.
- --item-name : nom du partage de fichiers d’origine sauvegardé que vous souhaitez utiliser pour l’opération de restauration. Pour récupérer le nom ou nom convivial de votre élément sauvegardé, utilisez la commande az backup item list.
Spécifiez les paramètres suivants pour les éléments que vous voulez récupérer :
- SourceFilePath : Chemin d'accès absolu du fichier, à restaurer dans le partage de fichiers, sous forme de chaîne. Ce chemin est le même que celui utilisé dans les commandes CLI az storage file download ou az storage file show.
- SourceFileType : Indiquez si un répertoire ou un fichier est sélectionné. Accepte Répertoire ou Fichier.
- ResolveConflict : Instruction en cas de conflit avec les données restaurées. Accepte Remplacer ou Ignorer.
Restaurer des fichiers ou dossiers individuels à l’emplacement d’origine
Utilisez la cmdlet az backup restore restore-azurefiles avec le mode de restauration défini sur originallocation pour restaurer des fichiers ou dossiers spécifiques à leur emplacement d’origine.
L’exemple suivant restaure le fichier RestoreTest.txt à son emplacement d’origine : le partage de fichiers azurefiles.
az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --source-file-type file --source-file-path "Restore/RestoreTest.txt" --resolve-conflict overwrite --out table
Name ResourceGroup
------------------------------------ ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319 azurefiles
L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.
Restaurer des fichiers ou dossiers individuels dans un autre emplacement
Pour restaurer des fichiers ou dossiers spécifiques dans un autre emplacement, utilisez la cmdlet az backup restore restore-azurefiles avec le mode de restauration défini sur alternatelocation, puis spécifiez les paramètres liés à la cible suivants :
- --target-storage-account : Compte de stockage sur lequel le contenu sauvegardé est restauré. Le compte de stockage cible doit se trouver au même emplacement que le coffre.
- --target-file-share : Partage de fichiers du compte de stockage cible sur lequel le contenu sauvegardé est restauré.
- --target-folder : Dossier situé sous le partage de fichiers sur lequel les données sont restaurées. Si le contenu sauvegardé doit être restauré dans un dossier racine, indiquez une chaîne vide comme valeur du dossier cible.
L’exemple suivant restaure le fichier RestoreTest.txt initialement présent dans le partage de fichiers azurefiles dans un autre emplacement : le dossier restoredata dans le partage de fichiers azurefiles1 hébergé dans le compte de stockage afaccount1.
az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932881556234035474 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode alternatelocation --target-storage-account afaccount1 --target-file-share azurefiles1 --target-folder restoredata --resolve-conflict overwrite --source-file-type file --source-file-path "Restore/RestoreTest.txt" --out table
Name ResourceGroup
------------------------------------ ---------------
df4d9024-0dcb-4edc-bf8c-0a3d18a25319 azurefiles
L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.
Restaurer plusieurs fichiers ou dossiers à l’emplacement d’origine ou à un autre emplacement
Pour effectuer une restauration pour plusieurs éléments, transmettez la valeur du paramètre source-file-path en tant que chemins séparés par des espaces de tous les fichiers ou dossiers que vous souhaitez restaurer.
L’exemple suivant restaure les fichiers Restore.txt et AFS testing Report.docx à leur emplacement d’origine.
az backup restore restore-azurefiles --vault-name azurefilesvault --resource-group azurefiles --rp-name 932889937058317910 --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name "AzureFileShare;azurefiles" --restore-mode originallocation --source-file-type file --source-file-path "Restore Test.txt" "AFS Testing Report.docx" --resolve-conflict overwrite --out table
Vous devez obtenir un résultat semblable à ce qui suit :
Name ResourceGroup
------------------------------------ ---------------
649b0c14-4a94-4945-995a-19e2aace0305 azurefiles
L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de restauration. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.
Si vous souhaitez restaurer plusieurs éléments à un autre emplacement, utilisez la commande ci-dessus en spécifiant les paramètres liés à la cible, comme expliqué dans la section Restaurer des fichiers ou dossiers individuels dans un autre emplacement.
Étapes suivantes
Découvrir comment Gérer les sauvegardes de partage de fichiers Azure avec l'interface de ligne de commande Azure