Virtual Machines - Attach Detach Data Disks

Tjänst:: Compute

API-version:: 2026-04-01

Koppla och koppla från datadiskar till/från den virtuella datorn.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
vmName	path	True	string	Namnet på den virtuella datorn.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Begärandetext

Name	Typ	Description
dataDisksToAttach	DataDisksToAttach[]	Listan över hanterade datadiskar som ska kopplas.
dataDisksToDetach	DataDisksToDetach[]	Listan över hanterade datadiskar som ska kopplas från.

Svar

Name	Typ	Description
200 OK	StorageProfile	Azure-operationen slutfördes framgångsrikt.
202 Accepted		Resursåtgärden har godkänts. Sidhuvuden Location: string Retry-After: integer
Other Status Codes	CloudError	Ett oväntat felsvar.

Name

Typ

Description

200 OK

StorageProfile

Azure-operationen slutfördes framgångsrikt.

202 Accepted

Resursåtgärden har godkänts.

Sidhuvuden

Location: string
Retry-After: integer

Other Status Codes

CloudError

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Exempelbegäran

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2026-04-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"
    }
  ]
}


import com.azure.resourcemanager.compute.models.AttachDetachDataDisksRequest;
import com.azure.resourcemanager.compute.models.CachingTypes;
import com.azure.resourcemanager.compute.models.DataDisksToAttach;
import com.azure.resourcemanager.compute.models.DataDisksToDetach;
import com.azure.resourcemanager.compute.models.DiskDeleteOptionTypes;
import com.azure.resourcemanager.compute.models.DiskDetachOptionTypes;
import com.azure.resourcemanager.compute.models.DiskEncryptionSetParameters;
import java.util.Arrays;

/**
 * Samples for VirtualMachines AttachDetachDataDisks.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-04-01/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void
        virtualMachineAttachDetachDataDisksMaximumSetGen(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachines().attachDetachDataDisks("rgcompute", "aaaaaaaaaaaaaaaaaaaa",
            new AttachDetachDataDisksRequest().withDataDisksToAttach(Arrays.asList(new DataDisksToAttach().withDiskId(
                "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d")
                .withLun(1).withCaching(CachingTypes.READ_ONLY).withDeleteOption(DiskDeleteOptionTypes.DELETE)
                .withDiskEncryptionSet(new DiskEncryptionSetParameters().withId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"))
                .withWriteAcceleratorEnabled(true),
                new DataDisksToAttach().withDiskId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e")
                    .withLun(2).withCaching(CachingTypes.READ_WRITE).withDeleteOption(DiskDeleteOptionTypes.DETACH)
                    .withDiskEncryptionSet(new DiskEncryptionSetParameters().withId(
                        "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"))
                    .withWriteAcceleratorEnabled(false)))
                .withDataDisksToDetach(Arrays.asList(new DataDisksToDetach().withDiskId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x")
                    .withDetachOption(DiskDetachOptionTypes.FORCE_DETACH),
                    new DataDisksToDetach().withDiskId(
                        "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z")
                        .withDetachOption(DiskDetachOptionTypes.FORCE_DETACH))),
            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

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: 2026-04-01/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

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

// Generated from example definition: 2026-04-01/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{
			{
				Lun:    to.Ptr[int32](1),
				DiskID: 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}"),
				},
				Caching:                 to.Ptr(armcompute.CachingTypesReadOnly),
				DeleteOption:            to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
				WriteAcceleratorEnabled: to.Ptr(true),
			},
			{
				Lun:    to.Ptr[int32](2),
				DiskID: 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}"),
				},
				Caching:                 to.Ptr(armcompute.CachingTypesReadWrite),
				DeleteOption:            to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
				WriteAcceleratorEnabled: to.Ptr(false),
			},
		},
		DataDisksToDetach: []*armcompute.DataDisksToDetach{
			{
				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"),
				DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
			},
		},
	}, 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 poll 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 = armcompute.VirtualMachinesClientAttachDetachDataDisksResponse{
	// 	StorageProfile: armcompute.StorageProfile{
	// 		ImageReference: &armcompute.ImageReference{
	// 			Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 			Offer: to.Ptr("WindowsServer"),
	// 			SKU: to.Ptr("2016-Datacenter"),
	// 			Version: to.Ptr("latest"),
	// 		},
	// 		OSDisk: &armcompute.OSDisk{
	// 			OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 			Name: to.Ptr("myOsDisk"),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			},
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 		},
	// 		DataDisks: []*armcompute.DataDisk{
	// 			{
	// 				Lun: to.Ptr[int32](1),
	// 				Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 				Caching: to.Ptr(armcompute.CachingTypesReadOnly),
	// 				ManagedDisk: &armcompute.ManagedDiskParameters{
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					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}"),
	// 					},
	// 				},
	// 				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
	// 				DiskSizeGB: to.Ptr[int32](30),
	// 				WriteAcceleratorEnabled: to.Ptr(true),
	// 			},
	// 			{
	// 				Lun: to.Ptr[int32](2),
	// 				Name: to.Ptr("vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
	// 				CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 				Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 				ManagedDisk: &armcompute.ManagedDiskParameters{
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					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}"),
	// 					},
	// 				},
	// 				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
	// 				DiskSizeGB: to.Ptr[int32](100),
	// 				WriteAcceleratorEnabled: to.Ptr(false),
	// 			},
	// 		},
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to 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: 2026-04-01/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
 */
async function virtualMachineAttachDetachDataDisksMaximumSetGen() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.attachDetachDataDisks(
    "rgcompute",
    "aaaaaaaaaaaaaaaaaaaa",
    {
      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",
        },
      ],
    },
  );
  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

Exempelsvar

Statuskod:: 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
    }
  ]
}

Statuskod:: 202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Exempelbegäran

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2026-04-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"
    }
  ]
}


import com.azure.resourcemanager.compute.models.AttachDetachDataDisksRequest;
import com.azure.resourcemanager.compute.models.DataDisksToAttach;
import com.azure.resourcemanager.compute.models.DataDisksToDetach;
import java.util.Arrays;

/**
 * Samples for VirtualMachines AttachDetachDataDisks.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-04-01/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void
        virtualMachineAttachDetachDataDisksMinimumSetGen(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachines().attachDetachDataDisks("rgcompute", "azure-vm",
            new AttachDetachDataDisksRequest().withDataDisksToAttach(Arrays.asList(new DataDisksToAttach().withDiskId(
                "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d")))
                .withDataDisksToDetach(Arrays.asList(new DataDisksToDetach().withDiskId(
                    "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"))),
            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

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: 2026-04-01/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

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

// Generated from example definition: 2026-04-01/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 poll 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 = armcompute.VirtualMachinesClientAttachDetachDataDisksResponse{
	// 	StorageProfile: armcompute.StorageProfile{
	// 		ImageReference: &armcompute.ImageReference{
	// 			Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 			Offer: to.Ptr("WindowsServer"),
	// 			SKU: to.Ptr("2016-Datacenter"),
	// 			Version: to.Ptr("latest"),
	// 		},
	// 		OSDisk: &armcompute.OSDisk{
	// 			OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 			Name: to.Ptr("myOsDisk"),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			},
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 		},
	// 		DataDisks: []*armcompute.DataDisk{
	// 			{
	// 				Lun: to.Ptr[int32](0),
	// 				Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 				Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 				ManagedDisk: &armcompute.ManagedDiskParameters{
	// 					StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				},
	// 				DiskSizeGB: to.Ptr[int32](30),
	// 			},
	// 		},
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to 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: 2026-04-01/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
 */
async function virtualMachineAttachDetachDataDisksMinimumSetGen() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.attachDetachDataDisks("rgcompute", "azure-vm", {
    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",
      },
    ],
  });
  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

Exempelsvar

Statuskod:: 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
    }
  ]
}

Statuskod:: 202

location: https://foo.com/operationstatus

Definitioner

Name	Description
AdditionalDiskProperties	Specificerar ytterligare egenskaper för en hanterad disk som kan ställas in vid tidpunkten för den implicita skapandet av disken.
ApiEntityReference	API-entitetsreferensen.
ApiError	Api-fel.
ApiErrorBase	Api-felbas.
AttachDetachDataDisksRequest	Anger indata för att ansluta och koppla från en lista över hanterade datadiskar.
AvailabilityPolicyDiskDelay	Avgör hur du hanterar diskar med långsam I/O.
CachingTypes	Anger cachelagringskraven. Möjliga värden är: None,ReadOnly,ReadWrite. Standardvärdena är: Ingen för Standard Storage. ReadOnly för Premium-lagring
CloudError	Ett felsvar från Compute-tjänsten.
DataDisk	Beskriver en datadisk.
DataDisksToAttach	Beskriver den datadisk som ska kopplas.
DataDisksToDetach	Beskriver den datadisk som ska kopplas från.
DiffDiskOptions	Anger det tillfälliga diskalternativet för operativsystemdisken.
DiffDiskPlacement	Anger den tillfälliga diskplaceringen för operativsystemdisken. Den här egenskapen kan användas av användaren i begäran för att välja plats, dvs. cachedisk, resursdisk eller nvme-diskutrymme för tillfällig OS-disketablering. Mer information om krav för tillfällig os-diskstorlek finns i Krav på tillfällig OS-diskstorlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Lägsta api-version för NvmeDisk: 2024-03-01.
DiffDiskSettings	Beskriver parametrarna för tillfälliga diskinställningar som kan anges för operativsystemdisken. Obs! De tillfälliga diskinställningarna kan bara anges för hanterad disk.
DiskApiVersion	Specificerar Disk API-versionen som används vid tillämpning av additionalDiskProperties på hanterade diskar. Värdet måste vara i formatet YYYYY-MM-DD.
DiskAvailabilityPolicy	Vid tillgänglighet eller anslutningsproblem med disken, ange hur din VM fungerar.
DiskControllerTypes	Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn och VirtualMachineScaleSet. Den här egenskapen stöds endast för virtuella datorer vars operativsystemdisk och VM-SKU stöder generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), kontrollera funktionen HyperVGenerations som returneras som en del av vm-sku-funktionerna i svaret från Microsoft.Compute SKU:er api för regionen innehåller V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Mer information om de typer av diskkontrollanter som stöds finns i https://aka.ms/azure-diskcontrollertypes.
DiskCreateOptionTypes	Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.
DiskDeleteOptionTypes	Anger beteendet för den hanterade disken när den virtuella datorn tas bort, till exempel om den hanterade disken tas bort eller kopplas från. Värden som stöds är: Ta bort. Om det här värdet används tas den hanterade disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls den hanterade disken när den virtuella datorn tas bort. Lägsta API-version: 2021-03-01.
DiskDetachOptionTypes	Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds är: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".
DiskEncryptionSetParameters	Beskriver parametern för resurs-ID för kundhanterad diskkrypteringsuppsättning som kan anges för disk. Obs! Diskkrypteringsuppsättningens resurs-ID kan bara anges för hanterad disk. Mer information finns i https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Beskriver krypteringsinställningar för en disk
ImageReference	Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.
InnerError	Inre felinformation.
KeyVaultKeyReference	Beskriver en referens till Key Vault Key
KeyVaultSecretReference	Beskriver en referens till Key Vault Secret
ManagedDiskParameters	Parametrarna för en hanterad disk.
ManagedDiskProperties	Specificerar egenskaperna hos en hanterad disk som kan ställas in vid tidpunkten för den implicita skapandet av disken.
NetworkAccessPolicy	Princip för åtkomst till disken via nätverk.
OperatingSystemTypes	Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från en anpassad avbildning. Möjliga värden är: Windows,Linux.
OSDisk	Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.
SecurityEncryptionTypes	Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.
StorageAccountTypes	Anger lagringskontotypen för den hanterade disken. Kontotypen hanterad os-disklagring kan bara anges när du skapar skalningsuppsättningen. Obs! UltraSSD_LRS kan bara användas med datadiskar. Det går inte att använda med OS Disk. Standard_LRS använder Standard HDD. StandardSSD_LRS använder Standard SSD. Premium_LRS använder Premium SSD. UltraSSD_LRS använder Ultra Disk. Premium_ZRS använder Premium SSD-zonredundant lagring. StandardSSD_ZRS använder Standard SSD-zonredundant lagring. Mer information om diskar som stöds för virtuella Windows-datorer finns i https://docs.microsoft.com/azure/virtual-machines/windows/disks-types och, för virtuella Linux-datorer, se https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Specificerar typen av lagringsfeldomänjustering för disken.
StorageProfile	Anger lagringsinställningarna för de virtuella datordiskarna.
SubResource
VirtualHardDisk	Beskriver URI för en disk.
VMDiskSecurityProfile	Anger säkerhetsprofilinställningarna för den hanterade disken. Obs! Det kan bara anges för konfidentiella virtuella datorer.

AdditionalDiskProperties

Objekt

Specificerar ytterligare egenskaper för en hanterad disk som kan ställas in vid tidpunkten för den implicita skapandet av disken.

Name	Typ	Description
managedDiskProperties	ManagedDiskProperties	Specificerar de hanterade diskegenskaper som kan ställas in vid tidpunkten för implicit skapande av disken.

ApiEntityReference

Objekt

API-entitetsreferensen.

Name	Typ	Description
id	string	ARM-resurs-ID i form av /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Objekt

Api-fel.

Name	Typ	Description
code	string	Felkoden.
details	ApiErrorBase[]	Api-felinformationen
innererror	InnerError	Api:ets inre fel
message	string	Felmeddelandet.
target	string	Målet för det specifika felet.

ApiErrorBase

Objekt

Api-felbas.

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet.
target	string	Målet för det specifika felet.

AttachDetachDataDisksRequest

Objekt

Anger indata för att ansluta och koppla från en lista över hanterade datadiskar.

Name	Typ	Description
dataDisksToAttach	DataDisksToAttach[]	Listan över hanterade datadiskar som ska kopplas.
dataDisksToDetach	DataDisksToDetach[]	Listan över hanterade datadiskar som ska kopplas från.

AvailabilityPolicyDiskDelay

Uppräkning

Avgör hur du hanterar diskar med långsam I/O.

Värde	Description
None	Standardinställningen är till beteende utan specificerad tillgänglighetspolicy, vilket är VM-omstart vid långsam disk-I/O.
AutomaticReattach	Vid ett disk-I/O-fel eller långsam respons, prova att koppla bort och sedan sätta tillbaka skivan.

CachingTypes

Uppräkning

Anger cachelagringskraven. Möjliga värden är: None,ReadOnly,ReadWrite. Standardvärdena är: Ingen för Standard Storage. ReadOnly för Premium-lagring

Värde	Description
None
ReadOnly
ReadWrite

CloudError

Objekt

Ett felsvar från Compute-tjänsten.

Name	Typ	Description
error	ApiError	Api-fel.

DataDisk

Objekt

Beskriver en datadisk.

Name	Typ	Description
caching	CachingTypes	Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.
createOption	DiskCreateOptionTypes	Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa datadisken för den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.
deleteOption	DiskDeleteOptionTypes	Anger om datadisken ska tas bort eller kopplas från vid borttagning av virtuella datorer. Möjliga värden är: Ta bort. Om det här värdet används tas datadisken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls datadisken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från.
detachOption	DiskDetachOptionTypes	Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".
diskIOPSReadWrite	integer (int64)	Anger Read-Write IOPS för den hanterade disken när StorageAccountType UltraSSD_LRS.
diskMBpsReadWrite	integer (int64)	Anger bandbredden i MB per sekund för den hanterade disken när StorageAccountType UltraSSD_LRS.
diskSizeGB	integer (int32)	Anger storleken på en tom datadisk i gigabyte. Det här elementet kan användas för att skriva över storleken på disken i en virtuell datorbild. Egenskapen "diskSizeGB" är antalet byte x 1024^3 för disken och värdet får inte vara större än 1023.
image	VirtualHardDisk	Den virtuella hårddisken för källanvändarens avbildning. Den virtuella hårddisken kopieras innan den ansluts till den virtuella datorn. Om SourceImage tillhandahålls får den virtuella målhårdenheten inte finnas.
lun	integer (int32)	Anger datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till en virtuell dator.
managedDisk	ManagedDiskParameters	Parametrarna för hanterade diskar.
name	string	Disknamnet.
sourceResource	ApiEntityReference	Källresursidentifieraren. Det kan vara en ögonblicksbild eller en diskåterställningspunkt för att skapa en disk.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specificerar typen av lagringsfeldomänjustering för disken.
toBeDetached	boolean	Anger om datadisken håller på att kopplas från VirtualMachine/VirtualMachineScaleset
vhd	VirtualHardDisk	Den virtuella hårddisken.
writeAcceleratorEnabled	boolean	Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

DataDisksToAttach

Objekt

Beskriver den datadisk som ska kopplas.

Name	Typ	Description
caching	CachingTypes	Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.
deleteOption	DiskDeleteOptionTypes	Anger om datadisken ska tas bort eller kopplas från vid borttagning av virtuella datorer. Möjliga värden är: Ta bort. Om det här värdet används tas datadisken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls datadisken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från.
diskEncryptionSet	DiskEncryptionSetParameters	Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disken.
diskId	string	ID för den hanterade datadisken.
lun	integer (int32)	Datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till en virtuell dator. Om det inte anges tilldelas lun automatiskt.
writeAcceleratorEnabled	boolean	Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

DataDisksToDetach

Objekt

Beskriver den datadisk som ska kopplas från.

Name	Typ	Description
detachOption	DiskDetachOptionTypes	Tillgängliga alternativ som stöds för Att koppla från en disk från en virtuell dator. Mer information finns i Referens för DetachOption-objekt.
diskId	string	ID för den hanterade datadisken.

DiffDiskOptions

Uppräkning

Anger det tillfälliga diskalternativet för operativsystemdisken.

Värde	Description
Local

DiffDiskPlacement

Uppräkning

Anger den tillfälliga diskplaceringen för operativsystemdisken. Den här egenskapen kan användas av användaren i begäran för att välja plats, dvs. cachedisk, resursdisk eller nvme-diskutrymme för tillfällig OS-disketablering. Mer information om krav för tillfällig os-diskstorlek finns i Krav på tillfällig OS-diskstorlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Lägsta api-version för NvmeDisk: 2024-03-01.

Värde	Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Objekt

Beskriver parametrarna för tillfälliga diskinställningar som kan anges för operativsystemdisken. Obs! De tillfälliga diskinställningarna kan bara anges för hanterad disk.

Name	Typ	Description
enableFullCaching	boolean	Specificerar om full caching ska aktiveras för denna VM, vilket kommer att cachelagra OS-disken lokalt på värden och göra denna VM mer motståndskraftig mot lagringsavbrott
option	DiffDiskOptions	Anger tillfälliga diskinställningar för operativsystemdisken.
placement	DiffDiskPlacement	Anger den tillfälliga diskplaceringen för operativsystemdisken. Möjliga värden är: CacheDisk,ResourceDiskNvmeDisk. Standardbeteendet är: CacheDisk om en har konfigurerats för den virtuella datorns storlek, annars används ResourceDisk eller NvmeDisk. Se dokumentationen om VM-storlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/sizes och virtuell Linux-dator på https://docs.microsoft.com/azure/virtual-machines/linux/sizes för att kontrollera vilka VM-storlekar som exponerar en cachedisk. Lägsta api-version för NvmeDisk: 2024-03-01.

DiskApiVersion

Uppräkning

Specificerar Disk API-versionen som används vid tillämpning av additionalDiskProperties på hanterade diskar. Värdet måste vara i formatet YYYYY-MM-DD.

Värde	Description
2025-01-02	Disk RP API-versionen 2025-01-01.
2026-03-02	Disk RP API-versionen 2026-03-02.

DiskAvailabilityPolicy

Objekt

Vid tillgänglighet eller anslutningsproblem med disken, ange hur din VM fungerar.

Name	Typ	Description
actionOnDiskDelay	AvailabilityPolicyDiskDelay	Avgör hur du hanterar diskar med långsam I/O.

DiskControllerTypes

Uppräkning

Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn och VirtualMachineScaleSet. Den här egenskapen stöds endast för virtuella datorer vars operativsystemdisk och VM-SKU stöder generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), kontrollera funktionen HyperVGenerations som returneras som en del av vm-sku-funktionerna i svaret från Microsoft.Compute SKU:er api för regionen innehåller V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Mer information om de typer av diskkontrollanter som stöds finns i https://aka.ms/azure-diskcontrollertypes.

Värde	Description
SCSI
NVMe

DiskCreateOptionTypes

Uppräkning

Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.

Värde	Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Uppräkning

Anger beteendet för den hanterade disken när den virtuella datorn tas bort, till exempel om den hanterade disken tas bort eller kopplas från. Värden som stöds är: Ta bort. Om det här värdet används tas den hanterade disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls den hanterade disken när den virtuella datorn tas bort. Lägsta API-version: 2021-03-01.

Värde	Description
Delete
Detach

DiskDetachOptionTypes

Uppräkning

Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds är: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".

Värde	Description
ForceDetach

DiskEncryptionSetParameters

Objekt

Beskriver parametern för resurs-ID för kundhanterad diskkrypteringsuppsättning som kan anges för disk. Obs! Diskkrypteringsuppsättningens resurs-ID kan bara anges för hanterad disk. Mer information finns i https://aka.ms/mdssewithcmkoverview.

Name	Typ	Description
id	string	Resurs-ID

DiskEncryptionSettings

Objekt

Beskriver krypteringsinställningar för en disk

Name	Typ	Description
diskEncryptionKey	KeyVaultSecretReference	Anger platsen för diskkrypteringsnyckeln, som är en Nyckelvalvshemlighet.
enabled	boolean	Anger om diskkryptering ska aktiveras på den virtuella datorn.
keyEncryptionKey	KeyVaultKeyReference	Anger platsen för nyckelkrypteringsnyckeln i Key Vault.

ImageReference

Objekt

Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.

Name	Typ	Description
communityGalleryImageId	string	Angav communitygalleriets unika ID för vm-distribution. Det här kan hämtas från get-anropet för communitygalleribilden.
exactVersion	string	Anger i decimaltal, vilken version av plattformsbild eller marketplace-avbildning som används för att skapa den virtuella datorn. Det här skrivskyddade fältet skiljer sig från "version", endast om värdet som anges i fältet "version" är "senaste".
id	string	Resurs-ID
offer	string	Anger erbjudandet för plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn.
publisher	string	Bildutgivaren.
sharedGalleryImageId	string	Angav det unika ID:t för den delade galleriavbildningen för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.
sku	string	Avbildnings-SKU:n.
version	string	Anger vilken version av plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn. De tillåtna formaten är Major.Minor.Build eller "latest". Major, Minor och Build är decimaltal. Ange "senaste" för att använda den senaste versionen av en avbildning som är tillgänglig vid distributionstillfället. Även om du använder "senaste" uppdateras inte den virtuella datoravbildningen automatiskt efter distributionstiden även om en ny version blir tillgänglig. Använd inte fältet "version" för distribution av galleribilder. Galleribild bör alltid använda id-fältet för distribution, för att använda den senaste versionen av galleribilden, ange bara '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' i fältet "id" utan indata från versionen.

InnerError

Objekt

Inre felinformation.

Name	Typ	Description
errordetail	string	Det interna felmeddelandet eller undantagsdumpen.
exceptiontype	string	Typen av undantag.

KeyVaultKeyReference

Objekt

Beskriver en referens till Key Vault Key

Name	Typ	Description
keyUrl	string	URL:en som refererar till en nyckelkrypteringsnyckel i Key Vault.
sourceVault	SubResource	Den relativa URL:en för nyckelvalvet som innehåller nyckeln.

KeyVaultSecretReference

Objekt

Beskriver en referens till Key Vault Secret

Name	Typ	Description
secretUrl	string	URL:en som refererar till en hemlighet i ett Nyckelvalv.
sourceVault	SubResource	Den relativa URL:en för nyckelvalvet som innehåller hemligheten.

ManagedDiskParameters

Objekt

Parametrarna för en hanterad disk.

Name	Typ	Description
additionalDiskProperties	AdditionalDiskProperties	Specificerar ytterligare egenskaper för den hanterade disken som kan ställas in vid tidpunkten för implicit skapande av disken. Denna egendom registreras inte för återställningspoäng.
diskEncryptionSet	DiskEncryptionSetParameters	Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disken.
id	string	Resurs-ID
securityProfile	VMDiskSecurityProfile	Anger säkerhetsprofilen för den hanterade disken.
storageAccountType	StorageAccountTypes	Anger lagringskontotypen för den hanterade disken. Obs! UltraSSD_LRS endast kan användas med datadiskar kan den inte användas med OS-disk.

ManagedDiskProperties

Objekt

Specificerar egenskaperna hos en hanterad disk som kan ställas in vid tidpunkten för den implicita skapandet av disken.

Name	Typ	Description
availabilityPolicy	DiskAvailabilityPolicy	Vid tillgänglighet eller anslutningsproblem med disken, ange hur din VM fungerar.
burstingEnabled	boolean	Ställ in på true för att aktivera burst-prestanda utöver diskens etablerade prestandamål. Bursting är inaktiverat som standard. Gäller inte för Ultra-diskar.
diskAccessId	string	Azure-resurs-ID för DiskAccess-resursen för användning av privata endpoints på diskar.
diskIOPSReadOnly	integer (int64)	Det totala antalet IOPS som tillåts för alla virtuella datorer som monterar den delade disken som ReadOnly. En åtgärd kan överföra mellan 4k och 256 000 byte.
diskMBpsReadOnly	integer (int64)	Det totala dataflödet (Mbit/s) som tillåts för alla virtuella datorer som monterar den delade disken som ReadOnly. Mbit/s innebär miljontals byte per sekund – MB använder här ISO-notationen, med krafter på 10.
logicalSectorSize	integer (int32)	Logisk sektorstorlek i byte för Ultra Disks. Värden som stöds är 512 och 4096. 4096 är standardvärdet.
maxShares	integer (int32) minimum: 1	Det maximala antalet virtuella datorer som kan anslutas till disken samtidigt. Värdet större än ett anger en disk som kan monteras på flera virtuella datorer samtidigt. Gäller endast datadiskar.
networkAccessPolicy	NetworkAccessPolicy	Princip för åtkomst till disken via nätverk.
optimizedForFrequentAttach	boolean	Att sätta denna egenskap till true förbättrar tillförlitligheten och prestandan hos datadiskar som ofta (mer än 5 gånger per dag) kopplas bort från en virtuell maskin och ansluts till en annan. Den här egenskapen bör inte anges för diskar som inte kopplas från och ansluts ofta eftersom det gör att diskarna inte överensstämmer med feldomänen för den virtuella datorn.
performancePlus	boolean	Ange den här flaggan till true för att få en ökning av prestandamålet för den distribuerade disken. Den här flaggan kan bara anges när disken skapas och kan inte inaktiveras när den har aktiverats.
tier	string	Prestandanivån på disken (t.ex. P4, S10) som beskrivs här: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Gäller inte för Ultra-diskar.

NetworkAccessPolicy

Uppräkning

Princip för åtkomst till disken via nätverk.

Värde	Description
AllowAll	Disken kan exporteras eller laddas upp från vilket nätverk som helst.
AllowPrivate	Disken kan exporteras eller laddas upp med hjälp av en DiskAccess-resurss privata slutpunkter.
DenyAll	Det går inte att exportera disken.

OperatingSystemTypes

Uppräkning

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från en anpassad avbildning. Möjliga värden är: Windows,Linux.

Värde	Description
Windows
Linux

OSDisk

Objekt

Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

Name	Typ	Description
caching	CachingTypes	Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.
createOption	DiskCreateOptionTypes	Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare.
deleteOption	DiskDeleteOptionTypes	Anger om OS-disken ska tas bort eller kopplas från när den virtuella datorn tas bort. Möjliga värden är: Ta bort. Om det här värdet används tas OS-disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls os-disken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från. För en tillfällig OS-disk är standardvärdet inställt på Ta bort. Användaren kan inte ändra borttagningsalternativet för en tillfällig OS-disk.
diffDiskSettings	DiffDiskSettings	Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn.
diskSizeGB	integer (int32)	Anger storleken på en tom datadisk i gigabyte. Det här elementet kan användas för att skriva över storleken på disken i en virtuell datorbild. Egenskapen "diskSizeGB" är antalet byte x 1024^3 för disken och värdet får inte vara större än 1023.
encryptionSettings	DiskEncryptionSettings	Anger krypteringsinställningarna för OS-disken. Lägsta API-version: 2015-06-15.
image	VirtualHardDisk	Den virtuella hårddisken för källanvändarens avbildning. Den virtuella hårddisken kopieras innan den ansluts till den virtuella datorn. Om SourceImage tillhandahålls får den virtuella målhårdenheten inte finnas.
managedDisk	ManagedDiskParameters	Parametrarna för hanterade diskar.
name	string	Disknamnet.
osType	OperatingSystemTypes	Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från användaravbildning eller en specialiserad virtuell hårddisk. Möjliga värden är: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Specificerar typen av lagringsfeldomänjustering för disken.
vhd	VirtualHardDisk	Den virtuella hårddisken.
writeAcceleratorEnabled	boolean	Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

SecurityEncryptionTypes

Uppräkning

Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.

Värde	Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Uppräkning

Anger lagringskontotypen för den hanterade disken. Kontotypen hanterad os-disklagring kan bara anges när du skapar skalningsuppsättningen. Obs! UltraSSD_LRS kan bara användas med datadiskar. Det går inte att använda med OS Disk. Standard_LRS använder Standard HDD. StandardSSD_LRS använder Standard SSD. Premium_LRS använder Premium SSD. UltraSSD_LRS använder Ultra Disk. Premium_ZRS använder Premium SSD-zonredundant lagring. StandardSSD_ZRS använder Standard SSD-zonredundant lagring. Mer information om diskar som stöds för virtuella Windows-datorer finns i https://docs.microsoft.com/azure/virtual-machines/windows/disks-types och, för virtuella Linux-datorer, se https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Värde	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Uppräkning

Specificerar typen av lagringsfeldomänjustering för disken.

Värde	Description
Aligned	Feldomäner för disklagring mappas till beräkningsfeldomäner. Distributionen misslyckas om disken inte stöder tillräckligt många feldomäner.
BestEffortAligned	Försök att mappa lagringsfeldomäner till beräkningsfeldomäner. Diskar är ojusterade om disken inte stöder tillräckligt många feldomäner.

StorageProfile

Objekt

Anger lagringsinställningarna för de virtuella datordiskarna.

Name	Typ	Description
alignRegionalDisksToVMZone	boolean	Anger om de regionala diskarna ska justeras/flyttas till vm-zonen. Detta gäller endast för virtuella datorer med placeringsegenskapen inställd. Observera att den här ändringen inte kan ångras. Lägsta API-version: 2024-11-01.
dataDisks	DataDisk[]	Anger de parametrar som används för att lägga till en datadisk till en virtuell dator. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.
diskApiVersion	DiskApiVersion	Specificerar Disk API-versionen som används vid tillämpning av additionalDiskProperties på hanterade diskar. Värdet måste vara i formatet YYYY-MM-DD (t.ex. "2026-03-02").
diskControllerType	DiskControllerTypes	Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn. Obs! Den här egenskapen anges till standardtypen för diskkontrollanten om den inte anges, förutsatt att den virtuella datorn skapas med "hyperVGeneration" inställt på V2 baserat på funktionerna för operativsystemdisken och VM-storleken från den angivna lägsta API-versionen. Du måste frigöra den virtuella datorn innan du uppdaterar dess typ av diskkontrollant såvida du inte uppdaterar vm-storleken i VM-konfigurationen som implicit frigör och omallokerar den virtuella datorn. Lägsta API-version: 2022-08-01.
imageReference	ImageReference	Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder.
osDisk	OSDisk	Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

SubResource

Objekt

Name	Typ	Description
id	string	Resurs-ID

VirtualHardDisk

Objekt

Beskriver URI för en disk.

Name	Typ	Description
uri	string	Anger den virtuella hårddiskens URI.

VMDiskSecurityProfile

Objekt

Anger säkerhetsprofilinställningarna för den hanterade disken. Obs! Det kan bara anges för konfidentiella virtuella datorer.

Name	Typ	Description
diskEncryptionSet	DiskEncryptionSetParameters	Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disk som används för customer managed key encrypted ConfidentialVM OS Disk och VMGuest blob.
securityEncryptionType	SecurityEncryptionTypes	Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.