Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Bicep resource definition
The restorePointCollections/restorePoints resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Compute/restorePointCollections/restorePoints resource, add the following Bicep to your template.
resource symbolicname 'Microsoft.Compute/restorePointCollections/restorePoints@2021-03-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    excludeDisks: [
      {
        id: 'string'
      }
    ]
    timeCreated: 'string'
  }
}
Property Values
Microsoft.Compute/restorePointCollections/restorePoints
| Name | Description | Value | 
|---|---|---|
| name | The resource name | string (required) | 
| parent | In Bicep, you can specify the parent resource for a child resource. You only need to add this property when the child resource is declared outside of the parent resource. For more information, see Child resource outside parent resource. | Symbolic name for resource of type: restorePointCollections | 
| properties | The restore point properties. | RestorePointProperties | 
ApiEntityReference
| Name | Description | Value | 
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string | 
RestorePointProperties
| Name | Description | Value | 
|---|---|---|
| excludeDisks | List of disk resource ids that the customer wishes to exclude from the restore point. If no disks are specified, all disks will be included. | ApiEntityReference[] | 
| timeCreated | Gets the creation time of the restore point. | string | 
ARM template resource definition
The restorePointCollections/restorePoints resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Compute/restorePointCollections/restorePoints resource, add the following JSON to your template.
{
  "type": "Microsoft.Compute/restorePointCollections/restorePoints",
  "apiVersion": "2021-03-01",
  "name": "string",
  "properties": {
    "excludeDisks": [
      {
        "id": "string"
      }
    ],
    "timeCreated": "string"
  }
}
Property Values
Microsoft.Compute/restorePointCollections/restorePoints
| Name | Description | Value | 
|---|---|---|
| apiVersion | The api version | '2021-03-01' | 
| name | The resource name | string (required) | 
| properties | The restore point properties. | RestorePointProperties | 
| type | The resource type | 'Microsoft.Compute/restorePointCollections/restorePoints' | 
ApiEntityReference
| Name | Description | Value | 
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string | 
RestorePointProperties
| Name | Description | Value | 
|---|---|---|
| excludeDisks | List of disk resource ids that the customer wishes to exclude from the restore point. If no disks are specified, all disks will be included. | ApiEntityReference[] | 
| timeCreated | Gets the creation time of the restore point. | string | 
Usage Examples
Terraform (AzAPI provider) resource definition
The restorePointCollections/restorePoints resource type can be deployed with operations that target:
For a list of changed properties in each API version, see change log.
Resource format
To create a Microsoft.Compute/restorePointCollections/restorePoints resource, add the following Terraform to your template.
resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Compute/restorePointCollections/restorePoints@2021-03-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      excludeDisks = [
        {
          id = "string"
        }
      ]
      timeCreated = "string"
    }
  }
}
Property Values
Microsoft.Compute/restorePointCollections/restorePoints
| Name | Description | Value | 
|---|---|---|
| name | The resource name | string (required) | 
| parent_id | The ID of the resource that is the parent for this resource. | ID for resource of type: restorePointCollections | 
| properties | The restore point properties. | RestorePointProperties | 
| type | The resource type | "Microsoft.Compute/restorePointCollections/restorePoints@2021-03-01" | 
ApiEntityReference
| Name | Description | Value | 
|---|---|---|
| id | The ARM resource id in the form of /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... | string | 
RestorePointProperties
| Name | Description | Value | 
|---|---|---|
| excludeDisks | List of disk resource ids that the customer wishes to exclude from the restore point. If no disks are specified, all disks will be included. | ApiEntityReference[] | 
| timeCreated | Gets the creation time of the restore point. | string | 
Usage Examples
Terraform Samples
A basic example of deploying Virtual Machine Restore Point.
terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}
provider "azapi" {
  skip_provider_registration = false
}
variable "resource_name" {
  type    = string
  default = "acctest0001"
}
variable "___location" {
  type    = string
  default = "westus"
}
resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  ___location = var.___location
}
resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2024-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-vnet"
  ___location  = var.___location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = ["10.0.0.0/16"]
      }
      dhcpOptions = {
        dnsServers = []
      }
      privateEndpointVNetPolicies = "Disabled"
      subnets                     = []
    }
  }
}
resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2024-05-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = "${var.resource_name}-subnet"
  body = {
    properties = {
      addressPrefix                     = "10.0.0.0/24"
      defaultOutboundAccess             = true
      delegations                       = []
      privateEndpointNetworkPolicies    = "Disabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies           = []
      serviceEndpoints                  = []
    }
  }
}
resource "azapi_resource" "networkInterface" {
  type      = "Microsoft.Network/networkInterfaces@2024-05-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-nic"
  ___location  = var.___location
  body = {
    properties = {
      enableAcceleratedNetworking = false
      enableIPForwarding          = false
      ipConfigurations = [{
        name = "internal"
        properties = {
          primary                   = false
          privateIPAddressVersion   = "IPv4"
          privateIPAllocationMethod = "Dynamic"
          subnet = {
            id = azapi_resource.subnet.id
          }
        }
      }]
    }
  }
}
resource "azapi_resource" "virtualMachine" {
  type      = "Microsoft.Compute/virtualMachines@2024-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-vm"
  ___location  = var.___location
  body = {
    properties = {
      additionalCapabilities = {}
      applicationProfile = {
        galleryApplications = []
      }
      diagnosticsProfile = {
        bootDiagnostics = {
          enabled    = false
          storageUri = ""
        }
      }
      extensionsTimeBudget = "PT1H30M"
      hardwareProfile = {
        vmSize = "Standard_F2"
      }
      networkProfile = {
        networkInterfaces = [{
          id = azapi_resource.networkInterface.id
          properties = {
            primary = true
          }
        }]
      }
      osProfile = {
        adminUsername            = "adminuser"
        allowExtensionOperations = true
        computerName             = "${var.resource_name}-vm"
        linuxConfiguration = {
          disablePasswordAuthentication = true
          patchSettings = {
            assessmentMode = "ImageDefault"
            patchMode      = "ImageDefault"
          }
          provisionVMAgent = true
          ssh = {
            publicKeys = [{
              keyData = "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQC+wWK73dCr+jgQOAxNsHAnNNNMEMWOHYEccp6wJm2gotpr9katuF/ZAdou5AaW1C61slRkHRkpRRX9FA9CYBiitZgvCCz+3nWNN7l/Up54Zps/pHWGZLHNJZRYyAB6j5yVLMVHIHriY49d/GZTZVNB8GoJv9Gakwc/fuEZYYl4YDFiGMBP///TzlI4jhiJzjKnEvqPFki5p2ZRJqcbCiF4pJrxUQR/RXqVFQdbRLZgYfJ8xGB878RENq3yQ39d8dVOkq4edbkzwcUmwwwkYVPIoDGsYLaRHnG+To7FvMeyO7xDVQkMKzopTQV8AuKpyvpqu0a9pWOMaiCyDytO7GGN you@me.com"
              path    = "/home/adminuser/.ssh/authorized_keys"
            }]
          }
        }
        secrets = []
      }
      priority = "Regular"
      storageProfile = {
        dataDisks = []
        imageReference = {
          offer     = "0001-com-ubuntu-server-jammy"
          publisher = "Canonical"
          sku       = "22_04-lts"
          version   = "latest"
        }
        osDisk = {
          caching      = "ReadWrite"
          createOption = "FromImage"
          managedDisk = {
            storageAccountType = "Standard_LRS"
          }
          osType                  = "Linux"
          writeAcceleratorEnabled = false
        }
      }
    }
  }
}
resource "azapi_resource" "restorePointCollection" {
  type      = "Microsoft.Compute/restorePointCollections@2024-03-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = "${var.resource_name}-rpc"
  ___location  = var.___location
  body = {
    properties = {
      source = {
        id = azapi_resource.virtualMachine.id
      }
    }
  }
  tags = {
    foo = "bar"
  }
}
resource "azapi_resource" "restorePoint" {
  type      = "Microsoft.Compute/restorePointCollections/restorePoints@2024-03-01"
  parent_id = azapi_resource.restorePointCollection.id
  name      = "${var.resource_name}-rp"
  body = {
    properties = {}
  }
}