Virtual Machines - Attach Detach Data Disks

Servizio:

Compute

Versione API:

2024-03-01

Collegare e scollegare dischi dati da/verso la macchina virtuale.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2024-03-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string	Nome del gruppo di risorse.
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 di servizio.
vmName	path	True	string	Nome della macchina virtuale.
api-version	query	True	string	Versione dell'API client.

Corpo della richiesta

Nome	Tipo	Descrizione
parameters	AttachDetachDataDisksRequest	Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.

Risposte

Nome	Tipo	Descrizione
200 OK	StorageProfile	OK
202 Accepted		Accettato Intestazioni Location: string
Other Status Codes	CloudError	Risposta di errore che descrive perché 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

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2024-03-01

{
  "dataDisksToAttach": [
    {
      "lun": 1,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadOnly",
      "deleteOption": "Delete",
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadWrite",
      "deleteOption": "Detach",
      "writeAcceleratorEnabled": false
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      "detachOption": "ForceDetach"
    },
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      "detachOption": "ForceDetach"
    }
  ]
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_attach_detach_data_disks_maximum_set_gen.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.virtual_machines.begin_attach_detach_data_disks(
        resource_group_name="rgcompute",
        vm_name="aaaaaaaaaaaaaaaaaaaa",
        parameters={
            "dataDisksToAttach": [
                {
                    "caching": "ReadOnly",
                    "deleteOption": "Delete",
                    "diskEncryptionSet": {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
                    },
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
                    "lun": 1,
                    "writeAcceleratorEnabled": True,
                },
                {
                    "caching": "ReadWrite",
                    "deleteOption": "Detach",
                    "diskEncryptionSet": {
                        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
                    },
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
                    "lun": 2,
                    "writeAcceleratorEnabled": False,
                },
            ],
            "dataDisksToDetach": [
                {
                    "detachOption": "ForceDetach",
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
                },
                {
                    "detachOption": "ForceDetach",
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
                },
            ],
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.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/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
func ExampleVirtualMachinesClient_BeginAttachDetachDataDisks_virtualMachineAttachDetachDataDisksMaximumSetGen() {
	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.NewVirtualMachinesClient().BeginAttachDetachDataDisks(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaa", armcompute.AttachDetachDataDisksRequest{
		DataDisksToAttach: []*armcompute.DataDisksToAttach{
			{
				Caching:      to.Ptr(armcompute.CachingTypesReadOnly),
				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
				},
				DiskID:                  to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
				Lun:                     to.Ptr[int32](1),
				WriteAcceleratorEnabled: to.Ptr(true),
			},
			{
				Caching:      to.Ptr(armcompute.CachingTypesReadWrite),
				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
				},
				DiskID:                  to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
				Lun:                     to.Ptr[int32](2),
				WriteAcceleratorEnabled: to.Ptr(false),
			}},
		DataDisksToDetach: []*armcompute.DataDisksToDetach{
			{
				DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
				DiskID:       to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"),
			},
			{
				DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
				DiskID:       to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z"),
			}},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %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.StorageProfile = armcompute.StorageProfile{
	// 	DataDisks: []*armcompute.DataDisk{
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadOnly),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 			Lun: to.Ptr[int32](1),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
	// 				},
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 			WriteAcceleratorEnabled: to.Ptr(true),
	// 		},
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
	// 			DiskSizeGB: to.Ptr[int32](100),
	// 			Lun: to.Ptr[int32](2),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
	// 				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
	// 				},
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 			WriteAcceleratorEnabled: to.Ptr(false),
	// 	}},
	// 	ImageReference: &armcompute.ImageReference{
	// 		Offer: to.Ptr("WindowsServer"),
	// 		Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 		SKU: to.Ptr("2016-Datacenter"),
	// 		Version: to.Ptr("latest"),
	// 	},
	// 	OSDisk: &armcompute.OSDisk{
	// 		Name: to.Ptr("myOsDisk"),
	// 		Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 		CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 		DiskSizeGB: to.Ptr[int32](30),
	// 		ManagedDisk: &armcompute.ManagedDiskParameters{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 		},
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 	},
	// }
}

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");

/**
 * This sample demonstrates how to Attach and detach data disks to/from the virtual machine.
 *
 * @summary Attach and detach data disks to/from the virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
 */
async function virtualMachineAttachDetachDataDisksMaximumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const vmName = "aaaaaaaaaaaaaaaaaaaa";
  const parameters = {
    dataDisksToAttach: [
      {
        caching: "ReadOnly",
        deleteOption: "Delete",
        diskEncryptionSet: {
          id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}",
        },
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
        lun: 1,
        writeAcceleratorEnabled: true,
      },
      {
        caching: "ReadWrite",
        deleteOption: "Detach",
        diskEncryptionSet: {
          id: "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}",
        },
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
        lun: 2,
        writeAcceleratorEnabled: false,
      },
    ],
    dataDisksToDetach: [
      {
        detachOption: "ForceDetach",
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      },
      {
        detachOption: "ForceDetach",
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.beginAttachDetachDataDisksAndWait(
    resourceGroupName,
    vmName,
    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

Risposta di esempio

Codice di stato:

200

location: https://foo.com/operationstatus

{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 1,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadOnly",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Delete",
      "diskSizeGB": 30,
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "name": "vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Detach",
      "diskSizeGB": 100,
      "writeAcceleratorEnabled": false
    }
  ]
}

Codice di stato:

202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Esempio di richiesta

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2024-03-01

{
  "dataDisksToAttach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
    }
  ]
}

Python

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_attach_detach_data_disks_minimum_set_gen.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.virtual_machines.begin_attach_detach_data_disks(
        resource_group_name="rgcompute",
        vm_name="azure-vm",
        parameters={
            "dataDisksToAttach": [
                {
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
                }
            ],
            "dataDisksToDetach": [
                {
                    "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
                }
            ],
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.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/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
func ExampleVirtualMachinesClient_BeginAttachDetachDataDisks_virtualMachineAttachDetachDataDisksMinimumSetGen() {
	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.NewVirtualMachinesClient().BeginAttachDetachDataDisks(ctx, "rgcompute", "azure-vm", armcompute.AttachDetachDataDisksRequest{
		DataDisksToAttach: []*armcompute.DataDisksToAttach{
			{
				DiskID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
			}},
		DataDisksToDetach: []*armcompute.DataDisksToDetach{
			{
				DiskID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"),
			}},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %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.StorageProfile = armcompute.StorageProfile{
	// 	DataDisks: []*armcompute.DataDisk{
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 			Lun: to.Ptr[int32](0),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 	}},
	// 	ImageReference: &armcompute.ImageReference{
	// 		Offer: to.Ptr("WindowsServer"),
	// 		Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 		SKU: to.Ptr("2016-Datacenter"),
	// 		Version: to.Ptr("latest"),
	// 	},
	// 	OSDisk: &armcompute.OSDisk{
	// 		Name: to.Ptr("myOsDisk"),
	// 		Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 		CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 		DiskSizeGB: to.Ptr[int32](30),
	// 		ManagedDisk: &armcompute.ManagedDiskParameters{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 		},
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 	},
	// }
}

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");

/**
 * This sample demonstrates how to Attach and detach data disks to/from the virtual machine.
 *
 * @summary Attach and detach data disks to/from the virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
 */
async function virtualMachineAttachDetachDataDisksMinimumSetGen() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "rgcompute";
  const vmName = "azure-vm";
  const parameters = {
    dataDisksToAttach: [
      {
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      },
    ],
    dataDisksToDetach: [
      {
        diskId:
          "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      },
    ],
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.beginAttachDetachDataDisksAndWait(
    resourceGroupName,
    vmName,
    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

Risposta di esempio

Codice di stato:

200

location: https://foo.com/operationstatus

{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 0,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
      },
      "diskSizeGB": 30
    }
  ]
}

Codice di stato:

202

location: https://foo.com/operationstatus

Definizioni

Nome	Descrizione
ApiEntityReference	Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.
ApiError	Errore dell'API.
ApiErrorBase	Base di errori dell'API.
AttachDetachDataDisksRequest	Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.
CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
CloudError	Risposta di errore dal servizio di calcolo.
DataDisk	Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni sui dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
DataDisksToAttach	Elenco di dischi dati gestiti da collegare.
DataDisksToDetach	Elenco di dischi dati gestiti da scollegare.
DiffDiskOptions	Specifica le impostazioni del disco temporaneo per il disco del sistema operativo.
DiffDiskPlacement	Specifica il posizionamento del disco temporaneo per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se viene configurato per le dimensioni della macchina virtuale altrimenti viene usato ResourceDisk o NvmeDisk. Vedere la documentazione delle dimensioni della macchina virtuale per la macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e la macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare quali dimensioni della macchina virtuale espone un disco della cache. Versione minima dell'API per NvmeDisk: 2024-03-01.
DiffDiskSettings	Specifica le impostazioni del disco temporaneo per il disco del sistema operativo usato dalla macchina virtuale.
DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e alle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.
DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è necessario usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è necessario usare anche l'elemento piano descritto in precedenza.
DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.
DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare forzatamente il disco dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su "true" insieme all'impostazione di detachOption: 'ForceDetach'.
DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
DiskEncryptionSettings	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.
ImageReference	Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.
InnerError	Dettagli dell'errore interno.
KeyVaultKeyReference	Specifica la posizione della chiave di crittografia della chiave in Key Vault.
KeyVaultSecretReference	Specifica il percorso della chiave di crittografia del disco, ovvero un segreto Key Vault.
ManagedDiskParameters	Parametri del disco gestito.
OperatingSystemTypes	Tipo di sistema operativo.
OSDisk	Specifica informazioni sul disco del sistema operativo utilizzato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
securityEncryptionTypes	Specifica EncryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia 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.
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.
StorageProfile	Specifica le impostazioni di archiviazione per i dischi della macchina virtuale.
SubResource
VirtualHardDisk	Disco rigido virtuale.
VMDiskSecurityProfile	Specifica il profilo di sicurezza per il disco gestito.

ApiEntityReference

Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.

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 di errori dell'API.

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

AttachDetachDataDisksRequest

Parametri forniti all'operazione di collegamento e scollegamento dei dischi dati nella macchina virtuale.

Nome	Tipo	Descrizione
dataDisksToAttach	DataDisksToAttach[]	Elenco di dischi dati gestiti da collegare.
dataDisksToDetach	DataDisksToDetach[]	Elenco di dischi dati gestiti da scollegare.

CachingTypes

Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.

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.

DataDisk

Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni sui dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: Nessuno,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare il disco dati della macchina virtuale. Se si usa un'immagine della piattaforma, è necessario usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è necessario usare anche l'elemento piano descritto in precedenza. Vuoto: Questo valore viene usato durante la creazione di un disco dati vuoto. Copia: Questo valore viene usato per creare un disco dati da uno snapshot o da un altro disco. Ripristinare: Questo valore viene usato per creare un disco dati da un punto di ripristino del disco.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato all'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Scollega.
detachOption	DiskDetachOptionTypes	Specifica il comportamento di scollegamento da usare durante il scollegamento di un disco o che è già in corso nel processo di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo precedente di scollegamento del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare il disco in modo forzato dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare il scollegamento di un aggiornamento di un disco dati aBeDetached su 'true' insieme all'impostazione di detachOption: 'ForceDetach'.
diskIOPSReadWrite	integer	Specifica i Read-Write operazioni di I/O al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi vm VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.
diskMBpsReadWrite	integer	Specifica la larghezza di banda in MB al secondo per il disco gestito quando StorageAccountType è UltraSSD_LRS. Restituito solo per i dischi vm VirtualMachine ScaleSet. Può essere aggiornato solo tramite aggiornamenti al set di scalabilità VirtualMachine.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se SourceImage è specificato, il disco rigido virtuale di destinazione non deve esistere.
lun	integer	Specifica il numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
sourceResource	ApiEntityReference	Identificatore della risorsa di origine. Può essere uno snapshot o un punto di ripristino del disco da cui creare un disco.
toBeDetached	boolean	Specifica se il disco dati è in fase di scollegamento da VirtualMachine/VirtualMachineScaleset
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato nel disco.

DataDisksToAttach

Elenco di dischi dati gestiti da collegare.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco dati deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco dati viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco dati viene conservato dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach.
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.
diskId	string	ID del disco dati gestito.
lun	integer	Numero di unità logica del disco dati. Questo valore viene usato per identificare i dischi dati all'interno della macchina virtuale e pertanto deve essere univoco per ogni disco dati collegato a una macchina virtuale. Se non specificato, lun verrebbe assegnato automaticamente.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

DataDisksToDetach

Elenco di dischi dati gestiti da scollegare.

Nome	Tipo	Descrizione
detachOption	DiskDetachOptionTypes	Opzioni supportate disponibili per Scollegare un disco da una macchina virtuale. Per altri dettagli, vedere Riferimento all'oggetto DetachOption.
diskId	string	ID del disco dati gestito.

DiffDiskOptions

Specifica le impostazioni del disco temporaneo per il disco del sistema operativo.

Nome	Tipo	Descrizione
Local	string

DiffDiskPlacement

Specifica il posizionamento del disco temporaneo per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se viene configurato per le dimensioni della macchina virtuale altrimenti viene usato ResourceDisk o NvmeDisk. Vedere la documentazione delle dimensioni della macchina virtuale per la macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e la macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare quali dimensioni della macchina virtuale espone un disco della cache. Versione minima dell'API per NvmeDisk: 2024-03-01.

Nome	Tipo	Descrizione
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

Specifica le impostazioni del disco temporaneo per il disco del sistema operativo usato dalla macchina virtuale.

Nome	Tipo	Descrizione
option	DiffDiskOptions	Specifica le impostazioni del disco temporaneo per il disco del sistema operativo.
placement	DiffDiskPlacement	Specifica il posizionamento del disco temporaneo per il disco del sistema operativo. I valori possibili sono: CacheDisk,ResourceDisk,NvmeDisk. Il comportamento predefinito è: CacheDisk se viene configurato per le dimensioni della macchina virtuale altrimenti viene usato ResourceDisk o NvmeDisk. Vedere la documentazione delle dimensioni della macchina virtuale per la macchina virtuale Windows in https://docs.microsoft.com/azure/virtual-machines/windows/sizes e la macchina virtuale Linux in https://docs.microsoft.com/azure/virtual-machines/linux/sizes per verificare quali dimensioni della macchina virtuale espone un disco della cache. Versione minima dell'API per NvmeDisk: 2024-03-01.

DiskControllerTypes

Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller del disco predefinito se non specificata la macchina virtuale specificata viene creata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e alle dimensioni della macchina virtuale dalla versione minima dell'API specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.

Nome	Tipo	Descrizione
NVMe	string
SCSI	string

DiskCreateOptionTypes

Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è necessario usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è necessario usare anche l'elemento piano descritto in precedenza.

Nome	Tipo	Descrizione
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

DiskDeleteOptionTypes

Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Detach. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.

Nome	Tipo	Descrizione
Delete	string
Detach	string

DiskDetachOptionTypes

Specifica il comportamento di scollegamento da usare durante lo scollegamento di un disco o che è già in fase di scollegamento dalla macchina virtuale. Valori supportati: ForceDetach. detachOption: ForceDetach è applicabile solo per i dischi dati gestiti. Se un tentativo di scollegamento precedente del disco dati non è stato completato a causa di un errore imprevisto dalla macchina virtuale e il disco non viene ancora rilasciato, usare force-detach come ultima opzione di scollegamento per scollegare forzatamente il disco dalla macchina virtuale. Tutte le scritture potrebbero non essere state scaricate quando si usa questo comportamento di scollegamento. Questa funzionalità è ancora in modalità di anteprima e non è supportata per VirtualMachineScaleSet. Per forzare lo scollegamento di un aggiornamento del disco dati aBeDetached su "true" insieme all'impostazione di detachOption: 'ForceDetach'.

Nome	Tipo	Descrizione
ForceDetach	string

DiskEncryptionSetParameters

Specifica l'ID risorsa del set di crittografia dischi gestiti dal cliente per il disco gestito.

Nome	Tipo	Descrizione
id	string	ID risorsa

DiskEncryptionSettings

Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.

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

ImageReference

Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.

Nome	Tipo	Descrizione
communityGalleryImageId	string	Specifica l'ID univoco dell'immagine della raccolta della community per la distribuzione di macchine virtuali. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta della community.
exactVersion	string	Specifica i numeri decimali, la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. Questo campo di sola lettura è diverso da 'version', solo se il valore specificato nel campo 'version' è 'latest'.
id	string	ID risorsa
offer	string	Specifica l'offerta dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale.
publisher	string	Autore dell'immagine.
sharedGalleryImageId	string	Specifica l'ID univoco dell'immagine della raccolta condivisa per la distribuzione della macchina virtuale. Questa operazione può essere recuperata dalla chiamata GET dell'immagine della raccolta condivisa.
sku	string	SKU dell'immagine.
version	string	Specifica la versione dell'immagine della piattaforma o dell'immagine del marketplace usata per creare la macchina virtuale. I formati consentiti sono Major.Minor.Build o 'latest'. Major, Minor e Build sono numeri decimali. Specificare "latest" per usare la versione più recente di un'immagine disponibile in fase di distribuzione. Anche se si usa 'latest', l'immagine della macchina virtuale non verrà aggiornata automaticamente dopo la distribuzione anche se una nuova versione diventa disponibile. Non usare il campo 'version' per la distribuzione di immagini della raccolta, l'immagine della raccolta deve sempre usare il campo 'id' per la distribuzione, per usare la versione più recente dell'immagine della raccolta, è sufficiente impostare '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' nel campo 'id' senza input della versione.

InnerError

Dettagli dell'errore interno.

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

KeyVaultKeyReference

Specifica la posizione della chiave di crittografia della chiave in Key Vault.

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

KeyVaultSecretReference

Specifica il percorso della chiave di crittografia del disco, ovvero un segreto Key Vault.

Nome	Tipo	Descrizione
secretUrl	string	URL che fa riferimento a un segreto in un Key Vault.
sourceVault	SubResource	URL relativo della Key Vault contenente il segreto.

ManagedDiskParameters

Parametri del disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di risorse del set di crittografia del disco gestito del 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.

OperatingSystemTypes

Tipo di sistema operativo.

Nome	Tipo	Descrizione
Linux	string
Windows	string

OSDisk

Specifica informazioni sul disco del sistema operativo utilizzato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

Nome	Tipo	Descrizione
caching	CachingTypes	Specifica i requisiti di memorizzazione nella cache. I valori possibili sono: None,ReadOnly,ReadWrite. Il comportamento predefinito è: Nessuno per l'archiviazione Standard. ReadOnly per l'archiviazione Premium.
createOption	DiskCreateOptionTypes	Specifica la modalità di creazione del disco della macchina virtuale. I valori possibili sono Attach: questo valore viene usato quando si usa un disco specializzato per creare la macchina virtuale. FromImage: Questo valore viene usato quando si usa un'immagine per creare la macchina virtuale. Se si usa un'immagine della piattaforma, è consigliabile usare anche l'elemento imageReference descritto in precedenza. Se si usa un'immagine del marketplace, è consigliabile usare anche l'elemento di piano descritto in precedenza.
deleteOption	DiskDeleteOptionTypes	Specifica se il disco del sistema operativo deve essere eliminato o scollegato al momento dell'eliminazione della macchina virtuale. I valori possibili sono: Elimina. Se questo valore viene usato, il disco del sistema operativo viene eliminato quando viene eliminata la macchina virtuale. Staccare. Se questo valore viene usato, il disco del sistema operativo viene mantenuto dopo l'eliminazione della macchina virtuale. Il valore predefinito è impostato su Scollega. Per un disco del sistema operativo temporaneo, il valore predefinito è impostato su Elimina. L'utente non può modificare l'opzione di eliminazione per un disco del sistema operativo temporaneo.
diffDiskSettings	DiffDiskSettings	Specifica le impostazioni temporanee del disco per il disco del sistema operativo utilizzato dalla macchina virtuale.
diskSizeGB	integer	Specifica le dimensioni di un disco dati vuoto in gigabyte. Questo elemento può essere usato per sovrascrivere le dimensioni del disco in un'immagine di macchina virtuale. La proprietà 'diskSizeGB' è il numero di byte x 1024^3 per il disco e il valore non può essere maggiore di 1023.
encryptionSettings	DiskEncryptionSettings	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15.
image	VirtualHardDisk	Disco rigido virtuale dell'immagine utente di origine. Il disco rigido virtuale verrà copiato prima di essere collegato alla macchina virtuale. Se viene fornito SourceImage, il disco rigido virtuale di destinazione non deve esistere.
managedDisk	ManagedDiskParameters	Parametri del disco gestito.
name	string	Nome del disco.
osType	OperatingSystemTypes	Questa proprietà consente di specificare il tipo di sistema operativo incluso nel disco se si crea una macchina virtuale da un'immagine utente o un disco rigido virtuale specializzato. I valori possibili sono : Windows,Linux.
vhd	VirtualHardDisk	Disco rigido virtuale.
writeAcceleratorEnabled	boolean	Specifica se writeAccelerator deve essere abilitato o disabilitato sul disco.

securityEncryptionTypes

Specifica EncryptionType del disco gestito. È impostato su DiskWithVMGuestState per la crittografia del disco gestito insieme al BLOB VMGuestState, VMGuestStateOnly per la crittografia 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

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

StorageProfile

Specifica le impostazioni di archiviazione per i dischi della macchina virtuale.

Nome	Tipo	Descrizione
dataDisks	DataDisk[]	Specifica i parametri usati per aggiungere un disco dati a una macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.
diskControllerType	DiskControllerTypes	Specifica il tipo di controller del disco configurato per la macchina virtuale. Nota: Questa proprietà verrà impostata sul tipo di controller disco predefinito se non viene specificata la macchina virtuale specificata con 'hyperVGeneration' impostata su V2 in base alle funzionalità del disco del sistema operativo e delle dimensioni della macchina virtuale dalla versione api minima specificata. È necessario deallocare la macchina virtuale prima di aggiornare il tipo di controller del disco, a meno che non si aggiornino le dimensioni della macchina virtuale nella configurazione della macchina virtuale che dealloca in modo implicito e rialloca la macchina virtuale. Versione minima api: 2022-08-01.
imageReference	ImageReference	Specifica informazioni sull'immagine da usare. È possibile specificare informazioni sulle immagini della piattaforma, sulle immagini del marketplace o sulle immagini di macchine virtuali. Questo elemento è necessario quando si vuole usare un'immagine della piattaforma, un'immagine del marketplace o un'immagine di macchina virtuale, ma non viene usata in altre operazioni di creazione.
osDisk	OSDisk	Specifica informazioni sul disco del sistema operativo utilizzato dalla macchina virtuale. Per altre informazioni sui dischi, vedere Informazioni su dischi e dischi rigidi virtuali per le macchine virtuali di Azure.

SubResource

Nome	Tipo	Descrizione
id	string	ID risorsa

VirtualHardDisk

Disco rigido virtuale.

Nome	Tipo	Descrizione
uri	string	Specifica l'uri del disco rigido virtuale.

VMDiskSecurityProfile

Specifica il profilo di sicurezza per il disco gestito.

Nome	Tipo	Descrizione
diskEncryptionSet	DiskEncryptionSetParameters	Specifica l'ID risorsa del set di risorse del set di crittografia del disco gestito del cliente usato per Il disco gestito da Customer Managed Key crittografato con disco del sistema operativo ConfidentialVM e 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 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.