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

  • Article

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

État de suppression réversible

La suppression des sauvegardes d’un élément protégé est une opération importante qui doit être supervisé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, au cours d’une période 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, même dans l’état de suppression réversible. 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 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 la 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. Pour plus d’informations, consultez l’article sur la suppression réversible.

Extraire l’état de suppression réversible à l’aide de l’API REST

Par défaut, l’état de suppression réversible est activé pour tout coffre Recovery Services 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 contient les paramètres {subscriptionId}, {vaultName}, {vaultresourceGroupName}. Dans cet exemple, {vaultName} est « testVault » et {vaultresourceGroupName} est « testVaultRG ». Étant donné que tous les paramètres nécessaires sont fournis dans l’URI, un corps de demande distinct est inutile.

GET https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/testVaultRG/providers/Microsoft.RecoveryServices/vaults/testVault/backupconfig/vaultconfig?api-version=2019-06-15

Réponses

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

Nom Type Description
200 OK BackupResourceVaultConfig OK
Exemple de réponse

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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 réversible à 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 de PUT contient les paramètres {subscriptionId}, {vaultName}, {vaultresourceGroupName}. Dans cet exemple, {vaultName} est « testVault » et {vaultresourceGroupName} est « testVaultRG ». Si nous remplaçons l’URI par les valeurs ci-dessus, l’URI ressemble à ce qui suit.

PUT https://management.azure.com/Subscriptions/00000000-0000-0000-0000-000000000000/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 permettent de créer un corps de demande.

Pour plus d’informations, consultez la documentation de l’API REST.

Nom Requise Type Description
eTag String eTag facultatif
location true String Emplacement de la ressource
properties VaultProperties Propriétés du coffre
tags Object Balises de ressource

Exemple de corps de demande

L’exemple suivant permet de définir l’état de suppression réversible sur « Disabled » (désactivé).

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

Réponses à l’opération PATCH

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

Nom Type Description
200 OK BackupResourceVaultConfig OK
Exemple de réponse à l’opération PATCH

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

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/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 l’envoi de travaux à l’aide des API REST Azure, consultez les documents suivants :