Guida introduttiva: Creare punti di ripristino delle macchine virtuali usando le API

Usare le API REST di calcolo Azure per creare punti di ripristino coerenti con l'applicazione o coerenti con l'arresto anomalo del sistema per una macchina virtuale, nella stessa area o tra aree.

Riferimenti API: Punti di ripristino | Raccolte di punti di ripristino | PowerShell

Prerequisiti

• Altre informazioni sui requisiti per un punto di ripristino della macchina virtuale.
• Esaminare i requisiti e le limitazioni del supporto prima di creare punti di ripristino.

Creare punti di ripristino della macchina virtuale

Le sezioni seguenti illustrano i passaggi da eseguire per creare punti di ripristino delle macchine virtuali con le API REST di calcolo Azure.

Per altre informazioni, vedere la documentazione dell'API Punti di ripristino, PowerShell e Restore Point Collections .

Passaggio 1: Creare una raccolta di punti di ripristino della macchina virtuale

Una raccolta di punti di ripristino è la risorsa padre che contiene tutti i punti di ripristino per una macchina virtuale.

Chiamare l'API Raccolte di punti di ripristino — Crea o aggiorna:

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

Corpo della richiesta:

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

• Impostare location sull'area della macchina virtuale per una raccolta locale o sull'area di destinazione per una raccolta tra aree e includere l'ID risorsa ARM della raccolta di punti di ripristino di origine in source.id.
• Facoltativamente, per abilitare l'accesso immediato (anteprima) aggiungere "instantAccess": true a properties. Questo vale per tutti i punti di ripristino creati nella raccolta. Richiede la versione dell'API 2025-04-01 o successiva. Questo è applicabile solo per le macchine virtuali con dischi SSD Premium v2 e/o Ultra come dischi dati .

Passaggio 2: Creare un punto di ripristino della macchina virtuale

Richiamare l'API Restore Points — Create all'interno della raccolta creata nel passaggio 1:

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

Corpo della richiesta:

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

Nota: instantAccessDurationMinutes è un parametro facoltativo. Il valore predefinito è 300 (5 ore). Può essere impostato su un valore inferiore, ma non superiore a 300. Questo vale per i punti di ripristino futuri e NON per i punti di ripristino esistenti già creati.

Proprietà del corpo della richiesta della chiave:

Passaggio 3: Tenere traccia dello stato della creazione del punto di ripristino della macchina virtuale

I punti di ripristino locali sono stati completati entro pochi secondi. Controlla provisioningState nel punto di ripristino — passa da Creating a Succeeded (o Failed).

I punti di ripristino tra aree geografiche sono un'operazione di lunga durata. Interrogare l'API Punti di ripristino — Get usando $expand=instanceView per verificare l'avanzamento della copia per ogni disco (completionPercent). Il punto di ripristino è utilizzabile solo dopo che tutti i punti di ripristino del disco hanno completato la replica.

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

Stato dell'accesso snapshot: Se per la raccolta è abilitato Accesso immediato, la stessa risposta GET con instanceView include snapshotAccessState per ogni punto di ripristino del disco. Uno stato pari a InstantAccess o AvailableWithInstantAccess indica che il punto di ripristino è pronto per un rapido ripristino del disco.

Passaggio 4: Disabilitare InstantAccess

Usare la chiamata API REST seguente per disabilitare L'IA abilitata nella macchina virtuale.

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

Corpo della richiesta:

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

Passaggi successivi

• Altre informazioni sulla gestione dei punti di ripristino.
• Creare punti di ripristino usando il portale Azure, CLI o PowerShell.
• Altre informazioni sulle opzioni di backup e ripristino per le macchine virtuali in Azure.