Partager via

Créer des stratégies de sauvegarde de la protection des données Azure pour les blobs à l’aide de l’API REST

Cet article explique comment créer des stratégies de sauvegarde Azure Data Protection pour les objets blob Azure à l’aide de l’API REST.

Une stratégie Sauvegarde Azure régit généralement la conservation et la planification de vos sauvegardes. Étant donné que la sauvegarde opérationnelle d’objets blob est continue par nature, vous n’avez pas besoin d’une planification pour effectuer des sauvegardes. La stratégie est essentiellement nécessaire pour spécifier la période de rétention. Vous pouvez réutiliser la stratégie de sauvegarde afin de configurer la sauvegarde de plusieurs comptes de stockage dans un coffre.

Important

Avant de créer la stratégie et de configurer les sauvegardes pour les objets blob Azure, consultez cette section.

Cet article explique comment créer une stratégie pour les objets blob dans un compte de stockage. Découvrez le processus de création d’une stratégie de sauvegarde pour un coffre Azure Recovery Services avec l’API REST.

Notes

Restaurer sur de longues durées peut conduire à des opérations de restauration plus longues. De plus, le temps nécessaire à la restauration d’un jeu de données dépend du nombre d’opérations d’écriture et de suppression effectuées au cours de la période de restauration. Par exemple, la restauration à un point situé 30 jours auparavant d’un compte avec 1 million d’objets, 3 000 objets ajoutés par jour et 1 000 objets supprimés par jour nécessite environ deux heures. Une période de rétention et une restauration à plus de 90 jours dans le passé ne sont pas recommandées pour un compte avec ce taux de changement.

Cet article porte sur les points suivants :

  • Créer une stratégie
  • Créer le corps de la demande
  • Réponses

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 demande.

Important

Nous ne prenons pas en charge la mise à jour ni la modification d’une stratégie existante. Ainsi, vous pouvez créer une 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 blob, utilisez le composant suivant du corps de la demande :

Nom Requise Type Description
properties True BaseBackupPolicy : BackupPolicy Propriétés BaseBackupPolicyResource

Pour obtenir la liste complète des définitions dans le corps de la demande, consultez le document sur l’API REST de stratégie de sauvegarde.

Exemple de corps de demande

Le corps de la demande suivant définit une stratégie de sauvegarde pour les sauvegardes blobs.

La stratégie indique ce qui suit :

  • La période de rétention est de 30 jours.
  • Le magasin de données est « magasin opérationnel ».
{
  "properties": {
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ]
      }
    ]
  }
}

Pour configurer une stratégie de sauvegarde avec la sauvegarde archivée, utilisez le script JSON suivant :

{
  "id": "/subscriptions/495944b2-66b7-4173-8824-77043bb269be/resourceGroups/Blob-Backup/providers/Microsoft.DataProtection/BackupVaults/yavovaultecy01/backupPolicies/TestPolicy",
  "name": "TestPolicy",
  "type": "Microsoft.DataProtection/BackupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P30D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "Default",
        "objectType": "AzureRetentionRule",
        "isDefault": true,
        "lifecycles": [
          {
            "deleteAfter": {
              "duration": "P7D",
              "objectType": "AbsoluteDeleteOption"
            },
            "sourceDataStore": {
              "dataStoreType": "VaultStore",
              "objectType": "DataStoreInfoBase"
            },
            "targetDataStoreCopySettings": []
          }
        ]
      },
      {
        "name": "BackupDaily",
        "objectType": "AzureBackupRule",
        "backupParameters": {
          "backupType": "Discrete",
          "objectType": "AzureBackupParams"
        },
        "dataStore": {
          "dataStoreType": "VaultStore",
          "objectType": "DataStoreInfoBase"
        },
        "trigger": {
          "schedule": {
            "timeZone": "UTC",
            "repeatingTimeIntervals": [
              "R/2024-05-08T14:00:00+00:00/P1D"
            ]
          },
          "taggingCriteria": [
            {
              "isDefault": true,
              "taggingPriority": 99,
              "tagInfo": {
                "id": "Default_",
                "tagName": "Default"
              }
            }
          ],
          "objectType": "ScheduleBasedTriggerContext"
        }
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy",
    "name": "TestPolicy"
  }
}

Important

Le seul format d’heure pris en charge est DateTime. Ils ne prennent pas en charge le format Time uniquement.

Réponses

La création/mise à jour de la stratégie de sauvegarde est une opération asynchrone et retourne OK une fois l’opération réussie.

Name 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/xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups//TestBkpVaultRG/providers/Microsoft.RecoveryServices/vaults/testBkpVault/backupPolicies/TestBlobPolicy",
  "name": "TestBlobPolicy",
  "type": "Microsoft.DataProtection/backupVaults/backupPolicies",
  "properties": {
    "policyRules": [
      {
        "lifecycles": [
          {
            "deleteAfter": {
              "objectType": "AbsoluteDeleteOption",
              "duration": "P30D"
            },
            "sourceDataStore": {
              "dataStoreType": "OperationalStore",
              "objectType": "DataStoreInfoBase"
            }
          }
        ],
        "isDefault": true,
        "name": "Default",
        "objectType": "AzureRetentionRule"
      }
    ],
    "datasourceTypes": [
      "Microsoft.Storage/storageAccounts/blobServices"
    ],
    "objectType": "BackupPolicy"
  }
}

Étapes suivantes

Activez la protection des blobs dans un compte de stockage.

Pour plus d’informations sur les API REST de la Sauvegarde Azure, voir les documents suivants :