Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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=2025-04-01
Corpo della richiesta:
{
"location": "<region>",
"properties": {
"source": {
"id": "<VM Arm Id>"
},
"instantAccess": true
}
}
- Impostare
locationsull'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 insource.id. - Per abilitare l'accesso immediato, aggiungere
"instantAccess": trueaproperties. L'accesso immediato si applica solo alle macchine virtuali con dischi dati Ssd Premium v2 o Ultra come dischi dati. Supporta punti di ripristino coerenti con l'applicazione e coerenti con l'arresto anomalo su più dischi (in anteprima) creati nella raccolta e richiede la versione2025-04-01dell'API o versioni successive.
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=2025-04-01
Corpo della richiesta:
{
"name": "<restorePointName>",
"properties": {
"instantAccessDurationMinutes": 120
}
}
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:
| Proprietà | Description |
|---|---|
consistencyMode |
Omettere per coerenza con l'applicazione (impostazione predefinita). Impostare a CrashConsistent per i punti di ripristino coerenti in caso di crash. |
excludeDisks |
Optional. Matrice di identificatori di disco da escludere dal punto di ripristino, per ridurre i costi di archiviazione. |
instantAccessDurationMinutes |
Optional. (Solo accesso istantaneo) Durata in minuti per l'accesso immediato. Intervallo valido: 60-300. Impostazione predefinita: 300 minuti (5 ore). |
Per creare un punto di ripristino coerente con l'arresto anomalo di più dischi con durata dell'Accesso immediato di 120 minuti (in anteprima), usare il corpo della richiesta seguente nella raccolta abilitata per l'Accesso immediato del passaggio:
{
"properties": {
"consistencyMode": "CrashConsistent",
"instantAccessDurationMinutes": 120
}
}
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=2025-04-01
Stato di Accesso istantaneo: Se per la raccolta è abilitato l'Accesso istantaneo, controllare instantAccessState nel punto di ripristino per verificare lo stato di accesso consolidato tra tutti i punti di ripristino del disco. Un valore di AvailableWithInstantAccess o InstantAccess indica che il punto di ripristino è pronto per un rapido ripristino del disco. Usa l'opzione per disco snapshotAccessState in instanceView solo quando devi verificare lo stato di un singolo punto di ripristino di un disco.
Passaggio 4: Disabilitare l'accesso immediato
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.