Virtual Machines - Attach Detach Data Disks

서비스:

Compute

API 버전:

2024-03-01

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

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

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
resourceGroupName	path	True	string	리소스 그룹의 이름.
subscriptionId	path	True	string	Microsoft Azure 구독을 고유하게 식별하는 구독 자격 증명 구독 ID는 모든 서비스 호출에 대한 URI의 파트를 형성합니다.
vmName	path	True	string	가상 머신의 이름입니다.
api-version	query	True	string	클라이언트 API 버전.

요청 본문

Name	형식	Description
parameters	AttachDetachDataDisksRequest	가상 머신에서 데이터 디스크 연결 및 분리 작업에 제공된 매개 변수입니다.

응답

Name	형식	Description
200 OK	StorageProfile	정상
202 Accepted		수락됨 헤더 Location: string
Other Status Codes	CloudError	작업이 실패한 이유를 설명하는 오류 응답입니다.

보안

azure_auth

Azure Active Directory OAuth2 Flow

형식: 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

샘플 요청

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2024-03-01

{
  "dataDisksToAttach": [
    {
      "lun": 1,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadOnly",
      "deleteOption": "Delete",
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadWrite",
      "deleteOption": "Detach",
      "writeAcceleratorEnabled": false
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      "detachOption": "ForceDetach"
    },
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      "detachOption": "ForceDetach"
    }
  ]
}

Python

from typing import Any, IO, Union

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

Go

package armcompute_test

import (
	"context"
	"log"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-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

JavaScript

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

/**
 * This sample demonstrates how to Attach and detach data disks to/from the virtual machine.
 *
 * @summary Attach and detach data disks to/from the virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-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

샘플 응답

상태 코드:

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

샘플 요청

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2024-03-01

{
  "dataDisksToAttach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
    }
  ]
}

Python

from typing import Any, IO, Union

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

Go

package armcompute_test

import (
	"context"
	"log"

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

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-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

JavaScript

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

/**
 * This sample demonstrates how to Attach and detach data disks to/from the virtual machine.
 *
 * @summary Attach and detach data disks to/from the virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-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

샘플 응답

상태 코드:

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	원본 리소스 식별자입니다. 디스크를 만들 스냅샷 디스크 복원 지점일 수 있습니다.
ApiError	API 오류입니다.
ApiErrorBase	API 오류 기준입니다.
AttachDetachDataDisksRequest	가상 머신에서 데이터 디스크 연결 및 분리 작업에 제공된 매개 변수입니다.
CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지의 경우 없음입니다. Premium Storage용 ReadOnly.
CloudError	Compute 서비스의 오류 응답입니다.
DataDisk	가상 컴퓨터에 데이터 디스크를 추가하는 데 사용되는 매개 변수를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신용 디스크 및 VHD 정보를 참조하세요.
DataDisksToAttach	연결할 관리되는 데이터 디스크 목록입니다.
DataDisksToDetach	분리할 관리되는 데이터 디스크 목록입니다.
DiffDiskOptions	운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiffDiskPlacement	운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 가능한 값은 CacheDisk,ResourceDisk,NvmeDisk입니다. 기본 동작은 VM 크기에 대해 구성된 경우 CacheDisk이고, 그렇지 않으면 ResourceDisk 또는 NvmeDisk가 사용됩니다. 에서 Windows VM 및 Linux VM에 https://docs.microsoft.com/azure/virtual-machines/windows/sizes 대한 VM https://docs.microsoft.com/azure/virtual-machines/linux/sizes 크기 설명서를 참조하여 캐시 디스크를 노출하는 VM 크기를 검사. NvmeDisk의 최소 api-version: 2024-03-01.
DiffDiskSettings	가상 머신에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiskControllerTypes	VM에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 참고: 지정된 가상 머신이 지정된 최소 API 버전의 운영 체제 디스크 및 VM 크기에 따라 V2로 설정된 'hyperVGeneration'을 사용하여 만들어지는 경우 이 속성은 기본 디스크 컨트롤러 유형으로 설정됩니다. VM을 암시적으로 할당 취소하고 다시 할당하는 VM 구성에서 VM 크기를 업데이트하지 않는 한 디스크 컨트롤러 유형을 업데이트하기 전에 VM의 할당을 취소해야 합니다. 최소 api-version: 2022-08-01.
DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 Attach입니다. 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다.
DiskDeleteOptionTypes	VM을 삭제할 때 OS 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 Delete입니다. 이 값을 사용하면 VM이 삭제되면 OS 디스크가 삭제됩니다. 분리. 이 값을 사용하면 VM이 삭제된 후 os 디스크가 유지됩니다. 기본값은 분리로 설정 됩니다. 임시 OS 디스크의 경우 기본값은 삭제로 설정됩니다. 사용자는 임시 OS 디스크에 대한 삭제 옵션을 변경할 수 없습니다.
DiskDetachOptionTypes	디스크를 분리하는 동안 사용하거나 가상 머신에서 분리하는 과정에 이미 있는 분리 동작을 지정합니다. 지원되는 값: ForceDetach. detachOption: ForceDetach 는 관리되는 데이터 디스크에만 적용됩니다. 가상 머신에서 예기치 않은 오류로 인해 데이터 디스크의 이전 분리 시도가 완료되지 않았고 디스크가 아직 릴리스되지 않은 경우 강제 분리 옵션을 사용하여 VM에서 강제로 디스크를 분리합니다. 이 분리 동작을 사용할 때 모든 쓰기가 플러시되지 않았을 수 있습니다. 이 기능은 아직 미리 보기 모드이며 VirtualMachineScaleSet에서 지원되지 않습니다. 데이터 디스크 업데이트를 'true'로 강제 분리하려면 detachOption: 'ForceDetach'를 설정합니다.
DiskEncryptionSetParameters	관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.
DiskEncryptionSettings	OS 디스크에 대한 암호화 설정을 지정합니다. 최소 api-version: 2015-06-15.
ImageReference	사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다.
InnerError	내부 오류 세부 정보입니다.
KeyVaultKeyReference	Key Vault 키 암호화 키의 위치를 지정합니다.
KeyVaultSecretReference	Key Vault 비밀인 디스크 암호화 키의 위치를 지정합니다.
ManagedDiskParameters	관리 디스크 매개 변수입니다.
OperatingSystemTypes	운영 체제 유형입니다.
OSDisk	가상 머신에서 사용하는 운영 체제 디스크에 대한 정보를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보를 참조하세요.
securityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob만 암호화하는 경우 VMGuestStateOnly, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.
StorageAccountTypes	관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.
StorageProfile	가상 머신 디스크에 대한 스토리지 설정을 지정합니다.
SubResource
VirtualHardDisk	가상 하드 디스크입니다.
VMDiskSecurityProfile	관리 디스크의 보안 프로필을 지정합니다.

ApiEntityReference

원본 리소스 식별자입니다. 디스크를 만들 스냅샷 디스크 복원 지점일 수 있습니다.

Name	형식	Description
id	string	/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... 형식의 ARM 리소스 ID입니다.

ApiError

API 오류입니다.

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

ApiErrorBase

API 오류 기준입니다.

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

AttachDetachDataDisksRequest

가상 머신에서 데이터 디스크 연결 및 분리 작업에 제공된 매개 변수입니다.

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

CachingTypes

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

Name	형식	Description
None	string
ReadOnly	string
ReadWrite	string

CloudError

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

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

DataDisk

가상 컴퓨터에 데이터 디스크를 추가하는 데 사용되는 매개 변수를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신용 디스크 및 VHD 정보를 참조하세요.

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

DataDisksToAttach

연결할 관리되는 데이터 디스크 목록입니다.

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

DataDisksToDetach

분리할 관리되는 데이터 디스크 목록입니다.

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

DiffDiskOptions

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

Name	형식	Description
Local	string

DiffDiskPlacement

운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 가능한 값은 CacheDisk,ResourceDisk,NvmeDisk입니다. 기본 동작은 VM 크기에 대해 구성된 경우 CacheDisk이고, 그렇지 않으면 ResourceDisk 또는 NvmeDisk가 사용됩니다. 에서 Windows VM 및 Linux VM에 https://docs.microsoft.com/azure/virtual-machines/windows/sizes 대한 VM https://docs.microsoft.com/azure/virtual-machines/linux/sizes 크기 설명서를 참조하여 캐시 디스크를 노출하는 VM 크기를 검사. NvmeDisk의 최소 api-version: 2024-03-01.

Name	형식	Description
CacheDisk	string
NvmeDisk	string
ResourceDisk	string

DiffDiskSettings

가상 머신에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.

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

DiskControllerTypes

VM에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 참고: 지정된 가상 머신이 지정된 최소 API 버전의 운영 체제 디스크 및 VM 크기에 따라 V2로 설정된 'hyperVGeneration'을 사용하여 만들어지는 경우 이 속성은 기본 디스크 컨트롤러 유형으로 설정됩니다. VM을 암시적으로 할당 취소하고 다시 할당하는 VM 구성에서 VM 크기를 업데이트하지 않는 한 디스크 컨트롤러 유형을 업데이트하기 전에 VM의 할당을 취소해야 합니다. 최소 api-version: 2022-08-01.

Name	형식	Description
NVMe	string
SCSI	string

DiskCreateOptionTypes

가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 Attach입니다. 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 이전에 설명한 계획 요소도 사용해야 합니다.

Name	형식	Description
Attach	string
Copy	string
Empty	string
FromImage	string
Restore	string

DiskDeleteOptionTypes

VM을 삭제할 때 OS 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 Delete입니다. 이 값을 사용하면 VM이 삭제되면 OS 디스크가 삭제됩니다. 분리. 이 값을 사용하면 VM이 삭제된 후 os 디스크가 유지됩니다. 기본값은 분리로 설정 됩니다. 임시 OS 디스크의 경우 기본값은 삭제로 설정됩니다. 사용자는 임시 OS 디스크에 대한 삭제 옵션을 변경할 수 없습니다.

Name	형식	Description
Delete	string
Detach	string

DiskDetachOptionTypes

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

Name	형식	Description
ForceDetach	string

DiskEncryptionSetParameters

관리 디스크에 대한 고객 관리 디스크 암호화 집합 리소스 ID를 지정합니다.

Name	형식	Description
id	string	리소스 ID

DiskEncryptionSettings

OS 디스크에 대한 암호화 설정을 지정합니다. 최소 api-version: 2015-06-15.

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

ImageReference

사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다.

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'입니다. 주, 부 및 빌드는 10진수입니다. 배포 시 사용할 수 있는 최신 버전의 이미지를 사용하려면 '최신'을 지정합니다. '최신'을 사용하는 경우에도 새 버전을 사용할 수 있게 되더라도 배포 시간 후에 VM 이미지가 자동으로 업데이트되지 않습니다. 갤러리 이미지 배포에 'version' 필드를 사용하지 마세요. 갤러리 이미지는 항상 배포에 'id' 필드를 사용해야 합니다. '최신' 버전의 갤러리 이미지를 사용하려면 버전 입력 없이 'id' 필드에 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/images/{imageName}'를 설정합니다.

InnerError

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

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

KeyVaultKeyReference

Key Vault 키 암호화 키의 위치를 지정합니다.

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

KeyVaultSecretReference

Key Vault 비밀인 디스크 암호화 키의 위치를 지정합니다.

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

ManagedDiskParameters

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

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

OperatingSystemTypes

운영 체제 유형입니다.

Name	형식	Description
Linux	string
Windows	string

OSDisk

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

Name	형식	Description
caching	CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지의 경우 없음입니다. Premium Storage용 ReadOnly.
createOption	DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 Attach입니다. 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신을 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 앞에서 설명한 계획 요소도 사용해야 합니다.
deleteOption	DiskDeleteOptionTypes	VM을 삭제할 때 OS 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 Delete입니다. 이 값을 사용하면 VM이 삭제되면 OS 디스크가 삭제됩니다. 분리. 이 값을 사용하면 VM이 삭제된 후 os 디스크가 유지됩니다. 기본값은 분리로 설정 됩니다. 임시 OS 디스크의 경우 기본값은 Delete로 설정됩니다. 사용자는 임시 OS 디스크에 대한 삭제 옵션을 변경할 수 없습니다.
diffDiskSettings	DiffDiskSettings	가상 머신에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
diskSizeGB	integer	빈 데이터 디스크의 크기를 기가바이트 단위로 지정합니다. 이 요소를 사용하여 가상 머신 이미지의 디스크 크기를 덮어쓸 수 있습니다. '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에 대해서만 설정할 수 있습니다.

Name	형식	Description
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

StorageAccountTypes

관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.

Name	형식	Description
PremiumV2_LRS	string
Premium_LRS	string
Premium_ZRS	string
StandardSSD_LRS	string
StandardSSD_ZRS	string
Standard_LRS	string
UltraSSD_LRS	string

StorageProfile

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

Name	형식	Description
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

Name	형식	Description
id	string	리소스 ID

VirtualHardDisk

가상 하드 디스크입니다.

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

VMDiskSecurityProfile

관리 디스크의 보안 프로필을 지정합니다.

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