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=2025-04-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).
• Pour activer l’accès instantané, ajoutez "instantAccess": true à properties. L’accès instantané s’applique uniquement aux machines virtuelles avec des disques de données Premium SSD v2 ou Ultra. Il prend en charge les points de restauration cohérents entre applications et multi-disques (en préversion) créés dans la collection et nécessite la version d’API 2025-04-01 ou ultérieure.

É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=2025-04-01

Corps de la demande :

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

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é :

Pour créer un point de restauration cohérent après incident sur plusieurs disques avec une durée d’accès instantané de 120 minutes (en version préliminaire), utilisez le corps de la requête suivant dans la collection avec Accès instantané à l’étape 1 :

{
  "properties": {
    "consistencyMode": "CrashConsistent",
    "instantAccessDurationMinutes": 120
  }
}

É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=2025-04-01

État de l’accès instantané : Si l’accès instantané est activé pour la collection, vérifiez instantAccessState le point de restauration pour valider l’état d’accès consolidé sur tous les points de restauration de disque. Une valeur de AvailableWithInstantAccess ou InstantAccess signifie que le point de restauration est prêt pour une restauration rapide des disques. Utilisez snapshotAccessState par disque dans instanceView uniquement lorsque vous devez vérifier l’état du point de restauration d’un disque spécifique.

Étape 4 : Désactiver l’accès instantané

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.