Virtual Machines - Attach Detach Data Disks

Szolgáltatás:

Compute

API-verzió:

2026-03-01

Adatlemezek csatolása és leválasztása a virtuális géphez vagy onnan.

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

URI-paraméterek

Name	In	Kötelező	Típus	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Az erőforráscsoport neve. A név nem megkülönbözteti a kis- és nagybetűket.
subscriptionId	path	True	string minLength: 1	A cél-előfizetés azonosítója.
vmName	path	True	string	A virtuális gép neve.
api-version	query	True	string minLength: 1	A művelethez használni kívánt API-verzió.

Kérelem törzse

Name	Típus	Description
dataDisksToAttach	DataDisksToAttach[]	A csatolandó felügyelt adatlemezek listája.
dataDisksToDetach	DataDisksToDetach[]	A leválasztandó felügyelt adatlemezek listája.

Válaszok

Name	Típus	Description
200 OK	StorageProfile	Az Azure-művelet sikeresen befejeződött.
202 Accepted		Az erőforrásművelet elfogadott. Fejlécek Location: string Retry-After: integer
Other Status Codes	CloudError	Váratlan hibaválasz.

Biztonság

azure_auth

Azure Active Directory Oauth2-folyamat.

Típus: oauth2
Folyamat: implicit
Engedélyezési URL: https://login.microsoftonline.com/common/oauth2/authorize

Hatókörök

Name	Description
user_impersonation	a felhasználói fiók megszemélyesítése

Példák

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Mintakérelem

HTTP

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

Java

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

Python

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

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

// Generated from example definition: 2026-03-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

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: 2026-03-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

Mintaválasz

Állapotkód:

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

Állapotkód:

202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Mintakérelem

HTTP

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

Java

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

Python

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

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

// Generated from example definition: 2026-03-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

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: 2026-03-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

Mintaválasz

Állapotkód:

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

Állapotkód:

202

location: https://foo.com/operationstatus

Definíciók

Name	Description
ApiEntityReference	Az API-entitás referenciája.
ApiError	Api-hiba.
ApiErrorBase	Api-hibabázis.
AttachDetachDataDisksRequest	Megadja a felügyelt adatlemezek listájának csatolásához és leválasztáshoz szükséges bemenetet.
CachingTypes	Megadja a gyorsítótárazási követelményeket. A lehetséges értékek a következők: None,ReadOnly,ReadWrite. Az alapértelmezett értékek a következők: Nincs a Standard Storage esetében. Csak olvasható prémium szintű tároláshoz
CloudError	Hibaválasz a Compute szolgáltatástól.
DataDisk	Adatlemezt ír le.
DataDisksToAttach	A csatolandó adatlemezt ismerteti.
DataDisksToDetach	A leválasztani kívánt adatlemezt ismerteti.
DiffDiskOptions	Az operációsrendszer-lemez rövid élettartamú lemezbeállítását adja meg.
DiffDiskPlacement	Az operációsrendszer-lemez rövid élettartamú lemezelhelyezését adja meg. Ezt a tulajdonságot a felhasználó használhatja a kérésben a hely kiválasztásához, azaz gyorsítótárlemez, erőforráslemez vagy nvme lemezterület kiválasztásához a rövid élettartamú operációsrendszer-lemezek kiépítéséhez. A rövid élettartamú operációsrendszer-lemez méretére vonatkozó követelményekről további információt a Windows rendszerű virtuális gépek rövid élettartamú operációsrendszer-lemezméreti követelményeit https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements- és Linux rendszerű virtuális gépeken https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Az NvmeDisk minimális API-verziója: 2024-03-01.
DiffDiskSettings	Az operációs rendszer lemezéhez megadható rövid élettartamú lemezbeállítások paramétereit ismerteti. Megjegyzés: A rövid élettartamú lemezbeállítások csak felügyelt lemezhez adhatók meg.
DiskControllerTypes	Megadja a virtuális géphez és a VirtualMachineScaleSethez konfigurált lemezvezérlő típusát. Ez a tulajdonság csak azokhoz a virtuális gépekhez támogatott, amelyek operációsrendszer-lemeze és virtuálisgép-termékváltozata támogatja a 2. generációt (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), ellenőrizze a Virtuális gépek termékváltozatának részeként visszaadott HyperVGenerations képességet a régióhoz tartozó Microsoft.Compute SKU API válaszában(https://docs.microsoft.com/rest/api/compute/resourceskus/list). A támogatott lemezvezérlő-típusokkal kapcsolatos további információkért tekintse meg a következőt https://aka.ms/azure-diskcontrollertypes:
DiskCreateOptionTypes	Meghatározza a virtuálisgép-lemez létrehozásának módját. A lehetséges értékek csatolása : Ezt az értéket akkor használja a rendszer, ha speciális lemezt használ a virtuális gép létrehozásához. FromImage: Ez az érték akkor használatos, ha rendszerképet használ a virtuális gép létrehozásához. Ha platformrendszerképet használ, használja a fent leírt imageReference elemet is. Ha piactéri rendszerképet használ, használja a korábban ismertetett tervelemet is. Üres: Ez az érték üres adatlemez létrehozásakor használatos. Másolás: Ez az érték egy pillanatképből vagy egy másik lemezből származó adatlemez létrehozásához használható. Visszaállítás: Ez az érték egy lemez-visszaállítási pontból származó adatlemez létrehozásához használható.
DiskDeleteOptionTypes	Meghatározza a felügyelt lemez viselkedését a virtuális gép törlésekor, például azt, hogy a felügyelt lemez törölve vagy leválasztva van-e. A támogatott értékek a következők: Törlés. Ha ezt az értéket használja, a rendszer törli a felügyelt lemezt a virtuális gép törlésekor. Elválaszt. Ha ezt az értéket használja, a felügyelt lemez megmarad a virtuális gép törlése után. Minimális API-verzió: 2021-03-01.
DiskDetachOptionTypes	Megadja a lemez leválasztása során használandó vagy a virtuális gépről már leválasztás alatt álló leválasztási viselkedést. A támogatott értékek a következők: ForceDetach. detachOption: A ForceDetach csak felügyelt adatlemezekre alkalmazható. Ha az adatlemez korábbi leválasztási kísérlete nem fejeződött be a virtuális gép váratlan hibája miatt, és a lemez még mindig nem lett felszabadítva, akkor használja a kényszerített leválasztást végső megoldásként a lemez kényszerített leválasztásához a virtuális gépről. Lehet, hogy a leválasztott viselkedés használatakor nem minden írás lett kiürítve. Ez a funkció még előzetes verzióban érhető el. Adatlemez frissítésének kényszerített leválasztása a "true" értékre, valamint a detachOption: "ForceDetach" beállítással együtt.
DiskEncryptionSetParameters	A lemezhez megadható ügyfél által felügyelt lemeztitkosítási csoport erőforrás-azonosítójának paraméterét ismerteti. Megjegyzés: A lemeztitkosítási csoport erőforrás-azonosítója csak felügyelt lemezhez adható meg. További részletekért tekintse meg https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Lemez titkosítási beállításainak ismertetése
ImageReference	Megadja a használni kívánt kép adatait. Megadhatja a platformrendszerképekről, a marketplace-rendszerképekről vagy a virtuálisgép-rendszerképekről szóló információkat. Ez az elem akkor szükséges, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-lemezképet szeretne használni, de más létrehozási műveletekben nem használja. MEGJEGYZÉS: A képhivatkozás közzétevője és ajánlata csak a méretezési csoport létrehozásakor állítható be.
InnerError	Belső hiba részletei.
KeyVaultKeyReference	A Key Vault-kulcsra mutató hivatkozás leírása
KeyVaultSecretReference	A Key Vault titkos kulcsára mutató hivatkozás leírása
ManagedDiskParameters	Egy felügyelt lemez paraméterei.
OperatingSystemTypes	Ez a tulajdonság lehetővé teszi a lemezen található operációs rendszer típusának megadását, ha egyéni rendszerképből hoz létre virtuális gépet. Lehetséges értékek: Windows,Linux.
OSDisk	Megadja a virtuális gép által használt operációsrendszer-lemez adatait. További információ a lemezekről: Az Azure-beli virtuális gépek lemezei és virtuális merevlemezei.
SecurityEncryptionTypes	A felügyelt lemez EncryptionType tulajdonságát adja meg. A felügyelt lemez titkosításához a DiskWithVMGuestState értékre van állítva, a VMGuestState blob mellett a VMGuestStateOnly értékre csak a VMGuestState-blob titkosításához, valamint a NemPersistedTPM értékre, hogy ne őrizze meg a belső vezérlőprogram állapotát a VMGuestState blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be.
StorageAccountTypes	Megadja a felügyelt lemez tárfiókjának típusát. A felügyelt operációsrendszer-lemez tárfiókjának típusa csak a méretezési csoport létrehozásakor állítható be. MEGJEGYZÉS: UltraSSD_LRS csak adatlemezekkel használható. Operációsrendszer-lemezzel nem használható. Standard_LRS standard HDD-t használ. StandardSSD_LRS Standard SSD-t használ. Premium_LRS Prémium SSD-t használ. UltraSSD_LRS Ultra lemezt használ. Premium_ZRS prémium szintű SSD zónaredundáns tárolást használ. StandardSSD_ZRS standard SSD zónaredundáns tárolást használ. A Windows rendszerű virtuális gépekhez támogatott lemezekről további információt a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types és Linux rendszerű virtuális gépek esetében a https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Megadja a lemez tárolóhiba domain igazítási típusát.
StorageProfile	Megadja a virtuálisgép-lemezek tárolási beállításait.
SubResource
VirtualHardDisk	Egy lemez URI-ját ismerteti.
VMDiskSecurityProfile	Megadja a felügyelt lemez biztonsági profilbeállításait. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be.

ApiEntityReference

Tárgy

Az API-entitás referenciája.

Name	Típus	Description
id	string	Az ARM-erőforrás azonosítója /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Tárgy

Api-hiba.

Name	Típus	Description
code	string	A hibakód.
details	ApiErrorBase[]	Az API-hiba részletei
innererror	InnerError	Az Api belső hibája
message	string	A hibaüzenet.
target	string	Az adott hiba célja.

ApiErrorBase

Tárgy

Api-hibabázis.

Name	Típus	Description
code	string	A hibakód.
message	string	A hibaüzenet.
target	string	Az adott hiba célja.

AttachDetachDataDisksRequest

Tárgy

Megadja a felügyelt adatlemezek listájának csatolásához és leválasztáshoz szükséges bemenetet.

Name	Típus	Description
dataDisksToAttach	DataDisksToAttach[]	A csatolandó felügyelt adatlemezek listája.
dataDisksToDetach	DataDisksToDetach[]	A leválasztandó felügyelt adatlemezek listája.

CachingTypes

Felsorolás

Megadja a gyorsítótárazási követelményeket. A lehetséges értékek a következők: None,ReadOnly,ReadWrite. Az alapértelmezett értékek a következők: Nincs a Standard Storage esetében. Csak olvasható prémium szintű tároláshoz

Érték	Description
None
ReadOnly
ReadWrite

CloudError

Tárgy

Hibaválasz a Compute szolgáltatástól.

Name	Típus	Description
error	ApiError	Api-hiba.

DataDisk

Tárgy

Adatlemezt ír le.

Name	Típus	Description
caching	CachingTypes	Megadja a gyorsítótárazási követelményeket. A lehetséges értékek a következők: Nincs,ReadOnly,ReadWrite. Az alapértelmezett viselkedés a következő: Nincs a standard tárterülethez. ReadOnly for Premium Storage.
createOption	DiskCreateOptionTypes	Meghatározza a virtuálisgép-lemez létrehozásának módját. A lehetséges értékek csatolása : Ezt az értéket akkor használja a rendszer, ha speciális lemezt használ a virtuális gép létrehozásához. FromImage: Ez az érték akkor használatos, ha rendszerképet használ a virtuálisgép-adatlemez létrehozásához. Ha platformrendszerképet használ, használja a fent leírt imageReference elemet is. Ha piactéri rendszerképet használ, használja a korábban ismertetett tervelemet is. Üres: Ez az érték üres adatlemez létrehozásakor használatos. Másolás: Ez az érték egy pillanatképből vagy egy másik lemezből származó adatlemez létrehozásához használható. Visszaállítás: Ez az érték egy lemez-visszaállítási pontból származó adatlemez létrehozásához használható.
deleteOption	DiskDeleteOptionTypes	Megadja, hogy az adatlemezt törölni vagy leválasztani kell-e a virtuális gép törlésekor. A lehetséges értékek a következők: Törlés. Ha ezt az értéket használja, az adatlemez törlődik a virtuális gép törlésekor. Elválaszt. Ha ezt az értéket használja, az adatlemez megmarad a virtuális gép törlése után. Az alapértelmezett érték aleválasztása .
detachOption	DiskDetachOptionTypes	Megadja a lemez leválasztása során használandó vagy a virtuális gépről már leválasztás alatt álló leválasztási viselkedést. Támogatott értékek: ForceDetach. detachOption: ForceDetach csak felügyelt adatlemezekre alkalmazható. Ha az adatlemez korábbi leválasztási kísérlete nem fejeződött be a virtuális gép váratlan hibája miatt, és a lemez még mindig nem lett felszabadítva, akkor használja a kényszerített leválasztást végső megoldásként a lemez kényszerített leválasztásához a virtuális gépről. Lehet, hogy a leválasztott viselkedés használatakor nem minden írás lett kiürítve. Ez a funkció még előzetes verzióban érhető el. Adatlemez frissítésének kényszerített leválasztása a "true" értékre, valamint a detachOption: "ForceDetach" beállítással együtt.
diskIOPSReadWrite	integer (int64)	Megadja a felügyelt lemez Read-Write IOPS-értékét, ha a StorageAccountType UltraSSD_LRS.
diskMBpsReadWrite	integer (int64)	Megadja a felügyelt lemez sávszélességét MB/másodpercben, ha a StorageAccountType UltraSSD_LRS.
diskSizeGB	integer (int32)	Egy üres adatlemez méretét adja meg gigabájtban. Ez az elem a virtuálisgép-lemezkép lemezméretének felülírására használható. A "diskSizeGB" tulajdonság a lemez 1024^3 bájtjainak száma, és az érték nem lehet nagyobb 1023-nál.
image	VirtualHardDisk	A forrásfelhasználói lemezkép virtuális merevlemeze. A virtuális merevlemez másolása a virtuális géphez való csatolás előtt történik. Ha a SourceImage meg van adva, a cél virtuális merevlemez nem létezhet.
lun	integer (int32)	Az adatlemez logikai egységszámát adja meg. Ez az érték a virtuális gépen belüli adatlemezek azonosítására szolgál, ezért egyedinek kell lennie a virtuális géphez csatlakoztatott minden adatlemez esetében.
managedDisk	ManagedDiskParameters	A felügyelt lemez paraméterei.
name	string	A lemez neve.
sourceResource	ApiEntityReference	A forráserőforrás azonosítója. Ez lehet pillanatkép vagy lemez-visszaállítási pont, amelyből lemezt hozhat létre.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Megadja a lemez tárolóhiba domain igazítási típusát.
toBeDetached	boolean	Megadja, hogy az adatlemez le van-e választva a VirtualMachine/VirtualMachineScalesetről
vhd	VirtualHardDisk	A virtuális merevlemez.
writeAcceleratorEnabled	boolean	Megadja, hogy a writeAccelerator engedélyezve legyen vagy le legyen tiltva a lemezen.

DataDisksToAttach

Tárgy

A csatolandó adatlemezt ismerteti.

Name	Típus	Description
caching	CachingTypes	Megadja a gyorsítótárazási követelményeket. A lehetséges értékek a következők: Nincs,ReadOnly,ReadWrite. Az alapértelmezett viselkedés a következő: Nincs a standard tárterülethez. ReadOnly for Premium Storage.
deleteOption	DiskDeleteOptionTypes	Megadja, hogy az adatlemezt törölni vagy leválasztani kell-e a virtuális gép törlésekor. A lehetséges értékek a következők: Törlés. Ha ezt az értéket használja, az adatlemez törlődik a virtuális gép törlésekor. Elválaszt. Ha ezt az értéket használja, az adatlemez megmarad a virtuális gép törlése után. Az alapértelmezett érték aleválasztása .
diskEncryptionSet	DiskEncryptionSetParameters	Megadja a felügyelt lemez ügyfél által felügyelt lemeztitkosítási készletének erőforrás-azonosítóját.
diskId	string	A felügyelt adatlemez azonosítója.
lun	integer (int32)	Az adatlemez logikai egységszáma. Ez az érték a virtuális gépen belüli adatlemezek azonosítására szolgál, ezért egyedinek kell lennie a virtuális géphez csatlakoztatott minden adatlemez esetében. Ha nincs megadva, a lun automatikusan lesz hozzárendelve.
writeAcceleratorEnabled	boolean	Megadja, hogy a writeAccelerator engedélyezve legyen vagy le legyen tiltva a lemezen.

DataDisksToDetach

Tárgy

A leválasztani kívánt adatlemezt ismerteti.

Name	Típus	Description
detachOption	DiskDetachOptionTypes	A lemez virtuális gépről való leválasztásának támogatott beállításai. További részletekért tekintse meg a DetachOption objektumreferenciáját.
diskId	string	A felügyelt adatlemez azonosítója.

DiffDiskOptions

Felsorolás

Az operációsrendszer-lemez rövid élettartamú lemezbeállítását adja meg.

Érték	Description
Local

DiffDiskPlacement

Felsorolás

Az operációsrendszer-lemez rövid élettartamú lemezelhelyezését adja meg. Ezt a tulajdonságot a felhasználó használhatja a kérésben a hely kiválasztásához, azaz gyorsítótárlemez, erőforráslemez vagy nvme lemezterület kiválasztásához a rövid élettartamú operációsrendszer-lemezek kiépítéséhez. A rövid élettartamú operációsrendszer-lemez méretére vonatkozó követelményekről további információt a Windows rendszerű virtuális gépek rövid élettartamú operációsrendszer-lemezméreti követelményeit https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements- és Linux rendszerű virtuális gépeken https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Az NvmeDisk minimális API-verziója: 2024-03-01.

Érték	Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Tárgy

Az operációs rendszer lemezéhez megadható rövid élettartamú lemezbeállítások paramétereit ismerteti. Megjegyzés: A rövid élettartamú lemezbeállítások csak felügyelt lemezhez adhatók meg.

Name	Típus	Description
enableFullCaching	boolean	Megadja, hogy engedélyezze-e a teljes gyorsítótározást ezen a VM-nél, amely helyben gyorsítótározza az operációs rendszer lemezét a hoston, és ellenállóbbá teszi a tárolókiesésekkel
option	DiffDiskOptions	Megadja az operációsrendszer-lemez rövid élettartamú lemezbeállításait.
placement	DiffDiskPlacement	Az operációsrendszer-lemez rövid élettartamú lemezelhelyezését adja meg. Lehetséges értékek: CacheDisk,ResourceDisk,NvmeDisk. Az alapértelmezett viselkedés a következő: CacheDisk, ha a virtuális gép méretéhez van konfigurálva, ellenkező esetben ResourceDisk vagy NvmeDisk van használatban. Tekintse meg a Windows rendszerű virtuális gépek méretdokumentációját https://docs.microsoft.com/azure/virtual-machines/windows/sizes és Linux rendszerű virtuális gépekhez a https://docs.microsoft.com/azure/virtual-machines/linux/sizes- és https://docs.microsoft.com/azure/virtual-machines/linux/sizes, hogy ellenőrizze, mely virtuálisgép-méretek teszik elérhetővé a gyorsítótárlemezt. Az NvmeDisk minimális API-verziója: 2024-03-01.

DiskControllerTypes

Felsorolás

Megadja a virtuális géphez és a VirtualMachineScaleSethez konfigurált lemezvezérlő típusát. Ez a tulajdonság csak azokhoz a virtuális gépekhez támogatott, amelyek operációsrendszer-lemeze és virtuálisgép-termékváltozata támogatja a 2. generációt (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), ellenőrizze a Virtuális gépek termékváltozatának részeként visszaadott HyperVGenerations képességet a régióhoz tartozó Microsoft.Compute SKU API válaszában(https://docs.microsoft.com/rest/api/compute/resourceskus/list). A támogatott lemezvezérlő-típusokkal kapcsolatos további információkért tekintse meg a következőt https://aka.ms/azure-diskcontrollertypes:

Érték	Description
SCSI
NVMe

DiskCreateOptionTypes

Felsorolás

Meghatározza a virtuálisgép-lemez létrehozásának módját. A lehetséges értékek csatolása : Ezt az értéket akkor használja a rendszer, ha speciális lemezt használ a virtuális gép létrehozásához. FromImage: Ez az érték akkor használatos, ha rendszerképet használ a virtuális gép létrehozásához. Ha platformrendszerképet használ, használja a fent leírt imageReference elemet is. Ha piactéri rendszerképet használ, használja a korábban ismertetett tervelemet is. Üres: Ez az érték üres adatlemez létrehozásakor használatos. Másolás: Ez az érték egy pillanatképből vagy egy másik lemezből származó adatlemez létrehozásához használható. Visszaállítás: Ez az érték egy lemez-visszaállítási pontból származó adatlemez létrehozásához használható.

Érték	Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Felsorolás

Meghatározza a felügyelt lemez viselkedését a virtuális gép törlésekor, például azt, hogy a felügyelt lemez törölve vagy leválasztva van-e. A támogatott értékek a következők: Törlés. Ha ezt az értéket használja, a rendszer törli a felügyelt lemezt a virtuális gép törlésekor. Elválaszt. Ha ezt az értéket használja, a felügyelt lemez megmarad a virtuális gép törlése után. Minimális API-verzió: 2021-03-01.

Érték	Description
Delete
Detach

DiskDetachOptionTypes

Felsorolás

Megadja a lemez leválasztása során használandó vagy a virtuális gépről már leválasztás alatt álló leválasztási viselkedést. A támogatott értékek a következők: ForceDetach. detachOption: A ForceDetach csak felügyelt adatlemezekre alkalmazható. Ha az adatlemez korábbi leválasztási kísérlete nem fejeződött be a virtuális gép váratlan hibája miatt, és a lemez még mindig nem lett felszabadítva, akkor használja a kényszerített leválasztást végső megoldásként a lemez kényszerített leválasztásához a virtuális gépről. Lehet, hogy a leválasztott viselkedés használatakor nem minden írás lett kiürítve. Ez a funkció még előzetes verzióban érhető el. Adatlemez frissítésének kényszerített leválasztása a "true" értékre, valamint a detachOption: "ForceDetach" beállítással együtt.

Érték	Description
ForceDetach

DiskEncryptionSetParameters

Tárgy

A lemezhez megadható ügyfél által felügyelt lemeztitkosítási csoport erőforrás-azonosítójának paraméterét ismerteti. Megjegyzés: A lemeztitkosítási csoport erőforrás-azonosítója csak felügyelt lemezhez adható meg. További részletekért tekintse meg https://aka.ms/mdssewithcmkoverview.

Name	Típus	Description
id	string	Erőforrás-azonosító

DiskEncryptionSettings

Tárgy

Lemez titkosítási beállításainak ismertetése

Name	Típus	Description
diskEncryptionKey	KeyVaultSecretReference	Megadja a lemeztitkosítási kulcs helyét, amely egy Key Vault-titkos kulcs.
enabled	boolean	Megadja, hogy engedélyezni kell-e a lemeztitkosítást a virtuális gépen.
keyEncryptionKey	KeyVaultKeyReference	Megadja a kulcstitkosítási kulcs helyét a Key Vaultban.

ImageReference

Tárgy

Megadja a használni kívánt kép adatait. Megadhatja a platformrendszerképekről, a marketplace-rendszerképekről vagy a virtuálisgép-rendszerképekről szóló információkat. Ez az elem akkor szükséges, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-lemezképet szeretne használni, de más létrehozási műveletekben nem használja. MEGJEGYZÉS: A képhivatkozás közzétevője és ajánlata csak a méretezési csoport létrehozásakor állítható be.

Name	Típus	Description
communityGalleryImageId	string	A virtuális gép üzembe helyezéséhez a közösségi katalógus rendszerképének egyedi azonosítóját adta meg. Ez lekérhető a közösségi galéria rendszerképének GET hívásából.
exactVersion	string	Decimális számokban adja meg a virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép verzióját. Ez az olvasható mező eltér a verziótól, csak akkor, ha a "verzió" mezőben megadott érték a "legújabb".
id	string	Erőforrás-azonosító
offer	string	Megadja a virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép ajánlatát.
publisher	string	A kép publisher.
sharedGalleryImageId	string	A megosztott katalógus lemezképének egyedi azonosítóját adta meg a virtuális gép üzembe helyezéséhez. Ez lekérhető a megosztott katalógus képének GET hívásából.
sku	string	A kép termékváltozata.
version	string	A virtuális gép létrehozásához használt platformrendszerkép vagy marketplace-rendszerkép verzióját adja meg. Az engedélyezett formátumok a Major.Minor.Build vagy a "legújabb". A fő, a kisebb és a build tizedes tört. Adja meg a "legújabb" értéket a rendszerkép üzembe helyezéskor elérhető legújabb verziójának használatához. Még ha a legújabb verziót is használja, a virtuálisgép-rendszerkép nem frissül automatikusan az üzembe helyezés után, még akkor sem, ha egy új verzió elérhetővé válik. Ne használja a "verzió" mezőt a katalógus lemezképének üzembe helyezéséhez, a katalógus lemezképének "id" mezője mindig az "id" mezőt használja a katalóguskép "legújabb" verziójának használatához, csak állítsa be a "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" mezőt az "id" mezőben verzióbemenet nélkül.

InnerError

Tárgy

Belső hiba részletei.

Name	Típus	Description
errordetail	string	A belső hibaüzenet vagy kivételkép.
exceptiontype	string	A kivétel típusa.

KeyVaultKeyReference

Tárgy

A Key Vault-kulcsra mutató hivatkozás leírása

Name	Típus	Description
keyUrl	string	A Key Vault kulcstitkosítási kulcsára hivatkozó URL-cím.
sourceVault	SubResource	A kulcsot tartalmazó Key Vault relatív URL-címe.

KeyVaultSecretReference

Tárgy

A Key Vault titkos kulcsára mutató hivatkozás leírása

Name	Típus	Description
secretUrl	string	Az URL-cím, amely egy titkos kulcsra hivatkozik egy Key Vaultban.
sourceVault	SubResource	A titkos kulcsot tartalmazó Key Vault relatív URL-címe.

ManagedDiskParameters

Tárgy

Egy felügyelt lemez paraméterei.

Name	Típus	Description
diskEncryptionSet	DiskEncryptionSetParameters	Megadja a felügyelt lemez ügyfél által felügyelt lemeztitkosítási készletének erőforrás-azonosítóját.
id	string	Erőforrás-azonosító
securityProfile	VMDiskSecurityProfile	Megadja a felügyelt lemez biztonsági profilját.
storageAccountType	StorageAccountTypes	Megadja a felügyelt lemez tárfiókjának típusát. MEGJEGYZÉS: UltraSSD_LRS csak adatlemezekkel használható, operációsrendszer-lemezzel nem használható.

OperatingSystemTypes

Felsorolás

Ez a tulajdonság lehetővé teszi a lemezen található operációs rendszer típusának megadását, ha egyéni rendszerképből hoz létre virtuális gépet. Lehetséges értékek: Windows,Linux.

Érték	Description
Windows
Linux

OSDisk

Tárgy

Megadja a virtuális gép által használt operációsrendszer-lemez adatait. További információ a lemezekről: Az Azure-beli virtuális gépek lemezei és virtuális merevlemezei.

Name	Típus	Description
caching	CachingTypes	Megadja a gyorsítótárazási követelményeket. A lehetséges értékek a következők: Nincs,ReadOnly,ReadWrite. Az alapértelmezett viselkedés a következő: Nincs a standard tárterülethez. ReadOnly for Premium Storage.
createOption	DiskCreateOptionTypes	Meghatározza a virtuálisgép-lemez létrehozásának módját. A lehetséges értékek csatolása : Ezt az értéket akkor használja a rendszer, ha speciális lemezt használ a virtuális gép létrehozásához. FromImage: Ez az érték akkor használatos, ha rendszerképet használ a virtuális gép létrehozásához. Ha platformrendszerképet használ, használja a fent leírt imageReference elemet is. Ha piactéri rendszerképet használ, használja a korábban ismertetett tervelemet is.
deleteOption	DiskDeleteOptionTypes	Megadja, hogy az operációsrendszer-lemezt törölni vagy leválasztani kell-e a virtuális gép törlésekor. A lehetséges értékek a következők: Törlés. Ha ezt az értéket használja, a rendszer törli az operációsrendszer-lemezt a virtuális gép törlésekor. Elválaszt. Ha ezt az értéket használja, az operációsrendszer-lemez megmarad a virtuális gép törlése után. Az alapértelmezett érték aleválasztása . Rövid élettartamú operációsrendszer-lemez esetén az alapértelmezett érték Törlés. A felhasználó nem módosíthatja a rövid élettartamú operációsrendszer-lemez törlési beállítását.
diffDiskSettings	DiffDiskSettings	Megadja a virtuális gép által használt operációsrendszer-lemez rövid élettartamú lemezbeállításait.
diskSizeGB	integer (int32)	Egy üres adatlemez méretét adja meg gigabájtban. Ez az elem a virtuálisgép-lemezkép lemezméretének felülírására használható. A "diskSizeGB" tulajdonság a lemez 1024^3 bájtjainak száma, és az érték nem lehet nagyobb 1023-nál.
encryptionSettings	DiskEncryptionSettings	Megadja az operációsrendszer-lemez titkosítási beállításait. Minimális API-verzió: 2015-06-15.
image	VirtualHardDisk	A forrásfelhasználói lemezkép virtuális merevlemeze. A virtuális merevlemez másolása a virtuális géphez való csatolás előtt történik. Ha a SourceImage meg van adva, a cél virtuális merevlemez nem létezhet.
managedDisk	ManagedDiskParameters	A felügyelt lemez paraméterei.
name	string	A lemez neve.
osType	OperatingSystemTypes	Ez a tulajdonság lehetővé teszi a lemezen található operációs rendszer típusának megadását, ha virtuális gépet hoz létre felhasználói lemezképből vagy speciális VHD-ből. Lehetséges értékek: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Megadja a lemez tárolóhiba domain igazítási típusát.
vhd	VirtualHardDisk	A virtuális merevlemez.
writeAcceleratorEnabled	boolean	Megadja, hogy a writeAccelerator engedélyezve legyen vagy le legyen tiltva a lemezen.

SecurityEncryptionTypes

Felsorolás

A felügyelt lemez EncryptionType tulajdonságát adja meg. A felügyelt lemez titkosításához a DiskWithVMGuestState értékre van állítva, a VMGuestState blob mellett a VMGuestStateOnly értékre csak a VMGuestState-blob titkosításához, valamint a NemPersistedTPM értékre, hogy ne őrizze meg a belső vezérlőprogram állapotát a VMGuestState blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be.

Érték	Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Felsorolás

Megadja a felügyelt lemez tárfiókjának típusát. A felügyelt operációsrendszer-lemez tárfiókjának típusa csak a méretezési csoport létrehozásakor állítható be. MEGJEGYZÉS: UltraSSD_LRS csak adatlemezekkel használható. Operációsrendszer-lemezzel nem használható. Standard_LRS standard HDD-t használ. StandardSSD_LRS Standard SSD-t használ. Premium_LRS Prémium SSD-t használ. UltraSSD_LRS Ultra lemezt használ. Premium_ZRS prémium szintű SSD zónaredundáns tárolást használ. StandardSSD_ZRS standard SSD zónaredundáns tárolást használ. A Windows rendszerű virtuális gépekhez támogatott lemezekről további információt a https://docs.microsoft.com/azure/virtual-machines/windows/disks-types és Linux rendszerű virtuális gépek esetében a https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Érték	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Felsorolás

Megadja a lemez tárolóhiba domain igazítási típusát.

Érték	Description
Aligned	A lemeztárhely hibatartományai a számítási hibatartományokhoz vannak leképezve. A telepítés akkor bukik meg, ha a lemez nem támogatja elegendő hibatartományt.
BestEffortAligned	Próbáld meg leképezni a Storage hibatartományokat a hibatartományok számítására. A lemezek nem igazítottak, ha a lemez nem támogatja elegendő hibatartományt.

StorageProfile

Tárgy

Megadja a virtuálisgép-lemezek tárolási beállításait.

Name	Típus	Description
alignRegionalDisksToVMZone	boolean	Megadja, hogy a regionális lemezeket a virtuálisgép-zónához kell-e igazítani/áthelyezni. Ez csak elhelyezési tulajdonságkészlettel rendelkező virtuális gépekre vonatkozik. Vegye figyelembe, hogy ez a módosítás visszafordíthatatlan. Minimális API-verzió: 2024-11-01.
dataDisks	DataDisk[]	Megadja az adatlemez virtuális géphez való hozzáadásához használt paramétereket. További információ a lemezekről: Az Azure-beli virtuális gépek lemezei és virtuális merevlemezei.
diskControllerType	DiskControllerTypes	Megadja a virtuális géphez konfigurált lemezvezérlő típusát. Megjegyzés: Ez a tulajdonság az alapértelmezett lemezvezérlő-típusra lesz beállítva, ha nincs megadva, ha a virtuális gép a megadott minimális API-verziójú operációsrendszer-lemez és virtuálisgép-méret képességei alapján a "hyperVGeneration" 2-re van állítva. A lemezvezérlő típusának frissítése előtt fel kell szabadítania a virtuális gépet, hacsak nem frissíti a virtuálisgép-méretet a virtuálisgép-konfigurációban, amely implicit módon felszabadítja és újratelepíti a virtuális gépet. Minimális API-verzió: 2022-08-01.
imageReference	ImageReference	Megadja a használni kívánt kép adatait. Megadhatja a platformrendszerképekről, a marketplace-rendszerképekről vagy a virtuálisgép-rendszerképekről szóló információkat. Ez az elem akkor szükséges, ha platformrendszerképet, piactéri rendszerképet vagy virtuálisgép-lemezképet szeretne használni, de más létrehozási műveletekben nem használja.
osDisk	OSDisk	Megadja a virtuális gép által használt operációsrendszer-lemez adatait. További információ a lemezekről: Az Azure-beli virtuális gépek lemezei és virtuális merevlemezei.

SubResource

Tárgy

Name	Típus	Description
id	string	Erőforrás-azonosító

VirtualHardDisk

Tárgy

Egy lemez URI-ját ismerteti.

Name	Típus	Description
uri	string	Megadja a virtuális merevlemez URI-ját.

VMDiskSecurityProfile

Tárgy

Megadja a felügyelt lemez biztonsági profilbeállításait. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be.

Name	Típus	Description
diskEncryptionSet	DiskEncryptionSetParameters	Megadja az ügyfél által felügyelt lemeztitkosítási csoport erőforrás-azonosítóját a felügyelt lemezhez, amelyet az ügyfél által titkosított ConfidentialVM OS Disk és VMGuest blob használ.
securityEncryptionType	SecurityEncryptionTypes	A felügyelt lemez EncryptionType tulajdonságát adja meg. A felügyelt lemez titkosításához a DiskWithVMGuestState értékre van állítva, a VMGuestState blob mellett a VMGuestStateOnly értékre csak a VMGuestState-blob titkosításához, valamint a NemPersistedTPM értékre, hogy ne őrizze meg a belső vezérlőprogram állapotát a VMGuestState blobban. Megjegyzés: Csak bizalmas virtuális gépekhez állítható be.