Virtual Machines - Attach Detach Data Disks

Odwołanie

Usługa:: Compute

Wersja interfejsu API:: 2024-07-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=2024-07-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
resourceGroupName	path	True	string	Nazwa grupy zasobów.
subscriptionId	path	True	string	Poświadczenia subskrypcji, które jednoznacznie identyfikują subskrypcję platformy Microsoft Azure. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.
vmName	path	True	string	Nazwa maszyny wirtualnej.
api-version	query	True	string	Wersja interfejsu API klienta.

Treść żądania

Nazwa	Typ	Opis
parameters	AttachDetachDataDisksRequest	Parametry dostarczone do operacji dołączania i odłączania dysków danych na maszynie wirtualnej.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	StorageProfile	OK
202 Accepted		Akceptowane Nagłówki Location: string
Other Status Codes	CloudError	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Nazwa

Typ

Opis

200 OK

StorageProfile

202 Accepted

Akceptowane

Nagłówki

Location: string

Other Status Codes

CloudError

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory

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

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta 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=2024-07-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:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        virtualMachineAttachDetachDataDisksMaximumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().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: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
if __name__ == "__main__":
    main()

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

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
func ExampleVirtualMachinesClient_BeginAttachDetachDataDisks_virtualMachineAttachDetachDataDisksMaximumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginAttachDetachDataDisks(ctx, "rgcompute", "aaaaaaaaaaaaaaaaaaaa", armcompute.AttachDetachDataDisksRequest{
		DataDisksToAttach: []*armcompute.DataDisksToAttach{
			{
				Caching:      to.Ptr(armcompute.CachingTypesReadOnly),
				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
				},
				DiskID:                  to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
				Lun:                     to.Ptr[int32](1),
				WriteAcceleratorEnabled: to.Ptr(true),
			},
			{
				Caching:      to.Ptr(armcompute.CachingTypesReadWrite),
				DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
				},
				DiskID:                  to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
				Lun:                     to.Ptr[int32](2),
				WriteAcceleratorEnabled: to.Ptr(false),
			}},
		DataDisksToDetach: []*armcompute.DataDisksToDetach{
			{
				DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
				DiskID:       to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"),
			},
			{
				DetachOption: to.Ptr(armcompute.DiskDetachOptionTypesForceDetach),
				DiskID:       to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z"),
			}},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.StorageProfile = armcompute.StorageProfile{
	// 	DataDisks: []*armcompute.DataDisk{
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadOnly),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDelete),
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 			Lun: to.Ptr[int32](1),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
	// 				},
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 			WriteAcceleratorEnabled: to.Ptr(true),
	// 		},
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DeleteOption: to.Ptr(armcompute.DiskDeleteOptionTypesDetach),
	// 			DiskSizeGB: to.Ptr[int32](100),
	// 			Lun: to.Ptr[int32](2),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e"),
	// 				DiskEncryptionSet: &armcompute.DiskEncryptionSetParameters{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
	// 				},
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 			WriteAcceleratorEnabled: to.Ptr(false),
	// 	}},
	// 	ImageReference: &armcompute.ImageReference{
	// 		Offer: to.Ptr("WindowsServer"),
	// 		Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 		SKU: to.Ptr("2016-Datacenter"),
	// 		Version: to.Ptr("latest"),
	// 	},
	// 	OSDisk: &armcompute.OSDisk{
	// 		Name: to.Ptr("myOsDisk"),
	// 		Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 		CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 		DiskSizeGB: to.Ptr[int32](30),
	// 		ManagedDisk: &armcompute.ManagedDiskParameters{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 		},
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 	},
	// }
}

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

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

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

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen.json
// this example is just showing the usage of "VirtualMachines_AttachDetachDataDisks" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://zcusa.951200.xyz/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineResource created on azure
// for more information of creating VirtualMachineResource, please refer to the document of VirtualMachineResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string vmName = "aaaaaaaaaaaaaaaaaaaa";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
AttachDetachDataDisksRequest attachDetachDataDisksRequest = new AttachDetachDataDisksRequest
{
    DataDisksToAttach = {new DataDisksToAttach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d")
    {
    Lun = 1,
    Caching = CachingType.ReadOnly,
    DeleteOption = DiskDeleteOptionType.Delete,
    DiskEncryptionSetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
    WriteAcceleratorEnabled = true,
    }, new DataDisksToAttach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e")
    {
    Lun = 2,
    Caching = CachingType.ReadWrite,
    DeleteOption = DiskDeleteOptionType.Detach,
    DiskEncryptionSetId = new ResourceIdentifier("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"),
    WriteAcceleratorEnabled = false,
    }},
    DataDisksToDetach = {new DataDisksToDetach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x")
    {
    DetachOption = DiskDetachOptionType.ForceDetach,
    }, new DataDisksToDetach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z")
    {
    DetachOption = DiskDetachOptionType.ForceDetach,
    }},
};
ArmOperation<VirtualMachineStorageProfile> lro = await virtualMachine.AttachDetachDataDisksAsync(WaitUntil.Completed, attachDetachDataDisksRequest);
VirtualMachineStorageProfile result = lro.Value;

Console.WriteLine($"Succeeded: {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=2024-07-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:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/
     * virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
     */
    /**
     * Sample code: VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        virtualMachineAttachDetachDataDisksMinimumSetGen(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().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: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
if __name__ == "__main__":
    main()

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

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/069a65e8a6d1a6c0c58d9a9d97610b7103b6e8a5/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
func ExampleVirtualMachinesClient_BeginAttachDetachDataDisks_virtualMachineAttachDetachDataDisksMinimumSetGen() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginAttachDetachDataDisks(ctx, "rgcompute", "azure-vm", armcompute.AttachDetachDataDisksRequest{
		DataDisksToAttach: []*armcompute.DataDisksToAttach{
			{
				DiskID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
			}},
		DataDisksToDetach: []*armcompute.DataDisksToDetach{
			{
				DiskID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"),
			}},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.StorageProfile = armcompute.StorageProfile{
	// 	DataDisks: []*armcompute.DataDisk{
	// 		{
	// 			Name: to.Ptr("vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 			Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 			DiskSizeGB: to.Ptr[int32](30),
	// 			Lun: to.Ptr[int32](0),
	// 			ManagedDisk: &armcompute.ManagedDiskParameters{
	// 				ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"),
	// 				StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 			},
	// 	}},
	// 	ImageReference: &armcompute.ImageReference{
	// 		Offer: to.Ptr("WindowsServer"),
	// 		Publisher: to.Ptr("MicrosoftWindowsServer"),
	// 		SKU: to.Ptr("2016-Datacenter"),
	// 		Version: to.Ptr("latest"),
	// 	},
	// 	OSDisk: &armcompute.OSDisk{
	// 		Name: to.Ptr("myOsDisk"),
	// 		Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 		CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesFromImage),
	// 		DiskSizeGB: to.Ptr[int32](30),
	// 		ManagedDisk: &armcompute.ManagedDiskParameters{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"),
	// 			StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 		},
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 	},
	// }
}

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

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

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

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-07-01/examples/virtualMachineExamples/VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen.json
// this example is just showing the usage of "VirtualMachines_AttachDetachDataDisks" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://zcusa.951200.xyz/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineResource created on azure
// for more information of creating VirtualMachineResource, please refer to the document of VirtualMachineResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "rgcompute";
string vmName = "azure-vm";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
AttachDetachDataDisksRequest attachDetachDataDisksRequest = new AttachDetachDataDisksRequest
{
    DataDisksToAttach = { new DataDisksToAttach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d") },
    DataDisksToDetach = { new DataDisksToDetach("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x") },
};
ArmOperation<VirtualMachineStorageProfile> lro = await virtualMachine.AttachDetachDataDisksAsync(WaitUntil.Completed, attachDetachDataDisksRequest);
VirtualMachineStorageProfile result = lro.Value;

Console.WriteLine($"Succeeded: {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

Nazwa	Opis
ApiEntityReference	Identyfikator zasobu źródłowego. Może to być migawka lub punkt przywracania dysku, z którego ma zostać utworzony dysk.
ApiError	Błąd interfejsu API.
ApiErrorBase	Baza błędów interfejsu API.
AttachDetachDataDisksRequest	Parametry dostarczone do operacji dołączania i odłączania dysków danych na maszynie wirtualnej.
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.
CloudError	Odpowiedź na błąd z usługi Obliczeniowej.
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.
DataDisksToAttach	Lista dysków danych zarządzanych do dołączenia.
DataDisksToDetach	Lista dysków danych zarządzanych do odłączenia.
DiffDiskOptions	Określa ustawienia dysku efemerycznego dla dysku systemu operacyjnego.
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.
DiffDiskSettings	Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.
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.
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.
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.
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. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".
DiskEncryptionSetParameters	Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego.
DiskEncryptionSettings	Określa ustawienia szyfrowania dysku systemu operacyjnego. Minimalna wersja interfejsu API: 2015-06-15.
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.
InnerError	Szczegóły błędu wewnętrznego.
KeyVaultKeyReference	Określa lokalizację klucza szyfrowania klucza w usłudze Key Vault.
KeyVaultSecretReference	Określa lokalizację klucza szyfrowania dysku, który jest kluczem tajnym usługi Key Vault.
ManagedDiskParameters	Parametry dysku zarządzanego.
OperatingSystemTypes	Typ systemu operacyjnego.
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. UWAGA: UltraSSD_LRS można używać tylko z dyskami danych. Nie można jej używać z dyskiem systemu operacyjnego.
StorageProfile	Określa ustawienia magazynu dla dysków maszyny wirtualnej.
SubResource
VirtualHardDisk	Wirtualny dysk twardy.
VMDiskSecurityProfile	Określa profil zabezpieczeń dysku zarządzanego.

ApiEntityReference

Identyfikator zasobu źródłowego. Może to być migawka lub punkt przywracania dysku, z którego ma zostać utworzony dysk.

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

ApiError

Błąd interfejsu API.

Nazwa	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

Baza błędów interfejsu API.

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

AttachDetachDataDisksRequest

Parametry dostarczone do operacji dołączania i odłączania dysków danych na maszynie wirtualnej.

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

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.

Nazwa	Typ	Opis
None	string
ReadOnly	string
ReadWrite	string

CloudError

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

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

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.

Nazwa	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. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".
diskIOPSReadWrite	integer	Określa Read-Write liczby operacji we/wy na sekundę dla dysku zarządzanego, gdy parametr StorageAccountType jest UltraSSD_LRS. Zwrócone tylko dla dysków maszyn wirtualnych VirtualMachine ScaleSet. Można aktualizować tylko za pośrednictwem aktualizacji zestawu skalowania VirtualMachine.
diskMBpsReadWrite	integer	Określa przepustowość w MB na sekundę dla dysku zarządzanego, gdy parametr StorageAccountType jest UltraSSD_LRS. Zwrócone tylko dla dysków maszyn wirtualnych VirtualMachine ScaleSet. Można aktualizować tylko za pośrednictwem aktualizacji zestawu skalowania VirtualMachine.
diskSizeGB	integer	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	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.
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

Lista dysków danych zarządzanych do dołączenia.

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

Lista dysków danych zarządzanych do odłączenia.

Nazwa	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

Określa ustawienia dysku efemerycznego dla dysku systemu operacyjnego.

Nazwa	Typ	Opis
Local	string

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.

Nazwa	Typ	Opis
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

Określa efemeryczne ustawienia dysku dla dysku systemu operacyjnego używanego przez maszynę wirtualną.

Nazwa	Typ	Opis
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.

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.

Nazwa	Typ	Opis
NVMe	string
SCSI	string

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.

Nazwa	Typ	Opis
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

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.

Nazwa	Typ	Opis
Delete	string
Detach	string

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. Aby wymusić odłączenie aktualizacji dysku danych na wartość "true" wraz z ustawieniem detachOption: "ForceDetach".

Nazwa	Typ	Opis
ForceDetach	string

DiskEncryptionSetParameters

Określa identyfikator zasobu zestawu zasobów zestawu szyfrowania dysków zarządzanych przez klienta dla dysku zarządzanego.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu

DiskEncryptionSettings

Określa ustawienia szyfrowania dysku systemu operacyjnego. Minimalna wersja interfejsu API: 2015-06-15.

Nazwa	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

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.

Nazwa	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

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

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

KeyVaultKeyReference

Określa lokalizację klucza szyfrowania klucza w usłudze Key Vault.

Nazwa	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

Określa lokalizację klucza szyfrowania dysku, który jest kluczem tajnym usługi Key Vault.

Nazwa	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

Parametry dysku zarządzanego.

Nazwa	Typ	Opis
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.

OperatingSystemTypes

Typ systemu operacyjnego.

Nazwa	Typ	Opis
Linux	string
Windows	string

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.

Nazwa	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	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.
vhd	VirtualHardDisk	Wirtualny dysk twardy.
writeAcceleratorEnabled	boolean	Określa, czy na dysku należy włączyć lub wyłączyć funkcję writeAccelerator.

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.

Nazwa	Typ	Opis
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

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.

Nazwa	Typ	Opis
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

StorageProfile

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

Nazwa	Typ	Opis
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.
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

Nazwa	Typ	Opis
id	string	Identyfikator zasobu

VirtualHardDisk

Wirtualny dysk twardy.

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

VMDiskSecurityProfile

Określa profil zabezpieczeń dysku zarządzanego.

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

Udostępnij za pośrednictwem

Virtual Machines - Attach Detach Data Disks

Parametry identyfikatora URI

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Przykładowe żądanie

Przykładowa odpowiedź

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ApiEntityReference

ApiError

ApiErrorBase

AttachDetachDataDisksRequest

CachingTypes

CloudError

DataDisk

DataDisksToAttach

DataDisksToDetach

DiffDiskOptions

DiffDiskPlacement

DiffDiskSettings

DiskControllerTypes

DiskCreateOptionTypes

DiskDeleteOptionTypes

DiskDetachOptionTypes

DiskEncryptionSetParameters

DiskEncryptionSettings

ImageReference

InnerError

KeyVaultKeyReference

KeyVaultSecretReference

ManagedDiskParameters

OperatingSystemTypes

OSDisk

securityEncryptionTypes

StorageAccountTypes

StorageProfile

SubResource

VirtualHardDisk

VMDiskSecurityProfile

Dodatkowe zasoby