Mettre à jour les configurations du coffre Azure Recovery Services à l’aide de l’API REST

Cet article explique comment mettre à jour les configurations associées à la sauvegarde dans le coffre Azure Recovery Services à l’aide de l’API REST.

Gérer les opérations de suppression réversible dans le coffre Recovery Services

La suppression de sauvegardes d’un élément protégé est une opération importante qui doit être surveillée. Pour vous protéger contre les suppressions accidentelles, le coffre Azure Recovery Services dispose d’une fonctionnalité de suppression réversible. Cette fonctionnalité vous permet de restaurer des sauvegardes supprimées, si nécessaire, dans un délai après la suppression.

Toutefois, il existe des scénarios dans lesquels cette fonctionnalité n’est pas nécessaire. Un coffre Azure Recovery Services ne peut pas être supprimé s’il contient des éléments de sauvegarde, y compris ceux supprimés temporairement. Cela peut poser un problème si le coffre doit être supprimé immédiatement. Par exemple : les opérations de déploiement nettoient souvent les ressources créées dans le même flux de travail. Un déploiement peut créer un coffre, configurer des sauvegardes pour un élément, effectuer une restauration de test, puis continuer à supprimer les éléments de sauvegarde et le coffre. En cas d’échec de la suppression du coffre, l’intégralité du déploiement peut échouer. La désactivation de la suppression réversible est le seul moyen de garantir une suppression immédiate.

Par conséquent, vous devez choisir avec précaution de désactiver ou non la suppression réversible pour un coffre particulier en fonction du scénario. En savoir plus sur la suppression réversible.

Récupérer l'état de suppression non définitive à l'aide de l'API REST

Par défaut, l'état de suppression douce sera activé pour tout coffre Recovery Services nouvellement créé. Pour extraire/mettre à jour l’état de suppression réversible pour un coffre, utilisez le document de l’API REST relatif à la configuration du coffre de sauvegarde.

Pour extraire l’état actuel de suppression réversible pour un coffre, utilisez l’opération GET.

GET https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

L’URI GET a {subscriptionId}, {vaultName}{vaultresourceGroupName}paramètres. Dans cet exemple, {vaultName} est « testVault » et {vaultresourceGroupName} « testVaultRG ». Comme tous les paramètres requis sont donnés dans l’URI, il n’est pas nécessaire d’utiliser un corps de requête distinct.

GET https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Responses

La réponse réussie pour l’opération « GET » est indiquée ci-dessous :

Exemple de réponse

Une fois la demande « GET » envoyée, une réponse 200 (réussie) est retournée.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Enabled"
  }
}

Mettre à jour l’état de suppression douce à l’aide de l’API REST

Pour mettre à jour l’état de suppression réversible du coffre Recovery Services à l’aide de l’API REST, utilisez l’opération PUT suivante

PUT https://management.azure.com/Subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.RecoveryServices/vaults/{vaultName}/backupconfig/vaultconfig?api-version=2019-06-15

L’URI PUT a {subscriptionId}, {vaultName}{vaultresourceGroupName}paramètres. Dans cet exemple, {vaultName} est « testVault » et {vaultresourceGroupName} « testVaultRG ». Si nous remplacez l’URI par les valeurs ci-dessus, l’URI se présente comme suit.

PUT https://management.azure.com/Subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Créer le corps de la demande

Les définitions courantes suivantes sont utilisées pour créer un corps de requête

Pour plus d’informations, reportez-vous à la documentation de l’API REST.

Exemple de corps de demande

Utilisez l’exemple suivant pour mettre à jour l’état de suppression réversible sur « désactivé ».

{
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Réponses pour l’opération PATCH

La réponse réussie pour l’opération « PATCH » est indiquée ci-dessous :

Exemple de réponse pour l’opération PATCH

Une fois la demande « PATCH » envoyée, une réponse 200 (réussie) est retournée.

{
  "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/testvaultRG/providers/Microsoft.RecoveryServices/vaults/testvault/backupconfig/vaultconfig",
  "name": "vaultconfig",
  "type": "Microsoft.RecoveryServices/vaults/backupconfig",
  "properties": {
    "enhancedSecurityState": "Enabled",
    "softDeleteFeatureState": "Disabled"
  }
}

Étapes suivantes

Créez une stratégie de sauvegarde pour sauvegarder une machine virtuelle Azure dans ce coffre.

Pour plus d’informations sur les API REST Azure, consultez les documents suivants :

• API REST du fournisseur Azure Recovery Services
• Bien démarrer avec l’API REST Azure