Démarrage rapide : Créer des points de restauration de machine virtuelle avec l’API

Utilisez les API REST de calcul Azure pour créer des points de restauration cohérents avec les applications ou les incidents pour une machine virtuelle, dans la même région ou entre régions.

Références d’API : Points de restauration | Collections de points de restauration | PowerShell

Prérequis

• Découvrez-en plus sur les exigences d’un point de restauration de machine virtuelle.
• Passez en revue les exigences et limitations de prise en charge avant de créer des points de restauration.

Créer des points de restauration VM

Les sections suivantes décrivent les étapes à suivre pour créer des points de restauration de machine virtuelle avec les API REST de calcul Azure.

Plus d’informations sont disponibles dans la documentation de l’API Points de restauration, PowerShell et Collections de points de restauration.

Étape 1 : Créer une collection de points de restauration VM

Une collection de points de restauration est la ressource parente qui contient tous les points de restauration d’une machine virtuelle.

Appelez l’API Collections de points de restauration — Créer ou mettre à jour :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}?api-version=2021-03-01

Corps de la demande :

  {
    "location": "<region>",
    "properties": {
      "source": {
        "id": "<VM Arm Id>"
      },
      "instantAccess": true
    }
  }

• Défini location sur la région de la machine virtuelle pour une collection locale ou sur la région cible d’une collection inter-régions (et incluez l’ID de ressource ARM de la collection de points de restauration source dans source.id).
• Si vous souhaitez activer l’accès instantané (version préliminaire), ajoutez "instantAccess": true à properties. Cela s’applique à tous les points de restauration créés dans la collection. Nécessite l’API version 2025-04-01 ou ultérieure. Cela s’applique uniquement aux machines virtuelles avec disque SSD Premium v2 et/ou Ultra en tant que disques de données .

Étape 2 : Créer un point de restauration VM

Appelez les points de restauration : créez une API dans la collection créée à l’étape 1 :

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}/restorePoints/{restorePointName}?api-version=2021-03-01

Corps de la demande :

  {
    "name": "<restorePointName>",
    "properties": {
     "instantAccessDurationMinutes": 120,
      "provisioningState": "Succeeded",
    }
  }

Remarque : instantAccessDurationMinutes est un paramètre facultatif. La valeur par défaut est 300 (5 heures). Peut être défini sur une valeur inférieure, mais pas supérieure à 300. Cela s’applique aux futurs points de restauration et NON aux points de restauration existants déjà créés.

Propriétés du corps de la demande de clé :

Étape 3 : Suivre l’état de création du point de restauration de machine virtuelle

La création des points de restauration locaux s’effectue en quelques secondes. Vérifiez provisioningState sur le point de restauration — il passe de Creating à Succeeded (ou Failed).

Les points de restauration interrégion sont une opération de longue durée. Interrogez l’API Restore Points — Get avec $expand=instanceView pour vérifier la progression de la copie pour chaque disque (completionPercent). Le point de restauration est utilisable uniquement une fois que tous les points de restauration de disque ont terminé la réplication.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{collectionName}/restorePoints/{restorePointName}?$expand=instanceView&api-version=2021-03-01

État de l’accès aux instantanés : Si l’accès instantané est activé pour la collection, la même réponse GET avec instanceView inclut snapshotAccessState par point de restauration de disque. Un statut de InstantAccess ou de AvailableWithInstantAccess signifie que le point de restauration est prêt pour la restauration rapide de disque.

Étape 4 : Désactiver InstantAccess

Utilisez l’appel d’API REST suivant pour désactiver l’IA activée sur la machine virtuelle.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}?api-version=2025-04-01

Corps de la demande :

  {
    "location": "<region>",
    "properties": {
      "source": {
        "id": "<VM Arm Id>"
      },
      "instantAccess": false
    }
  }

Étapes suivantes

• En découvrir plus sur la gestion des points de restauration.
• Créez des points de restauration à l’aide du portail Azure, CLI ou PowerShell.
• En savoir plus sur les options de sauvegarde et de restauration pour les machines virtuelles dans Azure.