Virtual Machines - Attach Detach Data Disks

Usługa:: Compute

Wersja interfejsu API:: 2026-04-01

Dołączanie i odłączanie dysków danych do/z maszyny wirtualnej.

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

Parametry identyfikatora URI

Nazwisko	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
subscriptionId	path	True	string minLength: 1	Identyfikator subskrypcji docelowej.
vmName	path	True	string	Nazwa maszyny wirtualnej.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Treść żądania

Nazwisko	Typ	Opis
dataDisksToAttach	DataDisksToAttach[]	Lista dysków danych zarządzanych do dołączenia.
dataDisksToDetach	DataDisksToDetach[]	Lista dysków danych zarządzanych do odłączenia.

Odpowiedzi

Nazwisko	Typ	Opis
200 OK	StorageProfile	Operacja Azure zakończyła się pomyślnie.
202 Accepted		Zaakceptowano operację zasobu. Nagłówki Location: string Retry-After: integer
Other Status Codes	CloudError	Nieoczekiwana odpowiedź na błąd.

Nazwisko

Typ

Opis

200 OK

StorageProfile

Operacja Azure zakończyła się pomyślnie.

202 Accepted

Zaakceptowano operację zasobu.

Nagłówki

Location: string
Retry-After: integer

Other Status Codes

CloudError

Nieoczekiwana odpowiedź na błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 w usłudze Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwisko	Opis
user_impersonation	podszywaj się pod konto użytkownika

Przykłady

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:: 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
    }
  ]
}

Kod stanu:: 202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Przykładowe żądanie

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

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

Przykładowa odpowiedź

Kod stanu:: 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
    }
  ]
}

Kod stanu:: 202

location: https://foo.com/operationstatus

Definicje

Nazwisko	Opis
AdditionalDiskProperties	Określa dodatkowe właściwości dla dysku zarządzanego, które można ustawić w momencie ukrytego utworzenia dysku.
ApiEntityReference	Dokumentacja jednostki interfejsu API.
ApiError	Błąd interfejsu API.
ApiErrorBase	Baza błędów interfejsu API.
AttachDetachDataDisksRequest	Określa dane wejściowe do dołączania i odłączania listy dysków danych zarządzanych.
AvailabilityPolicyDiskDelay	Określa sposób obsługi dysków z powolnym we/wy.
CachingTypes	Określa wymagania dotyczące buforowania. Możliwe wartości to: None,ReadOnly,ReadWrite. Wartości domyślne to: Brak dla magazynu w warstwie Standardowa. Tylko do odczytu dla magazynu w warstwie Premium
CloudError	Odpowiedź na błąd z usługi Obliczeniowej.
DataDisk	Opisuje dysk danych.
DataDisksToAttach	Opisuje dysk danych, który ma zostać dołączony.
DataDisksToDetach	Opisuje dysk danych, który ma być odłączony.
DiffDiskOptions	Określa opcję dysku efemerycznego dla dysku systemu operacyjnego.
DiffDiskPlacement	Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, tj. dysk pamięci podręcznej, dysk zasobu lub miejsce na dysku nvme na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku efemerycznego systemu operacyjnego, zobacz Wymagania dotyczące rozmiaru dysku efemerycznego systemu operacyjnego dla maszyny wirtualnej z systemem Windows w https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements i maszynie wirtualnej z systemem Linux w witrynie https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimalna wersja interfejsu API dla nvmeDisk: 2024-03-01.
DiffDiskSettings	Opisuje parametry ustawień dysku efemerycznego, które można określić dla dysku systemu operacyjnego. Uwaga: Ustawienia dysku efemerycznego można określić tylko dla dysku zarządzanego.
DiskApiVersion	Określa wersję API dysku używaną przy stosowaniu dodatkowych właściwości Dysku do zarządzanych dysków. Wartość musi być w formacie YYYY-MM-DD.
DiskAvailabilityPolicy	W przypadku problemu z dostępnością lub łącznością dysku, określ zachowanie maszyny wirtualnej.
DiskControllerTypes	Określa typ kontrolera dysku skonfigurowany dla maszyny wirtualnej i virtualMachineScaleSet. Ta właściwość jest obsługiwana tylko w przypadku maszyn wirtualnych, których dysk systemu operacyjnego i jednostka SKU maszyny wirtualnej obsługuje generację 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), sprawdź funkcję HyperVGenerations zwróconą jako część możliwości jednostki SKU maszyny wirtualnej w odpowiedzi interfejsu API jednostek SKU Microsoft.Compute dla regionu zawiera V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Aby uzyskać więcej informacji o obsługiwanych typach kontrolera dysków, zobacz https://aka.ms/azure-diskcontrollertypes.
DiskCreateOptionTypes	Określa sposób tworzenia dysku maszyny wirtualnej. Możliwe wartości to Attach: Ta wartość jest używana podczas tworzenia maszyny wirtualnej za pomocą wyspecjalizowanego dysku. FromImage: Ta wartość jest używana podczas tworzenia maszyny wirtualnej przy użyciu obrazu. Jeśli używasz obrazu platformy, należy również użyć elementu imageReference opisanego powyżej. Jeśli używasz obrazu z witryny Marketplace, należy również użyć wcześniej opisanego elementu planu. Empty: Ta wartość jest używana podczas tworzenia pustego dysku danych. Kopiuj: Ta wartość służy do tworzenia dysku danych na podstawie migawki lub innego dysku. Przywracanie: Ta wartość służy do tworzenia dysku danych z punktu przywracania dysku.
DiskDeleteOptionTypes	Określa zachowanie dysku zarządzanego po usunięciu maszyny wirtualnej, na przykład czy dysk zarządzany jest usuwany, czy odłączany. Obsługiwane wartości to: Delete. Jeśli ta wartość jest używana, dysk zarządzany zostanie usunięty po usunięciu maszyny wirtualnej. Odłączyć. Jeśli ta wartość jest używana, dysk zarządzany jest zachowywany po usunięciu maszyny wirtualnej. Minimalna wersja interfejsu API: 2021-03-01.
DiskDetachOptionTypes	Określa zachowanie odłączania, które ma być używane podczas odłączania dysku lub który jest już w trakcie odłączania od maszyny wirtualnej. Obsługiwane wartości to: ForceDetach. detachOption: ForceDetach ma zastosowanie tylko do zarządzanych dysków danych. Jeśli poprzednia próba odłączenia dysku danych nie została ukończona z powodu nieoczekiwanego błędu z maszyny wirtualnej, a dysk nadal nie został zwolniony, użyj opcji wymuszania odłączania jako opcji ostatniej próby odłączenia dysku, aby zmusić dysk do wymuszonego odłączenia od maszyny wirtualnej. Wszystkie zapisy mogły nie zostać opróżnione podczas korzystania z tego zachowania odłączania. Ta funkcja jest nadal dostępna w wersji zapoznawczej. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".
DiskEncryptionSetParameters	Opisuje parametr zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta, który można określić dla dysku. Uwaga: Identyfikator zasobu zestawu szyfrowania dysku można określić tylko dla dysku zarządzanego. Aby uzyskać więcej informacji, zobacz https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Opisuje ustawienia szyfrowania dysku
ImageReference	Określa informacje o obrazie do użycia. Możesz określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu witryny Marketplace lub obrazu maszyny wirtualnej, ale nie jest używany w innych operacjach tworzenia. UWAGA: Wydawca i oferta odwołania do obrazów można ustawić tylko podczas tworzenia zestawu skalowania.
InnerError	Szczegóły błędu wewnętrznego.
KeyVaultKeyReference	Opisuje odwołanie do klucza usługi Key Vault
KeyVaultSecretReference	Opisuje odwołanie do wpisu tajnego usługi Key Vault
ManagedDiskParameters	Parametry dysku zarządzanego.
ManagedDiskProperties	Określa właściwości zarządzanego dysku, które można ustawić w momencie ukrytego utworzenia dysku.
NetworkAccessPolicy	Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.
OperatingSystemTypes	Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku w przypadku tworzenia maszyny wirtualnej na podstawie obrazu niestandardowego. Możliwe wartości to: Windows,Linux.
OSDisk	Określa informacje o dysku systemu operacyjnego używanego przez maszynę wirtualną. Aby uzyskać więcej informacji na temat dysków, zobacz Informacje o dyskach i dyskach VHD dla maszyn wirtualnych platformy Azure.
SecurityEncryptionTypes	Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na DiskWithVMGuestState na potrzeby szyfrowania dysku zarządzanego wraz z vmGuestState blob, VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: Można go ustawić tylko dla poufnych maszyn wirtualnych.
StorageAccountTypes	Określa typ konta magazynu dla dysku zarządzanego. Typ konta magazynu dysku zarządzanego systemu operacyjnego można ustawić tylko podczas tworzenia zestawu skalowania. UWAGA: UltraSSD_LRS można używać tylko z dyskami danych. Nie można go używać z dyskiem systemu operacyjnego. Standard_LRS używa hdd w warstwie Standardowa. StandardSSD_LRS używa dysków SSD w warstwie Standardowa. Premium_LRS używa dysków SSD w warstwie Premium. UltraSSD_LRS używa dysku w warstwie Ultra. Premium_ZRS używa magazynu strefowo nadmiarowego SSD w warstwie Premium. StandardSSD_ZRS używa magazynu strefowo nadmiarowego SSD w warstwie Standardowa. Aby uzyskać więcej informacji na temat dysków obsługiwanych w przypadku maszyn wirtualnych z systemem Windows, zobacz https://docs.microsoft.com/azure/virtual-machines/windows/disks-types i, w przypadku maszyn wirtualnych z systemem Linux, zobacz https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Określa typ wyrównania domeny błędów pamięci masowej dla dysku.
StorageProfile	Określa ustawienia magazynu dla dysków maszyny wirtualnej.
SubResource
VirtualHardDisk	Opisuje identyfikator URI dysku.
VMDiskSecurityProfile	Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można go ustawić tylko dla poufnych maszyn wirtualnych.

AdditionalDiskProperties

Objekt

Określa dodatkowe właściwości dla dysku zarządzanego, które można ustawić w momencie ukrytego utworzenia dysku.

Nazwisko	Typ	Opis
managedDiskProperties	ManagedDiskProperties	Określa właściwości zarządzanego dysku, które można ustawić w momencie ukrytego utworzenia dysku.

ApiEntityReference

Objekt

Dokumentacja jednostki interfejsu API.

Nazwisko	Typ	Opis
id	string	Identyfikator zasobu usługi ARM w postaci /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Objekt

Błąd interfejsu API.

Nazwisko	Typ	Opis
code	string	Kod błędu.
details	ApiErrorBase[]	Szczegóły błędu interfejsu API
innererror	InnerError	Błąd wewnętrzny interfejsu API
message	string	Komunikat o błędzie.
target	string	Element docelowy określonego błędu.

ApiErrorBase

Objekt

Baza błędów interfejsu API.

Nazwisko	Typ	Opis
code	string	Kod błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy określonego błędu.

AttachDetachDataDisksRequest

Objekt

Określa dane wejściowe do dołączania i odłączania listy dysków danych zarządzanych.

Nazwisko	Typ	Opis
dataDisksToAttach	DataDisksToAttach[]	Lista dysków danych zarządzanych do dołączenia.
dataDisksToDetach	DataDisksToDetach[]	Lista dysków danych zarządzanych do odłączenia.

AvailabilityPolicyDiskDelay

Wyliczenie

Określa sposób obsługi dysków z powolnym we/wy.

Wartość	Opis
None	Domyślnie zachowuje się bez określonej polityki dostępności, czyli restart maszyny wirtualnej przy wolnym wejściu/wyjściu dysku.
AutomaticReattach	W przypadku awarii wejścia/wyjścia dysku lub wolnej reakcji spróbuj odłączyć i ponownie podłączyć dysk.

CachingTypes

Wyliczenie

Określa wymagania dotyczące buforowania. Możliwe wartości to: None,ReadOnly,ReadWrite. Wartości domyślne to: Brak dla magazynu w warstwie Standardowa. Tylko do odczytu dla magazynu w warstwie Premium

Wartość	Opis
None
ReadOnly
ReadWrite

CloudError

Objekt

Odpowiedź na błąd z usługi Obliczeniowej.

Nazwisko	Typ	Opis
error	ApiError	Błąd interfejsu API.

DataDisk

Objekt

Opisuje dysk danych.

Nazwisko	Typ	Opis
caching	CachingTypes	Określa wymagania dotyczące buforowania. Możliwe wartości to: None,ReadOnly,ReadWrite. Domyślne zachowanie to: Brak dla magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage.
createOption	DiskCreateOptionTypes	Określa sposób tworzenia dysku maszyny wirtualnej. Możliwe wartości to Attach: Ta wartość jest używana podczas tworzenia maszyny wirtualnej za pomocą wyspecjalizowanego dysku. FromImage: Ta wartość jest używana podczas tworzenia dysku danych maszyny wirtualnej przy użyciu obrazu. Jeśli używasz obrazu platformy, należy również użyć elementu imageReference opisanego powyżej. Jeśli używasz obrazu z witryny Marketplace, należy również użyć wcześniej opisanego elementu planu. Empty: Ta wartość jest używana podczas tworzenia pustego dysku danych. Kopiuj: Ta wartość służy do tworzenia dysku danych na podstawie migawki lub innego dysku. Przywracanie: Ta wartość służy do tworzenia dysku danych z punktu przywracania dysku.
deleteOption	DiskDeleteOptionTypes	Określa, czy dysk danych ma zostać usunięty, czy odłączony po usunięciu maszyny wirtualnej. Możliwe wartości to: Usuń. Jeśli ta wartość jest używana, dysk danych zostanie usunięty po usunięciu maszyny wirtualnej. Odłączyć. Jeśli ta wartość jest używana, dysk danych jest zachowywany po usunięciu maszyny wirtualnej. Wartość domyślna jest ustawiona na wartość Detach.
detachOption	DiskDetachOptionTypes	Określa zachowanie odłączania, które ma być używane podczas odłączania dysku lub który jest już w trakcie odłączania od maszyny wirtualnej. Obsługiwane wartości: ForceDetach. detachOption: ForceDetach ma zastosowanie tylko w przypadku dysków danych zarządzanych. Jeśli poprzednia próba odłączenia dysku danych nie została ukończona z powodu nieoczekiwanego błędu z maszyny wirtualnej, a dysk nadal nie został zwolniony, użyj opcji wymuszania odłączania jako opcji ostatniej próby odłączenia dysku, aby zmusić dysk do wymuszonego odłączenia od maszyny wirtualnej. Wszystkie zapisy mogły nie zostać opróżnione podczas korzystania z tego zachowania odłączania. Ta funkcja jest nadal dostępna w wersji zapoznawczej. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".
diskIOPSReadWrite	integer (int64)	Określa Read-Write liczby operacji we/wy na sekundę dla dysku zarządzanego, gdy parametr StorageAccountType jest UltraSSD_LRS.
diskMBpsReadWrite	integer (int64)	Określa przepustowość w MB na sekundę dla dysku zarządzanego, gdy parametr StorageAccountType jest UltraSSD_LRS.
diskSizeGB	integer (int32)	Określa rozmiar pustego dysku danych w gigabajtach. Za pomocą tego elementu można zastąpić rozmiar dysku na obrazie maszyny wirtualnej. Właściwość "diskSizeGB" jest liczbą bajtów x 1024^3 dla dysku, a wartość nie może być większa niż 1023.
image	VirtualHardDisk	Źródłowy obraz użytkownika wirtualny dysk twardy. Wirtualny dysk twardy zostanie skopiowany przed przyłączeniem do maszyny wirtualnej. Jeśli parametr SourceImage jest podany, docelowy wirtualny dysk twardy nie może istnieć.
lun	integer (int32)	Określa numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej.
managedDisk	ManagedDiskParameters	Parametry dysku zarządzanego.
name	string	Nazwa dysku.
sourceResource	ApiEntityReference	Identyfikator zasobu źródłowego. Może to być migawka lub punkt przywracania dysku, z którego ma zostać utworzony dysk.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Określa typ wyrównania domeny błędów pamięci masowej dla dysku.
toBeDetached	boolean	Określa, czy dysk danych jest w trakcie odłączania od zestawu VirtualMachine/VirtualMachineScaleset
vhd	VirtualHardDisk	Wirtualny dysk twardy.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

DataDisksToAttach

Objekt

Opisuje dysk danych, który ma zostać dołączony.

Nazwisko	Typ	Opis
caching	CachingTypes	Określa wymagania dotyczące buforowania. Możliwe wartości to: None,ReadOnly,ReadWrite. Domyślne zachowanie to: Brak dla magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage.
deleteOption	DiskDeleteOptionTypes	Określa, czy dysk danych ma zostać usunięty, czy odłączony po usunięciu maszyny wirtualnej. Możliwe wartości to: Usuń. Jeśli ta wartość jest używana, dysk danych zostanie usunięty po usunięciu maszyny wirtualnej. Odłączyć. Jeśli ta wartość jest używana, dysk danych jest zachowywany po usunięciu maszyny wirtualnej. Wartość domyślna jest ustawiona na wartość Detach.
diskEncryptionSet	DiskEncryptionSetParameters	Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego.
diskId	string	Identyfikator dysku danych zarządzanych.
lun	integer (int32)	Numer jednostki logicznej dysku danych. Ta wartość służy do identyfikowania dysków danych na maszynie wirtualnej i dlatego musi być unikatowa dla każdego dysku danych dołączonego do maszyny wirtualnej. Jeśli nie zostanie określony, jednostka lun zostanie przypisana automatycznie.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

DataDisksToDetach

Objekt

Opisuje dysk danych, który ma być odłączony.

Nazwisko	Typ	Opis
detachOption	DiskDetachOptionTypes	Obsługiwane opcje dostępne dla odłączania dysku od maszyny wirtualnej. Aby uzyskać więcej informacji, zapoznaj się z dokumentacją obiektu DetachOption.
diskId	string	Identyfikator dysku danych zarządzanych.

DiffDiskOptions

Wyliczenie

Określa opcję dysku efemerycznego dla dysku systemu operacyjnego.

Wartość	Opis
Local

DiffDiskPlacement

Wyliczenie

Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego. Ta właściwość może być używana przez użytkownika w żądaniu, aby wybrać lokalizację, tj. dysk pamięci podręcznej, dysk zasobu lub miejsce na dysku nvme na potrzeby aprowizacji efemerycznego dysku systemu operacyjnego. Aby uzyskać więcej informacji na temat wymagań dotyczących rozmiaru dysku efemerycznego systemu operacyjnego, zobacz Wymagania dotyczące rozmiaru dysku efemerycznego systemu operacyjnego dla maszyny wirtualnej z systemem Windows w https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements i maszynie wirtualnej z systemem Linux w witrynie https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimalna wersja interfejsu API dla nvmeDisk: 2024-03-01.

Wartość	Opis
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Objekt

Opisuje parametry ustawień dysku efemerycznego, które można określić dla dysku systemu operacyjnego. Uwaga: Ustawienia dysku efemerycznego można określić tylko dla dysku zarządzanego.

Nazwisko	Typ	Opis
enableFullCaching	boolean	Określa, czy należy włączyć pełne buforowanie dla tej maszyny wirtualnej, co pozwoli buforować dysk systemu operacyjnego lokalnie na hostze i uczyni tę maszynę bardziej odporną na awarie pamięci
option	DiffDiskOptions	Określa ustawienia dysku efemerycznego dla dysku systemu operacyjnego.
placement	DiffDiskPlacement	Określa efemeryczne umieszczanie dysku dla dysku systemu operacyjnego. Możliwe wartości to: CacheDisk,ResourceDisk,NvmeDisk. Domyślne zachowanie to: CacheDisk, jeśli jest skonfigurowany dla rozmiaru maszyny wirtualnej, w przeciwnym razie ResourceDisk lub NvmeDisk. Zapoznaj się z dokumentacją dotyczącą rozmiaru maszyny wirtualnej z systemem Windows na https://docs.microsoft.com/azure/virtual-machines/windows/sizes i maszynie wirtualnej z systemem Linux w https://docs.microsoft.com/azure/virtual-machines/linux/sizes, aby sprawdzić, które rozmiary maszyn wirtualnych uwidacznia dysk pamięci podręcznej. Minimalna wersja interfejsu API dla nvmeDisk: 2024-03-01.

DiskApiVersion

Wyliczenie

Określa wersję API dysku używaną przy stosowaniu dodatkowych właściwości Dysku do zarządzanych dysków. Wartość musi być w formacie YYYY-MM-DD.

Wartość	Opis
2025-01-02	Wersja API Disk RP 2025-01-02.
2026-03-02	Wersja API Disk RP 2026-03-02.

DiskAvailabilityPolicy

Objekt

W przypadku problemu z dostępnością lub łącznością dysku, określ zachowanie maszyny wirtualnej.

Nazwisko	Typ	Opis
actionOnDiskDelay	AvailabilityPolicyDiskDelay	Określa sposób obsługi dysków z powolnym we/wy.

DiskControllerTypes

Wyliczenie

Określa typ kontrolera dysku skonfigurowany dla maszyny wirtualnej i virtualMachineScaleSet. Ta właściwość jest obsługiwana tylko w przypadku maszyn wirtualnych, których dysk systemu operacyjnego i jednostka SKU maszyny wirtualnej obsługuje generację 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), sprawdź funkcję HyperVGenerations zwróconą jako część możliwości jednostki SKU maszyny wirtualnej w odpowiedzi interfejsu API jednostek SKU Microsoft.Compute dla regionu zawiera V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Aby uzyskać więcej informacji o obsługiwanych typach kontrolera dysków, zobacz https://aka.ms/azure-diskcontrollertypes.

Wartość	Opis
SCSI
NVMe

DiskCreateOptionTypes

Wyliczenie

Określa sposób tworzenia dysku maszyny wirtualnej. Możliwe wartości to Attach: Ta wartość jest używana podczas tworzenia maszyny wirtualnej za pomocą wyspecjalizowanego dysku. FromImage: Ta wartość jest używana podczas tworzenia maszyny wirtualnej przy użyciu obrazu. Jeśli używasz obrazu platformy, należy również użyć elementu imageReference opisanego powyżej. Jeśli używasz obrazu z witryny Marketplace, należy również użyć wcześniej opisanego elementu planu. Empty: Ta wartość jest używana podczas tworzenia pustego dysku danych. Kopiuj: Ta wartość służy do tworzenia dysku danych na podstawie migawki lub innego dysku. Przywracanie: Ta wartość służy do tworzenia dysku danych z punktu przywracania dysku.

Wartość	Opis
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Wyliczenie

Określa zachowanie dysku zarządzanego po usunięciu maszyny wirtualnej, na przykład czy dysk zarządzany jest usuwany, czy odłączany. Obsługiwane wartości to: Delete. Jeśli ta wartość jest używana, dysk zarządzany zostanie usunięty po usunięciu maszyny wirtualnej. Odłączyć. Jeśli ta wartość jest używana, dysk zarządzany jest zachowywany po usunięciu maszyny wirtualnej. Minimalna wersja interfejsu API: 2021-03-01.

Wartość	Opis
Delete
Detach

DiskDetachOptionTypes

Wyliczenie

Określa zachowanie odłączania, które ma być używane podczas odłączania dysku lub który jest już w trakcie odłączania od maszyny wirtualnej. Obsługiwane wartości to: ForceDetach. detachOption: ForceDetach ma zastosowanie tylko do zarządzanych dysków danych. Jeśli poprzednia próba odłączenia dysku danych nie została ukończona z powodu nieoczekiwanego błędu z maszyny wirtualnej, a dysk nadal nie został zwolniony, użyj opcji wymuszania odłączania jako opcji ostatniej próby odłączenia dysku, aby zmusić dysk do wymuszonego odłączenia od maszyny wirtualnej. Wszystkie zapisy mogły nie zostać opróżnione podczas korzystania z tego zachowania odłączania. Ta funkcja jest nadal dostępna w wersji zapoznawczej. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".

Wartość	Opis
ForceDetach

DiskEncryptionSetParameters

Objekt

Opisuje parametr zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta, który można określić dla dysku. Uwaga: Identyfikator zasobu zestawu szyfrowania dysku można określić tylko dla dysku zarządzanego. Aby uzyskać więcej informacji, zobacz https://aka.ms/mdssewithcmkoverview.

Nazwisko	Typ	Opis
id	string	Identyfikator zasobu

DiskEncryptionSettings

Objekt

Opisuje ustawienia szyfrowania dysku

Nazwisko	Typ	Opis
diskEncryptionKey	KeyVaultSecretReference	Określa lokalizację klucza szyfrowania dysku, który jest kluczem tajnym usługi Key Vault.
enabled	boolean	Określa, czy szyfrowanie dysków powinno być włączone na maszynie wirtualnej.
keyEncryptionKey	KeyVaultKeyReference	Określa lokalizację klucza szyfrowania klucza w usłudze Key Vault.

ImageReference

Objekt

Określa informacje o obrazie do użycia. Możesz określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu witryny Marketplace lub obrazu maszyny wirtualnej, ale nie jest używany w innych operacjach tworzenia. UWAGA: Wydawca i oferta odwołania do obrazów można ustawić tylko podczas tworzenia zestawu skalowania.

Nazwisko	Typ	Opis
communityGalleryImageId	string	Określono unikatowy identyfikator obrazu galerii społeczności dla wdrożenia maszyny wirtualnej. Można to pobrać z poziomu wywołania GET obrazu galerii społeczności.
exactVersion	string	Określa w liczbach dziesiętnych, wersję obrazu platformy lub obraz witryny Marketplace używany do tworzenia maszyny wirtualnej. To pole tylko do odczytu różni się od "wersji", tylko wtedy, gdy wartość określona w polu "version" to "latest".
id	string	Identyfikator zasobu
offer	string	Określa ofertę obrazu platformy lub obrazu platformy handlowej użytego do utworzenia maszyny wirtualnej.
publisher	string	Wydawca obrazów.
sharedGalleryImageId	string	Określono unikatowy identyfikator obrazu galerii udostępnionej dla wdrożenia maszyny wirtualnej. Można to pobrać z udostępnionego wywołania GET obrazu galerii.
sku	string	Jednostka SKU obrazu.
version	string	Określa wersję obrazu platformy lub obrazu platformy handlowej użytego do utworzenia maszyny wirtualnej. Dozwolone formaty to Major.Minor.Build lub 'latest'. Główne, pomocnicze i kompilacje to liczby dziesiętne. Określ wartość "latest", aby użyć najnowszej wersji obrazu dostępnego w czasie wdrażania. Nawet jeśli używasz polecenia "latest", obraz maszyny wirtualnej nie zostanie automatycznie zaktualizowany po czasie wdrażania, nawet jeśli nowa wersja stanie się dostępna. Nie należy używać pola "version" dla wdrożenia obrazu galerii, obraz galerii powinien zawsze używać pola "id" do wdrożenia, aby użyć "latest" wersji obrazu galerii, po prostu ustaw wartość "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}" w polu "id" bez danych wejściowych wersji.

InnerError

Objekt

Szczegóły błędu wewnętrznego.

Nazwisko	Typ	Opis
errordetail	string	Wewnętrzny komunikat o błędzie lub zrzut wyjątku.
exceptiontype	string	Typ wyjątku.

KeyVaultKeyReference

Objekt

Opisuje odwołanie do klucza usługi Key Vault

Nazwisko	Typ	Opis
keyUrl	string	Adres URL odwołujący się do klucza szyfrowania klucza w usłudze Key Vault.
sourceVault	SubResource	Względny adres URL usługi Key Vault zawierający klucz.

KeyVaultSecretReference

Objekt

Opisuje odwołanie do wpisu tajnego usługi Key Vault

Nazwisko	Typ	Opis
secretUrl	string	Adres URL odwołujący się do wpisu tajnego w usłudze Key Vault.
sourceVault	SubResource	Względny adres URL usługi Key Vault zawierający wpis tajny.

ManagedDiskParameters

Objekt

Parametry dysku zarządzanego.

Nazwisko	Typ	Opis
additionalDiskProperties	AdditionalDiskProperties	Określa dodatkowe właściwości dla zarządzanego dysku, które można ustawić w momencie niejawnego utworzenia dysku. Ta własność nie jest rejestrowana dla punktów przywracania.
diskEncryptionSet	DiskEncryptionSetParameters	Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego.
id	string	Identyfikator zasobu
securityProfile	VMDiskSecurityProfile	Określa profil zabezpieczeń dysku zarządzanego.
storageAccountType	StorageAccountTypes	Określa typ konta magazynu dla dysku zarządzanego. UWAGA: UltraSSD_LRS można używać tylko z dyskami danych. Nie można jej używać z dyskiem systemu operacyjnego.

ManagedDiskProperties

Objekt

Określa właściwości zarządzanego dysku, które można ustawić w momencie ukrytego utworzenia dysku.

Nazwisko	Typ	Opis
availabilityPolicy	DiskAvailabilityPolicy	W przypadku problemu z dostępnością lub łącznością dysku, określ zachowanie maszyny wirtualnej.
burstingEnabled	boolean	Ustaw wartość true, aby włączyć zwiększenie wydajności poza aprowizowaną wartość docelową wydajności dysku. "Wyburzanie jest domyślnie wyłączone." Nie dotyczy dysków w warstwie Ultra.
diskAccessId	string	Azure resource Id zasobu DiskAccess do używania prywatnych punktów końcowych na dyskach.
diskIOPSReadOnly	integer (int64)	Całkowita liczba operacji we/wy na sekundę, która będzie dozwolona na wszystkich maszynach wirtualnych instalowania dysku udostępnionego jako ReadOnly. Jedna operacja może przesyłać od 4k do 256 tys. bajtów.
diskMBpsReadOnly	integer (int64)	Łączna przepływność (MB/s), która będzie dozwolona na wszystkich maszynach wirtualnych instalowania dysku udostępnionego jako ReadOnly. Mb/s oznacza miliony bajtów na sekundę - MB w tym miejscu używa notacji ISO, mocy 10.
logicalSectorSize	integer (int32)	Rozmiar logicznego sektora w bajtach dla Ultra Disków. Obsługiwane wartości to 512 i 4096. Wartość domyślna to 4096.
maxShares	integer (int32) minimum: 1	Maksymalna liczba maszyn wirtualnych, które mogą być dołączane do dysku w tym samym czasie. Wartość większa niż jedna wskazuje dysk, który można instalować na wielu maszynach wirtualnych jednocześnie. Dotyczy to tylko dysków danych.
networkAccessPolicy	NetworkAccessPolicy	Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.
optimizedForFrequentAttach	boolean	Ustawienie tej właściwości na prawdziwą zwiększa niezawodność i wydajność dysków danych, które często (ponad 5 razy dziennie) są odłączane od jednej maszyny wirtualnej i dołączane do innej. Ta właściwość nie powinna być ustawiana dla dysków, które nie są odłączone i dołączone często, ponieważ powoduje, że dyski nie są zgodne z domeną błędów maszyny wirtualnej.
performancePlus	boolean	Ustaw tę flagę na true, aby zwiększyć wydajność docelową wdrożonego dysku. Tę flagę można ustawić tylko w czasie tworzenia dysku i nie można jej wyłączyć po włączeniu.
tier	string	Poziom wydajności dysku (np. P4, S10) opisany tutaj: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Nie dotyczy dysków w warstwie Ultra.

NetworkAccessPolicy

Wyliczenie

Zasady uzyskiwania dostępu do dysku za pośrednictwem sieci.

Wartość	Opis
AllowAll	Dysk może być eksportowany lub przesyłany z dowolnej sieci.
AllowPrivate	Dysk może być eksportowany lub przesyłany za pomocą prywatnych punktów końcowych zasobu DiskAccess.
DenyAll	Nie można wyeksportować dysku.

OperatingSystemTypes

Wyliczenie

Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku w przypadku tworzenia maszyny wirtualnej na podstawie obrazu niestandardowego. Możliwe wartości to: Windows,Linux.

Wartość	Opis
Windows
Linux

OSDisk

Objekt

Określa informacje o dysku systemu operacyjnego używanego przez maszynę wirtualną. Aby uzyskać więcej informacji na temat dysków, zobacz Informacje o dyskach i dyskach VHD dla maszyn wirtualnych platformy Azure.

Nazwisko	Typ	Opis
caching	CachingTypes	Określa wymagania dotyczące buforowania. Możliwe wartości to: None,ReadOnly,ReadWrite. Domyślne zachowanie to: Brak dla magazynu w warstwie Standardowa. Funkcja ReadOnly dla usługi Premium Storage.
createOption	DiskCreateOptionTypes	Określa sposób tworzenia dysku maszyny wirtualnej. Możliwe wartości to Attach: Ta wartość jest używana podczas tworzenia maszyny wirtualnej za pomocą wyspecjalizowanego dysku. FromImage: Ta wartość jest używana podczas tworzenia maszyny wirtualnej przy użyciu obrazu. Jeśli używasz obrazu platformy, należy również użyć elementu imageReference opisanego powyżej. Jeśli używasz obrazu z witryny Marketplace, należy również użyć wcześniej opisanego elementu planu.
deleteOption	DiskDeleteOptionTypes	Określa, czy dysk systemu operacyjnego ma zostać usunięty, czy odłączony po usunięciu maszyny wirtualnej. Możliwe wartości to: Usuń. Jeśli ta wartość jest używana, dysk systemu operacyjnego zostanie usunięty po usunięciu maszyny wirtualnej. Odłączyć. Jeśli ta wartość jest używana, dysk systemu operacyjnego jest zachowywany po usunięciu maszyny wirtualnej. Wartość domyślna jest ustawiona na wartość Detach. W przypadku efemerycznego dysku systemu operacyjnego wartość domyślna jest ustawiona na wartość Usuń. Użytkownik nie może zmienić opcji usuwania dla efemerycznego dysku systemu operacyjnego.
diffDiskSettings	DiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.
diskSizeGB	integer (int32)	Określa rozmiar pustego dysku danych w gigabajtach. Za pomocą tego elementu można zastąpić rozmiar dysku na obrazie maszyny wirtualnej. Właściwość "diskSizeGB" jest liczbą bajtów x 1024^3 dla dysku, a wartość nie może być większa niż 1023.
encryptionSettings	DiskEncryptionSettings	Określa ustawienia szyfrowania dysku systemu operacyjnego. Minimalna wersja interfejsu API: 2015-06-15.
image	VirtualHardDisk	Źródłowy obraz użytkownika wirtualny dysk twardy. Wirtualny dysk twardy zostanie skopiowany przed przyłączeniem do maszyny wirtualnej. Jeśli parametr SourceImage jest podany, docelowy wirtualny dysk twardy nie może istnieć.
managedDisk	ManagedDiskParameters	Parametry dysku zarządzanego.
name	string	Nazwa dysku.
osType	OperatingSystemTypes	Ta właściwość umożliwia określenie typu systemu operacyjnego dołączonego do dysku, jeśli tworzysz maszynę wirtualną na podstawie obrazu użytkownika lub wyspecjalizowanego wirtualnego dysku twardego. Możliwe wartości to: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Określa typ wyrównania domeny błędów pamięci masowej dla dysku.
vhd	VirtualHardDisk	Wirtualny dysk twardy.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

SecurityEncryptionTypes

Wyliczenie

Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na DiskWithVMGuestState na potrzeby szyfrowania dysku zarządzanego wraz z vmGuestState blob, VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: Można go ustawić tylko dla poufnych maszyn wirtualnych.

Wartość	Opis
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Wyliczenie

Określa typ konta magazynu dla dysku zarządzanego. Typ konta magazynu dysku zarządzanego systemu operacyjnego można ustawić tylko podczas tworzenia zestawu skalowania. UWAGA: UltraSSD_LRS można używać tylko z dyskami danych. Nie można go używać z dyskiem systemu operacyjnego. Standard_LRS używa hdd w warstwie Standardowa. StandardSSD_LRS używa dysków SSD w warstwie Standardowa. Premium_LRS używa dysków SSD w warstwie Premium. UltraSSD_LRS używa dysku w warstwie Ultra. Premium_ZRS używa magazynu strefowo nadmiarowego SSD w warstwie Premium. StandardSSD_ZRS używa magazynu strefowo nadmiarowego SSD w warstwie Standardowa. Aby uzyskać więcej informacji na temat dysków obsługiwanych w przypadku maszyn wirtualnych z systemem Windows, zobacz https://docs.microsoft.com/azure/virtual-machines/windows/disks-types i, w przypadku maszyn wirtualnych z systemem Linux, zobacz https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Wartość	Opis
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Wyliczenie

Określa typ wyrównania domeny błędów pamięci masowej dla dysku.

Wartość	Opis
Aligned	Domeny błędów pamięci dyskowej są mapowane na domeny błędów obliczeniowych. Wdrożenie kończy się niepowodzeniem, jeśli dysk nie obsługuje wystarczającej liczby domen błędów.
BestEffortAligned	Spróbuj odwzorować domeny błędów pamięci masowej na domeny błędów obliczania. Dyski są niewyrównane, jeśli dysk nie obsługuje wystarczającej liczby domen błędów.

StorageProfile

Objekt

Określa ustawienia magazynu dla dysków maszyny wirtualnej.

Nazwisko	Typ	Opis
alignRegionalDisksToVMZone	boolean	Określa, czy dyski regionalne powinny być wyrównane/przeniesione do strefy maszyny wirtualnej. Dotyczy to tylko maszyn wirtualnych z zestawem właściwości umieszczania. Należy pamiętać, że ta zmiana jest nieodwracalna. Minimalna wersja interfejsu API: 2024-11-01.
dataDisks	DataDisk[]	Określa parametry używane do dodawania dysku danych do maszyny wirtualnej. Aby uzyskać więcej informacji na temat dysków, zobacz Informacje o dyskach i dyskach VHD dla maszyn wirtualnych platformy Azure.
diskApiVersion	DiskApiVersion	Określa wersję API dysku używaną przy stosowaniu dodatkowych właściwości Dysku do zarządzanych dysków. Wartość musi być w formacie YYYY-MM-DD (np. "2026-03-02").
diskControllerType	DiskControllerTypes	Określa typ kontrolera dysku skonfigurowany dla maszyny wirtualnej. Uwaga: Ta właściwość zostanie ustawiona na domyślny typ kontrolera dysku, jeśli nie zostanie określona podana maszyna wirtualna zostanie utworzona z ustawieniem "hyperVGeneration" na wartość V2 na podstawie możliwości dysku systemu operacyjnego i rozmiaru maszyny wirtualnej z określonej minimalnej wersji interfejsu API. Przed zaktualizowaniem typu kontrolera dysku należy cofnąć przydział maszyny wirtualnej, chyba że aktualizujesz rozmiar maszyny wirtualnej w konfiguracji maszyny wirtualnej, która niejawnie cofnie przydział i cofa przydział maszyny wirtualnej. Minimalna wersja interfejsu API: 2022-08-01.
imageReference	ImageReference	Określa informacje o obrazie do użycia. Możesz określić informacje o obrazach platformy, obrazach witryny Marketplace lub obrazach maszyn wirtualnych. Ten element jest wymagany, gdy chcesz użyć obrazu platformy, obrazu witryny Marketplace lub obrazu maszyny wirtualnej, ale nie jest używany w innych operacjach tworzenia.
osDisk	OSDisk	Określa informacje o dysku systemu operacyjnego używanego przez maszynę wirtualną. Aby uzyskać więcej informacji na temat dysków, zobacz Informacje o dyskach i dyskach VHD dla maszyn wirtualnych platformy Azure.

SubResource

Objekt

Nazwisko	Typ	Opis
id	string	Identyfikator zasobu

VirtualHardDisk

Objekt

Opisuje identyfikator URI dysku.

Nazwisko	Typ	Opis
uri	string	Określa identyfikator URI wirtualnego dysku twardego.

VMDiskSecurityProfile

Objekt

Określa ustawienia profilu zabezpieczeń dla dysku zarządzanego. Uwaga: Można go ustawić tylko dla poufnych maszyn wirtualnych.

Nazwisko	Typ	Opis
diskEncryptionSet	DiskEncryptionSetParameters	Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysku zarządzanego klienta, który jest używany dla zaszyfrowanego dysku systemu operacyjnego systemu operacyjnego i vmGuest klucza zarządzanego przez klienta.
securityEncryptionType	SecurityEncryptionTypes	Określa typ szyfrowania dysku zarządzanego. Jest ona ustawiona na DiskWithVMGuestState na potrzeby szyfrowania dysku zarządzanego wraz z vmGuestState blob, VMGuestStateOnly na potrzeby szyfrowania tylko obiektu blob VMGuestState i nonPersistedTPM dla nietrwałego stanu oprogramowania układowego w obiekcie blob VMGuestState. Uwaga: Można go ustawić tylko dla poufnych maszyn wirtualnych.