Quickstart: Criar pontos de restauro de VMs usando APIs

Utilize as APIs REST do Azure Compute para criar pontos de restauro consistentes com a aplicação ou consistentes após falha para uma VM, na mesma região ou entre regiões.

Referências API: Restore Points | Restore Point Collections | PowerShell

Pré-requisitos

• Saiba mais sobre os requisitos para um ponto de restauro de VM.
• Revise os requisitos e limitações de suporte antes de criar pontos de restauro.

Criar pontos de restauração de VM

As secções seguintes descrevem os passos que precisa de seguir para criar pontos de restauro de VMs com as APIs REST do Azure Compute.

Pode encontrar mais informações na documentação da API Restore Points, PowerShell e Restore Point Collections.

Etapa 1: Criar uma coleção de pontos de restauração de VM

Uma coleção de pontos de restauração é o recurso pai que armazena todos os pontos de restauração de uma VM.

Chame a API Coleções de Pontos de Restauro — Criar ou Atualizar:

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

Corpo do pedido:

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

• Defina location para a região da VM para uma coleção local, ou para a região de destino para uma coleção entre regiões (e inclua o ID de recurso ARM da coleção do ponto de restauro de origem em source.id).
• Opcionalmente, para ativar o Acesso Instantâneo, adicione "instantAccess": true a properties. Esta definição aplica-se a todos os pontos de restauro criados na coleção. Requer a versão da API 2025-04-01 ou posterior. Esta configuração é aplicável apenas a VMs com discos Premium SSD v2 e Ultra como discos de dados .

Etapa 2: Criar um ponto de restauração de VM

Chame a API Restore Points — Create na coleção criada no passo 1:

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

Corpo do pedido:

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

Nota: instantAccessDurationMinutes é um parâmetro opcional. O padrão é 300 (5 horas). Pode ser definido para um valor inferior, mas não superior a 300. Isto aplica-se a pontos de restauro futuros e NÃO a pontos de restauro já criados.

Propriedades principais do corpo do pedido:

Etapa 3: Controlar o status da criação do ponto de restauração da VM

Os pontos de restauro locais são concluídos em poucos segundos. Verifique provisioningState no ponto de restauro — passa de Creating para Succeeded (ou Failed).

Os pontos de restauro entre regiões são uma operação de longa duração. Consultar a API Pontos de Restauro — Obter com $expand=instanceView para verificar o progresso da cópia por disco (completionPercent). O ponto de restauro só é utilizável depois de todos os pontos de restauro de disco terem concluído a replicação.

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

Estado do Acesso Instantâneo: Se a coleção tiver o Acesso Instantâneo ativado, verifique instantAccessState o ponto de restauro para validar o estado de acesso consolidado em todos os pontos de restauração do disco. Um valor de InstantAccess ou AvailableWithInstantAccess significa que o ponto de restauro está pronto para restauração rápida do disco. Utilize a instanceView por disco em snapshotAccessState apenas quando precisar de verificar o estado do ponto de restauro de um disco individual.

Passo 4: Desativar o Acesso Instantâneo

Use a seguinte chamada REST API para desativar a IA ativada na VM.

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

Corpo do pedido:

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

Próximos passos

• Saiba mais sobre a gestão dos pontos de reparação.
• Cria pontos de restauro usando o portal Azure, CLI ou PowerShell.
• Saiba mais sobre opções de backup e restauro para máquinas virtuais em Azure.