Virtual Machines - Attach Detach Data Disks

서비스:: Compute

API 버전:: 2024-11-01

가상 머신에 데이터 디스크를 연결하고 분리합니다.

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	리소스 그룹의 이름입니다. 이름은 대소문자를 구분하지 않습니다.
subscriptionId	path	True	string minLength: 1	대상 구독의 ID입니다.
vmName	path	True	string	가상 컴퓨터의 이름입니다.
api-version	query	True	string minLength: 1	이 작업에 사용할 API 버전입니다.

요청 본문

Name	형식	Description
dataDisksToAttach	DataDisksToAttach[]	연결할 관리되는 데이터 디스크 목록입니다.
dataDisksToDetach	DataDisksToDetach[]	분리할 관리되는 데이터 디스크 목록입니다.

응답

Name	형식	Description
200 OK	StorageProfile	Azure 작업이 성공적으로 완료되었습니다.
202 Accepted		리소스 작업이 수락되었습니다. 헤더 Location: string Retry-After: integer
Other Status Codes	CloudError	예기치 않은 오류 응답입니다.

Name

형식

Description

200 OK

StorageProfile

Azure 작업이 성공적으로 완료되었습니다.

202 Accepted

리소스 작업이 수락되었습니다.

헤더

Location: string
Retry-After: integer

Other Status Codes

CloudError

예기치 않은 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 흐름.

형식: oauth2
Flow: implicit
권한 부여 URL: https://login.microsoftonline.com/common/oauth2/authorize

범위

Name	Description
user_impersonation	사용자 계정 가장

예제

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

샘플 요청

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2024-11-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-11-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-11-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/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-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");
require("dotenv/config");

/**
 * 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-11-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-11-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://learn.microsoft.com/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

샘플 응답

상태 코드:: 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
    }
  ]
}

상태 코드:: 202

___location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

샘플 요청

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2024-11-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-11-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-11-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/250861bb6a886b75255edfa0aa5ee2dd0d6e7a11/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-11-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");
require("dotenv/config");

/**
 * 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-11-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-11-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://learn.microsoft.com/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

샘플 응답

상태 코드:: 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
    }
  ]
}

상태 코드:: 202

___location: https://foo.com/operationstatus

정의

Name	Description
ApiEntityReference	API 엔터티 참조입니다.
ApiError	API 오류입니다.
ApiErrorBase	API 오류 기준입니다.
AttachDetachDataDisksRequest	관리되는 데이터 디스크 목록을 연결하고 분리하기 위한 입력을 지정합니다.
CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본값은 표준 스토리지의 경우 None입니다. Premium Storage에 대한 ReadOnly
CloudError	Compute 서비스의 오류 응답입니다.
DataDisk	데이터 디스크에 대해 설명합니다.
DataDisksToAttach	연결할 데이터 디스크에 대해 설명합니다.
DataDisksToDetach	분리할 데이터 디스크에 대해 설명합니다.
DiffDiskOptions	운영 체제 디스크에 대한 임시 디스크 옵션을 지정합니다.
DiffDiskPlacement	운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 이 속성은 임시 OS 디스크 프로비저닝을 위한 캐시 디스크, 리소스 디스크 또는 nvme 디스크 공간과 같은 위치를 선택하기 위해 요청의 사용자가 사용할 수 있습니다. 임시 OS 디스크 크기 요구 사항에 대한 자세한 내용은 Windows VM 및 Linux VM https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements의 사용 후 삭제 OS 디스크 크기 요구 사항을 참조하세요. NvmeDisk의 최소 api-version: 2024-03-01.
DiffDiskSettings	운영 체제 디스크에 대해 지정할 수 있는 임시 디스크 설정의 매개 변수에 대해 설명합니다. 참고: 임시 디스크 설정은 관리 디스크에 대해서만 지정할 수 있습니다.
DiskControllerTypes	VM 및 VirtualMachineScaleSet에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 이 속성은 운영 체제 디스크 및 VM sku가 2세대(https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2)를 지원하는 가상 머신에 대해서만 지원됩니다. 지역에 대한 Microsoft.Compute SKU api의 응답에서 VM sku 기능의 일부로 반환된 HyperVGenerations 기능에 V2(https://docs.microsoft.com/rest/api/compute/resourceskus/list)가 포함되어 있는지 확인하세요. 지원되는 디스크 컨트롤러 유형에 대한 자세한 내용은 을 참조 https://aka.ms/azure-diskcontrollertypes하세요.
DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 연결: 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다. 비어 있음: 이 값은 빈 데이터 디스크를 만들 때 사용됩니다. 복사: 이 값은 스냅샷 또는 다른 디스크에서 데이터 디스크를 만드는 데 사용됩니다. 복원: 이 값은 디스크 복원 지점에서 데이터 디스크를 만드는 데 사용됩니다.
DiskDeleteOptionTypes	VM이 삭제될 때 관리 디스크의 동작(예: 관리 디스크 삭제 또는 분리 여부)을 지정합니다. 지원되는 값은 삭제입니다. 이 값을 사용하면 VM이 삭제되면 관리 디스크가 삭제됩니다. 떼다. 이 값을 사용하면 VM이 삭제된 후 관리 디스크가 유지됩니다. 최소 api-version: 2021-03-01.
DiskDetachOptionTypes	디스크를 분리하는 동안 사용할 분리 동작 또는 가상 머신에서 분리하는 과정에 이미 있는 분리 동작을 지정합니다. 지원되는 값은 ForceDetach입니다. detachOption: ForceDetach 는 관리 데이터 디스크에만 적용할 수 있습니다. 가상 머신의 예기치 않은 오류로 인해 데이터 디스크의 이전 분리 시도가 완료되지 않았고 디스크가 아직 릴리스되지 않은 경우 마지막 수단으로 강제 분리를 사용하여 VM에서 강제로 디스크를 분리합니다. 이 분리 동작을 사용할 때 모든 쓰기가 플러시되지 않았을 수 있습니다. 이 기능은 아직 미리 보기 상태입니다. 데이터 디스크 업데이트를 'true'로 강제 분리하려면 detachOption: 'ForceDetach'를 설정합니다.
DiskEncryptionSetParameters	디스크에 대해 지정할 수 있는 고객 관리 디스크 암호화 집합 리소스 ID의 매개 변수에 대해 설명합니다. 참고: 디스크 암호화 집합 리소스 ID는 관리 디스크에 대해서만 지정할 수 있습니다. 자세한 내용은 https://aka.ms/mdssewithcmkoverview 참조하세요.
DiskEncryptionSettings	디스크에 대한 암호화 설정에 대해 설명합니다.
ImageReference	사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다. 참고: 이미지 참조 게시자 및 제품은 확장 집합을 만들 때만 설정할 수 있습니다.
InnerError	내부 오류 세부 정보입니다.
KeyVaultKeyReference	Key Vault 키에 대한 참조를 설명합니다.
KeyVaultSecretReference	Key Vault 비밀에 대한 참조를 설명합니다.
ManagedDiskParameters	관리 디스크의 매개 변수입니다.
OperatingSystemTypes	이 속성을 사용하면 사용자 이미지 또는 특수 VHD에서 VM을 만드는 경우 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.
OSDisk	가상 머신에서 사용하는 운영 체제 디스크에 대한 정보를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보참조하세요.
SecurityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.
StorageAccountTypes	관리 디스크의 스토리지 계정 유형을 지정합니다. 관리되는 OS 디스크 스토리지 계정 유형은 확장 집합을 만들 때만 설정할 수 있습니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있습니다. OS 디스크에는 사용할 수 없습니다. Standard_LRS 표준 HDD를 사용합니다. StandardSSD_LRS 표준 SSD를 사용합니다. Premium_LRS 프리미엄 SSD를 사용합니다. UltraSSD_LRS Ultra Disk를 사용합니다. Premium_ZRS 프리미엄 SSD 영역 중복 스토리지를 사용합니다. StandardSSD_ZRS 표준 SSD 영역 중복 스토리지를 사용합니다. Windows Virtual Machines에 지원되는 디스크에 대한 자세한 내용은 https://docs.microsoft.com/azure/virtual-machines/windows/disks-types 참조하고 Linux Virtual Machines의 경우 https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageProfile	가상 머신 디스크에 대한 스토리지 설정을 지정합니다.
SubResource
VirtualHardDisk	디스크의 URI를 설명합니다.
VMDiskSecurityProfile	관리 디스크에 대한 보안 프로필 설정을 지정합니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

ApiEntityReference

Object

API 엔터티 참조입니다.

Name	형식	Description
id	string	/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Object

API 오류입니다.

Name	형식	Description
code	string	오류 코드입니다.
details	ApiErrorBase[]	API 오류 세부 정보
innererror	InnerError	API 내부 오류
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

ApiErrorBase

Object

API 오류 기준입니다.

Name	형식	Description
code	string	오류 코드입니다.
message	string	오류 메시지입니다.
target	string	특정 오류의 대상입니다.

AttachDetachDataDisksRequest

Object

관리되는 데이터 디스크 목록을 연결하고 분리하기 위한 입력을 지정합니다.

Name	형식	Description
dataDisksToAttach	DataDisksToAttach[]	연결할 관리되는 데이터 디스크 목록입니다.
dataDisksToDetach	DataDisksToDetach[]	분리할 관리되는 데이터 디스크 목록입니다.

CachingTypes

열거형

캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본값은 표준 스토리지의 경우 None입니다. Premium Storage에 대한 ReadOnly

값	Description
None
ReadOnly
ReadWrite

CloudError

Object

Compute 서비스의 오류 응답입니다.

Name	형식	Description
error	ApiError	API 오류입니다.

DataDisk

Object

데이터 디스크에 대해 설명합니다.

Name	형식	Description
caching	CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지에 대한 없음입니다. Premium Storage의 경우 ReadOnly입니다.
createOption	DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 연결: 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신 데이터 디스크를 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다. 비어 있음: 이 값은 빈 데이터 디스크를 만들 때 사용됩니다. 복사: 이 값은 스냅샷 또는 다른 디스크에서 데이터 디스크를 만드는 데 사용됩니다. 복원: 이 값은 디스크 복원 지점에서 데이터 디스크를 만드는 데 사용됩니다.
deleteOption	DiskDeleteOptionTypes	VM 삭제 시 데이터 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 삭제입니다. 이 값을 사용하면 VM이 삭제될 때 데이터 디스크가 삭제됩니다. 떼다. 이 값을 사용하면 VM이 삭제된 후 데이터 디스크가 유지됩니다. 기본값은 분리로 설정됩니다.
detachOption	DiskDetachOptionTypes	디스크를 분리하는 동안 사용할 분리 동작 또는 가상 머신에서 분리하는 과정에 이미 있는 분리 동작을 지정합니다. 지원되는 값: ForceDetach. detachOption: ForceDetach 관리되는 데이터 디스크에만 적용됩니다. 가상 머신의 예기치 않은 오류로 인해 데이터 디스크의 이전 분리 시도가 완료되지 않았고 디스크가 아직 릴리스되지 않은 경우 마지막 수단으로 강제 분리를 사용하여 VM에서 강제로 디스크를 분리합니다. 이 분리 동작을 사용할 때 모든 쓰기가 플러시되지 않았을 수 있습니다. 이 기능은 아직 미리 보기 상태입니다. 데이터 디스크 업데이트를 'true'로 강제 분리하려면 detachOption: 'ForceDetach'를 설정합니다.
diskIOPSReadWrite	integer (int64)	StorageAccountType이 UltraSSD_LRS 경우 관리 디스크에 대한 Read-Write IOPS를 지정합니다. VirtualMachine ScaleSet VM 디스크에 대해서만 반환됩니다. VirtualMachine 확장 집합에 대한 업데이트를 통해서만 업데이트할 수 있습니다.
diskMBpsReadWrite	integer (int64)	StorageAccountType이 UltraSSD_LRS 경우 관리 디스크의 대역폭을 초당 MB 단위로 지정합니다. VirtualMachine ScaleSet VM 디스크에 대해서만 반환됩니다. VirtualMachine 확장 집합에 대한 업데이트를 통해서만 업데이트할 수 있습니다.
diskSizeGB	integer (int32)	빈 데이터 디스크의 크기를 기가바이트 단위로 지정합니다. 이 요소는 가상 머신 이미지의 디스크 크기를 덮어쓰는 데 사용할 수 있습니다. 'diskSizeGB' 속성은 디스크에 대한 바이트 x 1024^3의 수이며 값은 1023보다 클 수 없습니다.
image	VirtualHardDisk	원본 사용자 이미지 가상 하드 디스크입니다. 가상 머신에 연결되기 전에 가상 하드 디스크가 복사됩니다. SourceImage가 제공되면 대상 가상 하드 드라이브가 없어야 합니다.
lun	integer (int32)	데이터 디스크의 논리적 단위 번호를 지정합니다. 이 값은 VM 내의 데이터 디스크를 식별하는 데 사용되므로 VM에 연결된 각 데이터 디스크에 대해 고유해야 합니다.
managedDisk	ManagedDiskParameters	관리 디스크 매개 변수입니다.
name	string	디스크 이름입니다.
sourceResource	ApiEntityReference	원본 리소스 식별자입니다. 스냅샷 또는 디스크를 만들 디스크 복원 지점일 수 있습니다.
toBeDetached	boolean	데이터 디스크가 VirtualMachine/VirtualMachineScaleset에서 분리 중인지 여부를 지정합니다.
vhd	VirtualHardDisk	가상 하드 디스크입니다.
writeAcceleratorEnabled	boolean	디스크에서 writeAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

DataDisksToAttach

Object

연결할 데이터 디스크에 대해 설명합니다.

Name	형식	Description
caching	CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지에 대한 없음입니다. Premium Storage의 경우 ReadOnly입니다.
deleteOption	DiskDeleteOptionTypes	VM 삭제 시 데이터 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 삭제입니다. 이 값을 사용하면 VM이 삭제될 때 데이터 디스크가 삭제됩니다. 떼다. 이 값을 사용하면 VM이 삭제된 후 데이터 디스크가 유지됩니다. 기본값은 분리로 설정됩니다.
diskEncryptionSet	DiskEncryptionSetParameters	관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
diskId	string	관리되는 데이터 디스크의 ID입니다.
lun	integer (int32)	데이터 디스크의 논리 단위 번호입니다. 이 값은 VM 내의 데이터 디스크를 식별하는 데 사용되므로 VM에 연결된 각 데이터 디스크에 대해 고유해야 합니다. 지정하지 않으면 lun이 자동으로 할당됩니다.
writeAcceleratorEnabled	boolean	디스크에서 writeAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

DataDisksToDetach

Object

분리할 데이터 디스크에 대해 설명합니다.

Name	형식	Description
detachOption	DiskDetachOptionTypes	VM에서 디스크 분리에 사용할 수 있는 지원되는 옵션입니다. 자세한 내용은 DetachOption 개체 참조를 참조하세요.
diskId	string	관리되는 데이터 디스크의 ID입니다.

DiffDiskOptions

열거형

운영 체제 디스크에 대한 임시 디스크 옵션을 지정합니다.

값	Description
Local

DiffDiskPlacement

열거형

운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 이 속성은 임시 OS 디스크 프로비저닝을 위한 캐시 디스크, 리소스 디스크 또는 nvme 디스크 공간과 같은 위치를 선택하기 위해 요청의 사용자가 사용할 수 있습니다. 임시 OS 디스크 크기 요구 사항에 대한 자세한 내용은 Windows VM 및 Linux VM https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements의 사용 후 삭제 OS 디스크 크기 요구 사항을 참조하세요. NvmeDisk의 최소 api-version: 2024-03-01.

값	Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Object

운영 체제 디스크에 대해 지정할 수 있는 임시 디스크 설정의 매개 변수에 대해 설명합니다. 참고: 임시 디스크 설정은 관리 디스크에 대해서만 지정할 수 있습니다.

Name	형식	Description
option	DiffDiskOptions	운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
placement	DiffDiskPlacement	운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 가능한 값은 CacheDisk,ResourceDisk,NvmeDisk입니다. 기본 동작은 CacheDisk VM 크기에 대해 구성되었으면 ResourceDisk 또는 NvmeDisk 사용됩니다. https://docs.microsoft.com/azure/virtual-machines/windows/sizes Windows VM 및 https://docs.microsoft.com/azure/virtual-machines/linux/sizes Linux VM에 대한 VM 크기 설명서를 참조하여 캐시 디스크를 노출하는 VM 크기를 확인합니다. NvmeDisk의 최소 api-version: 2024-03-01.

DiskControllerTypes

열거형

VM 및 VirtualMachineScaleSet에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 이 속성은 운영 체제 디스크 및 VM sku가 2세대(https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2)를 지원하는 가상 머신에 대해서만 지원됩니다. 지역에 대한 Microsoft.Compute SKU api의 응답에서 VM sku 기능의 일부로 반환된 HyperVGenerations 기능에 V2(https://docs.microsoft.com/rest/api/compute/resourceskus/list)가 포함되어 있는지 확인하세요. 지원되는 디스크 컨트롤러 유형에 대한 자세한 내용은 을 참조 https://aka.ms/azure-diskcontrollertypes하세요.

값	Description
SCSI
NVMe

DiskCreateOptionTypes

열거형

가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 연결: 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다. 비어 있음: 이 값은 빈 데이터 디스크를 만들 때 사용됩니다. 복사: 이 값은 스냅샷 또는 다른 디스크에서 데이터 디스크를 만드는 데 사용됩니다. 복원: 이 값은 디스크 복원 지점에서 데이터 디스크를 만드는 데 사용됩니다.

값	Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

열거형

VM이 삭제될 때 관리 디스크의 동작(예: 관리 디스크 삭제 또는 분리 여부)을 지정합니다. 지원되는 값은 삭제입니다. 이 값을 사용하면 VM이 삭제되면 관리 디스크가 삭제됩니다. 떼다. 이 값을 사용하면 VM이 삭제된 후 관리 디스크가 유지됩니다. 최소 api-version: 2021-03-01.

값	Description
Delete
Detach

DiskDetachOptionTypes

열거형

디스크를 분리하는 동안 사용할 분리 동작 또는 가상 머신에서 분리하는 과정에 이미 있는 분리 동작을 지정합니다. 지원되는 값은 ForceDetach입니다. detachOption: ForceDetach 는 관리 데이터 디스크에만 적용할 수 있습니다. 가상 머신의 예기치 않은 오류로 인해 데이터 디스크의 이전 분리 시도가 완료되지 않았고 디스크가 아직 릴리스되지 않은 경우 마지막 수단으로 강제 분리를 사용하여 VM에서 강제로 디스크를 분리합니다. 이 분리 동작을 사용할 때 모든 쓰기가 플러시되지 않았을 수 있습니다. 이 기능은 아직 미리 보기 상태입니다. 데이터 디스크 업데이트를 'true'로 강제 분리하려면 detachOption: 'ForceDetach'를 설정합니다.

값	Description
ForceDetach

DiskEncryptionSetParameters

Object

디스크에 대해 지정할 수 있는 고객 관리 디스크 암호화 집합 리소스 ID의 매개 변수에 대해 설명합니다. 참고: 디스크 암호화 집합 리소스 ID는 관리 디스크에 대해서만 지정할 수 있습니다. 자세한 내용은 https://aka.ms/mdssewithcmkoverview 참조하세요.

Name	형식	Description
id	string	리소스 ID

DiskEncryptionSettings

Object

디스크에 대한 암호화 설정에 대해 설명합니다.

Name	형식	Description
diskEncryptionKey	KeyVaultSecretReference	키 자격 증명 모음 비밀인 디스크 암호화 키의 위치를 지정합니다.
enabled	boolean	가상 머신에서 디스크 암호화를 사용할지 여부를 지정합니다.
keyEncryptionKey	KeyVaultKeyReference	Key Vault에서 키 암호화 키의 위치를 지정합니다.

ImageReference

Object

사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다. 참고: 이미지 참조 게시자 및 제품은 확장 집합을 만들 때만 설정할 수 있습니다.

Name	형식	Description
communityGalleryImageId	string	vm 배포에 대한 커뮤니티 갤러리 이미지 고유 ID를 지정했습니다. 커뮤니티 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
exactVersion	string	가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 버전인 10진수로 지정합니다. 이 읽기 전용 필드는 'version' 필드에 지정된 값이 'latest'인 경우에만 'version'와 다릅니다.
id	string	리소스 ID
offer	string	가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 제안을 지정합니다.
publisher	string	이미지 게시자입니다.
sharedGalleryImageId	string	vm 배포에 대한 공유 갤러리 이미지 고유 ID를 지정했습니다. 공유 갤러리 이미지 GET 호출에서 가져올 수 있습니다.
sku	string	이미지 SKU입니다.
version	string	가상 머신을 만드는 데 사용되는 플랫폼 이미지 또는 마켓플레이스 이미지의 버전을 지정합니다. 허용되는 형식은 Major.Minor.Build 또는 'latest'입니다. 주, 부 및 빌드는 소수 자릿수입니다. 배포 시 사용할 수 있는 최신 버전의 이미지를 사용하도록 '최신'을 지정합니다. '최신'을 사용하더라도 새 버전을 사용할 수 있는 경우에도 배포 시간 후에 VM 이미지가 자동으로 업데이트되지 않습니다. 갤러리 이미지 배포에는 'version' 필드를 사용하지 마세요. 갤러리 이미지는 항상 배포에 'id' 필드를 사용해야 합니다. '최신' 버전의 갤러리 이미지를 사용하려면 버전 입력 없이 'id' 필드에 '/subscriptions/{subscriptionId}/resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}'을 설정하기만 하면 됩니다.

InnerError

Object

내부 오류 세부 정보입니다.

Name	형식	Description
errordetail	string	내부 오류 메시지 또는 예외 덤프입니다.
exceptiontype	string	예외 형식입니다.

KeyVaultKeyReference

Object

Key Vault 키에 대한 참조를 설명합니다.

Name	형식	Description
keyUrl	string	Key Vault에서 키 암호화 키를 참조하는 URL입니다.
sourceVault	SubResource	키를 포함하는 Key Vault의 상대 URL입니다.

KeyVaultSecretReference

Object

Key Vault 비밀에 대한 참조를 설명합니다.

Name	형식	Description
secretUrl	string	Key Vault의 비밀을 참조하는 URL입니다.
sourceVault	SubResource	비밀을 포함하는 Key Vault의 상대 URL입니다.

ManagedDiskParameters

Object

관리 디스크의 매개 변수입니다.

Name	형식	Description
diskEncryptionSet	DiskEncryptionSetParameters	관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
id	string	리소스 ID
securityProfile	VMDiskSecurityProfile	관리 디스크의 보안 프로필을 지정합니다.
storageAccountType	StorageAccountTypes	관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.

OperatingSystemTypes

열거형

이 속성을 사용하면 사용자 이미지 또는 특수 VHD에서 VM을 만드는 경우 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.

값	Description
Windows
Linux

OSDisk

Object

가상 머신에서 사용하는 운영 체제 디스크에 대한 정보를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보참조하세요.

Name	형식	Description
caching	CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지에 대한 없음입니다. Premium Storage의 경우 ReadOnly입니다.
createOption	DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 연결: 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다.
deleteOption	DiskDeleteOptionTypes	VM을 삭제할 때 OS 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 삭제입니다. 이 값을 사용하면 VM이 삭제될 때 OS 디스크가 삭제됩니다. 떼다. 이 값을 사용하면 VM이 삭제된 후에 os 디스크가 유지됩니다. 기본값은 분리로 설정됩니다. 임시 OS 디스크의 경우 기본값은삭제를 설정됩니다. 사용자는 임시 OS 디스크에 대한 삭제 옵션을 변경할 수 없습니다.
diffDiskSettings	DiffDiskSettings	가상 머신에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
diskSizeGB	integer (int32)	빈 데이터 디스크의 크기를 기가바이트 단위로 지정합니다. 이 요소는 가상 머신 이미지의 디스크 크기를 덮어쓰는 데 사용할 수 있습니다. 'diskSizeGB' 속성은 디스크에 대한 바이트 x 1024^3의 수이며 값은 1023보다 클 수 없습니다.
encryptionSettings	DiskEncryptionSettings	OS 디스크에 대한 암호화 설정을 지정합니다. 최소 api-version: 2015-06-15.
image	VirtualHardDisk	원본 사용자 이미지 가상 하드 디스크입니다. 가상 머신에 연결되기 전에 가상 하드 디스크가 복사됩니다. SourceImage가 제공되면 대상 가상 하드 드라이브가 없어야 합니다.
managedDisk	ManagedDiskParameters	관리 디스크 매개 변수입니다.
name	string	디스크 이름입니다.
osType	OperatingSystemTypes	이 속성을 사용하면 사용자 이미지 또는 특수 VHD에서 VM을 만드는 경우 디스크에 포함된 OS 유형을 지정할 수 있습니다. 가능한 값은 Windows,Linux입니다.
vhd	VirtualHardDisk	가상 하드 디스크입니다.
writeAcceleratorEnabled	boolean	디스크에서 writeAccelerator를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

SecurityEncryptionTypes

열거형

관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

값	Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

열거형

관리 디스크의 스토리지 계정 유형을 지정합니다. 관리되는 OS 디스크 스토리지 계정 유형은 확장 집합을 만들 때만 설정할 수 있습니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있습니다. OS 디스크에는 사용할 수 없습니다. Standard_LRS 표준 HDD를 사용합니다. StandardSSD_LRS 표준 SSD를 사용합니다. Premium_LRS 프리미엄 SSD를 사용합니다. UltraSSD_LRS Ultra Disk를 사용합니다. Premium_ZRS 프리미엄 SSD 영역 중복 스토리지를 사용합니다. StandardSSD_ZRS 표준 SSD 영역 중복 스토리지를 사용합니다. Windows Virtual Machines에 지원되는 디스크에 대한 자세한 내용은 https://docs.microsoft.com/azure/virtual-machines/windows/disks-types 참조하고 Linux Virtual Machines의 경우 https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

값	Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageProfile

Object

가상 머신 디스크에 대한 스토리지 설정을 지정합니다.

Name	형식	Description
alignRegionalDisksToVMZone	boolean	지역 디스크를 VM 영역으로 정렬/이동할지 여부를 지정합니다. 배치 속성이 설정된 VM에만 적용됩니다. 이 변경은 되돌릴 수 없습니다. 최소 api-version: 2024-11-01.
dataDisks	DataDisk[]	가상 머신에 데이터 디스크를 추가하는 데 사용되는 매개 변수를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보참조하세요.
diskControllerType	DiskControllerTypes	VM에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 참고: 지정된 최소 api 버전의 운영 체제 디스크 및 VM 크기에 따라 'hyperVGeneration'을 V2로 설정하여 가상 머신을 만드는 경우 지정하지 않으면 이 속성이 기본 디스크 컨트롤러 유형으로 설정됩니다. VM을 암시적으로 할당 취소하고 다시 할당하는 VM 구성에서 VM 크기를 업데이트하지 않는 한 디스크 컨트롤러 유형을 업데이트하기 전에 VM의 할당을 취소해야 합니다. 최소 api-version: 2022-08-01.
imageReference	ImageReference	사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다.
osDisk	OSDisk	가상 머신에서 사용하는 운영 체제 디스크에 대한 정보를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보참조하세요.

SubResource

Object

Name	형식	Description
id	string	리소스 ID

VirtualHardDisk

Object

디스크의 URI를 설명합니다.

Name	형식	Description
uri	string	가상 하드 디스크의 URI를 지정합니다.

VMDiskSecurityProfile

Object

관리 디스크에 대한 보안 프로필 설정을 지정합니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

Name	형식	Description
diskEncryptionSet	DiskEncryptionSetParameters	고객 관리형 키 암호화 ConfidentialVM OS 디스크 및 VMGuest Blob에 사용되는 관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
securityEncryptionType	SecurityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob의 암호화를 위한 VMGuestStateOnly, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.

다음을 통해 공유

Virtual Machines - Attach Detach Data Disks

URI 매개 변수

요청 본문

응답

보안

azure_auth

범위

예제

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

샘플 요청

샘플 응답

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

샘플 요청

샘플 응답

정의

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