Restore Point Collections - Create Or Update

Service:

Compute

API-versie:

2025-04-01

De bewerking voor het maken of bijwerken van de verzameling herstelpunten. Raadpleeg https://aka.ms/RestorePoints voor meer informatie. Bij het bijwerken van een verzameling herstelpunten kunnen alleen tags worden gewijzigd.

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

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
restorePointCollectionName	path	True	string	De naam van de verzameling herstelpunten.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Aanvraagbody

Name	Vereist	Type	Description
location	True	string	De geografische locatie waar de resource zich bevindt
properties.instantAccess		boolean	Deze eigenschap bepaalt of momentopname met directe toegang is ingeschakeld voor herstelpunten die zijn gemaakt onder deze verzameling herstelpunten voor Premium SSD v2 of Ultra-schijf. Snapshot met directe toegang voor Premium SSD v2 of Ultra-schijf is onmiddellijk beschikbaar voor het herstellen van de schijf met snelle herstelprestaties.
properties.source		RestorePointCollectionSourceProperties	De eigenschappen van de bronresource waaruit deze verzameling herstelpunten is gemaakt.
tags		object	Resourcetags.

Antwoorden

Name	Type	Description
200 OK	RestorePointCollection	De updatebewerking van de resource 'RestorePointCollection' is geslaagd
201 Created	RestorePointCollection	Resource 'RestorePointCollection' create-bewerking geslaagd
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Create or update a restore point collection for cross region copy.

Create or update a restore point collection.

Create or update a restore point collection for cross region copy.

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc?api-version=2025-04-01

{
  "location": "norwayeast",
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName"
    }
  },
  "tags": {
    "myTag1": "tagValue1"
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.RestorePointCollectionInner;
import com.azure.resourcemanager.compute.models.RestorePointCollectionSourceProperties;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for RestorePointCollections CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/
     * restorePointExamples/RestorePointCollection_CreateOrUpdate_ForCrossRegionCopy.json
     */
    /**
     * Sample code: Create or update a restore point collection for cross region copy.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        createOrUpdateARestorePointCollectionForCrossRegionCopy(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections().createOrUpdateWithResponse(
            "myResourceGroup", "myRpc",
            new RestorePointCollectionInner().withLocation("norwayeast").withTags(mapOf("myTag1", "tagValue1"))
                .withSource(new RestorePointCollectionSourceProperties().withId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName")),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python restore_point_collection_create_or_update_for_cross_region_copy.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.restore_point_collections.create_or_update(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="myRpc",
        parameters={
            "location": "norwayeast",
            "properties": {
                "source": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName"
                }
            },
            "tags": {"myTag1": "tagValue1"},
        },
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate_ForCrossRegionCopy.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v7"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ccea12be6cd5e64743499d46f7a9c8b60df52db1/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate_ForCrossRegionCopy.json
func ExampleRestorePointCollectionsClient_CreateOrUpdate_createOrUpdateARestorePointCollectionForCrossRegionCopy() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewRestorePointCollectionsClient().CreateOrUpdate(ctx, "myResourceGroup", "myRpc", armcompute.RestorePointCollection{
		Location: to.Ptr("norwayeast"),
		Tags: map[string]*string{
			"myTag1": to.Ptr("tagValue1"),
		},
		Properties: &armcompute.RestorePointCollectionProperties{
			Source: &armcompute.RestorePointCollectionSourceProperties{
				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.RestorePointCollection = armcompute.RestorePointCollection{
	// 	Name: to.Ptr("myRpc"),
	// 	Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc"),
	// 	Location: to.Ptr("norwayeast"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.RestorePointCollectionProperties{
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		RestorePointCollectionID: to.Ptr("638f052b-a7c2-450c-89e7-6a3b8f1d6a7c"),
	// 		Source: &armcompute.RestorePointCollectionSourceProperties{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 			Location: to.Ptr("eastus"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to The operation to create or update the restore point collection. Please refer to https://aka.ms/RestorePoints for more details. When updating a restore point collection, only tags may be modified.
 *
 * @summary The operation to create or update the restore point collection. Please refer to https://aka.ms/RestorePoints for more details. When updating a restore point collection, only tags may be modified.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate_ForCrossRegionCopy.json
 */
async function createOrUpdateARestorePointCollectionForCrossRegionCopy() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "myRpc";
  const parameters = {
    location: "norwayeast",
    source: {
      id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName",
    },
    tags: { myTag1: "tagValue1" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.createOrUpdate(
    resourceGroupName,
    restorePointCollectionName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate_ForCrossRegionCopy.json
// this example is just showing the usage of "RestorePointCollections_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this RestorePointGroupResource
RestorePointGroupCollection collection = resourceGroupResource.GetRestorePointGroups();

// invoke the operation
string restorePointGroupName = "myRpc";
RestorePointGroupData data = new RestorePointGroupData(new AzureLocation("norwayeast"))
{
    Source = new RestorePointGroupSource
    {
        Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName"),
    },
    Tags =
    {
    ["myTag1"] = "tagValue1"
    },
};
ArmOperation<RestorePointGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, restorePointGroupName, data);
RestorePointGroupResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
RestorePointGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "name": "myRpc",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "norwayeast",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
      "location": "eastus"
    },
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "provisioningState": "Succeeded"
  }
}

Statuscode:

201

{
  "name": "myRpc",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "norwayeast",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName",
      "location": "eastus"
    },
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "provisioningState": "Succeeded"
  }
}

Create or update a restore point collection.

Voorbeeldaanvraag

HTTP

PUT https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc?api-version=2025-04-01

{
  "location": "norwayeast",
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
    },
    "instantAccess": true
  },
  "tags": {
    "myTag1": "tagValue1"
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.RestorePointCollectionInner;
import com.azure.resourcemanager.compute.models.RestorePointCollectionSourceProperties;
import java.util.HashMap;
import java.util.Map;

/**
 * Samples for RestorePointCollections CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/
     * restorePointExamples/RestorePointCollection_CreateOrUpdate.json
     */
    /**
     * Sample code: Create or update a restore point collection.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createOrUpdateARestorePointCollection(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePointCollections().createOrUpdateWithResponse(
            "myResourceGroup", "myRpc",
            new RestorePointCollectionInner().withLocation("norwayeast").withTags(mapOf("myTag1", "tagValue1"))
                .withSource(new RestorePointCollectionSourceProperties().withId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"))
                .withInstantAccess(true),
            com.azure.core.util.Context.NONE);
    }

    // Use "Map.of" if available
    @SuppressWarnings("unchecked")
    private static <T> Map<String, T> mapOf(Object... inputs) {
        Map<String, T> map = new HashMap<>();
        for (int i = 0; i < inputs.length; i += 2) {
            String key = (String) inputs[i];
            T value = (T) inputs[i + 1];
            map.put(key, value);
        }
        return map;
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Python

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python restore_point_collection_create_or_update.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.restore_point_collections.create_or_update(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="myRpc",
        parameters={
            "location": "norwayeast",
            "properties": {
                "instantAccess": True,
                "source": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"
                },
            },
            "tags": {"myTag1": "tagValue1"},
        },
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v7"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/ccea12be6cd5e64743499d46f7a9c8b60df52db1/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate.json
func ExampleRestorePointCollectionsClient_CreateOrUpdate_createOrUpdateARestorePointCollection() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewRestorePointCollectionsClient().CreateOrUpdate(ctx, "myResourceGroup", "myRpc", armcompute.RestorePointCollection{
		Location: to.Ptr("norwayeast"),
		Tags: map[string]*string{
			"myTag1": to.Ptr("tagValue1"),
		},
		Properties: &armcompute.RestorePointCollectionProperties{
			InstantAccess: to.Ptr(true),
			Source: &armcompute.RestorePointCollectionSourceProperties{
				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.RestorePointCollection = armcompute.RestorePointCollection{
	// 	Name: to.Ptr("myRpc"),
	// 	Type: to.Ptr("Microsoft.Compute/restorePointCollections"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc"),
	// 	Location: to.Ptr("norwayeast"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.RestorePointCollectionProperties{
	// 		InstantAccess: to.Ptr(true),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		RestorePointCollectionID: to.Ptr("638f052b-a7c2-450c-89e7-6a3b8f1d6a7c"),
	// 		Source: &armcompute.RestorePointCollectionSourceProperties{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 			Location: to.Ptr("eastus"),
	// 		},
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
require("dotenv/config");

/**
 * This sample demonstrates how to The operation to create or update the restore point collection. Please refer to https://aka.ms/RestorePoints for more details. When updating a restore point collection, only tags may be modified.
 *
 * @summary The operation to create or update the restore point collection. Please refer to https://aka.ms/RestorePoints for more details. When updating a restore point collection, only tags may be modified.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate.json
 */
async function createOrUpdateARestorePointCollection() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "myRpc";
  const parameters = {
    instantAccess: true,
    location: "norwayeast",
    source: {
      id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
    },
    tags: { myTag1: "tagValue1" },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePointCollections.createOrUpdate(
    resourceGroupName,
    restorePointCollectionName,
    parameters,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2025-04-01/examples/restorePointExamples/RestorePointCollection_CreateOrUpdate.json
// this example is just showing the usage of "RestorePointCollections_CreateOrUpdate" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ResourceGroupResource created on azure
// for more information of creating ResourceGroupResource, please refer to the document of ResourceGroupResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
ResourceIdentifier resourceGroupResourceId = ResourceGroupResource.CreateResourceIdentifier(subscriptionId, resourceGroupName);
ResourceGroupResource resourceGroupResource = client.GetResourceGroupResource(resourceGroupResourceId);

// get the collection of this RestorePointGroupResource
RestorePointGroupCollection collection = resourceGroupResource.GetRestorePointGroups();

// invoke the operation
string restorePointGroupName = "myRpc";
RestorePointGroupData data = new RestorePointGroupData(new AzureLocation("norwayeast"))
{
    Source = new RestorePointGroupSource
    {
        Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
    },
    InstantAccess = true,
    Tags =
    {
    ["myTag1"] = "tagValue1"
    },
};
ArmOperation<RestorePointGroupResource> lro = await collection.CreateOrUpdateAsync(WaitUntil.Completed, restorePointGroupName, data);
RestorePointGroupResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
RestorePointGroupData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Voorbeeldrespons

Statuscode:

200

{
  "name": "myRpc",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "norwayeast",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
      "location": "eastus"
    },
    "instantAccess": true,
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "provisioningState": "Succeeded"
  }
}

Statuscode:

201

{
  "name": "myRpc",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/myRpc",
  "type": "Microsoft.Compute/restorePointCollections",
  "location": "norwayeast",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "source": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
      "location": "eastus"
    },
    "instantAccess": true,
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "provisioningState": "Succeeded"
  }
}

Definities

Name	Description
AdditionalUnattendContent	Hiermee geeft u aanvullende XML-opgemaakte informatie op die kan worden opgenomen in het Unattend.xml-bestand, dat wordt gebruikt door Windows Setup. De inhoud wordt gedefinieerd door de naam van de instelling, de onderdeelnaam en de pass waarin de inhoud wordt toegepast.
ApiEntityReference	De API-entiteitsreferentie.
ApiError	Api-fout.
ApiErrorBase	Api-foutbasis.
BootDiagnostics	Diagnostische gegevens over opstarten is een functie voor foutopsporing waarmee u console-uitvoer en schermopname kunt bekijken om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.
CachingTypes	Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: Geen,Alleen-lezen,Lezen'. De standaardwaarden zijn: Geen voor standaardopslag. ReadOnly voor Premium opslag
CloudError	Een foutreactie van de Compute-service.
ComponentNames
ConsistencyModeTypes	ConsistencyMode van het RestorePoint. Kan worden opgegeven in de invoer tijdens het maken van een herstelpunt. Voorlopig wordt alleen CrashConsistent geaccepteerd als een geldige invoer. Raadpleeg https://aka.ms/RestorePoints voor meer informatie.
createdByType	Het type identiteit waarmee de resource is gemaakt.
DiagnosticsProfile	Hiermee geeft u de status van diagnostische instellingen voor opstarten. Minimale API-versie: 2015-06-15.
DiskControllerTypes	Hiermee geeft u het type schijfcontroller geconfigureerd voor de VIRTUELE machine en VirtualMachineScaleSet. Deze eigenschap wordt alleen ondersteund voor virtuele machines waarvan de besturingssysteemschijf en de VM-sku ondersteuning biedt voor generatie 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), controleert u de HyperVGenerations-functie die wordt geretourneerd als onderdeel van de SKU-mogelijkheden van de VM in het antwoord van de API voor Microsoft.Compute SKU's voor de regio bevat V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Raadpleeg https://aka.ms/azure-diskcontrollertypesvoor meer informatie over ondersteunde schijfcontrollertypen.
DiskEncryptionSetParameters	Beschrijft de parameter van de resource-id van de door de klant beheerde schijfversleutelingsset die kan worden opgegeven voor schijf. Opmerking: de resource-id van de schijfversleutelingsset kan alleen worden opgegeven voor beheerde schijven. Raadpleeg https://aka.ms/mdssewithcmkoverview voor meer informatie.
DiskEncryptionSettings	Beschrijft een versleutelingsinstelling voor een schijf
DiskRestorePointAttributes	Details van het schijfherstelpunt.
DiskRestorePointInstanceView	De instantieweergave van een schijfherstelpunt.
DiskRestorePointReplicationStatus	De instantieweergave van een schijfherstelpunt.
EncryptionIdentity	Hiermee geeft u de beheerde identiteit op die door ADE wordt gebruikt om toegangstoken op te halen voor sleutelkluisbewerkingen.
HardwareProfile	Hiermee geeft u de hardware-instellingen voor de virtuele machine.
HostEndpointSettings	Hiermee geeft u bepaalde instellingen voor hosteindpunten op.
HyperVGenerationTypes	Hiermee geeft u het HyperVGeneration-type op
InnerError	Interne foutdetails.
InstanceViewStatus	Status van exemplaarweergave.
KeyVaultKeyReference	Beschrijft een verwijzing naar Key Vault Key
KeyVaultSecretReference	Beschrijft een verwijzing naar Key Vault-geheim
LinuxConfiguration	Hiermee geeft u de linux-besturingssysteeminstellingen op de virtuele machine. Zie Linux op Azure-Endorsed Distributiesvoor een lijst met ondersteunde Linux-distributies.
LinuxPatchAssessmentMode	Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine. Mogelijke waarden zijn: ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine. AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.
LinuxPatchSettings	Hiermee geeft u instellingen met betrekking tot VM-gastpatching op Linux.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.
LinuxVMGuestPatchAutomaticByPlatformSettings	Hiermee geeft u aanvullende instellingen op die moeten worden toegepast wanneer de patchmodus AutomaticByPlatform is geselecteerd in de Instellingen voor Linux-patches.
LinuxVMGuestPatchMode	Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel. Mogelijke waarden zijn: ImageDefault : de standaardpatchingconfiguratie van de virtuele machine wordt gebruikt. AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschap provisionVMAgent moet waar zijn
ManagedDiskParameters	De parameters van een beheerde schijf.
Mode	Hiermee geeft u de modus op waarop ProxyAgent wordt uitgevoerd als de functie is ingeschakeld. ProxyAgent begint met controleren of bewaken, maar dwingt geen toegangsbeheer af over aanvragen voor hosteindpunten in de controlemodus, terwijl in de modus Afdwingen het toegangsbeheer wordt afgedwongen. De standaardwaarde is de modus Afdwingen.
Modes	Hiermee geeft u de uitvoeringsmodus. In de controlemodus fungeert het systeem alsof het het toegangsbeheerbeleid afdwingt, inclusief het verzenden van toegangsontkenningsvermeldingen in de logboeken, maar het weigert geen aanvragen voor hosteindpunten. In de modus Afdwingen dwingt het systeem het toegangsbeheer af en is het de aanbevolen bewerkingsmodus.
OperatingSystemType	Hiermee haalt u het type besturingssysteem op.
OSProfile	Hiermee geeft u de besturingssysteeminstellingen voor de virtuele machine. Sommige instellingen kunnen niet worden gewijzigd zodra de VIRTUELE machine is ingericht.
PassNames
PatchSettings	Hiermee geeft u instellingen met betrekking tot VM-gastpatching in Windows.
ProtocolTypes	Hiermee geeft u het protocol van WinRM-listener. Mogelijke waarden zijn: http,https.
ProxyAgentSettings	Hiermee geeft u ProxyAgent-instellingen op voor de virtuele-machine of virtuele-machineschaalset. Minimale API-versie: 2023-09-01.
RestorePoint	Details van het punt herstellen.
RestorePointCollection	Maak of werk de parameters voor het verzamelen van punten herstellen.
RestorePointCollectionSourceProperties	De eigenschappen van de bronresource waaruit deze verzameling herstelpunten is gemaakt.
RestorePointEncryption	Versleuteling-at-rest-instellingen voor schijfherstelpunt. Het is een optionele eigenschap die kan worden opgegeven in de invoer tijdens het maken van een herstelpunt.
RestorePointEncryptionType	Het type sleutel dat wordt gebruikt voor het versleutelen van de gegevens van het schijfherstelpunt.
RestorePointInstanceView	De instantieweergave van een herstelpunt.
RestorePointSourceMetadata	Beschrijft de eigenschappen van de virtuele machine waarvoor het herstelpunt is gemaakt. De opgegeven eigenschappen zijn een subset en de momentopname van de algemene eigenschappen van de virtuele machine die zijn vastgelegd op het moment dat het herstelpunt wordt gemaakt.
RestorePointSourceVMDataDisk	Beschrijft een gegevensschijf.
RestorePointSourceVMOSDisk	Beschrijft een schijf van het besturingssysteem.
RestorePointSourceVMStorageProfile	Beschrijft het opslagprofiel.
SecurityEncryptionTypes	Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.
SecurityProfile	Hiermee geeft u de beveiligingsprofielinstellingen voor de virtuele machine of virtuele-machineschaalset op.
SecurityTypes	Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. Het standaardgedrag is: UefiSettings wordt niet ingeschakeld, tenzij deze eigenschap is ingesteld.
SettingNames	Hiermee geeft u de naam op van de instelling waarop de inhoud van toepassing is. Mogelijke waarden zijn: FirstLogonCommands en AutoLogon.
SnapshotAccessState	De status van snapshot die de beschikbaarheid van toegang tot de snapshot bepaalt.
SshConfiguration	SSH-configuratie voor op Linux gebaseerde VM's die worden uitgevoerd in Azure
SshPublicKey	Bevat informatie over de openbare SSH-certificaatsleutel en het pad op de Virtuele Linux-machine waarop de openbare sleutel wordt geplaatst.
StatusLevelTypes	De niveaucode.
StorageAccountTypes	Hiermee geeft u het type opslagaccount voor de beheerde schijf. Het opslagaccounttype beheerde besturingssysteemschijf kan alleen worden ingesteld wanneer u de schaalset maakt. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven. Het kan niet worden gebruikt met besturingssysteemschijf. Standard_LRS maakt gebruik van Standard HDD. StandardSSD_LRS maakt gebruik van Standard SSD. Premium_LRS maakt gebruik van Premium SSD. UltraSSD_LRS maakt gebruik van Ultra disk. Premium_ZRS maakt gebruik van premium SSD-zone-redundante opslag. StandardSSD_ZRS maakt gebruik van zone-redundante opslag met Standard SSD. Raadpleeg voor meer informatie over schijven die worden ondersteund voor Virtuele Windows-machines https://docs.microsoft.com/azure/virtual-machines/windows/disks-types en raadpleeg voor Virtuele Linux-machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
SubResource
systemData	Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.
UefiSettings	Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. Minimale API-versie: 2020-12-01.
VaultCertificate	Beschrijft één certificaatverwijzing in een Sleutelkluis en waar het certificaat zich op de virtuele machine moet bevinden.
VaultSecretGroup	Beschrijft een set certificaten die zich allemaal in dezelfde Key Vault bevinden.
VirtualMachineSizeTypes	Hiermee geeft u de grootte van de virtuele machine. Het enum-gegevenstype is momenteel afgeschaft en wordt op 23 december 2023 verwijderd. De aanbevolen manier om de lijst met beschikbare grootten op te halen, is met behulp van deze API's: Alle beschikbare grootten van virtuele machines in een beschikbaarheidsset weergeven, Alle beschikbare grootten van virtuele machines in een regio weergeven, Alle beschikbare grootten van virtuele machines weergeven voor het wijzigen van de grootte van. Zie Grootten voor virtuele machinesvoor meer informatie over de grootte van virtuele machines. De beschikbare VM-grootten zijn afhankelijk van de regio en beschikbaarheidsset.
VMDiskSecurityProfile	Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.
VMSizeProperties	Hiermee geeft u de instellingen voor de eigenschap VM-grootte op de virtuele machine.
WindowsConfiguration	Hiermee geeft u windows-besturingssysteeminstellingen op de virtuele machine.
WindowsPatchAssessmentMode	Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine. Mogelijke waarden zijn: ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine. AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.
WindowsVMGuestPatchAutomaticByPlatformSettings	Hiermee geeft u aanvullende instellingen op die moeten worden toegepast wanneer de patchmodus AutomaticByPlatform is geselecteerd in de Windows-patchinstellingen.
WindowsVMGuestPatchMode	Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel. Mogelijke waarden zijn: Handmatig: u beheert de toepassing van patches op een virtuele machine. U doet dit door patches handmatig toe te passen in de VIRTUELE machine. In deze modus worden automatische updates uitgeschakeld; de eigenschap WindowsConfiguration.enableAutomaticUpdates moet onwaar zijn AutomaticByOS : de virtuele machine wordt automatisch bijgewerkt door het besturingssysteem. De eigenschap WindowsConfiguration.enableAutomaticUpdates moet waar zijn. AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschappen provisionVMAgent en WindowsConfiguration.enableAutomaticUpdates moeten waar zijn
WinRMConfiguration	Hierin wordt de configuratie van Windows Remote Management van de VM beschreven
WinRMListener	Beschrijft protocol en vingerafdruk van Windows Remote Management-listener

AdditionalUnattendContent

Object

Hiermee geeft u aanvullende XML-opgemaakte informatie op die kan worden opgenomen in het Unattend.xml-bestand, dat wordt gebruikt door Windows Setup. De inhoud wordt gedefinieerd door de naam van de instelling, de onderdeelnaam en de pass waarin de inhoud wordt toegepast.

Name	Type	Description
componentName	ComponentNames	De naam van het onderdeel. Momenteel is de enige toegestane waarde Microsoft-Windows-Shell-Setup.
content	string	Hiermee geeft u de xml-opgemaakte inhoud op die wordt toegevoegd aan het unattend.xml-bestand voor het opgegeven pad en het opgegeven onderdeel. De XML moet kleiner zijn dan 4 kB en moet het hoofdelement bevatten voor de instelling of functie die wordt ingevoegd.
passName	PassNames	De wachtwoordnaam. Momenteel is de enige toegestane waarde OobeSystem.
settingName	SettingNames	Hiermee geeft u de naam op van de instelling waarop de inhoud van toepassing is. Mogelijke waarden zijn: FirstLogonCommands en AutoLogon.

ApiEntityReference

Object

De API-entiteitsreferentie.

Name	Type	Description
id	string	De ARM-resource-id in de vorm van /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Object

Api-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	Details van de Api-fout
innererror	InnerError	De innerlijke fout van de Api
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

Object

Api-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

BootDiagnostics

Object

Diagnostische gegevens over opstarten is een functie voor foutopsporing waarmee u console-uitvoer en schermopname kunt bekijken om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.

Name	Type	Description
enabled	boolean	Of diagnostische gegevens over opstarten moeten worden ingeschakeld op de virtuele machine.
storageUri	string	Uri van het opslagaccount dat moet worden gebruikt voor het plaatsen van de console-uitvoer en schermopname. Als storageUri niet is opgegeven tijdens het inschakelen van diagnostische gegevens over opstarten, wordt beheerde opslag gebruikt.

CachingTypes

Opsomming

Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: Geen,Alleen-lezen,Lezen'. De standaardwaarden zijn: Geen voor standaardopslag. ReadOnly voor Premium opslag

Waarde	Description
None
ReadOnly
ReadWrite

CloudError

Object

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	Api-fout.

ComponentNames

Opsomming

Waarde	Description
Microsoft-Windows-Shell-Setup

ConsistencyModeTypes

Opsomming

ConsistencyMode van het RestorePoint. Kan worden opgegeven in de invoer tijdens het maken van een herstelpunt. Voorlopig wordt alleen CrashConsistent geaccepteerd als een geldige invoer. Raadpleeg https://aka.ms/RestorePoints voor meer informatie.

Waarde	Description
CrashConsistent
FileSystemConsistent
ApplicationConsistent

createdByType

Opsomming

Het type identiteit waarmee de resource is gemaakt.

Waarde	Description
User
Application
ManagedIdentity
Key

DiagnosticsProfile

Object

Hiermee geeft u de status van diagnostische instellingen voor opstarten. Minimale API-versie: 2015-06-15.

Name	Type	Description
bootDiagnostics	BootDiagnostics	Diagnostische gegevens over opstarten is een functie voor foutopsporing waarmee u console-uitvoer en schermopname kunt bekijken om de VM-status te diagnosticeren. OPMERKING: als storageUri wordt opgegeven, moet u ervoor zorgen dat het opslagaccount zich in dezelfde regio en hetzelfde abonnement bevindt als de virtuele machine. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.

DiskControllerTypes

Opsomming

Hiermee geeft u het type schijfcontroller geconfigureerd voor de VIRTUELE machine en VirtualMachineScaleSet. Deze eigenschap wordt alleen ondersteund voor virtuele machines waarvan de besturingssysteemschijf en de VM-sku ondersteuning biedt voor generatie 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), controleert u de HyperVGenerations-functie die wordt geretourneerd als onderdeel van de SKU-mogelijkheden van de VM in het antwoord van de API voor Microsoft.Compute SKU's voor de regio bevat V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Raadpleeg https://aka.ms/azure-diskcontrollertypesvoor meer informatie over ondersteunde schijfcontrollertypen.

Waarde	Description
SCSI
NVMe

DiskEncryptionSetParameters

Object

Beschrijft de parameter van de resource-id van de door de klant beheerde schijfversleutelingsset die kan worden opgegeven voor schijf. Opmerking: de resource-id van de schijfversleutelingsset kan alleen worden opgegeven voor beheerde schijven. Raadpleeg https://aka.ms/mdssewithcmkoverview voor meer informatie.

Name	Type	Description
id	string	Resource-id

DiskEncryptionSettings

Object

Beschrijft een versleutelingsinstelling voor een schijf

Name	Type	Description
diskEncryptionKey	KeyVaultSecretReference	Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.
enabled	boolean	Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine.
keyEncryptionKey	KeyVaultKeyReference	Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.

DiskRestorePointAttributes

Object

Details van het schijfherstelpunt.

Name	Type	Description
encryption	RestorePointEncryption	Versleuteling-at-rest-instellingen voor schijfherstelpunt. Het is een optionele eigenschap die kan worden opgegeven in de invoer tijdens het maken van een herstelpunt.
id	string	Resource-id
sourceDiskRestorePoint	ApiEntityReference	Resource-id van het herstelpunt van de bronschijf.

DiskRestorePointInstanceView

Object

De instantieweergave van een schijfherstelpunt.

Name	Type	Description
id	string	Id van het schijfherstelpunt
replicationStatus	DiskRestorePointReplicationStatus	De informatie over de replicatiestatus van het schijfherstelpunt.
snapshotAccessState	SnapshotAccessState	De status van snapshot die de beschikbaarheid van toegang tot de snapshot bepaalt.

DiskRestorePointReplicationStatus

Object

De instantieweergave van een schijfherstelpunt.

Name	Type	Description
completionPercent	integer (int32)	Voltooiingspercentage replicatie.
status	InstanceViewStatus	De informatie over de resourcestatus.

EncryptionIdentity

Object

Hiermee geeft u de beheerde identiteit op die door ADE wordt gebruikt om toegangstoken op te halen voor sleutelkluisbewerkingen.

Name	Type	Description
userAssignedIdentityResourceId	string	Hiermee geeft u de ARM-resource-id op van een van de gebruikersidentiteiten die zijn gekoppeld aan de virtuele machine.

HardwareProfile

Object

Hiermee geeft u de hardware-instellingen voor de virtuele machine.

Name	Type	Description
vmSize	VirtualMachineSizeTypes	Hiermee geeft u de grootte van de virtuele machine. Het enum-gegevenstype is momenteel afgeschaft en wordt op 23 december 2023 verwijderd. De aanbevolen manier om de lijst met beschikbare grootten op te halen, is met behulp van deze API's: Alle beschikbare grootten van virtuele machines in een beschikbaarheidsset weergeven, Alle beschikbare grootten van virtuele machines in een regio weergeven, Alle beschikbare grootten van virtuele machines weergeven voor het wijzigen van de grootte van. Zie Grootten voor virtuele machinesvoor meer informatie over de grootte van virtuele machines. De beschikbare VM-grootten zijn afhankelijk van de regio en beschikbaarheidsset.
vmSizeProperties	VMSizeProperties	Hiermee geeft u de eigenschappen voor het aanpassen van de grootte van de virtuele machine. Minimale API-versie: 2021-07-01. Deze functie bevindt zich nog steeds in de preview-modus en wordt niet ondersteund voor VirtualMachineScaleSet. Volg de instructies in VM-aanpassing voor meer informatie.

HostEndpointSettings

Object

Hiermee geeft u bepaalde instellingen voor hosteindpunten op.

Name	Type	Description
inVMAccessControlProfileReferenceId	string	Hiermee geeft u de resource-id InVMAccessControlProfileVersion op in de indeling /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/inVMAccessControlProfiles/{profile}/versions/{version}
mode	Modes	Hiermee geeft u de uitvoeringsmodus. In de controlemodus fungeert het systeem alsof het het toegangsbeheerbeleid afdwingt, inclusief het verzenden van toegangsontkenningsvermeldingen in de logboeken, maar het weigert geen aanvragen voor hosteindpunten. In de modus Afdwingen dwingt het systeem het toegangsbeheer af en is het de aanbevolen bewerkingsmodus.

HyperVGenerationTypes

Opsomming

Hiermee geeft u het HyperVGeneration-type op

Waarde	Description
V1
V2

InnerError

Object

Interne foutdetails.

Name	Type	Description
errordetail	string	De interne foutmelding of uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.

InstanceViewStatus

Object

Status van exemplaarweergave.

Name	Type	Description
code	string	De statuscode.
displayStatus	string	Het korte lokaliseerbare label voor de status.
level	StatusLevelTypes	De niveaucode.
message	string	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.
time	string (date-time)	Het tijdstip van de status.

KeyVaultKeyReference

Object

Beschrijft een verwijzing naar Key Vault Key

Name	Type	Description
keyUrl	string	De URL die verwijst naar een sleutelversleutelingssleutel in Key Vault.
sourceVault	SubResource	De relatieve URL van de sleutelkluis die de sleutel bevat.

KeyVaultSecretReference

Object

Beschrijft een verwijzing naar Key Vault-geheim

Name	Type	Description
secretUrl	string	De URL die verwijst naar een geheim in een Sleutelkluis.
sourceVault	SubResource	De relatieve URL van de sleutelkluis die het geheim bevat.

LinuxConfiguration

Object

Hiermee geeft u de linux-besturingssysteeminstellingen op de virtuele machine. Zie Linux op Azure-Endorsed Distributiesvoor een lijst met ondersteunde Linux-distributies.

Name	Type	Description
disablePasswordAuthentication	boolean	Hiermee geeft u op of wachtwoordverificatie moet worden uitgeschakeld.
enableVMAgentPlatformUpdates	boolean	Geeft aan of VMAgent-platformupdates zijn ingeschakeld voor de virtuele Linux-machine. De standaardwaarde is onwaar.
patchSettings	LinuxPatchSettings	[Preview-functie] Hiermee geeft u instellingen met betrekking tot VM-gastpatching op Linux.
provisionVMAgent	boolean	Hiermee wordt aangegeven of de virtuele-machineagent moet worden ingericht op de virtuele machine. Wanneer deze eigenschap niet is opgegeven in de hoofdtekst van de aanvraag, is het standaardgedrag ingesteld op waar. Dit zorgt ervoor dat de VM-agent op de VIRTUELE machine is geïnstalleerd, zodat extensies later aan de VIRTUELE machine kunnen worden toegevoegd.
ssh	SshConfiguration	Hiermee geeft u de ssh-sleutelconfiguratie voor een Linux-besturingssysteem.

LinuxPatchAssessmentMode

Opsomming

Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine.

Mogelijke waarden zijn:

ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine.

AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.

Waarde	Description
ImageDefault
AutomaticByPlatform

LinuxPatchSettings

Object

Hiermee geeft u instellingen met betrekking tot VM-gastpatching op Linux.

Name	Type	Description
assessmentMode	LinuxPatchAssessmentMode	Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine. Mogelijke waarden zijn: ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine. AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Hiermee geeft u aanvullende instellingen voor patchmodus AutomaticByPlatform in VM-gastpatching op Linux.
patchMode	LinuxVMGuestPatchMode	Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel. Mogelijke waarden zijn: ImageDefault : de standaardpatchingconfiguratie van de virtuele machine wordt gebruikt. AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschap provisionVMAgent moet waar zijn

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Opsomming

Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.

Waarde	Description
Unknown
IfRequired
Never
Always

LinuxVMGuestPatchAutomaticByPlatformSettings

Object

Hiermee geeft u aanvullende instellingen op die moeten worden toegepast wanneer de patchmodus AutomaticByPlatform is geselecteerd in de Instellingen voor Linux-patches.

Name	Type	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Stelt de klant in staat patches te plannen zonder onbedoelde upgrades
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.

LinuxVMGuestPatchMode

Opsomming

Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel.

Mogelijke waarden zijn:

ImageDefault : de standaardpatchingconfiguratie van de virtuele machine wordt gebruikt.

AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschap provisionVMAgent moet waar zijn

Waarde	Description
ImageDefault
AutomaticByPlatform

ManagedDiskParameters

Object

De parameters van een beheerde schijf.

Name	Type	Description
diskEncryptionSet	DiskEncryptionSetParameters	Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op.
id	string	Resource-id
securityProfile	VMDiskSecurityProfile	Hiermee geeft u het beveiligingsprofiel voor de beheerde schijf.
storageAccountType	StorageAccountTypes	Hiermee geeft u het type opslagaccount voor de beheerde schijf. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven, deze kan niet worden gebruikt met besturingssysteemschijf.

Mode

Opsomming

Hiermee geeft u de modus op waarop ProxyAgent wordt uitgevoerd als de functie is ingeschakeld. ProxyAgent begint met controleren of bewaken, maar dwingt geen toegangsbeheer af over aanvragen voor hosteindpunten in de controlemodus, terwijl in de modus Afdwingen het toegangsbeheer wordt afgedwongen. De standaardwaarde is de modus Afdwingen.

Waarde	Description
Audit
Enforce

Modes

Opsomming

Hiermee geeft u de uitvoeringsmodus. In de controlemodus fungeert het systeem alsof het het toegangsbeheerbeleid afdwingt, inclusief het verzenden van toegangsontkenningsvermeldingen in de logboeken, maar het weigert geen aanvragen voor hosteindpunten. In de modus Afdwingen dwingt het systeem het toegangsbeheer af en is het de aanbevolen bewerkingsmodus.

Waarde	Description
Audit
Enforce
Disabled

OperatingSystemType

Opsomming

Hiermee haalt u het type besturingssysteem op.

Waarde	Description
Windows
Linux

OSProfile

Object

Hiermee geeft u de besturingssysteeminstellingen voor de virtuele machine. Sommige instellingen kunnen niet worden gewijzigd zodra de VIRTUELE machine is ingericht.

Name	Type	Description
adminPassword	string (password)	Hiermee geeft u het wachtwoord van het beheerdersaccount. Minimale lengte (Windows): 8 tekens Minimale lengte (Linux): 6 tekens Maximale lengte (Windows): 123 tekens Maximale lengte (Linux): 72 tekens Complexiteitsvereisten: aan 3 van de 4 onderstaande voorwaarden moet worden voldaan Heeft lagere tekens Bevat bovenliggende tekens Heeft een cijfer Heeft een speciaal teken (Regex-overeenkomst [\W_]) Niet-toegestane waarden: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Wachtwoord!", "Wachtwoord1", "Wachtwoord22", "iloveyou!" Zie De extern bureaublad-service of het aanmeldingswachtwoord opnieuw instellen in een Windows-VM voor het opnieuw instellen van het wachtwoord. Zie Gebruikers, SSH beheren en schijven controleren of herstellen op virtuele Azure Linux-machines met behulp van de VMAccess-extensie voor het opnieuw instellen van het hoofdwachtwoord
adminUsername	string	Hiermee geeft u de naam van het beheerdersaccount. Deze eigenschap kan niet worden bijgewerkt nadat de virtuele machine is gemaakt. beperking voor alleen Windows: kan niet eindigen op '.' niet-toegestane waarden: 'administrator', 'admin', 'user', 'user1', 'test', 'user2', 'test1', 'user3', 'admin1', "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". Minimale lengte (Linux): 1 teken Maximale lengte (Linux): 64 tekens Maximale lengte (Windows): 20 tekens.
allowExtensionOperations	boolean	Hiermee geeft u op of uitbreidingsbewerkingen moeten worden toegestaan op de virtuele machine. Dit kan alleen worden ingesteld op False wanneer er geen extensies aanwezig zijn op de virtuele machine.
computerName	string	Hiermee geeft u de naam van het host-besturingssysteem van de virtuele machine. Deze naam kan niet worden bijgewerkt nadat de virtuele machine is gemaakt. Maximale lengte (Windows): 15 tekens. Maximale lengte (Linux): 64 tekens. Zie implementatierichtlijnen voor Azure-infrastructuurservicesvoor naamconventies en -beperkingen.
customData	string	Hiermee geeft u een met base 64 gecodeerde tekenreeks van aangepaste gegevens op. De met base 64 gecodeerde tekenreeks wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes. Opmerking: geef geen geheimen of wachtwoorden door in de eigenschap customData. Deze eigenschap kan niet worden bijgewerkt nadat de virtuele machine is gemaakt. De eigenschap 'customData' wordt doorgegeven aan de virtuele machine die als bestand moet worden opgeslagen. Zie Aangepaste gegevens op Virtuele Azure-machinesvoor meer informatie. Zie Cloud-init gebruiken om een Virtuele Linux-machine aan te passen tijdens het maken.
linuxConfiguration	LinuxConfiguration	Hiermee geeft u de linux-besturingssysteeminstellingen op de virtuele machine. Zie Linux op Azure-Endorsed Distributiesvoor een lijst met ondersteunde Linux-distributies.
requireGuestProvisionSignal	boolean	Optionele eigenschap die moet worden ingesteld op Waar of weggelaten.
secrets	VaultSecretGroup[]	Hiermee geeft u een set certificaten op die op de virtuele machine moeten worden geïnstalleerd. Als u certificaten op een virtuele machine wilt installeren, wordt u aangeraden de extensie van de virtuele Azure Key Vault-machine voor Linux- of de virtuele Machine-extensie van Azure Key Vault voor Windowste gebruiken.
windowsConfiguration	WindowsConfiguration	Hiermee geeft u windows-besturingssysteeminstellingen op de virtuele machine.

PassNames

Opsomming

Waarde	Description
OobeSystem

PatchSettings

Object

Hiermee geeft u instellingen met betrekking tot VM-gastpatching in Windows.

Name	Type	Description
assessmentMode	WindowsPatchAssessmentMode	Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine. Mogelijke waarden zijn: ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine. AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Hiermee geeft u aanvullende instellingen voor patchmodus AutomaticByPlatform in VM-gastpatching in Windows.
enableHotpatching	boolean	Hiermee kunnen klanten hun Virtuele Azure-machines patchen zonder dat ze opnieuw hoeven op te starten. Voor enableHotpatching moet de 'provisionVMAgent' worden ingesteld op true en moet patchMode worden ingesteld op 'AutomaticByPlatform'.
patchMode	WindowsVMGuestPatchMode	Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel. Mogelijke waarden zijn: Handmatig: u beheert de toepassing van patches op een virtuele machine. U doet dit door patches handmatig toe te passen in de VIRTUELE machine. In deze modus worden automatische updates uitgeschakeld; de eigenschap WindowsConfiguration.enableAutomaticUpdates moet onwaar zijn AutomaticByOS : de virtuele machine wordt automatisch bijgewerkt door het besturingssysteem. De eigenschap WindowsConfiguration.enableAutomaticUpdates moet waar zijn. AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschappen provisionVMAgent en WindowsConfiguration.enableAutomaticUpdates moeten waar zijn

ProtocolTypes

Opsomming

Hiermee geeft u het protocol van WinRM-listener. Mogelijke waarden zijn: http,https.

Waarde	Description
Http
Https

ProxyAgentSettings

Object

Hiermee geeft u ProxyAgent-instellingen op voor de virtuele-machine of virtuele-machineschaalset. Minimale API-versie: 2023-09-01.

Name	Type	Description
addProxyAgentExtension	boolean	Geef op of de ProxyAgent-extensie impliciet moet worden geïnstalleerd. Deze optie is momenteel alleen van toepassing op Linux OS.
enabled	boolean	Hiermee geeft u op of de functie ProxyAgent moet worden ingeschakeld op de virtuele machine of virtuele-machineschaalset.
imds	HostEndpointSettings	Hiermee geeft u de IMDS-eindpuntinstellingen op tijdens het maken van de virtuele machine of virtuele-machineschaalset. Minimale API-versie: 2024-03-01.
keyIncarnationId	integer (int32)	Verhoog de waarde van deze eigenschap zodat gebruikers de sleutel die wordt gebruikt voor het beveiligen van het communicatiekanaal tussen gast en host opnieuw kunnen instellen.
mode	Mode	Hiermee geeft u de modus op waarop ProxyAgent wordt uitgevoerd. Waarschuwing: deze eigenschap is afgeschaft. Geef de modus op onder een bepaalde instelling voor hostendpoint.
wireServer	HostEndpointSettings	Hiermee geeft u de instellingen voor wire server-eindpunten op tijdens het maken van de virtuele machine of virtuele-machineschaalset. Minimale API-versie: 2024-03-01.

RestorePoint

Object

Details van het punt herstellen.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	De naam van de resource
properties.consistencyMode	ConsistencyModeTypes	ConsistencyMode van het RestorePoint. Kan worden opgegeven in de invoer tijdens het maken van een herstelpunt. Voorlopig wordt alleen CrashConsistent geaccepteerd als een geldige invoer. Raadpleeg https://aka.ms/RestorePoints voor meer informatie.
properties.excludeDisks	ApiEntityReference[]	Lijst met schijfresource-id's die de klant wil uitsluiten van het herstelpunt. Als er geen schijven zijn opgegeven, worden alle schijven opgenomen.
properties.instanceView	RestorePointInstanceView	De weergave van het herstelpunt.
properties.instantAccessDurationMinutes	integer (int32)	Deze eigenschap bepaalt de tijd in minuten dat de momentopname wordt bewaard als directe toegang voor het herstellen van Premium SSD v2 of Ultra-schijf met snelle herstelprestaties in dit herstelpunt.
properties.provisioningState	string	Hiermee haalt u de inrichtingsstatus van het herstelpunt op.
properties.sourceMetadata	RestorePointSourceMetadata	Hiermee haalt u de details op van de virtuele machine die is vastgelegd op het moment dat het herstelpunt is gemaakt.
properties.sourceRestorePoint	ApiEntityReference	Resource-id van het bronherstelpunt waaruit een kopie moet worden gemaakt.
properties.timeCreated	string (date-time)	Hiermee haalt u de aanmaaktijd van het herstelpunt op.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

RestorePointCollection

Object

Maak of werk de parameters voor het verzamelen van punten herstellen.

Name	Type	Description
id	string	Volledig gekwalificeerde resource-id voor de resource. Vb.: - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
location	string	De geografische locatie waar de resource zich bevindt
name	string	De naam van de resource
properties.instantAccess	boolean	Deze eigenschap bepaalt of momentopname met directe toegang is ingeschakeld voor herstelpunten die zijn gemaakt onder deze verzameling herstelpunten voor Premium SSD v2 of Ultra-schijf. Snapshot met directe toegang voor Premium SSD v2 of Ultra-schijf is onmiddellijk beschikbaar voor het herstellen van de schijf met snelle herstelprestaties.
properties.provisioningState	string	De inrichtingsstatus van de verzameling herstelpunten.
properties.restorePointCollectionId	string	De unieke id van de verzameling herstelpunten.
properties.restorePoints	RestorePoint[]	Een lijst met alle herstelpunten die onder deze verzameling herstelpunten zijn gemaakt.
properties.source	RestorePointCollectionSourceProperties	De eigenschappen van de bronresource waaruit deze verzameling herstelpunten is gemaakt.
systemData	systemData	Azure Resource Manager-metagegevens met createdBy- en modifiedBy-gegevens.
tags	object	Resourcetags.
type	string	Het type bron. Bijvoorbeeld 'Microsoft.Compute/virtualMachines' of 'Microsoft.Storage/storageAccounts'

RestorePointCollectionSourceProperties

Object

De eigenschappen van de bronresource waaruit deze verzameling herstelpunten is gemaakt.

Name	Type	Description
id	string	Resource-id van de bronresource die wordt gebruikt om deze herstelpuntverzameling te maken
location	string	Locatie van de bronresource die is gebruikt om deze verzameling herstelpunten te maken.

RestorePointEncryption

Object

Versleuteling-at-rest-instellingen voor schijfherstelpunt. Het is een optionele eigenschap die kan worden opgegeven in de invoer tijdens het maken van een herstelpunt.

Name	Type	Description
diskEncryptionSet	DiskEncryptionSetParameters	Beschrijft de parameter van de resource-id van de door de klant beheerde schijfversleutelingsset die kan worden opgegeven voor schijf. Opmerking: de resource-id van de schijfversleutelingsset kan alleen worden opgegeven voor beheerde schijven. Raadpleeg https://aka.ms/mdssewithcmkoverview voor meer informatie.
type	RestorePointEncryptionType	Het type sleutel dat wordt gebruikt voor het versleutelen van de gegevens van het schijfherstelpunt.

RestorePointEncryptionType

Opsomming

Het type sleutel dat wordt gebruikt voor het versleutelen van de gegevens van het schijfherstelpunt.

Waarde	Description
EncryptionAtRestWithPlatformKey	Schijfherstelpunt wordt in rust versleuteld met een door het platform beheerde sleutel.
EncryptionAtRestWithCustomerKey	Schijfherstelpunt wordt in rust versleuteld met een door de klant beheerde sleutel die door een klant kan worden gewijzigd en ingetrokken.
EncryptionAtRestWithPlatformAndCustomerKeys	Disk Restore Point is in rust versleuteld met 2 versleutelingslagen. Een van de sleutels is Customer managed en de andere key is Platform managed.

RestorePointInstanceView

Object

De instantieweergave van een herstelpunt.

Name	Type	Description
diskRestorePoints	DiskRestorePointInstanceView[]	De informatie over de schijfherstelpunten.
statuses	InstanceViewStatus[]	De informatie over de resourcestatus.

RestorePointSourceMetadata

Object

Beschrijft de eigenschappen van de virtuele machine waarvoor het herstelpunt is gemaakt. De opgegeven eigenschappen zijn een subset en de momentopname van de algemene eigenschappen van de virtuele machine die zijn vastgelegd op het moment dat het herstelpunt wordt gemaakt.

Name	Type	Description
diagnosticsProfile	DiagnosticsProfile	Hiermee haalt u het diagnostische profiel op.
hardwareProfile	HardwareProfile	Hiermee haalt u het hardwareprofiel op.
hyperVGeneration	HyperVGenerationTypes	HyperVGeneratie van de bron-VM waarvoor het herstelpunt is vastgelegd.
licenseType	string	Hiermee haalt u het licentietype op, dat is voor het scenario voor het meenemen van uw eigen licentie.
location	string	Locatie van de VM van waaruit het herstelpunt is gemaakt.
osProfile	OSProfile	Hiermee haalt u het besturingssysteemprofiel op.
securityProfile	SecurityProfile	Hiermee haalt u het beveiligingsprofiel op.
storageProfile	RestorePointSourceVMStorageProfile	Hiermee haalt u het opslagprofiel op.
userData	string	Gebruikersgegevens die zijn gekoppeld aan de bron-VM waarvoor het herstelpunt is vastgelegd, wat een met basis 64 gecodeerde waarde is.
vmId	string	Hiermee haalt u de unieke id van de virtuele machine op.

RestorePointSourceVMDataDisk

Object

Beschrijft een gegevensschijf.

Name	Type	Description
caching	CachingTypes	Haalt het caching-type op.
diskRestorePoint	DiskRestorePointAttributes	Bevat eigenschappen van schijfherstelpunt.
diskSizeGB	integer (int32)	Hiermee haalt u de initiële schijfgrootte op in GB voor lege gegevensschijven en de nieuwe gewenste grootte voor bestaande besturingssysteem- en gegevensschijven.
lun	integer (int32)	Hiermee haalt u het logische eenheidsnummer op.
managedDisk	ManagedDiskParameters	Bevat de details van de beheerde schijf.
name	string	Hiermee haalt u de schijfnaam op.
writeAcceleratorEnabled	boolean	Geeft true aan als de schijf is ingeschakeld voor schrijfversneller.

RestorePointSourceVMOSDisk

Object

Beschrijft een schijf van het besturingssysteem.

Name	Type	Description
caching	CachingTypes	Haalt het caching-type op.
diskRestorePoint	DiskRestorePointAttributes	Bevat eigenschappen van schijfherstelpunt.
diskSizeGB	integer (int32)	Hiermee haalt u de schijfgrootte op in GB.
encryptionSettings	DiskEncryptionSettings	Hiermee haalt u de instellingen voor schijfversleuteling op.
managedDisk	ManagedDiskParameters	Hiermee haalt u de details van de beheerde schijf op
name	string	Hiermee haalt u de schijfnaam op.
osType	OperatingSystemType	Hiermee haalt u het type besturingssysteem op.
writeAcceleratorEnabled	boolean	Geeft true aan als de schijf is ingeschakeld voor schrijfversneller.

RestorePointSourceVMStorageProfile

Object

Beschrijft het opslagprofiel.

Name	Type	Description
dataDisks	RestorePointSourceVMDataDisk[]	Haalt de gegevensschijven op van de VIRTUELE machine die is vastgelegd op het moment dat het herstelpunt is gemaakt.
diskControllerType	DiskControllerTypes	Hiermee haalt u het type schijfcontroller op van de VM die is vastgelegd op het moment dat het herstelpunt wordt gemaakt.
osDisk	RestorePointSourceVMOSDisk	Hiermee haalt u de besturingssysteemschijf op van de virtuele machine die is vastgelegd op het moment dat het herstelpunt is gemaakt.

SecurityEncryptionTypes

Opsomming

Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.

Waarde	Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

SecurityProfile

Object

Hiermee geeft u de beveiligingsprofielinstellingen voor de virtuele machine of virtuele-machineschaalset op.

Name	Type	Description
encryptionAtHost	boolean	Deze eigenschap kan worden gebruikt door de gebruiker in de aanvraag om hostversleuteling voor de virtuele machine of virtuele-machineschaalset in of uit te schakelen. Hierdoor wordt de versleuteling ingeschakeld voor alle schijven, inclusief resource-/tijdelijke schijf op de host zelf. Het standaardgedrag is: De versleuteling op de host wordt uitgeschakeld, tenzij deze eigenschap is ingesteld op waar voor de resource.
encryptionIdentity	EncryptionIdentity	Hiermee geeft u de beheerde identiteit op die door ADE wordt gebruikt om toegangstoken op te halen voor sleutelkluisbewerkingen.
proxyAgentSettings	ProxyAgentSettings	Hiermee geeft u ProxyAgent-instellingen op tijdens het maken van de virtuele machine. Minimale API-versie: 2023-09-01.
securityType	SecurityTypes	Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. Het standaardgedrag is: UefiSettings wordt niet ingeschakeld, tenzij deze eigenschap is ingesteld.
uefiSettings	UefiSettings	Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. Minimale API-versie: 2020-12-01.

SecurityTypes

Opsomming

Hiermee geeft u het SecurityType van de virtuele machine. Deze moet worden ingesteld op een opgegeven waarde om UefiSettings in te schakelen. Het standaardgedrag is: UefiSettings wordt niet ingeschakeld, tenzij deze eigenschap is ingesteld.

Waarde	Description
TrustedLaunch
ConfidentialVM

SettingNames

Opsomming

Hiermee geeft u de naam op van de instelling waarop de inhoud van toepassing is. Mogelijke waarden zijn: FirstLogonCommands en AutoLogon.

Waarde	Description
AutoLogon
FirstLogonCommands

SnapshotAccessState

Opsomming

De status van snapshot die de beschikbaarheid van toegang tot de snapshot bepaalt.

Waarde	Description
Unknown	Standaardwaarde.
Pending	De momentopname kan niet worden gebruikt voor herstellen, kopiëren of downloaden naar offline.
Available	De momentopname kan worden gebruikt voor herstel, kopiëren naar een andere regio en downloaden naar offline.
InstantAccess	De snapshot kan worden gebruikt voor het herstellen van schijven met snelle prestaties, maar kan niet worden gekopieerd of gedownload.
AvailableWithInstantAccess	De snapshot kan worden gebruikt voor het herstellen van schijven met snelle prestaties, gekopieerd en gedownload.

SshConfiguration

Object

SSH-configuratie voor op Linux gebaseerde VM's die worden uitgevoerd in Azure

Name	Type	Description
publicKeys	SshPublicKey[]	De lijst met openbare SSH-sleutels die worden gebruikt voor verificatie met virtuele Linux-machines.

SshPublicKey

Object

Bevat informatie over de openbare SSH-certificaatsleutel en het pad op de Virtuele Linux-machine waarop de openbare sleutel wordt geplaatst.

Name	Type	Description
keyData	string	Het openbare SSH-sleutelcertificaat dat wordt gebruikt voor verificatie met de virtuele machine via ssh. De sleutel moet ten minste 2048-bits en in ssh-rsa-indeling zijn. Zie [SSH-sleutels maken in Linux en Mac voor Linux-VM's in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed). voor het maken van SSH-sleutels
path	string	Hiermee geeft u het volledige pad op de gemaakte VM waarin de openbare SSH-sleutel wordt opgeslagen. Als het bestand al bestaat, wordt de opgegeven sleutel toegevoegd aan het bestand. Voorbeeld: /home/user/.ssh/authorized_keys

StatusLevelTypes

Opsomming

De niveaucode.

Waarde	Description
Info
Warning
Error

StorageAccountTypes

Opsomming

Hiermee geeft u het type opslagaccount voor de beheerde schijf. Het opslagaccounttype beheerde besturingssysteemschijf kan alleen worden ingesteld wanneer u de schaalset maakt. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven. Het kan niet worden gebruikt met besturingssysteemschijf. Standard_LRS maakt gebruik van Standard HDD. StandardSSD_LRS maakt gebruik van Standard SSD. Premium_LRS maakt gebruik van Premium SSD. UltraSSD_LRS maakt gebruik van Ultra disk. Premium_ZRS maakt gebruik van premium SSD-zone-redundante opslag. StandardSSD_ZRS maakt gebruik van zone-redundante opslag met Standard SSD. Raadpleeg voor meer informatie over schijven die worden ondersteund voor Virtuele Windows-machines https://docs.microsoft.com/azure/virtual-machines/windows/disks-types en raadpleeg voor Virtuele Linux-machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Waarde	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

SubResource

Object

Name	Type	Description
id	string	Resource-id

systemData

Object

Metagegevens met betrekking tot het maken en de laatste wijziging van de resource.

Name	Type	Description
createdAt	string (date-time)	De tijdstempel van het maken van resources (UTC).
createdBy	string	De identiteit waarmee de resource is gemaakt.
createdByType	createdByType	Het type identiteit waarmee de resource is gemaakt.
lastModifiedAt	string (date-time)	De tijdstempel van de laatste wijziging van de resource (UTC)
lastModifiedBy	string	De identiteit die de resource voor het laatst heeft gewijzigd.
lastModifiedByType	createdByType	Het type identiteit dat de resource voor het laatst heeft gewijzigd.

UefiSettings

Object

Hiermee geeft u de beveiligingsinstellingen op, zoals beveiligd opstarten en vTPM die worden gebruikt tijdens het maken van de virtuele machine. Minimale API-versie: 2020-12-01.

Name	Type	Description
secureBootEnabled	boolean	Hiermee geeft u op of beveiligd opstarten moet worden ingeschakeld op de virtuele machine. Minimale API-versie: 2020-12-01.
vTpmEnabled	boolean	Hiermee geeft u op of vTPM moet worden ingeschakeld op de virtuele machine. Minimale API-versie: 2020-12-01.

VaultCertificate

Object

Beschrijft één certificaatverwijzing in een Sleutelkluis en waar het certificaat zich op de virtuele machine moet bevinden.

Name	Type	Description
certificateStore	string	Voor Virtuele Windows-machines geeft u het certificaatarchief op de virtuele machine waaraan het certificaat moet worden toegevoegd. Het opgegeven certificaatarchief bevindt zich impliciet in het LocalMachine-account. Voor Linux-VM's wordt het certificaatbestand onder de map /var/lib/waagent geplaatst, met de bestandsnaam <HoofdletterThumbprint>.crt voor het X509-certificaatbestand en <HoofdlettercaseThumbprint>.prv voor persoonlijke sleutel. Beide bestanden zijn .pem-indeling.
certificateUrl	string	Dit is de URL van een certificaat dat als geheim is geüpload naar Key Vault. Zie Een sleutel of geheim toevoegen aan de sleutelkluisvoor informatie over het toevoegen van een geheim aan de sleutelkluis. In dit geval moet uw certificaat de Base64-codering zijn van het volgende JSON-object dat is gecodeerd in UTF-8: { "data":"<Base64-gecodeerd-certificaat>", "dataType":"pfx", "password":"<pfx-file-password>" } Als u certificaten op een virtuele machine wilt installeren, wordt u aangeraden de extensie van de virtuele Azure Key Vault-machine voor Linux- of de virtuele Machine-extensie van Azure Key Vault voor Windowste gebruiken.

VaultSecretGroup

Object

Beschrijft een set certificaten die zich allemaal in dezelfde Key Vault bevinden.

Name	Type	Description
sourceVault	SubResource	De relatieve URL van de Sleutelkluis met alle certificaten in VaultCertificates.
vaultCertificates	VaultCertificate[]	De lijst met sleutelkluisverwijzingen in SourceVault die certificaten bevatten.

VirtualMachineSizeTypes

Opsomming

Hiermee geeft u de grootte van de virtuele machine. Het enum-gegevenstype is momenteel afgeschaft en wordt op 23 december 2023 verwijderd. De aanbevolen manier om de lijst met beschikbare grootten op te halen, is met behulp van deze API's: Alle beschikbare grootten van virtuele machines in een beschikbaarheidsset weergeven, Alle beschikbare grootten van virtuele machines in een regio weergeven, Alle beschikbare grootten van virtuele machines weergeven voor het wijzigen van de grootte van. Zie Grootten voor virtuele machinesvoor meer informatie over de grootte van virtuele machines. De beschikbare VM-grootten zijn afhankelijk van de regio en beschikbaarheidsset.

Waarde	Description
Basic_A0
Basic_A1
Basic_A2
Basic_A3
Basic_A4
Standard_A0
Standard_A1
Standard_A2
Standard_A3
Standard_A4
Standard_A5
Standard_A6
Standard_A7
Standard_A8
Standard_A9
Standard_A10
Standard_A11
Standard_A1_v2
Standard_A2_v2
Standard_A4_v2
Standard_A8_v2
Standard_A2m_v2
Standard_A4m_v2
Standard_A8m_v2
Standard_B1s
Standard_B1ms
Standard_B2s
Standard_B2ms
Standard_B4ms
Standard_B8ms
Standard_D1
Standard_D2
Standard_D3
Standard_D4
Standard_D11
Standard_D12
Standard_D13
Standard_D14
Standard_D1_v2
Standard_D2_v2
Standard_D3_v2
Standard_D4_v2
Standard_D5_v2
Standard_D2_v3
Standard_D4_v3
Standard_D8_v3
Standard_D16_v3
Standard_D32_v3
Standard_D64_v3
Standard_D2s_v3
Standard_D4s_v3
Standard_D8s_v3
Standard_D16s_v3
Standard_D32s_v3
Standard_D64s_v3
Standard_D11_v2
Standard_D12_v2
Standard_D13_v2
Standard_D14_v2
Standard_D15_v2
Standard_DS1
Standard_DS2
Standard_DS3
Standard_DS4
Standard_DS11
Standard_DS12
Standard_DS13
Standard_DS14
Standard_DS1_v2
Standard_DS2_v2
Standard_DS3_v2
Standard_DS4_v2
Standard_DS5_v2
Standard_DS11_v2
Standard_DS12_v2
Standard_DS13_v2
Standard_DS14_v2
Standard_DS15_v2
Standard_DS13-4_v2
Standard_DS13-2_v2
Standard_DS14-8_v2
Standard_DS14-4_v2
Standard_E2_v3
Standard_E4_v3
Standard_E8_v3
Standard_E16_v3
Standard_E32_v3
Standard_E64_v3
Standard_E2s_v3
Standard_E4s_v3
Standard_E8s_v3
Standard_E16s_v3
Standard_E32s_v3
Standard_E64s_v3
Standard_E32-16_v3
Standard_E32-8s_v3
Standard_E64-32s_v3
Standard_E64-16s_v3
Standard_F1
Standard_F2
Standard_F4
Standard_F8
Standard_F16
Standard_F1s
Standard_F2s
Standard_F4s
Standard_F8s
Standard_F16s
Standard_F2s_v2
Standard_F4s_v2
Standard_F8s_v2
Standard_F16s_v2
Standard_F32s_v2
Standard_F64s_v2
Standard_F72s_v2
Standard_G1
Standard_G2
Standard_G3
Standard_G4
Standard_G5
Standard_GS1
Standard_GS2
Standard_GS3
Standard_GS4
Standard_GS5
Standard_GS4-8
Standard_GS4-4
Standard_GS5-16
Standard_GS5-8
Standard_H8
Standard_H16
Standard_H8m
Standard_H16m
Standard_H16r
Standard_H16mr
Standard_L4s
Standard_L8s
Standard_L16s
Standard_L32s
Standard_M64s
Standard_M64ms
Standard_M128s
Standard_M128ms
Standard_M64-32ms
Standard_M64-16ms
Standard_M128-64ms
Standard_M128-32ms
Standard_NC6
Standard_NC12
Standard_NC24
Standard_NC24r
Standard_NC6s_v2
Standard_NC12s_v2
Standard_NC24s_v2
Standard_NC24rs_v2
Standard_NC6s_v3
Standard_NC12s_v3
Standard_NC24s_v3
Standard_NC24rs_v3
Standard_ND6s
Standard_ND12s
Standard_ND24s
Standard_ND24rs
Standard_NV6
Standard_NV12
Standard_NV24

VMDiskSecurityProfile

Object

Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.

Name	Type	Description
diskEncryptionSet	DiskEncryptionSetParameters	Hiermee geeft u de door de klant beheerde schijfversleutelingssetresource-id op voor de beheerde schijf die wordt gebruikt voor door de klant beheerde sleutel versleutelde ConfidentialVM-besturingssysteemschijf en VMGuest-blob.
securityEncryptionType	SecurityEncryptionTypes	Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.

VMSizeProperties

Object

Hiermee geeft u de instellingen voor de eigenschap VM-grootte op de virtuele machine.

Name	Type	Description
vCPUsAvailable	integer (int32)	Hiermee geeft u het aantal vCPU's dat beschikbaar is voor de virtuele machine. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, wordt het standaardgedrag ingesteld op de waarde van vCPU's die beschikbaar zijn voor die VM-grootte die beschikbaar is in api-antwoord van Alle beschikbare grootten van virtuele machines in een regio weergeven.
vCPUsPerCore	integer (int32)	Hiermee geeft u de verhouding tussen vCPU en fysieke kern. Wanneer deze eigenschap niet is opgegeven in de aanvraagbody, wordt het standaardgedrag ingesteld op de waarde van vCPUUsPerCore voor de VM-grootte die wordt weergegeven in api-antwoord van Alle beschikbare grootten van virtuele machines in een regio weergeven. Deze eigenschap instellen op 1 betekent ook dat hyperthreading is uitgeschakeld.

WindowsConfiguration

Object

Hiermee geeft u windows-besturingssysteeminstellingen op de virtuele machine.

Name	Type	Description
additionalUnattendContent	AdditionalUnattendContent[]	Hiermee geeft u aanvullende base-64 gecodeerde XML-geformatteerde informatie op die kan worden opgenomen in het Unattend.xml-bestand, dat wordt gebruikt door Windows Setup.
enableAutomaticUpdates	boolean	Hiermee wordt aangegeven of Automatische updates is ingeschakeld voor de virtuele Windows-machine. De standaardwaarde is waar. Voor virtuele-machineschaalsets kan deze eigenschap worden bijgewerkt en worden updates van kracht bij het opnieuw inrichten van het besturingssysteem.
enableVMAgentPlatformUpdates	boolean	Geeft aan of VMAgent-platformupdates zijn ingeschakeld voor de virtuele Windows-machine.
patchSettings	PatchSettings	[Preview-functie] Hiermee geeft u instellingen met betrekking tot VM-gastpatching in Windows.
provisionVMAgent	boolean	Hiermee wordt aangegeven of de virtuele-machineagent moet worden ingericht op de virtuele machine. Wanneer deze eigenschap niet is opgegeven in de hoofdtekst van de aanvraag, is deze standaard ingesteld op true. Dit zorgt ervoor dat de VM-agent op de VIRTUELE machine is geïnstalleerd, zodat extensies later aan de VIRTUELE machine kunnen worden toegevoegd.
timeZone	string	Hiermee geeft u de tijdzone van de virtuele machine. bijvoorbeeld "Pacific Standard Time". Mogelijke waarden kunnen worden TimeZoneInfo.Id waarde uit tijdzones die worden geretourneerd door TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Hiermee geeft u de listeners voor Extern beheer van Windows op. Hiermee schakelt u externe Windows PowerShell in.

WindowsPatchAssessmentMode

Opsomming

Hiermee geeft u de modus van vm-gastpatchevaluatie voor de virtuele IaaS-machine.

Mogelijke waarden zijn:

ImageDefault-: u bepaalt de timing van patchevaluaties op een virtuele machine.

AutomaticByPlatform - Het platform activeert periodieke patchevaluaties. De eigenschap provisionVMAgent moet waar zijn.

Waarde	Description
ImageDefault
AutomaticByPlatform

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Opsomming

Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.

Waarde	Description
Unknown
IfRequired
Never
Always

WindowsVMGuestPatchAutomaticByPlatformSettings

Object

Hiermee geeft u aanvullende instellingen op die moeten worden toegepast wanneer de patchmodus AutomaticByPlatform is geselecteerd in de Windows-patchinstellingen.

Name	Type	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	Stelt de klant in staat patches te plannen zonder onbedoelde upgrades
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Hiermee geeft u de instelling voor opnieuw opstarten voor alle installatiebewerkingen van de AutomaticByPlatform-patch.

WindowsVMGuestPatchMode

Opsomming

Hiermee geeft u de modus van VM-gastpatching naar virtuele IaaS-machine of virtuele machines die zijn gekoppeld aan virtuele-machineschaalset met OrchestrationMode als Flexibel.

Mogelijke waarden zijn:

Handmatig: u beheert de toepassing van patches op een virtuele machine. U doet dit door patches handmatig toe te passen in de VIRTUELE machine. In deze modus worden automatische updates uitgeschakeld; de eigenschap WindowsConfiguration.enableAutomaticUpdates moet onwaar zijn

AutomaticByOS : de virtuele machine wordt automatisch bijgewerkt door het besturingssysteem. De eigenschap WindowsConfiguration.enableAutomaticUpdates moet waar zijn.

AutomaticByPlatform : de virtuele machine wordt automatisch bijgewerkt door het platform. De eigenschappen provisionVMAgent en WindowsConfiguration.enableAutomaticUpdates moeten waar zijn

Waarde	Description
Manual
AutomaticByOS
AutomaticByPlatform

WinRMConfiguration

Object

Hierin wordt de configuratie van Windows Remote Management van de VM beschreven

Name	Type	Description
listeners	WinRMListener[]	De lijst met Windows Remote Management-listeners

WinRMListener

Object

Beschrijft protocol en vingerafdruk van Windows Remote Management-listener

Name	Type	Description
certificateUrl	string	Dit is de URL van een certificaat dat als geheim is geüpload naar Key Vault. Zie Een sleutel of geheim toevoegen aan de sleutelkluisvoor informatie over het toevoegen van een geheim aan de sleutelkluis. In dit geval moet uw certificaat de Base64-codering zijn van het volgende JSON-object dat is gecodeerd in UTF-8: { "data":"<Base64-gecodeerd-certificaat>", "dataType":"pfx", "password":"<pfx-file-password>" } Als u certificaten op een virtuele machine wilt installeren, wordt u aangeraden de extensie van de virtuele Azure Key Vault-machine voor Linux- of de virtuele Machine-extensie van Azure Key Vault voor Windowste gebruiken.
protocol	ProtocolTypes	Hiermee geeft u het protocol van WinRM-listener. Mogelijke waarden zijn: http,https.