Schnellstart: Erstellen von VM-Wiederherstellungspunkten mithilfe von APIs

Verwenden Sie die Azure Compute-REST-APIs, um anwendungskonsensierte oder absturzkonsente Wiederherstellungspunkte für einen virtuellen Computer in derselben Region oder regionübergreifend zu erstellen.

API-Verweise: Wiederherstellungspunkte | Wiederherstellungspunktsammlungen | PowerShell

Voraussetzungen

Erstellen von VM-Wiederherstellungspunkten

In den folgenden Abschnitten werden die Schritte beschrieben, die Sie ausführen müssen, um VM-Wiederherstellungspunkte mit den Azure Compute-REST-APIs zu erstellen.

Weitere Informationen finden Sie in der API-Dokumentation zu Wiederherstellungspunkten, PowerShell und Wiederherstellungspunktsammlungen.

Schritt 1: Erstellen einer VM-Wiederherstellungspunktsammlung

Eine Wiederherstellungspunktauflistung ist die übergeordnete Ressource, die alle Wiederherstellungspunkte für einen virtuellen Computer enthält.

Rufen Sie die API Restore Point Collections — Create or Update auf:

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

Anforderungstext:

  {
    "location": "<region>",
    "properties": {
      "source": {
        "id": "<VM Arm Id>"
      },
      "instantAccess": true
    }
  }
  • Legen Sie in location die Region des virtuellen Computers für eine lokale Sammlung oder die Zielregion für eine regionsübergreifende Sammlung fest (und geben Sie die ARM-Ressourcen-ID der Quell-Wiederherstellungspunktsammlung in source.id an).
  • Optional können Sie zu "instantAccess": true hinzufügen, um properties zu aktivieren. Dies gilt für alle Wiederherstellungspunkte, die in der Sammlung erstellt wurden. Erfordert API-Version 2025-04-01 oder höher. Dies gilt nur für VMs mit Premium SSD v2 und/oder Ultra-Datenträgern als Datendatenträger.

Schritt 2: Erstellen eines VM-Wiederherstellungspunkts

Aufrufen der Wiederherstellungspunkte – Erstellen einer API innerhalb der in Schritt 1 erstellten Sammlung:

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

Anforderungstext:

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

Hinweis: instantAccessDurationMinutes ist ein optionaler Parameter. Der Standardwert ist 300 (5 Stunden). Kann auf einen niedrigeren Wert festgelegt werden, aber nicht höher als 300. Dies gilt für zukünftige Wiederherstellungspunkte und NICHT für bereits erstellte Wiederherstellungspunkte.

Haupteigenschaften des Anforderungstexts:

Eigenschaft Beschreibung
consistencyMode Weglassen für anwendungskonsistent (Standardeinstellung). Auf CrashConsistent für absturzkonsistente Wiederherstellungspunkte festgelegt.
excludeDisks Optional. Array von Datenträgerbezeichnern, die vom Wiederherstellungspunkt ausgeschlossen werden sollen, um die Speicherkosten zu reduzieren.
instantAccessDurationMinutes Optional. (Nur Sofortzugriff) Dauer in Minuten für den Sofortzugriff. Gültiger Bereich: 60–300. Standard: 300 Minuten (5 Stunden).

Schritt 3: Nachverfolgen des Status der Erstellung des VM-Wiederherstellungspunkts

Lokale Wiederherstellungspunkte sind innerhalb weniger Sekunden abgeschlossen. Überprüfen Sie provisioningState am Wiederherstellungspunkt – es wechselt von Creating zu Succeeded (oder Failed).

Regionsübergreifende Wiederherstellungspunkte sind ein lang andauernder Vorgang. Fragen Sie die API „Wiederherstellungspunkte — Abrufen“ mit $expand=instanceView ab, um den Kopierfortschritt für jeden Datenträger zu überprüfen (completionPercent). Der Wiederherstellungspunkt kann nur verwendet werden, nachdem alle Datenträgerwiederherstellungspunkte die Replikation abgeschlossen haben.

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

Status des Snapshotzugriffs: Wenn für die Sammlung Instant Access aktiviert ist, enthält dieselbe GET-Antwort mit instanceView snapshotAccessState für jeden Datenträgerwiederherstellungspunkt. Der Status InstantAccess oder AvailableWithInstantAccess bedeutet, dass der Wiederherstellungspunkt für die schnelle Datenträgerwiederherstellung bereit ist.

Schritt 4: Deaktivieren von InstantAccess

Verwenden Sie den folgenden REST-API-Aufruf, um IA auf dem virtuellen Computer zu deaktivieren.

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

Anforderungstext:

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

Nächste Schritte

  • Erfahren Sie mehr über die Verwaltung von Wiederherstellungspunkten.
  • Erstellen Sie Wiederherstellungspunkte mithilfe des portals Azure, CLI oder PowerShell.
  • Erfahren Sie mehr über Sicherungs- und Wiederherstellungsoptionen für virtuelle Computer in Azure.
  • Last updated on