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

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).
  • Para habilitar acceso instantáneo, agregue "instantAccess": true a properties. El acceso instantáneo solo se aplica a las máquinas virtuales con discos SSD Premium v2 o Ultra como discos de datos. Admite tanto puntos de restauración coherentes con la aplicación como puntos de restauración coherentes con varios discos (en versión preliminar) creados en la colección y requiere la versión 2025-04-01 de API o posterior.

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
    }
  }

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:

Propiedad Description
consistencyMode Omitir para la coherencia de la aplicación (valor predeterminado). Configúrelo en CrashConsistent para puntos de restauración consistente entre bloqueos.
excludeDisks Optional. Matriz de identificadores de disco que se excluirán del punto de restauración para reducir el costo de almacenamiento.
instantAccessDurationMinutes Optional. (Solo acceso instantáneo) Duración en minutos para el acceso instantáneo. Intervalo válido: 60–300. Valor predeterminado: 300 minutos (5 horas).

Para crear un punto de restauración coherente con bloqueos de varios discos con una duración de acceso instantáneo de 120 minutos (en versión preliminar), use el siguiente cuerpo de solicitud en la colección con el acceso instantáneo habilitado del paso 1:

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

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