Restore Point Collections - Create Or Update

Riferimento

Servizio:: Compute

Versione API:: 2024-07-01

Operazione per creare o aggiornare la raccolta di punti di ripristino. Per altri dettagli, vedere https://aka.ms/RestorePoints. Quando si aggiorna una raccolta di punti di ripristino, è possibile modificare solo i tag.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse.
restorePointCollectionName	path	True	string	Nome della raccolta di punti di ripristino.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
location	True	string	Percorso risorsa
properties.source		RestorePointCollectionSourceProperties	Proprietà della risorsa di origine da cui viene creata la raccolta di punti di ripristino.
tags		object	Tag delle risorse

Risposte

Nome	Tipo	Descrizione
200 OK	RestorePointCollection	OK
201 Created	RestorePointCollection	Creato
Other Status Codes	CloudError	Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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.

Esempio di richiesta

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

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


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/2024-07-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

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/2024-07-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

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-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

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

/**
 * 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/2024-07-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

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/2024-07-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

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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.

Esempio di richiesta

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

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


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/2024-07-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")),
            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

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": {
                "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/2024-07-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

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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-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{
			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{
	// 		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

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

/**
 * 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/2024-07-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 = {
    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

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/2024-07-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"),
    },
    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

Risposta di esempio

Codice di stato:: 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"
  }
}

Codice di stato:: 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"
    },
    "restorePointCollectionId": "638f052b-a7c2-450c-89e7-6a3b8f1d6a7c",
    "provisioningState": "Succeeded"
  }
}

Definizioni

Nome	Descrizione
AdditionalUnattendContent	Specifica informazioni aggiuntive in formato XML che possono essere incluse nel file Unattend.xml, utilizzato dal programma di installazione di Windows. Il contenuto viene definito impostando il nome, il nome del componente e il passaggio in cui viene applicato il contenuto.
ApiEntityReference	Informazioni di riferimento sulle entità API.
ApiError	Errore dell'API.
ApiErrorBase	Base degli errori api.
BootDiagnostics	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.
CachingTypes	Ottiene il tipo di memorizzazione nella cache.
CloudError	Risposta di errore dal servizio di calcolo.
ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
ConsistencyModeTypes	ConsistencyMode di RestorePoint. Può essere specificato nell'input durante la creazione di un punto di ripristino. Per il momento, solo CrashConsistent viene accettato come input valido. Per altri dettagli, vedere https://aka.ms/RestorePoints.
DiagnosticsProfile	Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.
DiskControllerTypes	Ottiene il tipo di controller del disco della macchina virtuale acquisita al momento della creazione del punto di ripristino.
DiskEncryptionSetParameters	Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Descrive le impostazioni di crittografia per un disco
DiskRestorePointAttributes	Dettagli del punto di ripristino del disco.
DiskRestorePointInstanceView	Visualizzazione dell'istanza di un punto di ripristino del disco.
DiskRestorePointReplicationStatus	Visualizzazione dell'istanza di un punto di ripristino del disco.
EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
HardwareProfile	Specifica le impostazioni hardware per la macchina virtuale.
HyperVGenerationTypes	HyperVGeneration della macchina virtuale di origine per cui viene acquisito il punto di ripristino.
InnerError	Dettagli dell'errore interno.
InstanceViewStatus	Stato di visualizzazione dell'istanza.
KeyVaultKeyReference	Descrive un riferimento alla chiave di Key Vault
KeyVaultSecretReference	Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi
LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
LinuxPatchSettings	Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch linux.
LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true
ManagedDiskParameters	Parametri di un disco gestito.
Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.
OperatingSystemType	Ottiene il tipo di sistema operativo.
OSProfile	Specifica le impostazioni del sistema operativo per la macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.
PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
PatchSettings	Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.
ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
RestorePoint	Dettagli del punto di ripristino.
RestorePointCollection	Creare o aggiornare i parametri della raccolta di punti di ripristino.
RestorePointCollectionSourceProperties	Proprietà della risorsa di origine da cui viene creata la raccolta di punti di ripristino.
RestorePointEncryption	Impostazioni di crittografia dei dati inattivi per il punto di ripristino del disco. Si tratta di una proprietà facoltativa che può essere specificata nell'input durante la creazione di un punto di ripristino.
RestorePointEncryptionType	Tipo di chiave utilizzata per crittografare i dati del punto di ripristino del disco.
RestorePointInstanceView	Visualizzazione dell'istanza di un punto di ripristino.
RestorePointSourceMetadata	Descrive le proprietà della macchina virtuale per cui è stato creato il punto di ripristino. Le proprietà fornite sono un subset e lo snapshot delle proprietà complessive della macchina virtuale acquisite al momento della creazione del punto di ripristino.
RestorePointSourceVMDataDisk	Descrive un disco dati.
RestorePointSourceVMOSDisk	Descrive un disco del sistema operativo.
RestorePointSourceVMStorageProfile	Descrive il profilo di archiviazione.
securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.
SecurityProfile	Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.
SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.
SshConfiguration	Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure
SshPublicKey	Contiene informazioni sulla chiave pubblica del certificato SSH e sul percorso nella macchina virtuale Linux in cui viene inserita la chiave pubblica.
StatusLevelTypes	Codice a livello.
StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.
SubResource
UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.
VaultCertificate	Descrive un singolo riferimento al certificato in un insieme di credenziali delle chiavi e dove risiede il certificato nella macchina virtuale.
VaultSecretGroup	Descrive un set di certificati che si trovano tutti nello stesso insieme di credenziali delle chiavi.
VirtualMachineSizeTypes	Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.
VMDiskSecurityProfile	Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.
VMSizeProperties	Specifica le impostazioni delle proprietà dimensioni macchina virtuale nella macchina virtuale.
WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.
WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.
WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch di Windows.
WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true
WinRMConfiguration	Descrive la configurazione di Gestione remota Windows della macchina virtuale
WinRMListener	Descrive il protocollo e l'identificazione personale del listener di Gestione remota Windows

AdditionalUnattendContent

Specifica informazioni aggiuntive in formato XML che possono essere incluse nel file Unattend.xml, utilizzato dal programma di installazione di Windows. Il contenuto viene definito impostando il nome, il nome del componente e il passaggio in cui viene applicato il contenuto.

Nome	Tipo	Descrizione
componentName	ComponentNames	Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.
content	string	Specifica il contenuto in formato XML aggiunto al file unattend.xml per il percorso e il componente specificati. Il codice XML deve essere minore di 4 KB e deve includere l'elemento radice per l'impostazione o la funzionalità da inserire.
passName	PassNames	Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.
settingName	SettingNames	Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

ApiEntityReference

Informazioni di riferimento sulle entità API.

Nome	Tipo	Descrizione
id	string	ID risorsa ARM sotto forma di /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Errore dell'API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore dell'API
innererror	InnerError	Errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Base degli errori api.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

BootDiagnostics

Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

Nome	Tipo	Descrizione
enabled	boolean	Indica se la diagnostica di avvio deve essere abilitata nella macchina virtuale.
storageUri	string	URI dell'account di archiviazione da usare per inserire l'output e lo screenshot della console. Se storageUri non viene specificato durante l'abilitazione della diagnostica di avvio, verrà usata l'archiviazione gestita.

CachingTypes

Ottiene il tipo di memorizzazione nella cache.

Nome	Tipo	Descrizione
None	string
ReadOnly	string
ReadWrite	string

CloudError

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore dell'API.

ComponentNames

Nome del componente. Attualmente, l'unico valore consentito è Microsoft-Windows-Shell-Setup.

Nome	Tipo	Descrizione
Microsoft-Windows-Shell-Setup	string

ConsistencyModeTypes

ConsistencyMode di RestorePoint. Può essere specificato nell'input durante la creazione di un punto di ripristino. Per il momento, solo CrashConsistent viene accettato come input valido. Per altri dettagli, vedere https://aka.ms/RestorePoints.

Nome	Tipo	Descrizione
ApplicationConsistent	string
CrashConsistent	string
FileSystemConsistent	string

DiagnosticsProfile

Specifica lo stato delle impostazioni di diagnostica di avvio. Versione minima api: 2015-06-15.

Nome	Tipo	Descrizione
bootDiagnostics	BootDiagnostics	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. NOTA: se si specifica storageUri, assicurarsi che l'account di archiviazione si trova nella stessa area e nella stessa sottoscrizione della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure consente anche di visualizzare uno screenshot della macchina virtuale dall'hypervisor.

DiskControllerTypes

Ottiene il tipo di controller del disco della macchina virtuale acquisita al momento della creazione del punto di ripristino.

Nome	Tipo	Descrizione
NVMe	string
SCSI	string

DiskEncryptionSetParameters

Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.

Nome	Tipo	Descrizione
id	string	ID risorsa

DiskEncryptionSettings

Descrive le impostazioni di crittografia per un disco

Nome	Tipo	Descrizione
diskEncryptionKey	KeyVaultSecretReference	Specifica il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica il percorso della chiave di crittografia della chiave in Key Vault.

DiskRestorePointAttributes

Dettagli del punto di ripristino del disco.

Nome	Tipo	Descrizione
encryption	RestorePointEncryption	Impostazioni di crittografia dei dati inattivi per il punto di ripristino del disco. Si tratta di una proprietà facoltativa che può essere specificata nell'input durante la creazione di un punto di ripristino.
id	string	ID risorsa
sourceDiskRestorePoint	ApiEntityReference	ID risorsa del punto di ripristino del disco di origine.

DiskRestorePointInstanceView

Visualizzazione dell'istanza di un punto di ripristino del disco.

Nome	Tipo	Descrizione
id	string	ID del punto di ripristino del disco.
replicationStatus	DiskRestorePointReplicationStatus	Informazioni sullo stato della replica del punto di ripristino del disco.

DiskRestorePointReplicationStatus

Visualizzazione dell'istanza di un punto di ripristino del disco.

Nome	Tipo	Descrizione
completionPercent	integer	Percentuale di completamento della replica.
status	InstanceViewStatus	Informazioni sullo stato della risorsa.

EncryptionIdentity

Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
userAssignedIdentityResourceId	string	Specifica l'ID risorsa ARM di una delle identità utente associate alla macchina virtuale.

HardwareProfile

Specifica le impostazioni hardware per la macchina virtuale.

Nome	Tipo	Descrizione
vmSize	VirtualMachineSizeTypes	Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.
vmSizeProperties	VMSizeProperties	Specifica le proprietà per la personalizzazione delle dimensioni della macchina virtuale. Versione minima api: 2021-07-01. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per altri dettagli, seguire le istruzioni riportate in di personalizzazione della macchina virtuale.

HyperVGenerationTypes

HyperVGeneration della macchina virtuale di origine per cui viene acquisito il punto di ripristino.

Nome	Tipo	Descrizione
V1	string
V2	string

InnerError

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump delle eccezioni.
exceptiontype	string	Tipo di eccezione.

InstanceViewStatus

Stato di visualizzazione dell'istanza.

Nome	Tipo	Descrizione
code	string	Codice di stato.
displayStatus	string	Etichetta localizzabile breve per lo stato.
level	StatusLevelTypes	Codice a livello.
message	string	Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.
time	string	Ora dello stato.

KeyVaultKeyReference

Descrive un riferimento alla chiave di Key Vault

Nome	Tipo	Descrizione
keyUrl	string	URL che fa riferimento a una chiave di crittografia della chiave in Key Vault.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente la chiave.

KeyVaultSecretReference

Descrive un riferimento al segreto dell'insieme di credenziali delle chiavi

Nome	Tipo	Descrizione
secretUrl	string	URL che fa riferimento a un segreto in un insieme di credenziali delle chiavi.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente il segreto.

LinuxConfiguration

Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.

Nome	Tipo	Descrizione
disablePasswordAuthentication	boolean	Specifica se l'autenticazione della password deve essere disabilitata.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Linux. Il valore predefinito è false.
patchSettings	LinuxPatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo su true. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
ssh	SshConfiguration	Specifica la configurazione della chiave SSH per un sistema operativo Linux.

LinuxPatchAssessmentMode

Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Linux.

Nome	Tipo	Descrizione
assessmentMode	LinuxPatchAssessmentMode	Specifica la modalità di valutazione della patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Linux.
patchMode	LinuxVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch linux.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

LinuxVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

ImageDefault: viene usata la configurazione di applicazione di patch predefinita della macchina virtuale.

AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. La proprietà provisionVMAgent deve essere true

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

ManagedDiskParameters

Parametri di un disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
id	string	ID risorsa
securityProfile	VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.
storageAccountType	StorageAccountTypes	Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

Mode

Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.

Nome	Tipo	Descrizione
Audit	string
Enforce	string

OperatingSystemType

Ottiene il tipo di sistema operativo.

Nome	Tipo	Descrizione
Linux	string
Windows	string

OSProfile

Specifica le impostazioni del sistema operativo per la macchina virtuale. Alcune impostazioni non possono essere modificate dopo il provisioning della macchina virtuale.

Nome	Tipo	Descrizione
adminPassword	string	Specifica la password dell'account amministratore. Lunghezza minima (Windows): 8 caratteri Lunghezza minima (Linux): 6 caratteri Lunghezza massima (Windows): 123 caratteri Lunghezza massima (Linux): 72 caratteri requisiti di complessità: è necessario soddisfare 3 su 4 condizioni seguenti Ha caratteri inferiori Ha caratteri superiori Ha una cifra Ha un carattere speciale (corrispondenza regex [\W_]) Valori non consentiti: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Per reimpostare la password, vedere Come reimpostare il servizio Desktop remoto o la relativa password di accesso in una macchina virtuale Windows Per reimpostare la password radice, vedere Gestire utenti, SSH e controllare o ripristinare i dischi in macchine virtuali Linux di Azure usando l'estensione VMAccess
adminUsername	string	Specifica il nome dell'account amministratore. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. restrizione solo Windows: Non è possibile terminare in "." Valori non consentiti: "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". lunghezza minima (Linux): 1 carattere Lunghezza massima (Linux): 64 caratteri Lunghezza massima (Windows): 20 caratteri.
allowExtensionOperations	boolean	Specifica se le operazioni di estensione devono essere consentite nella macchina virtuale. Questa impostazione può essere impostata su False solo quando non sono presenti estensioni nella macchina virtuale.
computerName	string	Specifica il nome del sistema operativo host della macchina virtuale. Questo nome non può essere aggiornato dopo la creazione della macchina virtuale. Lunghezza massima (Windows): 15 caratteri. Lunghezza massima (Linux): 64 caratteri. Per le convenzioni di denominazione e le restrizioni, vedere linee guida per l'implementazione dei servizi dell'infrastruttura di Azure.
customData	string	Specifica una stringa con codifica base 64 di dati personalizzati. La stringa con codifica base 64 viene decodificata in una matrice binaria salvata come file nella macchina virtuale. La lunghezza massima della matrice binaria è di 65535 byte. Nota: non passare segreti o password nella proprietà customData. Questa proprietà non può essere aggiornata dopo la creazione della macchina virtuale. La proprietà 'customData' viene passata alla macchina virtuale da salvare come file. Per altre informazioni, vedere dati personalizzati nelle macchine virtuali di Azure. Per l'uso di cloud-init per la macchina virtuale Linux, vedere Uso di cloud-init per personalizzare una macchina virtuale Linux durante la creazione.
linuxConfiguration	LinuxConfiguration	Specifica le impostazioni del sistema operativo Linux nella macchina virtuale. Per un elenco delle distribuzioni Linux supportate, vedere Linux in distribuzioni Azure-Endorsed.
requireGuestProvisionSignal	boolean	Proprietà facoltativa che deve essere impostata su True o omessa.
secrets	VaultSecretGroup[]	Specifica il set di certificati che devono essere installati nella macchina virtuale. Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
windowsConfiguration	WindowsConfiguration	Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

PassNames

Nome del pass. Attualmente, l'unico valore consentito è OobeSystem.

Nome	Tipo	Descrizione
OobeSystem	string

PatchSettings

Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.

Nome	Tipo	Descrizione
assessmentMode	WindowsPatchAssessmentMode	Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS. I valori possibili sono: ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale. AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Specifica impostazioni aggiuntive per la modalità patch AutomaticByPlatform nell'applicazione di patch guest alle macchine virtuali in Windows.
enableHotpatching	boolean	Consente ai clienti di applicare patch alle macchine virtuali di Azure senza richiedere un riavvio. Per enableHotpatching, 'provisionVMAgent' deve essere impostato su true e 'patchMode' deve essere impostato su 'AutomaticByPlatform'.
patchMode	WindowsVMGuestPatchMode	Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile. I valori possibili sono: manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true. AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

ProtocolTypes

Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

Nome	Tipo	Descrizione
Http	string
Https	string

ProxyAgentSettings

Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.

Nome	Tipo	Descrizione
enabled	boolean	Specifica se la funzionalità ProxyAgent deve essere abilitata nella macchina virtuale o nel set di scalabilità di macchine virtuali.
keyIncarnationId	integer	Aumentare il valore di questa proprietà consente all'utente di reimpostare la chiave usata per proteggere il canale di comunicazione tra guest e host.
mode	Mode	Specifica la modalità su cui Verrà eseguito ProxyAgent se la funzionalità è abilitata. ProxyAgent inizierà a controllare o monitorare ma non a imporre il controllo di accesso sulle richieste agli endpoint host in modalità di controllo, mentre in modalità di imposizione applichererà il controllo di accesso. Il valore predefinito è Imponi modalità.

RestorePoint

Dettagli del punto di ripristino.

Nome	Tipo	Descrizione
id	string	ID risorsa
name	string	Nome risorsa
properties.consistencyMode	ConsistencyModeTypes	ConsistencyMode di RestorePoint. Può essere specificato nell'input durante la creazione di un punto di ripristino. Per il momento, solo CrashConsistent viene accettato come input valido. Per altri dettagli, vedere https://aka.ms/RestorePoints.
properties.excludeDisks	ApiEntityReference[]	Elenco di ID risorsa disco che il cliente desidera escludere dal punto di ripristino. Se non viene specificato alcun disco, verranno inclusi tutti i dischi.
properties.instanceView	RestorePointInstanceView	Visualizzazione dell'istanza del punto di ripristino.
properties.provisioningState	string	Ottiene lo stato di provisioning del punto di ripristino.
properties.sourceMetadata	RestorePointSourceMetadata	Ottiene i dettagli della macchina virtuale acquisita al momento della creazione del punto di ripristino.
properties.sourceRestorePoint	ApiEntityReference	ID risorsa del punto di ripristino di origine da cui deve essere creata una copia.
properties.timeCreated	string	Ottiene l'ora di creazione del punto di ripristino.
type	string	Tipo di risorsa

RestorePointCollection

Creare o aggiornare i parametri della raccolta di punti di ripristino.

Nome	Tipo	Descrizione
id	string	ID risorsa
location	string	Percorso risorsa
name	string	Nome risorsa
properties.provisioningState	string	Stato di provisioning della raccolta di punti di ripristino.
properties.restorePointCollectionId	string	ID univoco della raccolta di punti di ripristino.
properties.restorePoints	RestorePoint[]	Elenco contenente tutti i punti di ripristino creati in questa raccolta di punti di ripristino.
properties.source	RestorePointCollectionSourceProperties	Proprietà della risorsa di origine da cui viene creata la raccolta di punti di ripristino.
tags	object	Tag delle risorse
type	string	Tipo di risorsa

RestorePointCollectionSourceProperties

Proprietà della risorsa di origine da cui viene creata la raccolta di punti di ripristino.

Nome	Tipo	Descrizione
id	string	ID risorsa della risorsa di origine usata per creare questa raccolta di punti di ripristino
location	string	Posizione della risorsa di origine usata per creare questa raccolta di punti di ripristino.

RestorePointEncryption

Impostazioni di crittografia dei dati inattivi per il punto di ripristino del disco. Si tratta di una proprietà facoltativa che può essere specificata nell'input durante la creazione di un punto di ripristino.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Descrive il parametro dell'ID risorsa del set di crittografia dischi gestiti dal cliente che può essere specificato per il disco. Nota: L'ID risorsa del set di crittografia del disco può essere specificato solo per il disco gestito. Per altri dettagli, vedere https://aka.ms/mdssewithcmkoverview.
type	RestorePointEncryptionType	Tipo di chiave utilizzata per crittografare i dati del punto di ripristino del disco.

RestorePointEncryptionType

Tipo di chiave utilizzata per crittografare i dati del punto di ripristino del disco.

Nome	Tipo	Descrizione
EncryptionAtRestWithCustomerKey	string	Il punto di ripristino del disco viene crittografato inattivo con la chiave gestita dal cliente che può essere modificata e revocata da un cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Il punto di ripristino del disco è crittografato inattivo con 2 livelli di crittografia. Una delle chiavi è Gestita dal cliente e l'altra è gestita dalla piattaforma.
EncryptionAtRestWithPlatformKey	string	Il punto di ripristino del disco viene crittografato inattivo con la chiave gestita dalla piattaforma.

RestorePointInstanceView

Visualizzazione dell'istanza di un punto di ripristino.

Nome	Tipo	Descrizione
diskRestorePoints	DiskRestorePointInstanceView[]	Informazioni sui punti di ripristino del disco.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.

RestorePointSourceMetadata

Descrive le proprietà della macchina virtuale per cui è stato creato il punto di ripristino. Le proprietà fornite sono un subset e lo snapshot delle proprietà complessive della macchina virtuale acquisite al momento della creazione del punto di ripristino.

Nome	Tipo	Descrizione
diagnosticsProfile	DiagnosticsProfile	Ottiene il profilo di diagnostica.
hardwareProfile	HardwareProfile	Ottiene il profilo hardware.
hyperVGeneration	HyperVGenerationTypes	HyperVGeneration della macchina virtuale di origine per cui viene acquisito il punto di ripristino.
licenseType	string	Ottiene il tipo di licenza, ovvero per lo scenario bring your own license.
location	string	Percorso della macchina virtuale da cui è stato creato il punto di ripristino.
osProfile	OSProfile	Ottiene il profilo del sistema operativo.
securityProfile	SecurityProfile	Ottiene il profilo di sicurezza.
storageProfile	RestorePointSourceVMStorageProfile	Ottiene il profilo di archiviazione.
userData	string	UserData associato alla macchina virtuale di origine per cui viene acquisito il punto di ripristino, ovvero un valore con codifica base 64.
vmId	string	Ottiene l'ID univoco della macchina virtuale.

RestorePointSourceVMDataDisk

Descrive un disco dati.

Nome	Tipo	Descrizione
caching	CachingTypes	Ottiene il tipo di memorizzazione nella cache.
diskRestorePoint	DiskRestorePointAttributes	Contiene le proprietà del punto di ripristino del disco.
diskSizeGB	integer	Ottiene le dimensioni iniziali del disco in GB per i dischi dati vuoti e le nuove dimensioni desiderate per i dischi dati e del sistema operativo esistenti.
lun	integer	Ottiene il numero di unità logica.
managedDisk	ManagedDiskParameters	Contiene i dettagli del disco gestito.
name	string	Ottiene il nome del disco.
writeAcceleratorEnabled	boolean	Indica true se il disco è abilitato per l'acceleratore di scrittura.

RestorePointSourceVMOSDisk

Descrive un disco del sistema operativo.

Nome	Tipo	Descrizione
caching	CachingTypes	Ottiene il tipo di memorizzazione nella cache.
diskRestorePoint	DiskRestorePointAttributes	Contiene le proprietà del punto di ripristino del disco.
diskSizeGB	integer	Ottiene le dimensioni del disco in GB.
encryptionSettings	DiskEncryptionSettings	Ottiene le impostazioni di crittografia del disco.
managedDisk	ManagedDiskParameters	Ottiene i dettagli del disco gestito
name	string	Ottiene il nome del disco.
osType	OperatingSystemType	Ottiene il tipo di sistema operativo.
writeAcceleratorEnabled	boolean	Indica true se il disco è abilitato per l'acceleratore di scrittura.

RestorePointSourceVMStorageProfile

Descrive il profilo di archiviazione.

Nome	Tipo	Descrizione
dataDisks	RestorePointSourceVMDataDisk[]	Ottiene i dischi dati della macchina virtuale acquisita al momento della creazione del punto di ripristino.
diskControllerType	DiskControllerTypes	Ottiene il tipo di controller del disco della macchina virtuale acquisita al momento della creazione del punto di ripristino.
osDisk	RestorePointSourceVMOSDisk	Ottiene il disco del sistema operativo della macchina virtuale acquisita al momento della creazione del punto di ripristino.

securityEncryptionTypes

Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

Nome	Tipo	Descrizione
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

Specifica le impostazioni del profilo di sicurezza per la macchina virtuale o il set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
encryptionAtHost	boolean	Questa proprietà può essere usata dall'utente nella richiesta per abilitare o disabilitare la crittografia host per la macchina virtuale o il set di scalabilità di macchine virtuali. In questo modo verrà abilitata la crittografia per tutti i dischi, incluso il disco Resource/Temp nell'host stesso. Il comportamento predefinito è: la crittografia dell'host verrà disabilitata a meno che questa proprietà non sia impostata su true per la risorsa.
encryptionIdentity	EncryptionIdentity	Specifica l'identità gestita usata da ADE per ottenere il token di accesso per le operazioni dell'insieme di credenziali delle chiavi.
proxyAgentSettings	ProxyAgentSettings	Specifica le impostazioni proxyAgent durante la creazione della macchina virtuale. Versione minima api: 2023-09-01.
securityType	SecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.
uefiSettings	UefiSettings	Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

SecurityTypes

Specifica il Tipo di sicurezza della macchina virtuale. Deve essere impostato su qualsiasi valore specificato per abilitare UefiSettings. Il comportamento predefinito è: UefiSettings non verrà abilitato a meno che questa proprietà non sia impostata.

Nome	Tipo	Descrizione
ConfidentialVM	string
TrustedLaunch	string

SettingNames

Specifica il nome dell'impostazione a cui si applica il contenuto. I valori possibili sono: FirstLogonCommands e AutoLogon.

Nome	Tipo	Descrizione
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure

Nome	Tipo	Descrizione
publicKeys	SshPublicKey[]	Elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

SshPublicKey

Contiene informazioni sulla chiave pubblica del certificato SSH e sul percorso nella macchina virtuale Linux in cui viene inserita la chiave pubblica.

Nome	Tipo	Descrizione
keyData	string	Certificato di chiave pubblica SSH usato per l'autenticazione con la macchina virtuale tramite ssh. La chiave deve essere almeno a 2048 bit e in formato ssh-rsa. Per la creazione di chiavi SSH, vedere [Creare chiavi SSH in Linux e Mac per macchine virtuali Linux in Azure]https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	Specifica il percorso completo nella macchina virtuale creata in cui è archiviata la chiave pubblica SSH. Se il file esiste già, la chiave specificata viene aggiunta al file. Esempio: /home/user/.ssh/authorized_keys

StatusLevelTypes

Codice a livello.

Nome	Tipo	Descrizione
Error	string
Info	string
Warning	string

StorageAccountTypes

Specifica il tipo di account di archiviazione per il disco gestito. NOTA: UltraSSD_LRS può essere usato solo con dischi dati, non può essere usato con il disco del sistema operativo.

Nome	Tipo	Descrizione
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

SubResource

Nome	Tipo	Descrizione
id	string	ID risorsa

UefiSettings

Specifica le impostazioni di sicurezza, ad esempio l'avvio protetto e vTPM usato durante la creazione della macchina virtuale. Versione minima api: 2020-12-01.

Nome	Tipo	Descrizione
secureBootEnabled	boolean	Specifica se l'avvio protetto deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.
vTpmEnabled	boolean	Specifica se vTPM deve essere abilitato nella macchina virtuale. Versione minima api: 2020-12-01.

VaultCertificate

Descrive un singolo riferimento al certificato in un insieme di credenziali delle chiavi e dove risiede il certificato nella macchina virtuale.

Nome	Tipo	Descrizione
certificateStore	string	Per le macchine virtuali Windows, specifica l'archivio certificati nella macchina virtuale a cui aggiungere il certificato. L'archivio certificati specificato è in modo implicito nell'account LocalMachine. Per le macchine virtuali Linux, il file di certificato viene inserito nella directory /var/lib/waagent, con il nome file <UppercaseThumbprint>.crt per il file di certificato X509 e <UppercaseThumbprint>.prv per la chiave privata. Entrambi questi file sono formattati con estensione pem.
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere La codifica Base64 dell'oggetto JSON seguente codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.

VaultSecretGroup

Descrive un set di certificati che si trovano tutti nello stesso insieme di credenziali delle chiavi.

Nome	Tipo	Descrizione
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente tutti i certificati in VaultCertificates.
vaultCertificates	VaultCertificate[]	Elenco di riferimenti all'insieme di credenziali delle chiavi in SourceVault che contengono certificati.

VirtualMachineSizeTypes

Specifica le dimensioni della macchina virtuale. Il tipo di dati enum è attualmente deprecato e verrà rimosso entro il 23 dicembre 2023. Il modo consigliato per ottenere l'elenco delle dimensioni disponibili consiste nell'usare queste API: Elencare tutte le dimensioni delle macchine virtuali disponibili in un set di disponibilità, Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area, Elencare tutte le dimensioni delle macchine virtuali disponibili per il ridimensionamento. Per altre informazioni sulle dimensioni delle macchine virtuali, vedere Dimensioni per le macchine virtuali. Le dimensioni della macchina virtuale disponibili dipendono dall'area e dal set di disponibilità.

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

VMDiskSecurityProfile

Specifica le impostazioni del profilo di sicurezza per il disco gestito. Nota: può essere impostato solo per le macchine virtuali riservate.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito usato per il disco del sistema operativo ConfidentialVM crittografato con chiave gestita dal cliente e il BLOB VMGuest.
securityEncryptionType	securityEncryptionTypes	Specifica encryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia solo del BLOB VMGuestState e NonPersistedTPM per non rendere persistente lo stato del firmware nel BLOB VMGuestState. Nota: può essere impostato solo per le macchine virtuali riservate.

VMSizeProperties

Specifica le impostazioni delle proprietà dimensioni macchina virtuale nella macchina virtuale.

Nome	Tipo	Descrizione
vCPUsAvailable	integer	Specifica il numero di vCPU disponibili per la macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito consiste nell'impostarlo sul valore delle vCPU disponibili per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area.
vCPUsPerCore	integer	Specifica il rapporto tra vCPU e core fisici. Quando questa proprietà non viene specificata nel corpo della richiesta, il comportamento predefinito è impostato sul valore di vCPUsPerCore per le dimensioni della macchina virtuale esposte in risposta api di Elencare tutte le dimensioni delle macchine virtuali disponibili in un'area. L'impostazione di questa proprietà su 1 indica anche che l'hyper-threading è disabilitato.

WindowsConfiguration

Specifica le impostazioni del sistema operativo Windows nella macchina virtuale.

Nome	Tipo	Descrizione
additionalUnattendContent	AdditionalUnattendContent[]	Specifica ulteriori informazioni in formato XML con codifica Base 64 che possono essere incluse nel file Unattend.xml, che viene utilizzato dal programma di installazione di Windows.
enableAutomaticUpdates	boolean	Indica se gli aggiornamenti automatici sono abilitati per la macchina virtuale Windows. Il valore predefinito è true. Per i set di scalabilità di macchine virtuali, questa proprietà può essere aggiornata e gli aggiornamenti avranno effetto sul reprovisioning del sistema operativo.
enableVMAgentPlatformUpdates	boolean	Indica se gli aggiornamenti della piattaforma VMAgent sono abilitati per la macchina virtuale Windows.
patchSettings	PatchSettings	[Funzionalità di anteprima] Specifica le impostazioni correlate all'applicazione di patch guest della macchina virtuale in Windows.
provisionVMAgent	boolean	Indica se è necessario eseguire il provisioning dell'agente di macchine virtuali nella macchina virtuale. Quando questa proprietà non viene specificata nel corpo della richiesta, viene impostata su true per impostazione predefinita. In questo modo si garantisce che l'agente di macchine virtuali sia installato nella macchina virtuale in modo che le estensioni possano essere aggiunte alla macchina virtuale in un secondo momento.
timeZone	string	Specifica il fuso orario della macchina virtuale. ad esempio "Ora solare pacifico". I valori possibili possono essere TimeZoneInfo.Id valore dai fusi orari restituiti da TimeZoneInfo.GetSystemTimeZones.
winRM	WinRMConfiguration	Specifica i listener di Gestione remota Windows. In questo modo si abilita Windows PowerShell remoto.

WindowsPatchAssessmentMode

Specifica la modalità di valutazione delle patch guest della macchina virtuale per la macchina virtuale IaaS.

I valori possibili sono:

ImageDefault: è possibile controllare la tempistica delle valutazioni delle patch in una macchina virtuale.

AutomaticByPlatform: la piattaforma attiverà valutazioni periodiche delle patch. La proprietà provisionVMAgent deve essere true.

Nome	Tipo	Descrizione
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

Nome	Tipo	Descrizione
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Specifica impostazioni aggiuntive da applicare quando la modalità patch AutomaticByPlatform è selezionata nelle impostazioni della patch di Windows.

Nome	Tipo	Descrizione
bypassPlatformSafetyChecksOnUserSchedule	boolean	Consente al cliente di pianificare l'applicazione di patch senza aggiornamenti accidentali
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	Specifica l'impostazione di riavvio per tutte le operazioni di installazione delle patch AutomaticByPlatform.

WindowsVMGuestPatchMode

Specifica la modalità di applicazione di patch guest alle macchine virtuali IaaS o alle macchine virtuali associate al set di scalabilità di macchine virtuali con OrchestrationMode come flessibile.

I valori possibili sono:

manuale: è possibile controllare l'applicazione di patch a una macchina virtuale. A tale scopo, applicare manualmente le patch all'interno della macchina virtuale. In questa modalità gli aggiornamenti automatici sono disabilitati; La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere false

AutomaticByOS: la macchina virtuale verrà aggiornata automaticamente dal sistema operativo. La proprietà WindowsConfiguration.enableAutomaticUpdates deve essere true.

AutomaticByPlatform: la macchina virtuale verrà aggiornata automaticamente dalla piattaforma. Le proprietà provisionVMAgent e WindowsConfiguration.enableAutomaticUpdates devono essere true

Nome	Tipo	Descrizione
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Descrive la configurazione di Gestione remota Windows della macchina virtuale

Nome	Tipo	Descrizione
listeners	WinRMListener[]	Elenco di listener di Gestione remota Windows

WinRMListener

Descrive il protocollo e l'identificazione personale del listener di Gestione remota Windows

Nome	Tipo	Descrizione
certificateUrl	string	Si tratta dell'URL di un certificato caricato in Key Vault come segreto. Per aggiungere un segreto all'insieme di credenziali delle chiavi, vedere Aggiungere una chiave o un segreto all'insieme di credenziali delle chiavi. In questo caso, il certificato deve essere la codifica Base64 dell'oggetto JSON seguente, codificato in UTF-8: { "data":"", "dataType":"pfx", "password":"" } Per installare i certificati in una macchina virtuale, è consigliabile usare l'estensione macchina virtuale di Azure Key Vault per Linux o l'estensione macchina virtuale di Azure Key Vault per Windows.
protocol	ProtocolTypes	Specifica il protocollo del listener WinRM. I valori possibili sono: http,https.

Condividi tramite

Restore Point Collections - Create Or Update

Parametri dell'URI

Corpo della richiesta

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

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

Esempio di richiesta

Risposta di esempio

Create or update a restore point collection.

Esempio di richiesta

Risposta di esempio

Definizioni

AdditionalUnattendContent

ApiEntityReference

ApiError

ApiErrorBase

BootDiagnostics

CachingTypes

CloudError

ComponentNames

ConsistencyModeTypes

DiagnosticsProfile

DiskControllerTypes

DiskEncryptionSetParameters

DiskEncryptionSettings

DiskRestorePointAttributes

DiskRestorePointInstanceView

DiskRestorePointReplicationStatus

EncryptionIdentity

HardwareProfile

HyperVGenerationTypes

InnerError

InstanceViewStatus

KeyVaultKeyReference

KeyVaultSecretReference

LinuxConfiguration

LinuxPatchAssessmentMode

LinuxPatchSettings

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

LinuxVMGuestPatchAutomaticByPlatformSettings

LinuxVMGuestPatchMode

ManagedDiskParameters

Mode

OperatingSystemType

OSProfile

PassNames

PatchSettings

ProtocolTypes

ProxyAgentSettings

RestorePoint

RestorePointCollection

RestorePointCollectionSourceProperties

RestorePointEncryption

RestorePointEncryptionType

RestorePointInstanceView

RestorePointSourceMetadata

RestorePointSourceVMDataDisk

RestorePointSourceVMOSDisk

RestorePointSourceVMStorageProfile

securityEncryptionTypes

SecurityProfile

SecurityTypes

SettingNames

SshConfiguration

SshPublicKey

StatusLevelTypes

StorageAccountTypes

SubResource

UefiSettings

VaultCertificate

VaultSecretGroup

VirtualMachineSizeTypes

VMDiskSecurityProfile

VMSizeProperties

WindowsConfiguration

WindowsPatchAssessmentMode