Partager via

Gérer les sauvegardes de partage de fichiers Azure avec l'interface de ligne de commande Azure

  • Article

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 effectuer les tâches pour gérer et superviser les partages de fichiers Azure sauvegardés par Sauvegarde Azure. Vous pouvez également suivre ces étapes avec le portail Azure.

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 partage 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

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 – Azure Storage
  • --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 : Quotidienne - 5 jours, Hebdomadaire - tous les dimanches pendant 12 semaines, Mensuelle - premier samedi de chaque mois pendant 60 mois et Annuelle - premier samedi 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 code JSON associé que vous avez passé en 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 monthlySchedule comme suit :

"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 hébergeant le partage de fichiers. Pour récupérer le nom ou nom convivial de votre conteneur, utilisez la commande az backup container list.
  • --name : correspond au 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: correspond au 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 partage de fichiers azurefiles 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 (container) et l’élément (item) 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 de suspendre la protection des partages de fichiers Azure :

  • 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

Le fait de laisser des points de récupération dans l'espace de stockage peut avoir un coût car les instantanés sous-jacents créés par Sauvegarde Azure sont conservés. Cela présente cependant l’avantage de vous permettre de restaurer ultérieurement le partage de fichiers, 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 décidez de supprimer tous les points de récupération, vous ne pouvez plus 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 hébergeant 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 : correspond au 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 du partage de fichiers azurefiles, 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 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 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 protection du partage de fichiers azurefiles 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 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 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’un partage de fichiers Azure mais conservé les 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 hébergeant 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 : correspond au 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: correspond au 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 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 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 coffre Recovery Services différent, commencez par Arrêter la protection de tous les partages de fichiers dans 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 la cmdlet précédente en utilisant le nom convivial pour le conteneur (container), en fournissant le paramètre supplémentaire 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

Pour plus d'informations, consultez Résoudre les problèmes liés à la sauvegarde des partages de fichiers Azure.