Note
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier les répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de changer de répertoire.
Cet article explique de quelle manière créer une stratégie de sauvegarde via l’API REST.
La sauvegarde des disques Azure offre une solution clé en main qui fournit une gestion du cycle de vie des instantanés pour les disques managés en automatisant la création périodique d’instantanés et en les conservant pour une durée configurée à l’aide d’une stratégie de sauvegarde. Vous pouvez gérer les instantanés des disques sans aucun coût d’infrastructure et sans avoir recours à aucun script personnalisé ni aucune surcharge de gestion. Il s’agit d’une solution de sauvegarde avec cohérence en cas de plantage qui effectue une sauvegarde ponctuelle d’un disque managé au moyen d’instantanés incrémentiels avec une prise en charge de plusieurs sauvegardes par jour. Il s’agit également d’une solution sans agent qui n’a pas d’impact sur les performances des applications de production. Elle prend en charge la sauvegarde et la restauration des disques du système d’exploitation et des données (y compris des disques partagés), qu’ils soient ou non actuellement attachés à une machine virtuelle Azure en cours d’exécution.
Une stratégie de sauvegarde régit la rétention et la planification de vos sauvegardes. La sauvegarde du disque Azure propose plusieurs sauvegardes par jour. Vous pouvez réutiliser la stratégie de sauvegarde pour configurer la sauvegarde de plusieurs disques Azure dans un coffre ou créer une stratégie de sauvegarde pour un coffre Azure Recovery Services à l’aide de l’API REST.
Pour créer une stratégie de sauvegarde des disques, procédez comme suit :
Créer une stratégie
Pour créer une stratégie de sauvegarde Azure, utilisez l’opération PUT suivante :
PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupPolicies/{policyName}?api-version=2021-01-01
{policyName} et {vaultName} sont fournis dans l’URI. Vous trouverez des informations supplémentaires dans le corps de la requête.
Important
Actuellement, ni la mise à jour ni la modification d’une stratégie existante n’est prise en charge. Sinon, vous pouvez créer une nouvelle stratégie avec les détails requis et l’attribuer à l’instance de sauvegarde appropriée.
Créer le corps de la demande
Par exemple, pour créer une stratégie pour une sauvegarde de disques, le corps de la demande a besoin des composants suivants :
| Nom | Requise | Type | Description |
|---|---|---|---|
| properties | True | BaseBackupPolicy : BackupPolicy | Propriétés BaseBackupPolicyResource |
Pour obtenir la liste complète des définitions de corps de la requête, reportez-vous au document sur l’API REST backup policy.
Exemple de corps de demande
La stratégie indique ce qui suit :
- Déclencheur programmé toutes les 4 heures (PT4H). Les sauvegardes sont effectuées à intervalles de 4 heures environ, de façon à être réparties équitablement sur la journée.
- Vous pouvez choisir l’intervalle de déclenchement toutes les 4, 6, 8 ou 12 heures. Pour planifier une sauvegarde une fois par jour, utilisez P1D. Les sauvegardes sont déclenchées une fois par jour à l’heure prévue.
- Le magasin de données est le magasin opérationnel, car les sauvegardes sont locales et aucune donnée n’est stockée dans le coffre Sauvegarde. Dans le magasin opérationnel, chaque instance de sauvegarde est stockée pendant sept jours (P7D).
{
"properties": {
"datasourceTypes": [
"Microsoft.Compute/disks"
],
"name": "DiskPolicy",
"objectType": "BackupPolicy",
"policyRules": [
{
"backupParameters": {
"backupType": "Incremental",
"objectType": "AzureBackupParams"
},
"dataStore": {
"dataStoreType": "OperationalStore",
"objectType": "DataStoreInfoBase"
},
"name": "BackupHourly",
"objectType": "AzureBackupRule",
"trigger": {
"objectType": "ScheduleBasedTriggerContext",
"schedule": {
"repeatingTimeIntervals": [
"R/2020-04-05T13:00:00+00:00/PT4H"
]
},
"taggingCriteria": [
{
"isDefault": true,
"tagInfo": {
"id": "Default_",
"tagName": "Default"
},
"taggingPriority": 99
}
]
}
},
{
"isDefault": true,
"lifecycles": [
{
"deleteAfter": {
"duration": "P7D",
"objectType": "AbsoluteDeleteOption"
},
"sourceDataStore": {
"dataStoreType": "OperationalStore",
"objectType": "DataStoreInfoBase"
}
}
],
"name": "Default",
"objectType": "AzureRetentionRule"
}
]
}
}
Important
Les formats d’heure ne prennent en charge que DateHeure. Ils ne prennent pas en charge qu’Heure. L’heure de la journée indique l’heure de début de la sauvegarde, et pas l’heure de fin.
Le temps nécessaire pour effectuer l’opération de sauvegarde dépend de différents facteurs, notamment de la taille du disque et du taux d’attrition entre les sauvegardes consécutives. Toutefois, la Sauvegarde de disque Azure est une sauvegarde sans agent qui utilise des instantanés incrémentiels sans avoir d’impact sur le niveau de performance des applications de production.
Pour plus d’informations sur la création de stratégies, reportez-vous au document sur la stratégie de sauvegarde de disque Azure.
Remarque
- Pour les disques Azure appartenant aux références SKU HDD Standard, SSD Standard et SSD Premium, vous pouvez définir la planification de sauvegarde avec une fréquence Horaire (de 1, 2, 4, 6, 8 ou 12 heures) et une fréquence Quotidienne.
- Pour les disques Azure appartenant aux références SKU Premium V2 et Disque Ultra, vous pouvez définir la planification de sauvegarde avec une fréquence Horaire de seulement 12 heures et une fréquence Quotidienne.
Réponses
La création/mise à jour de la stratégie de sauvegarde est une opération synchrone et retourne OK une fois l’opération réussie.
| Nom | Type | Description |
|---|---|---|
| 200 OK | BaseBackupPolicyResource | Ok |
Exemples de réponses
Une fois l’opération terminée, elle retourne 200 (OK) avec le contenu de la stratégie dans le corps de la réponse.
{
"id": "/subscriptions/73307177-bb00-4801-bd11-894b2f2d5162/resourceGroups/RG-BV/providers/Microsoft.DataProtection/backupVaults/BV-JPE-GRS/backupPolicies/DiskBackupPolicy-03",
"name": "DiskBackupPolicy-03",
"type": "Microsoft.DataProtection/backupVaults/backupPolicies",
"properties": {
"policyRules": [
{
"backupParameters": {
"backupType": "Incremental",
"objectType": "AzureBackupParams"
},
"trigger": {
"schedule": {
"repeatingTimeIntervals": [
"R/2021-07-01T19:00:00+00:00/P1D"
],
},
"taggingCriteria": [
{
"tagInfo": {
"tagName": "Default",
"id": "Default_"
},
"taggingPriority": 99,
"isDefault": true
}
],
"objectType": "ScheduleBasedTriggerContext"
},
"dataStore": {
"dataStoreType": "OperationalStore",
"objectType": "DataStoreInfoBase"
},
"name": "BackupDaily",
"objectType": "AzureBackupRule"
},
{
"lifecycles": [
{
"deleteAfter": {
"objectType": "AbsoluteDeleteOption",
"duration": "P7D"
},
"targetDataStoreCopySettings": [],
"sourceDataStore": {
"dataStoreType": "OperationalStore",
"objectType": "DataStoreInfoBase"
}
}
],
"isDefault": true,
"name": "Default",
"objectType": "AzureRetentionRule"
}
],
"datasourceTypes": [
"Microsoft.Compute/disks"
],
"objectType": "BackupPolicy"
}
}
Étapes suivantes
Activer la protection des disques Azure
Pour plus d’informations sur les API REST de Sauvegarde Azure, voir les articles suivants :