Partager via

Gérer les sauvegardes Azure Files avec Azure CLI

Cet article explique comment gérer et surveiller les fichiers Azure sauvegardés (instantanés et sauvegardes coffretées ) à l’aide d’Azure CLI. 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. Vous pouvez également gérer les sauvegardes Azure Files à l’aide du portail Azure, d’Azure PowerShell, de l’API REST.

Prérequis

Cet article part du principe que vous disposez déjà d’azure Files sauvegardé par Sauvegarde Azure. Si vous n’en avez pas, consultez Sauvegarder Azure Files avec l’interface CLI pour configurer la sauvegarde de vos partages de fichiers. Pour cet article, vous allez utiliser les ressources suivantes :

  • Groupe de ressources : azurefiles
  • RecoveryServicesVault : azurefilesvault
  • Compte de stockage : afsaccount
  • Partage de fichiers : azurefiles
  • 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.

Surveiller des travaux

Lorsque vous déclenchez une opération de sauvegarde ou de restauration, le service de sauvegarde crée une tâche de suivi. Pour superviser les travaux terminés ou en cours d’exécution, utilisez la cmdlet az backup job list. L’interface de ligne de commande vous permet également d’interrompre un travail en cours d’exécution ou d’attendre qu’un travail se termine.

L’exemple suivant affiche l’état des travaux de sauvegarde pour le coffre Recovery Services azurefilesvault :

az backup job list --resource-group azurefiles --vault-name azurefilesvault

[
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
    "location": null,
    "name": "d477dfb6-b292-4f24-bb43-6b14e9d06ab5",
    "properties": {
      "actionsInfo": null,
      "activityId": "3cef43ed-0af4-43e2-b9cb-1322c496ccb4",
      "backupManagementType": "AzureStorage",
      "duration": "0:00:29.718011",
      "endTime": "2020-01-13T08:05:29.180606+00:00",
      "entityFriendlyName": "azurefiles",
      "errorDetails": null,
      "extendedInfo": null,
      "jobType": "AzureStorageJob",
      "operation": "Backup",
      "startTime": "2020-01-13T08:04:59.462595+00:00",
      "status": "Completed",
      "storageAccountName": "afsaccount",
      "storageAccountVersion": "MicrosoftStorage"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupJobs"
  },
  {
    "eTag": null,
    "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupJobs/1b9399bf-c23c-4caa-933a-5fc2bf884519",
    "location": null,
    "name": "1b9399bf-c23c-4caa-933a-5fc2bf884519",
    "properties": {
      "actionsInfo": null,
      "activityId": "2663449c-94f1-4735-aaf9-5bb991e7e00c",
      "backupManagementType": "AzureStorage",
      "duration": "0:00:28.145216",
      "endTime": "2020-01-13T08:05:27.519826+00:00",
      "entityFriendlyName": "azurefilesresource",
      "errorDetails": null,
      "extendedInfo": null,
      "jobType": "AzureStorageJob",
      "operation": "Backup",
      "startTime": "2020-01-13T08:04:59.374610+00:00",
      "status": "Completed",
      "storageAccountName": "afsaccount",
      "storageAccountVersion": "MicrosoftStorage"
    },
    "resourceGroup": "azurefiles",
    "tags": null,
    "type": "Microsoft.RecoveryServices/vaults/backupJobs"
  }
]

Créer une stratégie de sauvegarde

La stratégie de sauvegarde Azure pour Azure Files définit comment et quand des sauvegardes sont créées, la période de rétention des points de récupération et les règles de protection et de récupération des données.

Choisir un niveau de sauvegarde:

Vous pouvez créer une stratégie de sauvegarde en exécutant la commande az backup policy create avec les paramètres suivants :

  • --backup-management-type – Stockage Azure
  • --workload-type - AzureFileShare
  • --name : nom de la stratégie
  • --policy : fichier JSON contenant les détails appropriés pour la planification et la conservation
  • --resource-group : groupe de ressources du coffre
  • --vault-name : nom du coffre

Exemple

az backup policy create --resource-group azurefiles --vault-name azurefilesvault --name schedule20 --backup-management-type AzureStorage --policy samplepolicy.json --workload-type AzureFileShare

Exemple JSON (samplepolicy.json)

{
  "eTag": null,
  "id": "/Subscriptions/ef4ab5a7-c2c0-4304-af80-af49f48af3d1/resourceGroups/azurefiles/providers/Microsoft.RecoveryServices/vaults/azurefilesvault/backupPolicies/schedule20",
  "location": null,
  "name": "schedule20",
  "properties": {
    "backupManagementType": "AzureStorage",
    "protectedItemsCount": 0,
    "retentionPolicy": {
      "dailySchedule": {
        "retentionDuration": {
          "count": 30,
          "durationType": "Days"
        },
        "retentionTimes": [
          "2020-01-05T08:00:00+00:00"
        ]
      },
      "monthlySchedule": null,
      "retentionPolicyType": "LongTermRetentionPolicy",
      "weeklySchedule": null,
      "yearlySchedule": null
    },
    "schedulePolicy": {
      "schedulePolicyType": "SimpleSchedulePolicy",
      "scheduleRunDays": null,
      "scheduleRunFrequency": "Daily",
      "scheduleRunTimes": [
        "2020-01-05T08:00:00+00:00"
      ],
      "scheduleWeeklyFrequency": 0
    },
    "timeZone": "UTC",
    "workLoadType": “AzureFileShare”
  },
  "resourceGroup": "azurefiles",
  "tags": null,
  "type": "Microsoft.RecoveryServices/vaults/backupPolicies"
}

Exemple pour créer une stratégie de sauvegarde qui configure plusieurs sauvegardes par jour

Cet exemple JSON est destiné aux exigences suivantes :

  • Planification : sauvegarde toutes les 4 heures à partir de 8 h (UTC) durant les 12 prochaines heures.
  • Rétention : Quotidien - cinq jours, Hebdomadaire - Tous les dimanches pour 12 semaines, Mensuel - Premier dimanche de chaque mois pendant 60 mois et Annuel - Premier dimanche de janvier pendant 10 ans.
{
    "properties":{
        "backupManagementType": "AzureStorage",
        "workloadType": "AzureFileShare",
        "schedulePolicy": {
            "schedulePolicyType": "SimpleSchedulePolicy",
            "scheduleRunFrequency": "Hourly",
            "hourlySchedule": {
                "interval": 4,
                "scheduleWindowStartTime": "2021-09-29T08:00:00.000Z",
                "scheduleWindowDuration": 12
            }
        },
        "timeZone": "UTC",
        "retentionPolicy": {
            "retentionPolicyType": "LongTermRetentionPolicy",
            "dailySchedule": {
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 5,
                    "durationType": "Days"
                }
            },
            "weeklySchedule": {
                "daysOfTheWeek": [
                    "Sunday"
                ],
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 12,
                    "durationType": "Weeks"
                }
            },
            "monthlySchedule": {
                "retentionScheduleFormatType": "Weekly",
                "retentionScheduleDaily": null,
                "retentionScheduleWeekly": {
                    "daysOfTheWeek": [
                        "Sunday"
                    ],
                    "weeksOfTheMonth": [
                        "First"
                    ]
                },
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 60,
                    "durationType": "Months"
                }
            },
            "yearlySchedule": {
                "retentionScheduleFormatType": "Weekly",
                "monthsOfYear": [
                    "January"
                ],
                "retentionScheduleDaily": null,
                "retentionScheduleWeekly": {
                    "daysOfTheWeek": [
                        "Sunday"
                    ],
                    "weeksOfTheMonth": [
                        "First"
                    ]
                },
                "retentionTimes": null,
                "retentionDuration": {
                    "count": 10,
                    "durationType": "Years"
                }
            }
        }
    }
}

Une fois la stratégie créée, la sortie de la commande affiche le json de stratégie que vous avez passé en tant que paramètre lors de l’exécution de la commande.

Vous pouvez modifier les sections schedule et retention de la stratégie selon vos besoins.

Exemple

Si vous souhaitez conserver la sauvegarde du premier dimanche de chaque mois pendant deux mois, mettez à jour la planification mensuelle en fonction de l’exemple suivant :

"monthlySchedule": {
        "retentionDuration": {
          "count": 2,
          "durationType": "Months"
        },
        "retentionScheduleDaily": null,
        "retentionScheduleFormatType": "Weekly",
        "retentionScheduleWeekly": {
          "daysOfTheWeek": [
            "Sunday"
          ],
          "weeksOfTheMonth": [
            "First"
          ]
        },
        "retentionTimes": [
          "2020-01-05T08:00:00+00:00"
        ]
      }

Modifier la stratégie

Vous pouvez modifier une stratégie de sauvegarde pour changer la fréquence de sauvegarde ou la durée de rétention à l’aide de la cmdlet az backup item set-policy.

Pour modifier la stratégie, définissez les paramètres suivants :

  • --container-name : nom du compte de stockage qui héberge le partage de fichiers. Pour récupérer le nom ou nom convivial de votre conteneur, utilisez la commande az backup container list.
  • --name : nom du partage de fichiers pour lequel vous souhaitez modifier la stratégie. Pour récupérer le nom ou nom convivial de votre élément sauvegardé, utilisez la commande az backup item list.
  • --policy-name : nom de la stratégie de sauvegarde que vous souhaitez définir pour votre partage de fichiers. Vous pouvez utiliser la commande az backup policy list pour afficher toutes les stratégies de votre coffre.

L’exemple suivant définit la stratégie de sauvegarde schedule2 pour le azurefiles partage de fichiers présent dans le compte de stockage afsaccount .

az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --name "AzureFileShare;azurefiles" --backup-management-type azurestorage --out table

Vous pouvez également exécuter la commande précédente en utilisant les noms conviviaux pour le conteneur et l’élément en fournissant les deux paramètres supplémentaires suivants :

  • --backup-management-type : azurestorage
  • --workload-type : azurefileshare
az backup item set-policy --policy-name schedule2 --name azurefiles --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --name azurefiles --backup-management-type azurestorage --out table

Name                                  ResourceGroup
------------------------------------  ---------------
fec6f004-0e35-407f-9928-10a163f123e5  azurefiles

L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de changement de stratégie. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.

Arrêter la protection sur un partage de fichiers

Il existe deux façons d’arrêter la protection d’Azure Files :

  • Arrêter tous les travaux de sauvegarde à venir et supprimer tous les points de récupération
  • Arrêter tous les travaux de sauvegarde à venir mais conserver les points de récupération

Il peut y avoir un coût associé à la rétention des points de récupération dans le stockage, car les instantanés sous-jacents créés par Azure Backup sont conservés. L’avantage de laisser les points de récupération est l’option de restaurer le partage de fichiers ultérieurement, si vous le souhaitez. Pour plus d’informations sur les coûts de conservation des points de récupération, voir les détails de la tarification. Si vous choisissez de supprimer tous les points de récupération, vous ne pouvez pas restaurer le partage de fichiers.

Pour arrêter la protection du partage de fichiers, définissez les paramètres suivants :

  • --container-name : nom du compte de stockage qui héberge le partage de fichiers. 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 pour lequel vous souhaitez arrêter la protection. Pour récupérer le nom ou nom convivial de votre élément sauvegardé, utilisez la commande az backup item list.

Arrêter la protection et conserver les points de récupération

Pour arrêter la protection en conservant les données, utilisez la cmdlet az backup protection disable.

L’exemple suivant arrête la protection pour le azurefiles partage de fichiers, mais conserve tous les points de récupération.

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --out table

Vous pouvez également exécuter la commande précédente à l’aide du nom convivial du conteneur et de l’élément en fournissant les deux paramètres supplémentaires suivants :

  • --backup-management-type : azurestorage
  • --workload-type : azurefileshare
az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --out table

Name                                  ResourceGroup
------------------------------------  ---------------
fec6f004-0e35-407f-9928-10a163f123e5  azurefiles

L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération d’arrêt de la protection. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.

Arrêter la protection sans conserver les points de récupération

Pour arrêter la protection sans conserver les points de récupération, utilisez la cmdlet az backup protection disable avec l’option delete-backup-data définie sur true.

L’exemple suivant arrête la azurefiles protection du partage de fichiers sans conserver les points de récupération.

az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --item-name “AzureFileShare;azurefiles” --delete-backup-data true --out table

Vous pouvez également exécuter la commande précédente à l’aide du nom convivial du conteneur et de l’élément en fournissant les deux paramètres supplémentaires suivants :

  • --backup-management-type : azurestorage
  • --workload-type : azurefileshare
az backup protection disable --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --delete-backup-data true --out table

Reprendre la protection sur un partage de fichiers

Si vous avez arrêté la protection d’azure Files, mais que vous avez conservé des points de récupération, vous pouvez reprendre la protection ultérieurement. Si vous ne conservez pas les points de récupération, vous ne pourrez pas reprendre la protection.

Pour reprendre la protection du partage de fichiers, définissez les paramètres suivants :

  • --container-name : nom du compte de stockage qui héberge le partage de fichiers. 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 pour lequel vous souhaitez reprendre la protection. Pour récupérer le nom ou nom convivial de votre élément sauvegardé, utilisez la commande az backup item list.
  • --policy-name : nom de la stratégie de sauvegarde pour laquelle vous souhaitez reprendre la protection du partage de fichiers.

L’exemple suivant utilise la cmdlet az backup protection reresume pour reprendre la protection du partage de fichiers azurefiles à l’aide de la stratégie de sauvegarde schedule1.

az backup protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount” --item-name “AzureFileShare;azurefiles” --policy-name schedule2 --out table

Vous pouvez également exécuter la commande précédente à l’aide du nom convivial du conteneur et de l’élément en fournissant les deux paramètres supplémentaires suivants :

  • --backup-management-type : azurestorage
  • --workload-type : azurefileshare
az backup protection resume --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --item-name azurefiles --workload-type azurefileshare --backup-management-type Azurestorage --policy-name schedule2 --out table

Name                                  ResourceGroup
------------------------------------  ---------------
75115ab0-43b0-4065-8698-55022a234b7f  azurefiles

L’attribut name figurant dans la sortie correspond au nom du travail créé par le service de sauvegarde pour votre opération de reprise de la protection. Pour suivre l’état de ce travail, utilisez la cmdlet az backup job show.

Annuler l’inscription d’un compte de stockage

Si vous souhaitez protéger vos partages de fichiers dans un compte de stockage particulier à l’aide d’un autre coffre Recovery Services, arrêtez d’abord la protection pour tous les partages de fichiers de ce compte de stockage. Annulez ensuite l’inscription du compte du coffre Recovery Services actuellement utilisé pour la protection.

Vous devez fournir un nom de conteneur pour annuler l’inscription du compte de stockage. Pour récupérer le nom ou nom convivial de votre conteneur, utilisez la commande az backup container list.

L’exemple suivant annule l’inscription du compte de stockage afsaccount de azurefilesvault à l'aide de la cmdlet az backup container unregister.

az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name "StorageContainer;Storage;AzureFiles;afsaccount" --out table

Vous pouvez également exécuter l’applet de commande précédente à l’aide du nom convivial du conteneur en fournissant le paramètre suivant :

  • --backup-management-type : azurestorage
az backup container unregister --vault-name azurefilesvault --resource-group azurefiles --container-name afsaccount --backup-management-type azurestorage --out table

Étapes suivantes

Résoudre les problèmes de sauvegarde Azure Files.

  • Last updated on