Restore Points - Create

Servizio:

Compute

Versione API:

2024-07-01

Operazione per creare il punto di ripristino. L'aggiornamento delle proprietà di un punto di ripristino esistente non è consentito

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}/restorePoints/{restorePointName}?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.
restorePointName	path	True	string	Nome del punto 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	Tipo	Descrizione
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.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.

Risposte

Nome	Tipo	Descrizione
201 Created	RestorePoint	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

Copy a restore point to a different region

Create a restore point

Copy a restore point to a different region

Esempio di richiesta

HTTP

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

{
  "properties": {
    "sourceRestorePoint": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName"
    }
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.RestorePointInner;
import com.azure.resourcemanager.compute.models.ApiEntityReference;

/**
 * Samples for RestorePoints Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePoint_Copy_BetweenRegions.json
     */
    /**
     * Sample code: Copy a restore point to a different region.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void copyARestorePointToADifferentRegion(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePoints().create("myResourceGroup", "rpcName",
            "rpName",
            new RestorePointInner().withSourceRestorePoint(new ApiEntityReference().withId(
                "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName")),
            com.azure.core.util.Context.NONE);
    }
}

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_copy_between_regions.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_points.begin_create(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="rpcName",
        restore_point_name="rpName",
        parameters={
            "properties": {
                "sourceRestorePoint": {
                    "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName"
                }
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Copy_BetweenRegions.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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d6d0798c6f5eb196fba7bd1924db2b145a94f58c/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Copy_BetweenRegions.json
func ExampleRestorePointsClient_BeginCreate_copyARestorePointToADifferentRegion() {
	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)
	}
	poller, err := clientFactory.NewRestorePointsClient().BeginCreate(ctx, "myResourceGroup", "rpcName", "rpName", armcompute.RestorePoint{
		Properties: &armcompute.RestorePointProperties{
			SourceRestorePoint: &armcompute.APIEntityReference{
				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName"),
			},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	_, err = poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
}

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 the restore point. Updating properties of an existing restore point is not allowed
 *
 * @summary The operation to create the restore point. Updating properties of an existing restore point is not allowed
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Copy_BetweenRegions.json
 */
async function copyARestorePointToADifferentRegion() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "rpcName";
  const restorePointName = "rpName";
  const parameters = {
    sourceRestorePoint: {
      id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName",
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePoints.beginCreateAndWait(
    resourceGroupName,
    restorePointCollectionName,
    restorePointName,
    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.Resources.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Copy_BetweenRegions.json
// this example is just showing the usage of "RestorePoints_Create" 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 RestorePointResource created on azure
// for more information of creating RestorePointResource, please refer to the document of RestorePointResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string restorePointGroupName = "rpcName";
string restorePointName = "rpName";
ResourceIdentifier restorePointResourceId = RestorePointResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, restorePointGroupName, restorePointName);
RestorePointResource restorePoint = client.GetRestorePointResource(restorePointResourceId);

// invoke the operation
RestorePointData data = new RestorePointData
{
    SourceRestorePointId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName"),
};
ArmOperation<RestorePointResource> lro = await restorePoint.UpdateAsync(WaitUntil.Completed, data);
RestorePointResource 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
RestorePointData 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:

201

{
  "name": "rpName",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/rpName",
  "properties": {
    "sourceRestorePoint": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/sourceRpcName/restorePoints/sourceRpName"
    },
    "sourceMetadata": {
      "vmId": "76d6541e-80bd-4dc1-932b-3cae4cfb80e7",
      "hardwareProfile": {
        "vmSize": "Standard_B1s"
      },
      "storageProfile": {
        "osDisk": {
          "osType": "Windows",
          "name": "osDisk123",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/osDisk123"
          },
          "diskRestorePoint": {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/rpName/diskRestorePoints/osDisk123_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"
          }
        },
        "dataDisks": [
          {
            "lun": 1,
            "name": "dataDisk123",
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS",
              "id": "/subscriptions/{subscription-id}/resourceGroups/userdata/providers/Microsoft.Compute/disks/dataDisk123"
            },
            "diskRestorePoint": {
              "id": "/subscriptions/{subscription-id}/resourceGroups/userdata/providers/Microsoft.Compute/restorePointCollections/mynewrpc/restorePoints/restorepointtwo/diskRestorePoints/dataDisk123_68785190-1acb-4d5e-a8ae-705b45f3dca5"
            }
          }
        ],
        "diskControllerType": "NVMe"
      },
      "osProfile": {
        "computerName": "computerName",
        "adminUsername": "admin",
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        },
        "secrets": [],
        "allowExtensionOperations": true,
        "requireGuestProvisionSignal": true
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true
        }
      },
      "location": "westus",
      "userData": "c2FtcGxlIHVzZXJEYXRh"
    },
    "provisioningState": "Creating",
    "consistencyMode": "ApplicationConsistent",
    "timeCreated": "2021-10-25T23:54:29.2796325+00:00"
  }
}

Create a restore point

Esempio di richiesta

HTTP

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

{
  "properties": {
    "excludeDisks": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"
      }
    ]
  }
}

Java

import com.azure.resourcemanager.compute.fluent.models.RestorePointInner;
import com.azure.resourcemanager.compute.models.ApiEntityReference;
import java.util.Arrays;

/**
 * Samples for RestorePoints Create.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * restorePointExamples/RestorePoint_Create.json
     */
    /**
     * Sample code: Create a restore point.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createARestorePoint(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getRestorePoints().create("myResourceGroup", "rpcName",
            "rpName",
            new RestorePointInner().withExcludeDisks(Arrays.asList(new ApiEntityReference().withId(
                "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"))),
            com.azure.core.util.Context.NONE);
    }
}

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_create.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_points.begin_create(
        resource_group_name="myResourceGroup",
        restore_point_collection_name="rpcName",
        restore_point_name="rpName",
        parameters={
            "properties": {
                "excludeDisks": [
                    {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"
                    }
                ]
            }
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Create.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/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/d6d0798c6f5eb196fba7bd1924db2b145a94f58c/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Create.json
func ExampleRestorePointsClient_BeginCreate_createARestorePoint() {
	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)
	}
	poller, err := clientFactory.NewRestorePointsClient().BeginCreate(ctx, "myResourceGroup", "rpcName", "rpName", armcompute.RestorePoint{
		Properties: &armcompute.RestorePointProperties{
			ExcludeDisks: []*armcompute.APIEntityReference{
				{
					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"),
				}},
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	_, err = poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
}

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 the restore point. Updating properties of an existing restore point is not allowed
 *
 * @summary The operation to create the restore point. Updating properties of an existing restore point is not allowed
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Create.json
 */
async function createARestorePoint() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const restorePointCollectionName = "rpcName";
  const restorePointName = "rpName";
  const parameters = {
    excludeDisks: [
      {
        id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123",
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.restorePoints.beginCreateAndWait(
    resourceGroupName,
    restorePointCollectionName,
    restorePointName,
    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.Resources.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/restorePointExamples/RestorePoint_Create.json
// this example is just showing the usage of "RestorePoints_Create" 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 RestorePointResource created on azure
// for more information of creating RestorePointResource, please refer to the document of RestorePointResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string restorePointGroupName = "rpcName";
string restorePointName = "rpName";
ResourceIdentifier restorePointResourceId = RestorePointResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, restorePointGroupName, restorePointName);
RestorePointResource restorePoint = client.GetRestorePointResource(restorePointResourceId);

// invoke the operation
RestorePointData data = new RestorePointData
{
    ExcludeDisks = {new WritableSubResource
    {
    Id = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"),
    }},
};
ArmOperation<RestorePointResource> lro = await restorePoint.UpdateAsync(WaitUntil.Completed, data);
RestorePointResource 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
RestorePointData 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:

201

{
  "name": "rpName",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/rpName",
  "properties": {
    "excludeDisks": [
      {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/disk123"
      }
    ],
    "sourceMetadata": {
      "vmId": "76d6541e-80bd-4dc1-932b-3cae4cfb80e7",
      "hardwareProfile": {
        "vmSize": "Standard_B1s"
      },
      "storageProfile": {
        "osDisk": {
          "osType": "Windows",
          "name": "osDisk123",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Standard_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/osDisk123"
          },
          "diskRestorePoint": {
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpcName/restorePoints/rpName/diskRestorePoints/osDisk123_22b4bdfe-6c54-4f72-84d8-85d8860f0c57"
          }
        },
        "dataDisks": [
          {
            "lun": 1,
            "name": "dataDisk123",
            "caching": "None",
            "managedDisk": {
              "storageAccountType": "Standard_LRS",
              "id": "/subscriptions/{subscription-id}/resourceGroups/userdata/providers/Microsoft.Compute/disks/dataDisk123"
            },
            "diskRestorePoint": {
              "id": "/subscriptions/{subscription-id}/resourceGroups/userdata/providers/Microsoft.Compute/restorePointCollections/mynewrpc/restorePoints/restorepointtwo/diskRestorePoints/dataDisk123_68785190-1acb-4d5e-a8ae-705b45f3dca5"
            }
          }
        ],
        "diskControllerType": "NVMe"
      },
      "osProfile": {
        "computerName": "computerName",
        "adminUsername": "admin",
        "windowsConfiguration": {
          "provisionVMAgent": true,
          "enableAutomaticUpdates": true
        },
        "secrets": [],
        "allowExtensionOperations": true,
        "requireGuestProvisionSignal": true
      },
      "diagnosticsProfile": {
        "bootDiagnostics": {
          "enabled": true
        }
      },
      "location": "westus",
      "userData": "c2FtcGxlIHVzZXJEYXRh"
    },
    "provisioningState": "Succeeded",
    "consistencyMode": "ApplicationConsistent",
    "timeCreated": "2021-01-27T20:35:05.8401519+00:00"
  }
}

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

Object

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

Object

Informazioni di riferimento sulle entità API.

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

ApiError

Object

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

Object

Base degli errori api.

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

BootDiagnostics

Object

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

Enumeration

Ottiene il tipo di memorizzazione nella cache.

Valore	Descrizione
None
ReadOnly
ReadWrite

CloudError

Object

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore dell'API.

ComponentNames

Enumeration

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

Valore	Descrizione
Microsoft-Windows-Shell-Setup

ConsistencyModeTypes

Enumeration

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.

Valore	Descrizione
ApplicationConsistent
CrashConsistent
FileSystemConsistent

DiagnosticsProfile

Object

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

Enumeration

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

Valore	Descrizione
NVMe
SCSI

DiskEncryptionSetParameters

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Object

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

Enumeration

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

Valore	Descrizione
V1
V2

InnerError

Object

Dettagli dell'errore interno.

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

InstanceViewStatus

Object

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

Object

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

Object

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

Object

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

Enumeration

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.

Valore	Descrizione
AutomaticByPlatform
ImageDefault

LinuxPatchSettings

Object

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

Enumeration

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

Valore	Descrizione
Always
IfRequired
Never
Unknown

LinuxVMGuestPatchAutomaticByPlatformSettings

Object

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

Enumeration

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

Valore	Descrizione
AutomaticByPlatform
ImageDefault

ManagedDiskParameters

Object

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

Enumeration

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à.

Valore	Descrizione
Audit
Enforce

OperatingSystemType

Enumeration

Ottiene il tipo di sistema operativo.

Valore	Descrizione
Linux
Windows

OSProfile

Object

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

Enumeration

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

Valore	Descrizione
OobeSystem

PatchSettings

Object

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

Enumeration

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

Valore	Descrizione
Http
Https

ProxyAgentSettings

Object

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

Object

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

RestorePointEncryption

Object

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

Enumeration

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

Valore	Descrizione
EncryptionAtRestWithCustomerKey	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	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	Il punto di ripristino del disco viene crittografato inattivo con la chiave gestita dalla piattaforma.

RestorePointInstanceView

Object

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

Object

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

Object

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

Object

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

Object

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

Enumeration

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.

Valore	Descrizione
DiskWithVMGuestState
NonPersistedTPM
VMGuestStateOnly

SecurityProfile

Object

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

Enumeration

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.

Valore	Descrizione
ConfidentialVM
TrustedLaunch

SettingNames

Enumeration

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

Valore	Descrizione
AutoLogon
FirstLogonCommands

SshConfiguration

Object

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

Object

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

Enumeration

Codice a livello.

Valore	Descrizione
Error
Info
Warning

StorageAccountTypes

Enumeration

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.

Valore	Descrizione
PremiumV2_LRS
Premium_LRS
Premium_ZRS
StandardSSD_LRS
StandardSSD_ZRS
Standard_LRS
UltraSSD_LRS

SubResource

Object

Nome	Tipo	Descrizione
id	string	ID risorsa

UefiSettings

Object

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

Object

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

Object

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

Enumeration

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à.

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

VMDiskSecurityProfile

Object

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

Object

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

Object

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

Enumeration

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.

Valore	Descrizione
AutomaticByPlatform
ImageDefault

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

Enumeration

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

Valore	Descrizione
Always
IfRequired
Never
Unknown

WindowsVMGuestPatchAutomaticByPlatformSettings

Object

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

Enumeration

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

Valore	Descrizione
AutomaticByOS
AutomaticByPlatform
Manual

WinRMConfiguration

Object

Descrive la configurazione di Gestione remota Windows della macchina virtuale

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

WinRMListener

Object

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.