Inicio rápido: Creación de puntos de restauración de máquinas virtuales mediante API

Use las API REST de Azure Compute para crear puntos de restauración consistente entre aplicaciones o consistente entre bloqueos para una máquina virtual, en la misma región o entre regiones.

Referencias de API: Restore Points | Restore Point Collections | PowerShell

Prerrequisitos

• Obtenga más información sobre los requisitos de un punto de restauración de máquina virtual.
• Revise los requisitos y limitaciones de soporte técnico antes de crear puntos de restauración.

Creación de puntos de restauración de máquinas virtuales

En las secciones siguientes se describen los pasos que debe seguir para crear puntos de restauración de máquinas virtuales con las API REST de proceso de Azure.

Puede encontrar más información en la documentación de las API de Puntos de restauración, PowerShell y Colecciones de puntos de restauración.

Paso 1: Creación de una colección de puntos de restauración de máquinas virtuales

Una colección de puntos de restauración es el recurso primario que contiene todos los puntos de restauración de una máquina virtual.

Llame a la API Colecciones de puntos de restauración: crear o actualizar:

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

Cuerpo de la solicitud:

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

• Establezca location en la región de la máquina virtual para una colección local o en la región de destino de una colección entre regiones (e incluya el identificador de recurso arm de la colección de puntos de restauración de origen en source.id).
• Opcionalmente, para habilitar el acceso instantáneo, agregue "instantAccess": true a properties. Esta configuración se aplica a todos los puntos de restauración creados en la colección. Requiere la versión de API 2025-04-01 o posterior. Esta configuración solo se aplica a las máquinas virtuales con discos SSD Premium v2 y Ultra como discos de datos .

Paso 2: Creación de un punto de restauración de máquinas virtuales

Llame a la API Restore Points — Create dentro de la colección creada en el Paso 1:

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

Cuerpo de la solicitud:

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

Nota: instantAccessDurationMinutes es un parámetro opcional. El valor predeterminado es 300 (5 horas). Se puede establecer en un valor inferior, pero no superior a 300. Esto es aplicable a los puntos de restauración futuros y NO a los puntos de restauración existentes ya creados.

Propiedades del cuerpo de la solicitud de clave:

Paso 3: Seguimiento del estado de la creación del punto de restauración de la VM

La creación de puntos de restauración locales se completa en unos segundos. Compruebe provisioningState en el punto de restauración: pasa de Creating a Succeeded (o Failed).

Los puntos de restauración entre regiones son una operación de larga duración. Sondee los puntos de restauración: obtenga API con $expand=instanceView para comprobar el progreso de la copia por disco (completionPercent). El punto de restauración solo se puede usar después de que todos los puntos de restauración de disco hayan completado la replicación.

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

Estado de acceso instantáneo: Si la colección tiene habilitado acceso instantáneo, compruebe instantAccessState en el punto de restauración para validar el estado de acceso consolidado en todos los puntos de restauración de disco. Un valor de AvailableWithInstantAccess o InstantAccess significa que el punto de restauración está listo para una restauración rápida del disco. Use la opción por disco snapshotAccessState en instanceView solo cuando necesite inspeccionar el estado de un punto de restauración de un disco individual.

Paso 4: Deshabilitar el acceso instantáneo

Use la siguiente llamada a la API REST para deshabilitar ia habilitada en la máquina virtual.

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

Cuerpo de la solicitud:

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

Pasos siguientes

• Obtenga más información sobre la administración de puntos de restauración.
• Cree puntos de restauración mediante el portal Azure, CLI o PowerShell.
• Learn más sobre las opciones de copia de seguridad y restauración de máquinas virtuales en Azure.