Virtual Machines - Get

참조

서비스:: Compute

API 버전:: 2024-03-01

가상 컴퓨터의 인스턴스 보기 또는 모델 보기에 대한 정보를 검색합니다.

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

선택적 매개 변수:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}?$expand={$expand}&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 버전.
$expand	query		InstanceViewTypes	작업에 적용할 확장 식입니다. 'InstanceView'는 플랫폼에서 관리하고 컨트롤 플레인 작업 외부에서 변경할 수 있는 가상 머신의 런타임 속성 스냅샷 검색합니다. 'UserData'는 VM 만들기/업데이트 작업 중에 사용자가 제공한 VM 모델 보기의 일부로 UserData 속성을 검색합니다.

응답

Name	형식	Description
200 OK	VirtualMachine	정상
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	사용자 계정 가장

예제

Get a virtual machine placed on a dedicated host group through automatic placement

Get a virtual machine with Disk Controller Type Properties

Get a virtual machine with VM Size Properties

Get a Virtual Machine.

Get a virtual machine placed on a dedicated host group through automatic placement

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?api-version=2024-03-01

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_get_auto_placed_on_dedicated_host_group.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.get(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_AutoPlacedOnDedicatedHostGroup.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/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_Get_AutoPlacedOnDedicatedHostGroup.json
func ExampleVirtualMachinesClient_Get_getAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().Get(ctx, "myResourceGroup", "myVM", &armcompute.VirtualMachinesClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardD2SV3),
	// 		},
	// 		HostGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"),
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"),
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("admin"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(false),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 			},
	// 			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),
	// 			},
	// 		},
	// 		VMID: to.Ptr("0f47b100-583c-48e3-a4c0-aefc2c9bbcc1"),
	// 	},
	// }
}

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

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

/**
 * This sample demonstrates how to Retrieves information about the model view or the instance view of a virtual machine.
 *
 * @summary Retrieves information about the model view or the instance view of a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_AutoPlacedOnDedicatedHostGroup.json
 */
async function getAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.get(resourceGroupName, vmName);
  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


import com.azure.resourcemanager.compute.models.InstanceViewTypes;

/**
 * Samples for VirtualMachines GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get_AutoPlacedOnDedicatedHostGroup.json
     */
    /**
     * Sample code: Get a virtual machine placed on a dedicated host group through automatic placement.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines()
            .getByResourceGroupWithResponse("myResourceGroup", "myVM", null, com.azure.core.util.Context.NONE);
    }

    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get_WithDiskControllerType.json
     */
    /**
     * Sample code: Get a virtual machine with Disk Controller Type Properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAVirtualMachineWithDiskControllerTypeProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().getByResourceGroupWithResponse(
            "myResourceGroup", "myVM", InstanceViewTypes.USER_DATA, com.azure.core.util.Context.NONE);
    }

    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get.json
     */
    /**
     * Sample code: Get a Virtual Machine.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachine(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().getByResourceGroupWithResponse(
            "myResourceGroup", "myVM", InstanceViewTypes.USER_DATA, 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

샘플 응답

상태 코드:: 200

{
  "name": "myVM",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "West US",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "vmId": "0f47b100-583c-48e3-a4c0-aefc2c9bbcc1",
    "hostGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup"
    },
    "hardwareProfile": {
      "vmSize": "Standard_D2s_v3"
    },
    "storageProfile": {
      "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": []
    },
    "osProfile": {
      "computerName": "myVM",
      "adminUsername": "admin",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": false
      },
      "secrets": []
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"
        }
      ]
    },
    "provisioningState": "Succeeded"
  }
}

Get a virtual machine with Disk Controller Type Properties

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?$expand=userData&api-version=2024-03-01

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_get_with_disk_controller_type.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.get(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_WithDiskControllerType.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/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_Get_WithDiskControllerType.json
func ExampleVirtualMachinesClient_Get_getAVirtualMachineWithDiskControllerTypeProperties() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().Get(ctx, "myResourceGroup", "myVM", &armcompute.VirtualMachinesClientGetOptions{Expand: to.Ptr(armcompute.InstanceViewTypesUserData)})
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		ApplicationProfile: &armcompute.ApplicationProfile{
	// 			GalleryApplications: []*armcompute.VMGalleryApplication{
	// 				{
	// 					ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 					Order: to.Ptr[int32](1),
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 					Tags: to.Ptr("myTag1"),
	// 				},
	// 				{
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 			}},
	// 		},
	// 		AvailabilitySet: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"),
	// 		},
	// 		DiagnosticsProfile: &armcompute.DiagnosticsProfile{
	// 			BootDiagnostics: &armcompute.BootDiagnostics{
	// 				Enabled: to.Ptr(true),
	// 				StorageURI: to.Ptr("http://{myStorageAccount}.blob.core.windows.net"),
	// 			},
	// 		},
	// 		ExtensionsTimeBudget: to.Ptr("PT50M"),
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardDS3V2),
	// 			VMSizeProperties: &armcompute.VMSizeProperties{
	// 				VCPUsAvailable: to.Ptr[int32](1),
	// 				VCPUsPerCore: to.Ptr[int32](1),
	// 			},
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"),
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("admin"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(false),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 				{
	// 					Name: to.Ptr("myDataDisk0"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					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/myDataDisk0"),
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 				{
	// 					Name: to.Ptr("myDataDisk1"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 					DiskSizeGB: to.Ptr[int32](100),
	// 					Lun: to.Ptr[int32](1),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"),
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 			}},
	// 			DiskControllerType: to.Ptr(armcompute.DiskControllerTypesNVMe),
	// 			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),
	// 			},
	// 		},
	// 		UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		VMID: to.Ptr("0f47b100-583c-48e3-a4c0-aefc2c9bbcc1"),
	// 	},
	// 	Resources: []*armcompute.VirtualMachineExtension{
	// 		{
	// 			Name: to.Ptr("CustomScriptExtension-DSC"),
	// 			Type: to.Ptr("Microsoft.Compute/virtualMachines/extensions"),
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC"),
	// 			Location: to.Ptr("west us"),
	// 			Tags: map[string]*string{
	// 				"displayName": to.Ptr("CustomScriptExtension-DSC"),
	// 			},
	// 			Properties: &armcompute.VirtualMachineExtensionProperties{
	// 				Type: to.Ptr("CustomScriptExtension"),
	// 				AutoUpgradeMinorVersion: to.Ptr(true),
	// 				ProvisioningState: to.Ptr("Succeeded"),
	// 				Publisher: to.Ptr("Microsoft.Compute"),
	// 				Settings: map[string]any{
	// 				},
	// 				TypeHandlerVersion: to.Ptr("1.9"),
	// 			},
	// 	}},
	// }
}

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

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

/**
 * This sample demonstrates how to Retrieves information about the model view or the instance view of a virtual machine.
 *
 * @summary Retrieves information about the model view or the instance view of a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_WithDiskControllerType.json
 */
async function getAVirtualMachineWithDiskControllerTypeProperties() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const expand = "userData";
  const options = { expand };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.get(resourceGroupName, vmName, options);
  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

{
  "name": "myVM",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "West US",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "vmId": "0f47b100-583c-48e3-a4c0-aefc2c9bbcc1",
    "availabilitySet": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"
    },
    "hardwareProfile": {
      "vmSize": "Standard_DS3_v2",
      "vmSizeProperties": {
        "vCPUsAvailable": 1,
        "vCPUsPerCore": 1
      }
    },
    "storageProfile": {
      "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": "myDataDisk0",
          "createOption": "Empty",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk0"
          },
          "diskSizeGB": 30
        },
        {
          "lun": 1,
          "name": "myDataDisk1",
          "createOption": "Attach",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"
          },
          "diskSizeGB": 100
        }
      ],
      "diskControllerType": "NVMe"
    },
    "applicationProfile": {
      "galleryApplications": [
        {
          "tags": "myTag1",
          "order": 1,
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
          "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config"
        },
        {
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
        }
      ]
    },
    "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
    "osProfile": {
      "computerName": "myVM",
      "adminUsername": "admin",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": false
      },
      "secrets": []
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"
        }
      ]
    },
    "diagnosticsProfile": {
      "bootDiagnostics": {
        "enabled": true,
        "storageUri": "http://{myStorageAccount}.blob.core.windows.net"
      }
    },
    "extensionsTimeBudget": "PT50M",
    "provisioningState": "Succeeded"
  },
  "resources": [
    {
      "name": "CustomScriptExtension-DSC",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "west us",
      "tags": {
        "displayName": "CustomScriptExtension-DSC"
      },
      "properties": {
        "autoUpgradeMinorVersion": true,
        "provisioningState": "Succeeded",
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.9",
        "settings": {}
      }
    }
  ]
}

Get a virtual machine with VM Size Properties

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?api-version=2024-03-01

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_get_with_vm_size_properties.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.get(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_WithVMSizeProperties.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/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_Get_WithVMSizeProperties.json
func ExampleVirtualMachinesClient_Get_getAVirtualMachineWithVmSizeProperties() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().Get(ctx, "myResourceGroup", "myVM", &armcompute.VirtualMachinesClientGetOptions{Expand: nil})
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		ApplicationProfile: &armcompute.ApplicationProfile{
	// 			GalleryApplications: []*armcompute.VMGalleryApplication{
	// 				{
	// 					ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 					Order: to.Ptr[int32](1),
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 					Tags: to.Ptr("myTag1"),
	// 				},
	// 				{
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 			}},
	// 		},
	// 		AvailabilitySet: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"),
	// 		},
	// 		DiagnosticsProfile: &armcompute.DiagnosticsProfile{
	// 			BootDiagnostics: &armcompute.BootDiagnostics{
	// 				Enabled: to.Ptr(true),
	// 				StorageURI: to.Ptr("http://{myStorageAccount}.blob.core.windows.net"),
	// 			},
	// 		},
	// 		ExtensionsTimeBudget: to.Ptr("PT50M"),
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardDS3V2),
	// 			VMSizeProperties: &armcompute.VMSizeProperties{
	// 				VCPUsAvailable: to.Ptr[int32](1),
	// 				VCPUsPerCore: to.Ptr[int32](1),
	// 			},
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"),
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("admin"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(false),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 				{
	// 					Name: to.Ptr("myDataDisk0"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					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/myDataDisk0"),
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 				{
	// 					Name: to.Ptr("myDataDisk1"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 					DiskSizeGB: to.Ptr[int32](100),
	// 					Lun: to.Ptr[int32](1),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"),
	// 						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),
	// 			},
	// 		},
	// 		UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		VMID: to.Ptr("0f47b100-583c-48e3-a4c0-aefc2c9bbcc1"),
	// 	},
	// 	Resources: []*armcompute.VirtualMachineExtension{
	// 		{
	// 			Name: to.Ptr("CustomScriptExtension-DSC"),
	// 			Type: to.Ptr("Microsoft.Compute/virtualMachines/extensions"),
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC"),
	// 			Location: to.Ptr("west us"),
	// 			Tags: map[string]*string{
	// 				"displayName": to.Ptr("CustomScriptExtension-DSC"),
	// 			},
	// 			Properties: &armcompute.VirtualMachineExtensionProperties{
	// 				Type: to.Ptr("CustomScriptExtension"),
	// 				AutoUpgradeMinorVersion: to.Ptr(true),
	// 				ProvisioningState: to.Ptr("Succeeded"),
	// 				Publisher: to.Ptr("Microsoft.Compute"),
	// 				Settings: map[string]any{
	// 				},
	// 				TypeHandlerVersion: to.Ptr("1.9"),
	// 			},
	// 	}},
	// }
}

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

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

/**
 * This sample demonstrates how to Retrieves information about the model view or the instance view of a virtual machine.
 *
 * @summary Retrieves information about the model view or the instance view of a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get_WithVMSizeProperties.json
 */
async function getAVirtualMachineWithVMSizeProperties() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.get(resourceGroupName, vmName);
  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


import com.azure.resourcemanager.compute.models.InstanceViewTypes;

/**
 * Samples for VirtualMachines GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get_WithVMSizeProperties.json
     */
    /**
     * Sample code: Get a virtual machine with VM Size Properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachineWithVMSizeProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines()
            .getByResourceGroupWithResponse("myResourceGroup", "myVM", null, com.azure.core.util.Context.NONE);
    }

    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get_WithDiskControllerType.json
     */
    /**
     * Sample code: Get a virtual machine with Disk Controller Type Properties.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        getAVirtualMachineWithDiskControllerTypeProperties(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().getByResourceGroupWithResponse(
            "myResourceGroup", "myVM", InstanceViewTypes.USER_DATA, com.azure.core.util.Context.NONE);
    }

    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_Get.json
     */
    /**
     * Sample code: Get a Virtual Machine.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getAVirtualMachine(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().getByResourceGroupWithResponse(
            "myResourceGroup", "myVM", InstanceViewTypes.USER_DATA, 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

샘플 응답

상태 코드:: 200

{
  "name": "myVM",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "West US",
  "tags": {
    "myTag1": "tagValue1"
  },
  "properties": {
    "vmId": "0f47b100-583c-48e3-a4c0-aefc2c9bbcc1",
    "availabilitySet": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"
    },
    "hardwareProfile": {
      "vmSize": "Standard_DS3_v2",
      "vmSizeProperties": {
        "vCPUsAvailable": 1,
        "vCPUsPerCore": 1
      }
    },
    "storageProfile": {
      "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": "myDataDisk0",
          "createOption": "Empty",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk0"
          },
          "diskSizeGB": 30
        },
        {
          "lun": 1,
          "name": "myDataDisk1",
          "createOption": "Attach",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"
          },
          "diskSizeGB": 100
        }
      ]
    },
    "applicationProfile": {
      "galleryApplications": [
        {
          "tags": "myTag1",
          "order": 1,
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
          "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config"
        },
        {
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
        }
      ]
    },
    "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
    "osProfile": {
      "computerName": "myVM",
      "adminUsername": "admin",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": false
      },
      "secrets": []
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"
        }
      ]
    },
    "diagnosticsProfile": {
      "bootDiagnostics": {
        "enabled": true,
        "storageUri": "http://{myStorageAccount}.blob.core.windows.net"
      }
    },
    "extensionsTimeBudget": "PT50M",
    "provisioningState": "Succeeded"
  },
  "resources": [
    {
      "name": "CustomScriptExtension-DSC",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "west us",
      "tags": {
        "displayName": "CustomScriptExtension-DSC"
      },
      "properties": {
        "autoUpgradeMinorVersion": true,
        "provisioningState": "Succeeded",
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.9",
        "settings": {}
      }
    }
  ]
}

Get a Virtual Machine.

샘플 요청

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM?$expand=userData&api-version=2024-03-01

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_get.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.get(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get.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/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_Get.json
func ExampleVirtualMachinesClient_Get_getAVirtualMachine() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().Get(ctx, "myResourceGroup", "myVM", &armcompute.VirtualMachinesClientGetOptions{Expand: to.Ptr(armcompute.InstanceViewTypesUserData)})
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachine = armcompute.VirtualMachine{
	// 	Name: to.Ptr("myVM"),
	// 	Type: to.Ptr("Microsoft.Compute/virtualMachines"),
	// 	ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM"),
	// 	Location: to.Ptr("West US"),
	// 	Tags: map[string]*string{
	// 		"myTag1": to.Ptr("tagValue1"),
	// 	},
	// 	Etag: to.Ptr("\"1\""),
	// 	ManagedBy: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{MyVmss}"),
	// 	Properties: &armcompute.VirtualMachineProperties{
	// 		ApplicationProfile: &armcompute.ApplicationProfile{
	// 			GalleryApplications: []*armcompute.VMGalleryApplication{
	// 				{
	// 					ConfigurationReference: to.Ptr("https://mystorageaccount.blob.core.windows.net/configurations/settings.config"),
	// 					Order: to.Ptr[int32](1),
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0"),
	// 					Tags: to.Ptr("myTag1"),
	// 				},
	// 				{
	// 					PackageReferenceID: to.Ptr("/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"),
	// 			}},
	// 		},
	// 		AvailabilitySet: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"),
	// 		},
	// 		DiagnosticsProfile: &armcompute.DiagnosticsProfile{
	// 			BootDiagnostics: &armcompute.BootDiagnostics{
	// 				Enabled: to.Ptr(true),
	// 				StorageURI: to.Ptr("http://{myStorageAccount}.blob.core.windows.net"),
	// 			},
	// 		},
	// 		ExtensionsTimeBudget: to.Ptr("PT50M"),
	// 		HardwareProfile: &armcompute.HardwareProfile{
	// 			VMSize: to.Ptr(armcompute.VirtualMachineSizeTypesStandardDS3V2),
	// 		},
	// 		NetworkProfile: &armcompute.NetworkProfile{
	// 			NetworkInterfaces: []*armcompute.NetworkInterfaceReference{
	// 				{
	// 					ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"),
	// 			}},
	// 		},
	// 		OSProfile: &armcompute.OSProfile{
	// 			AdminUsername: to.Ptr("admin"),
	// 			ComputerName: to.Ptr("myVM"),
	// 			Secrets: []*armcompute.VaultSecretGroup{
	// 			},
	// 			WindowsConfiguration: &armcompute.WindowsConfiguration{
	// 				EnableAutomaticUpdates: to.Ptr(false),
	// 				ProvisionVMAgent: to.Ptr(true),
	// 			},
	// 		},
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		ProximityPlacementGroup: &armcompute.SubResource{
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/proximityPlacementGroups/my-ppg01"),
	// 		},
	// 		StorageProfile: &armcompute.StorageProfile{
	// 			DataDisks: []*armcompute.DataDisk{
	// 				{
	// 					Name: to.Ptr("myDataDisk0"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesEmpty),
	// 					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/myDataDisk0"),
	// 						StorageAccountType: to.Ptr(armcompute.StorageAccountTypesPremiumLRS),
	// 					},
	// 				},
	// 				{
	// 					Name: to.Ptr("myDataDisk1"),
	// 					Caching: to.Ptr(armcompute.CachingTypesReadWrite),
	// 					CreateOption: to.Ptr(armcompute.DiskCreateOptionTypesAttach),
	// 					DiskSizeGB: to.Ptr[int32](100),
	// 					Lun: to.Ptr[int32](1),
	// 					ManagedDisk: &armcompute.ManagedDiskParameters{
	// 						ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"),
	// 						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),
	// 			},
	// 		},
	// 		TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2021-06-27T01:02:38.313Z"); return t}()),
	// 		UserData: to.Ptr("RXhhbXBsZSBVc2VyRGF0YQ=="),
	// 		VMID: to.Ptr("0f47b100-583c-48e3-a4c0-aefc2c9bbcc1"),
	// 	},
	// 	Resources: []*armcompute.VirtualMachineExtension{
	// 		{
	// 			Name: to.Ptr("CustomScriptExtension-DSC"),
	// 			Type: to.Ptr("Microsoft.Compute/virtualMachines/extensions"),
	// 			ID: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC"),
	// 			Location: to.Ptr("west us"),
	// 			Tags: map[string]*string{
	// 				"displayName": to.Ptr("CustomScriptExtension-DSC"),
	// 			},
	// 			Properties: &armcompute.VirtualMachineExtensionProperties{
	// 				Type: to.Ptr("CustomScriptExtension"),
	// 				AutoUpgradeMinorVersion: to.Ptr(true),
	// 				ProvisioningState: to.Ptr("Succeeded"),
	// 				Publisher: to.Ptr("Microsoft.Compute"),
	// 				Settings: map[string]any{
	// 				},
	// 				TypeHandlerVersion: to.Ptr("1.9"),
	// 			},
	// 	}},
	// }
}

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

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

/**
 * This sample demonstrates how to Retrieves information about the model view or the instance view of a virtual machine.
 *
 * @summary Retrieves information about the model view or the instance view of a virtual machine.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Get.json
 */
async function getAVirtualMachine() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const vmName = "myVM";
  const expand = "userData";
  const options = { expand };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.get(resourceGroupName, vmName, options);
  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

{
  "name": "myVM",
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM",
  "type": "Microsoft.Compute/virtualMachines",
  "location": "West US",
  "tags": {
    "myTag1": "tagValue1"
  },
  "etag": "\"1\"",
  "properties": {
    "vmId": "0f47b100-583c-48e3-a4c0-aefc2c9bbcc1",
    "availabilitySet": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/availabilitySets/my-AvailabilitySet"
    },
    "proximityPlacementGroup": {
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/proximityPlacementGroups/my-ppg01"
    },
    "hardwareProfile": {
      "vmSize": "Standard_DS3_v2"
    },
    "storageProfile": {
      "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": "myDataDisk0",
          "createOption": "Empty",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk0"
          },
          "diskSizeGB": 30
        },
        {
          "lun": 1,
          "name": "myDataDisk1",
          "createOption": "Attach",
          "caching": "ReadWrite",
          "managedDisk": {
            "storageAccountType": "Premium_LRS",
            "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDataDisk1"
          },
          "diskSizeGB": 100
        }
      ]
    },
    "applicationProfile": {
      "galleryApplications": [
        {
          "tags": "myTag1",
          "order": 1,
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdb/resourceGroups/myresourceGroupName2/providers/Microsoft.Compute/galleries/myGallery1/applications/MyApplication1/versions/1.0",
          "configurationReference": "https://mystorageaccount.blob.core.windows.net/configurations/settings.config"
        },
        {
          "packageReferenceId": "/subscriptions/32c17a9e-aa7b-4ba5-a45b-e324116b6fdg/resourceGroups/myresourceGroupName3/providers/Microsoft.Compute/galleries/myGallery2/applications/MyApplication2/versions/1.1"
        }
      ]
    },
    "userData": "RXhhbXBsZSBVc2VyRGF0YQ==",
    "osProfile": {
      "computerName": "myVM",
      "adminUsername": "admin",
      "windowsConfiguration": {
        "provisionVMAgent": true,
        "enableAutomaticUpdates": false
      },
      "secrets": []
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Network/networkInterfaces/{myNIC}"
        }
      ]
    },
    "diagnosticsProfile": {
      "bootDiagnostics": {
        "enabled": true,
        "storageUri": "http://{myStorageAccount}.blob.core.windows.net"
      }
    },
    "extensionsTimeBudget": "PT50M",
    "provisioningState": "Succeeded",
    "timeCreated": "2021-06-27T01:02:38.3138469+00:00"
  },
  "resources": [
    {
      "name": "CustomScriptExtension-DSC",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/extensions/CustomScriptExtension-DSC",
      "type": "Microsoft.Compute/virtualMachines/extensions",
      "location": "west us",
      "tags": {
        "displayName": "CustomScriptExtension-DSC"
      },
      "properties": {
        "autoUpgradeMinorVersion": true,
        "provisioningState": "Succeeded",
        "publisher": "Microsoft.Compute",
        "type": "CustomScriptExtension",
        "typeHandlerVersion": "1.9",
        "settings": {}
      }
    }
  ],
  "managedBy": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachineScaleSets/{MyVmss}"
}

정의

Name	Description
AdditionalCapabilities	가상 머신에서 사용하거나 사용하지 않도록 설정된 추가 기능을 지정합니다.
AdditionalUnattendContent	Windows 설치 프로그램에 사용되는 Unattend.xml 파일에 포함될 수 있는, base-64로 인코딩된 추가적인 XML 형식 정보를 지정합니다.
ApiEntityReference	원본 리소스 식별자입니다. 스냅샷 또는 디스크를 만들 디스크 복원 지점일 수 있습니다.
ApiError	API 오류입니다.
ApiErrorBase	API 오류 기준입니다.
ApplicationProfile	VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.
AvailablePatchSummary	가상 머신에 대한 최신 평가 작업의 사용 가능한 패치 요약입니다.
BillingProfile	Azure Spot 가상 머신의 청구 관련 세부 정보를 지정합니다. 최소 api-version: 2019-03-01.
BootDiagnostics	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 참고: storageUri를 지정하는 경우 스토리지 계정이 VM과 동일한 지역 및 구독에 있는지 확인합니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.
BootDiagnosticsInstanceView	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.
CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지의 경우 없음입니다. Premium Storage용 ReadOnly.
CapacityReservationProfile	가상 머신을 할당하는 데 사용되는 용량 예약에 대한 정보를 지정합니다. 최소 api-version: 2021-04-01.
CloudError	Compute 서비스의 오류 응답입니다.
ComponentNames	구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.
DataDisk	가상 컴퓨터에 데이터 디스크를 추가하는 데 사용되는 매개 변수를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보를 참조하세요.
DeleteOptions	VM이 삭제되면 네트워크 인터페이스에 어떤 일이 발생하는지 지정합니다.
DiagnosticsProfile	부팅 진단 설정 상태를 지정합니다. 최소 api-version: 2015-06-15.
DiffDiskOptions	운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiffDiskPlacement	운영 체제 디스크에 대한 임시 디스크 배치를 지정합니다. 가능한 값은 CacheDisk,ResourceDisk,NvmeDisk입니다. 기본 동작은 VM 크기에 대해 구성된 경우 CacheDisk이고, 그렇지 않으면 ResourceDisk 또는 NvmeDisk가 사용됩니다. 에서 Windows VM 및 Linux VM에 https://docs.microsoft.com/azure/virtual-machines/windows/sizes https://docs.microsoft.com/azure/virtual-machines/linux/sizes 대한 VM 크기 설명서를 참조하여 캐시 디스크를 노출하는 VM 크기를 검사. NvmeDisk의 최소 api-version: 2024-03-01.
DiffDiskSettings	가상 머신에서 사용하는 운영 체제 디스크에 대한 임시 디스크 설정을 지정합니다.
DiskControllerTypes	VM에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 참고: 지정된 최소 api 버전의 운영 체제 디스크 및 VM 크기에 따라 'hyperVGeneration'을 V2로 설정하여 가상 머신을 만드는 경우 지정하지 않으면 이 속성이 기본 디스크 컨트롤러 유형으로 설정됩니다. 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.
DiskInstanceView	가상 머신 디스크 정보입니다.
DomainNameLabelScopeTypes	도메인 이름 레이블은 만들 PublicIPAddress 리소스의 scope. 생성된 이름 레이블은 도메인 이름 레이블 scope 및 vm 네트워크 프로필 고유 ID에 따라 해시된 도메인 이름 레이블과 정책을 연결한 것입니다.
EncryptionIdentity	ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.
EventGridAndResourceGraph	eventGridAndResourceGraph Scheduled Event 설정을 만드는 동안 사용되는 구성 매개 변수입니다.
ExtendedLocation	Virtual Machine의 확장된 위치입니다.
ExtendedLocationTypes	확장된 위치의 형식입니다.
HardwareProfile	가상 머신에 대한 하드웨어 설정을 지정합니다.
HyperVGenerationType	리소스와 연결된 HyperVGeneration 형식을 지정합니다.
ImageReference	사용할 이미지에 대한 정보를 지정합니다. 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지에 대한 정보를 지정할 수 있습니다. 이 요소는 플랫폼 이미지, 마켓플레이스 이미지 또는 가상 머신 이미지를 사용하려는 경우 필요하지만 다른 만들기 작업에는 사용되지 않습니다.
InnerError	내부 오류 세부 정보입니다.
InstanceViewStatus	인스턴스 보기 상태.
InstanceViewTypes	작업에 적용할 확장 식입니다. 'InstanceView'는 플랫폼에서 관리하고 컨트롤 플레인 작업 외부에서 변경할 수 있는 가상 머신의 런타임 속성 스냅샷 검색합니다. 'UserData'는 VM 만들기/업데이트 작업 중에 사용자가 제공한 VM 모델 보기의 일부로 UserData 속성을 검색합니다.
IPVersions	Api-Version 2019-07-01부터 사용할 수 있으며 특정 ipconfiguration이 IPv4 또는 IPv6인지 여부를 나타냅니다. 기본값은 IPv4로 사용됩니다. 가능한 값은 'IPv4' 및 'IPv6'입니다.
KeyVaultKeyReference	Key Vault 키 암호화 키의 위치를 지정합니다.
KeyVaultSecretReference	키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정
LastPatchInstallationSummary	가상 머신에 대한 최신 설치 작업의 설치 요약입니다.
LinuxConfiguration	가상 머신에서 Linux 운영 체제 설정을 지정합니다. 지원되는 Linux 배포 목록은 Azure-Endorsed 배포판의 Linux를 참조하세요.
LinuxPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
LinuxPatchSettings	[미리 보기 기능] Linux의 VM 게스트 패치와 관련된 설정을 지정합니다.
LinuxVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.
LinuxVMGuestPatchAutomaticByPlatformSettings	Linux의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
LinuxVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.
MaintenanceOperationResultCodeTypes	마지막 유지 관리 작업 결과 코드입니다.
MaintenanceRedeployStatus	유지 관리 작업은 가상 머신에서 상태.
ManagedDiskParameters	관리 디스크 매개 변수입니다.
Mode	기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지 않고 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.
NetworkApiVersion	는 네트워크 인터페이스 구성에서 네트워킹 리소스를 만들 때 사용되는 Microsoft.Network API 버전을 지정합니다.
NetworkInterfaceAuxiliaryMode	네트워크 인터페이스 리소스에 보조 모드를 사용할 수 있는지 여부를 지정합니다.
NetworkInterfaceAuxiliarySku	네트워크 인터페이스 리소스에 대해 보조 sku를 사용할 수 있는지 여부를 지정합니다.
NetworkInterfaceReference	가상 머신과 연결된 네트워크 인터페이스의 리소스 ID 목록을 지정합니다.
NetworkProfile	가상 머신의 네트워크 인터페이스를 지정합니다.
OperatingSystemTypes	운영 체제 유형입니다.
OSDisk	가상 머신에서 사용하는 운영 체제 디스크에 대한 정보를 지정합니다. 디스크에 대한 자세한 내용은 Azure 가상 머신의 디스크 및 VHD 정보를 참조하세요.
OSImageNotificationProfile	OS 이미지 예약 이벤트 관련 구성을 지정합니다.
OSProfile	가상 머신을 만드는 동안 사용되는 운영 체제 설정을 지정합니다. VM이 프로비전되면 일부 설정을 변경할 수 없습니다.
PassNames	pass 이름입니다. 현재 허용 가능한 값은 OobeSystem뿐입니다.
PatchOperationStatus	작업의 전체 성공 또는 실패 상태. 작업이 완료될 때까지 "InProgress"로 유지됩니다. 이 시점에서 "알 수 없음", "실패", "성공" 또는 "CompletedWithWarnings"가 됩니다.
PatchSettings	[미리 보기 기능] Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.
Plan	가상 머신을 만드는 데 사용되는 마켓플레이스 이미지에 대한 정보를 지정합니다. 이 요소는 마켓플레이스 이미지에만 사용됩니다. API에서 마켓플레이스 이미지를 사용하려면 먼저 프로그래밍 방식으로 사용할 이미지를 사용하도록 설정해야 합니다. Azure Portal 사용하려는 마켓플레이스 이미지를 찾은 다음 프로그래밍 방식으로 배포하려는 시작 ->을 클릭합니다. 필요한 정보를 입력한 다음 저장을 클릭합니다.
ProtocolTypes	WinRM 수신기의 프로토콜을 지정합니다. 가능한 값은 http,https입니다.
ProxyAgentSettings	가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.
PublicIPAddressSku	공용 IP SKU에 대해 설명합니다. OrchestrationMode를 유연한 것으로만 설정할 수 있습니다.
PublicIPAddressSkuName	공용 IP sku 이름 지정
PublicIPAddressSkuTier	공용 IP sku 계층 지정
PublicIPAllocationMethod	공용 IP 할당 유형 지정
ResourceIdentityType	가상 머신에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
ScheduledEventsAdditionalPublishingTargets	scheduledEventsAdditionalPublishingTargets를 게시하는 동안 사용되는 구성 매개 변수입니다.
ScheduledEventsPolicy	가상 머신에 대한 재배포, 다시 부팅 및 ScheduledEventsAdditionalPublishingTargets 예약된 이벤트 관련 구성을 지정합니다.
ScheduledEventsProfile	예약된 이벤트 관련 구성을 지정합니다.
securityEncryptionTypes	관리 디스크의 EncryptionType을 지정합니다. VMGuestState Blob과 함께 관리 디스크의 암호화를 위해 DiskWithVMGuestState로 설정되고, VMGuestState Blob만 암호화하는 경우 VMGuestStateOnly, VMGuestState Blob에서 펌웨어 상태를 유지하지 않는 경우 NonPersistedTPM으로 설정됩니다. 참고: 기밀 VM에 대해서만 설정할 수 있습니다.
SecurityProfile	가상 머신에 대한 보안 관련 프로필 설정을 지정합니다.
SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작은 다음과 같습니다. 이 속성이 설정되지 않으면 UefiSettings가 사용하도록 설정되지 않습니다.
SettingNames	콘텐츠가 적용되는 설정의 이름을 지정합니다. 가능한 값은 FirstLogonCommands 및 AutoLogon입니다.
SshConfiguration	Linux OS용 ssh 키 구성을 지정합니다.
SshPublicKey	Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다.
StatusLevelTypes	수준 코드입니다.
StorageAccountTypes	관리 디스크의 스토리지 계정 유형을 지정합니다. 참고: UltraSSD_LRS 데이터 디스크에서만 사용할 수 있으므로 OS 디스크와 함께 사용할 수 없습니다.
StorageProfile	가상 머신 디스크에 대한 스토리지 설정을 지정합니다.
SubResource	비밀을 포함하는 Key Vault 상대 URL입니다.
TerminateNotificationProfile	Terminate Scheduled Event 관련 구성을 지정합니다.
UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 최소 api-version: 2020-12-01.
UserAssignedIdentities	Virtual Machine과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.
UserInitiatedReboot	userInitiatedReboot 예약된 이벤트 설정을 만드는 동안 사용되는 구성 매개 변수입니다.
UserInitiatedRedeploy	userInitiatedRedeploy 예약된 이벤트 설정 만들기를 만드는 동안 사용되는 구성 매개 변수입니다.
VaultCertificate	인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다.
VaultSecretGroup	가상 컴퓨터에 설치되어 있어야 하는 인증서 집합을 지정합니다. 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.
VirtualHardDisk	가상 하드 디스크입니다.
VirtualMachine	Virtual Machine에 대해 설명합니다.
VirtualMachineAgentInstanceView	가상 머신에서 실행되는 VM 에이전트입니다.
VirtualMachineEvictionPolicyTypes	Azure Spot 가상 머신 및 Azure 스폿 확장 집합에 대한 제거 정책을 지정합니다. Azure 스폿 가상 머신의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2019-03-01입니다. Azure 스폿 확장 집합의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2017-10-30-preview입니다.
VirtualMachineExtension	가상 머신 자식 확장 리소스입니다.
VirtualMachineExtensionHandlerInstanceView	가상 머신 확장 처리기는 보기를 instance.
VirtualMachineExtensionInstanceView	가상 머신 확장 instance 보기입니다.
VirtualMachineHealthStatus	VM에 대한 상태 상태.
VirtualMachineIdentity	구성된 경우 가상 머신의 ID입니다.
VirtualMachineInstanceView	가상 머신 instance 보기입니다.
VirtualMachineIpTag	공용 IP 주소와 연결된 IP 태그 목록입니다.
VirtualMachineNetworkInterfaceConfiguration	가상 머신 네트워킹 리소스를 만드는 데 사용할 네트워킹 구성을 지정합니다.
VirtualMachineNetworkInterfaceDnsSettingsConfiguration	네트워크 인터페이스에 적용할 dns 설정입니다.
VirtualMachineNetworkInterfaceIPConfiguration	네트워크 인터페이스의 IP 구성을 지정합니다.
VirtualMachinePatchStatus	[미리 보기 기능] 가상 머신 패치 작업의 상태.
VirtualMachinePriorityTypes	가상 머신의 우선 순위를 지정합니다. 최소 api-version: 2019-03-01
VirtualMachinePublicIPAddressConfiguration	publicIPAddressConfiguration입니다.
VirtualMachinePublicIPAddressDnsSettingsConfiguration	publicIP 주소 에 적용할 dns 설정입니다.
VirtualMachineSizeTypes	가상 컴퓨터의 크기를 지정합니다. 열거형 데이터 형식은 현재 사용되지 않으며 2023년 12월 23일까지 제거됩니다. 사용 가능한 크기 목록을 가져오는 권장 방법은 다음 API를 사용하는 것입니다. 가용성 집합에 사용 가능한 모든 가상 머신 크기 나열, 지역에서 사용 가능한 모든 가상 머신 크기 나열, 크기 조정을 위해 사용 가능한 모든 가상 머신 크기 나열. 가상 머신 크기에 대한 자세한 내용은 가상 머신의 크기를 참조하세요. 사용 가능한 VM 크기는 지역 및 가용성 집합에 따라 달라집니다.
VMDiskSecurityProfile	관리 디스크의 보안 프로필을 지정합니다.
VMGalleryApplication	VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.
VMSizeProperties	가상 머신의 크기를 사용자 지정하기 위한 속성을 지정합니다. 최소 api-version: 2021-07-01. 이 기능은 아직 미리 보기 모드이며 VirtualMachineScaleSet에서 지원되지 않습니다. 자세한 내용은 VM 사용자 지정 의 지침을 따르세요.
WindowsConfiguration	가상 머신의 Windows 운영 체제 설정을 지정합니다.
WindowsPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
WindowsVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.
WindowsVMGuestPatchAutomaticByPlatformSettings	Windows의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
WindowsVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 가상 머신에 패치 적용을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다. AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.
WinRMConfiguration	Windows 원격 관리 수신기를 지정합니다. 따라서 원격 Windows PowerShell을 사용할 수 있습니다.
WinRMListener	Windows 원격 관리 수신기 목록

AdditionalCapabilities

가상 머신에서 사용하거나 사용하지 않도록 설정된 추가 기능을 지정합니다.

Name	형식	Description
hibernationEnabled	boolean	VM에서 최대 절전 모드 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다.
ultraSSDEnabled	boolean	VM 또는 VMSS에 UltraSSD_LRS 스토리지 계정 유형이 있는 하나 이상의 관리되는 데이터 디스크가 있는 기능을 사용하거나 사용하지 않도록 설정하는 플래그입니다. 스토리지 계정 유형이 UltraSSD_LRS 관리 디스크는 이 속성을 사용하는 경우에만 가상 머신 또는 가상 머신 확장 집합에 추가할 수 있습니다.

AdditionalUnattendContent

Windows 설치 프로그램에 사용되는 Unattend.xml 파일에 포함될 수 있는, base-64로 인코딩된 추가적인 XML 형식 정보를 지정합니다.

Name	형식	Description
componentName	ComponentNames	구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.
content	string	지정된 경로 및 구성 요소에 대한 unattend.xml 파일에 추가되는 XML 형식의 콘텐츠를 지정합니다. XML은 4KB 미만이어야 하며 삽입되는 설정 또는 기능에 대한 루트 요소를 포함해야 합니다.
passName	PassNames	pass 이름입니다. 현재 허용 가능한 값은 OobeSystem뿐입니다.
settingName	SettingNames	콘텐츠가 적용되는 설정의 이름을 지정합니다. 가능한 값은 FirstLogonCommands 및 AutoLogon입니다.

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	특정 오류의 대상입니다.

ApplicationProfile

VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.

Name	형식	Description
galleryApplications	VMGalleryApplication[]	VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.

AvailablePatchSummary

가상 머신에 대한 최신 평가 작업의 사용 가능한 패치 요약입니다.

Name	형식	Description
assessmentActivityId	string	이 결과를 생성한 작업의 활동 ID입니다. CRP 및 확장 로그 간에 상관 관계를 지정하는 데 사용됩니다.
criticalAndSecurityPatchCount	integer	사용 가능하고 아직 설치되지 않은 것으로 검색된 중요 또는 보안 패치의 수입니다.
error	ApiError	작업을 실행하는 동안 발생한 오류입니다. 세부 정보 배열에는 해당 목록이 포함됩니다.
lastModifiedTime	string	작업이 시작된 UTC 타임스탬프입니다.
otherPatchCount	integer	중요 및 보안을 제외한 사용 가능한 모든 패치의 수입니다.
rebootPending	boolean	VM의 전체 재부팅 상태. 부분적으로 설치된 패치가 설치를 완료하기 위해 다시 부팅해야 하지만 다시 부팅이 아직 발생하지 않은 경우는 마찬가지입니다.
startTime	string	작업이 시작된 UTC 타임스탬프입니다.
status	PatchOperationStatus	작업의 전체 성공 또는 실패 상태. 작업이 완료될 때까지 "InProgress"로 유지됩니다. 이 시점에서 "알 수 없음", "실패", "성공" 또는 "CompletedWithWarnings"가 됩니다.

BillingProfile

Azure Spot 가상 머신의 청구 관련 세부 정보를 지정합니다. 최소 api-version: 2019-03-01.

Name	형식	Description
maxPrice	number	Azure Spot VM/VMSS에 대해 지불할 최대 가격을 지정합니다. 이 가격은 미국 달러입니다. 이 가격은 VM 크기의 현재 Azure 스폿 가격과 비교됩니다. 또한 가격은 Azure Spot VM/VMSS를 생성/업데이트할 때 비교되며 maxPrice가 현재 Azure 스폿 가격보다 큰 경우에만 작업이 성공합니다. maxPrice는 현재 Azure 스폿 가격이 VM/VMSS를 만든 후 maxPrice를 초과하는 경우 Azure 스폿 VM/VMSS를 제거할 때도 사용됩니다. 가능한 값은 다음과 같습니다. - 0보다 큰 10진수 값입니다. 예: 0.01538 -1 – 주문형으로 기본 가격을 나타냅니다. maxPrice를 -1로 설정하여 가격상의 이유로 Azure 스폿 VM/VMSS를 제거해서는 안 됨을 나타낼 수 있습니다. 또한 기본 최대 가격은 사용자가 제공하지 않는 경우 -1입니다. 최소 api-version: 2019-03-01.

BootDiagnostics

부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 참고: storageUri를 지정하는 경우 스토리지 계정이 VM과 동일한 지역 및 구독에 있는지 확인합니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

Name	형식	Description
enabled	boolean	Virtual Machine에서 부팅 진단 사용하도록 설정해야 하는지 여부입니다.
storageUri	string	콘솔 출력 및 스크린샷을 배치하는 데 사용할 스토리지 계정의 URI입니다. 부팅 진단 사용하도록 설정하는 동안 storageUri를 지정하지 않으면 관리형 스토리지가 사용됩니다.

BootDiagnosticsInstanceView

부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

Name	형식	Description
consoleScreenshotBlobUri	string	콘솔 스크린샷 Blob URI. 참고: 부팅 진단 현재 관리되는 스토리지에서 사용하도록 설정된 경우에는 설정되지 않습니다.
serialConsoleLogBlobUri	string	직렬 콘솔 로그 Blob Uri입니다. 참고: 부팅 진단 현재 관리되는 스토리지에서 사용하도록 설정된 경우에는 설정되지 않습니다.
status	InstanceViewStatus	부팅 진단 상태 VM에 대한 정보입니다. 참고: 부팅 진단 사용하도록 설정할 때 오류가 발생한 경우에만 설정됩니다.

CachingTypes

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

Name	형식	Description
None	string
ReadOnly	string
ReadWrite	string

CapacityReservationProfile

가상 머신을 할당하는 데 사용되는 용량 예약에 대한 정보를 지정합니다. 최소 api-version: 2021-04-01.

Name	형식	Description
capacityReservationGroup	SubResource	충분한 용량이 예약된 경우 가상 머신 또는 확장 집합 vm 인스턴스를 할당하는 데 사용해야 하는 용량 예약 그룹 리소스 ID를 지정합니다. 자세한 내용은 을 https://aka.ms/CapacityReservation 참조하세요.

CloudError

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

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

ComponentNames

구성 요소 이름입니다. 현재 허용되는 유일한 값은 Microsoft-Windows-Shell-Setup입니다.

Name	형식	Description
Microsoft-Windows-Shell-Setup	string

DataDisk

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

Name	형식	Description
caching	CachingTypes	캐싱 요구 사항을 지정합니다. 가능한 값은 None,ReadOnly,ReadWrite입니다. 기본 동작은 표준 스토리지의 경우 없음입니다. Premium Storage용 ReadOnly.
createOption	DiskCreateOptionTypes	가상 머신 디스크를 만드는 방법을 지정합니다. 가능한 값은 Attach입니다. 이 값은 특수 디스크를 사용하여 가상 머신을 만들 때 사용됩니다. FromImage: 이 값은 이미지를 사용하여 가상 머신 데이터 디스크를 만들 때 사용됩니다. 플랫폼 이미지를 사용하는 경우 위에서 설명한 imageReference 요소도 사용해야 합니다. 마켓플레이스 이미지를 사용하는 경우 앞에서 설명한 계획 요소도 사용해야 합니다. 빈: 이 값은 빈 데이터 디스크를 만들 때 사용됩니다. 복사: 이 값은 스냅샷 또는 다른 디스크에서 데이터 디스크를 만드는 데 사용됩니다. 복원: 이 값은 디스크 복원 지점에서 데이터 디스크를 만드는 데 사용됩니다.
deleteOption	DiskDeleteOptionTypes	VM을 삭제할 때 데이터 디스크를 삭제하거나 분리할지 여부를 지정합니다. 가능한 값은 Delete입니다. 이 값을 사용하면 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를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

DeleteOptions

VM이 삭제되면 네트워크 인터페이스에 어떤 일이 발생하는지 지정합니다.

Name	형식	Description
Delete	string
Detach	string

DiagnosticsProfile

부팅 진단 설정 상태를 지정합니다. 최소 api-version: 2015-06-15.

Name	형식	Description
bootDiagnostics	BootDiagnostics	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 참고: storageUri를 지정하는 경우 스토리지 계정이 VM과 동일한 지역 및 구독에 있는지 확인합니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.

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 https://docs.microsoft.com/azure/virtual-machines/linux/sizes 대한 VM 크기 설명서를 참조하여 캐시 디스크를 노출하는 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/sizes 대한 VM https://docs.microsoft.com/azure/virtual-machines/linux/sizes 크기 설명서를 참조하여 캐시 디스크를 노출하는 VM 크기를 검사. NvmeDisk의 최소 api-version: 2024-03-01.

DiskControllerTypes

VM에 대해 구성된 디스크 컨트롤러 유형을 지정합니다. 참고: 지정된 최소 api 버전의 운영 체제 디스크 및 VM 크기에 따라 'hyperVGeneration'을 V2로 설정하여 가상 머신을 만드는 경우 지정하지 않으면 이 속성이 기본 디스크 컨트롤러 유형으로 설정됩니다. 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 키 암호화 키의 위치를 지정합니다.

DiskInstanceView

가상 머신 디스크 정보입니다.

Name	형식	Description
encryptionSettings	DiskEncryptionSettings[]	OS 디스크에 대한 암호화 설정을 지정합니다. 최소 api-version: 2015-06-15
name	string	디스크 이름.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.

DomainNameLabelScopeTypes

도메인 이름 레이블은 만들 PublicIPAddress 리소스의 scope. 생성된 이름 레이블은 도메인 이름 레이블 scope 및 vm 네트워크 프로필 고유 ID에 따라 해시된 도메인 이름 레이블과 정책을 연결한 것입니다.

Name	형식	Description
NoReuse	string
ResourceGroupReuse	string
SubscriptionReuse	string
TenantReuse	string

EncryptionIdentity

ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.

Name	형식	Description
userAssignedIdentityResourceId	string	VM과 연결된 사용자 ID 중 하나의 ARM 리소스 ID를 지정합니다.

EventGridAndResourceGraph

eventGridAndResourceGraph Scheduled Event 설정을 만드는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
enable	boolean	Scheduled 이벤트 관련 구성에 대해 이벤트 그리드 및 리소스 그래프를 사용할 수 있는지를 지정합니다.

ExtendedLocation

Virtual Machine의 확장된 위치입니다.

Name	형식	Description
name	string	확장된 위치의 이름입니다.
type	ExtendedLocationTypes	확장된 위치의 형식입니다.

ExtendedLocationTypes

확장된 위치의 형식입니다.

Name	형식	Description
EdgeZone	string

HardwareProfile

가상 머신에 대한 하드웨어 설정을 지정합니다.

Name	형식	Description
vmSize	VirtualMachineSizeTypes	가상 컴퓨터의 크기를 지정합니다. 열거형 데이터 형식은 현재 사용되지 않으며 2023년 12월 23일까지 제거됩니다. 사용 가능한 크기 목록을 가져오는 권장 방법은 다음 API를 사용하는 것입니다. 가용성 집합에 사용 가능한 모든 가상 머신 크기 나열, 지역에서 사용 가능한 모든 가상 머신 크기 나열, 크기 조정을 위해 사용 가능한 모든 가상 머신 크기 나열. 가상 머신 크기에 대한 자세한 내용은 가상 머신의 크기를 참조하세요. 사용 가능한 VM 크기는 지역 및 가용성 집합에 따라 달라집니다.
vmSizeProperties	VMSizeProperties	가상 머신의 크기를 사용자 지정하기 위한 속성을 지정합니다. 최소 api-version: 2021-07-01. 이 기능은 아직 미리 보기 모드이며 VirtualMachineScaleSet에서 지원되지 않습니다. 자세한 내용은 VM 사용자 지정 의 지침을 따르세요.

HyperVGenerationType

리소스와 연결된 HyperVGeneration 형식을 지정합니다.

Name	형식	Description
V1	string
V2	string

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	예외 형식입니다.

InstanceViewStatus

인스턴스 보기 상태.

Name	형식	Description
code	string	상태 코드입니다.
displayStatus	string	상태 대한 짧은 지역화 가능 레이블입니다.
level	StatusLevelTypes	수준 코드입니다.
message	string	경고 및 오류 메시지를 포함하여 자세한 상태 메시지입니다.
time	string	상태 시간입니다.

InstanceViewTypes

작업에 적용할 확장 식입니다. 'InstanceView'는 플랫폼에서 관리하고 컨트롤 플레인 작업 외부에서 변경할 수 있는 가상 머신의 런타임 속성 스냅샷 검색합니다. 'UserData'는 VM 만들기/업데이트 작업 중에 사용자가 제공한 VM 모델 보기의 일부로 UserData 속성을 검색합니다.

Name	형식	Description
instanceView	string
userData	string

IPVersions

Api-Version 2019-07-01부터 사용할 수 있으며 특정 ipconfiguration이 IPv4 또는 IPv6인지 여부를 나타냅니다. 기본값은 IPv4로 사용됩니다. 가능한 값은 'IPv4' 및 'IPv6'입니다.

Name	형식	Description
IPv4	string
IPv6	string

KeyVaultKeyReference

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

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

KeyVaultSecretReference

키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정

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

LastPatchInstallationSummary

가상 머신에 대한 최신 설치 작업의 설치 요약입니다.

Name	형식	Description
error	ApiError	작업을 실행하는 동안 발생한 오류입니다. 세부 정보 배열에는 해당 목록이 포함됩니다.
excludedPatchCount	integer	고객이 지정한 제외 목록 일치에 의해 명시적으로 제외되었지만 사용 가능한 모든 패치의 수입니다.
failedPatchCount	integer	설치에 실패한 패치 수입니다.
installationActivityId	string	이 결과를 생성한 작업의 활동 ID입니다. CRP 및 확장 로그 간에 상관 관계를 지정하는 데 사용됩니다.
installedPatchCount	integer	성공적으로 설치된 패치 수입니다.
lastModifiedTime	string	작업이 시작된 UTC 타임스탬프입니다.
maintenanceWindowExceeded	boolean	작업이 의도한 모든 작업을 완료하기 전에 시간이 부족했는지 여부를 설명합니다.
notSelectedPatchCount	integer	사용 가능한 모든 패치의 수이지만 분류 또는 포함 목록 항목과 일치하지 않아 설치되지 않을 수 있습니다.
pendingPatchCount	integer	패치 설치 작업 과정에서 설치될 것으로 예상되는 사용 가능한 모든 패치의 수입니다.
startTime	string	작업이 시작된 UTC 타임스탬프입니다.
status	PatchOperationStatus	작업의 전체 성공 또는 실패 상태. 작업이 완료될 때까지 "InProgress"로 유지됩니다. 이 시점에서 "알 수 없음", "실패", "성공" 또는 "CompletedWithWarnings"가 됩니다.

LinuxConfiguration

가상 머신에서 Linux 운영 체제 설정을 지정합니다. 지원되는 Linux 배포 목록은 Azure-Endorsed 배포판의 Linux를 참조하세요.

Name	형식	Description
disablePasswordAuthentication	boolean	암호 인증을 사용하지 않도록 설정할지 여부를 지정합니다.
enableVMAgentPlatformUpdates	boolean	Linux 가상 머신에 대해 VMAgent Platform 업데이트 사용하도록 설정되어 있는지 여부를 나타냅니다. 기본값은 false입니다.
patchSettings	LinuxPatchSettings	[미리 보기 기능] Linux의 VM 게스트 패치와 관련된 설정을 지정합니다.
provisionVMAgent	boolean	가상 컴퓨터에서 가상 컴퓨터 에이전트를 프로비전해야 하는지 여부를 나타냅니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본 동작은 true로 설정하는 것입니다. 이렇게 하면 나중에 VM에 확장을 추가할 수 있도록 VM 에이전트가 VM에 설치됩니다.
ssh	SshConfiguration	Linux OS용 ssh 키 구성을 지정합니다.

LinuxPatchAssessmentMode

IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다.

가능한 값은 다음과 같습니다.

ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다.

AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

LinuxPatchSettings

[미리 보기 기능] Linux의 VM 게스트 패치와 관련된 설정을 지정합니다.

Name	형식	Description
assessmentMode	LinuxPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
automaticByPlatformSettings	LinuxVMGuestPatchAutomaticByPlatformSettings	Linux의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
patchMode	LinuxVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

Name	형식	Description
Always	string
IfRequired	string
Never	string
Unknown	string

LinuxVMGuestPatchAutomaticByPlatformSettings

Linux의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.

Name	형식	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	고객이 실수로 업그레이드하지 않고 패치를 예약할 수 있습니다.
rebootSetting	LinuxVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

LinuxVMGuestPatchMode

OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다.

가능한 값은 다음과 같습니다.

ImageDefault - 가상 머신의 기본 패치 구성이 사용됩니다.

AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 속성은 true여야 합니다.

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

MaintenanceOperationResultCodeTypes

마지막 유지 관리 작업 결과 코드입니다.

Name	형식	Description
MaintenanceAborted	string
MaintenanceCompleted	string
None	string
RetryLater	string

MaintenanceRedeployStatus

유지 관리 작업은 가상 머신에서 상태.

Name	형식	Description
isCustomerInitiatedMaintenanceAllowed	boolean	True이면 고객이 유지 관리를 수행할 수 있습니다.
lastOperationMessage	string	마지막 유지 관리 작업에 대해 반환된 메시지입니다.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	마지막 유지 관리 작업 결과 코드입니다.
maintenanceWindowEndTime	string	유지 관리 기간의 종료 시간입니다.
maintenanceWindowStartTime	string	유지 관리 기간의 시작 시간입니다.
preMaintenanceWindowEndTime	string	유지 관리 전 기간의 종료 시간입니다.
preMaintenanceWindowStartTime	string	사전 유지 관리 기간의 시작 시간입니다.

ManagedDiskParameters

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

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

Mode

기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지 않고 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.

Name	형식	Description
Audit	string
Enforce	string

NetworkApiVersion

는 네트워크 인터페이스 구성에서 네트워킹 리소스를 만들 때 사용되는 Microsoft.Network API 버전을 지정합니다.

Name	형식	Description
2020-11-01	string

NetworkInterfaceAuxiliaryMode

네트워크 인터페이스 리소스에 보조 모드를 사용할 수 있는지 여부를 지정합니다.

Name	형식	Description
AcceleratedConnections	string
Floating	string
None	string

NetworkInterfaceAuxiliarySku

네트워크 인터페이스 리소스에 대해 보조 sku를 사용할 수 있는지 여부를 지정합니다.

Name	형식	Description
A1	string
A2	string
A4	string
A8	string
None	string

NetworkInterfaceReference

가상 머신과 연결된 네트워크 인터페이스의 리소스 ID 목록을 지정합니다.

Name	형식	Description
id	string	리소스 ID
properties.deleteOption	DeleteOptions	VM이 삭제되면 네트워크 인터페이스에 발생하는 작업 지정
properties.primary	boolean	가상 머신에 1개 이상의 네트워크 인터페이스가 있는 경우 기본 네트워크 인터페이스를 지정합니다.

NetworkProfile

가상 머신의 네트워크 인터페이스를 지정합니다.

Name	형식	Description
networkApiVersion	NetworkApiVersion	는 네트워크 인터페이스 구성에서 네트워킹 리소스를 만들 때 사용되는 Microsoft.Network API 버전을 지정합니다.
networkInterfaceConfigurations	VirtualMachineNetworkInterfaceConfiguration[]	가상 머신 네트워킹 리소스를 만드는 데 사용할 네트워킹 구성을 지정합니다.
networkInterfaces	NetworkInterfaceReference[]	가상 머신과 연결된 네트워크 인터페이스에 대한 리소스 ID 목록을 지정합니다.

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 디스크의 경우 기본값은 삭제로 설정됩니다. 사용자는 임시 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를 사용하도록 설정하거나 사용하지 않도록 설정할지 여부를 지정합니다.

OSImageNotificationProfile

OS 이미지 예약 이벤트 관련 구성을 지정합니다.

Name	형식	Description
enable	boolean	OS Image Scheduled 이벤트를 사용할지 여부를 지정합니다.
notBeforeTimeout	string	가상 머신을 이미지로 다시 설치하거나 OS를 업그레이드하는 데 걸리는 시간은 이벤트가 자동으로 승인되기 전에 OS 이미지 예약 이벤트를 승인해야 합니다(시간 초과). 구성은 ISO 8601 형식으로 지정되며 값은 15분(PT15M)이어야 합니다.

OSProfile

가상 머신을 만드는 동안 사용되는 운영 체제 설정을 지정합니다. VM이 프로비전되면 일부 설정을 변경할 수 없습니다.

Name	형식	Description
adminPassword	string	관리자 계정의 암호를 지정합니다. 최소 길이(Windows): 8자 최소 길이(Linux): 6자 최대 길이(Windows): 123자 최대 길이(Linux): 72자 복잡성 요구 사항: 아래의 4개 조건 중 3개는 충족해야 합니다. 문자가 낮습니다. 대문자 포함 숫자 가 있습니다. 특수 문자가 있습니다(Regex 일치 [\W_]) 허용되지 않는 값: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" 암호를 다시 설정하려면 Windows VM에서 원격 데스크톱 서비스 또는 해당 로그인 암호를 다시 설정하는 방법을 참조하세요. 루트 암호를 다시 설정하려면 VMAccess 확장을 사용하여 Azure Linux VM에서 사용자, SSH 및 검사 관리 또는 디스크 복구를 참조하세요.
adminUsername	string	관리자 계정의 이름을 지정합니다. VM을 만든 후에는 이 속성을 업데이트할 수 없습니다. Windows 전용 제한 사항: ""로 끝날 수 없습니다. 허용되지 않는 값: "administrator", "admin", "user", "user1", "test", "user2", "test1", "user3", "admin1", "1", "123", "a", "actuser", "adm", "admin2", "aspnet", "backup", "console", "david", "guest", "john", "owner", "root", "server", "sql", "support", "support_388945a0", "sys", "test2", "test3", "user4", "user5". 최소 길이(Linux): 1자 최대 길이(Linux): 64자 최대 길이(Windows): 20자입니다.
allowExtensionOperations	boolean	가상 머신에서 확장 작업을 허용할지 여부를 지정합니다. 가상 머신에 확장이 없는 경우에만 False로 설정할 수 있습니다.
computerName	string	가상 머신의 호스트 OS 이름을 지정합니다. VM을 만든 후에는 이 이름을 업데이트할 수 없습니다. 최대 길이(Windows): 15자. 최대 길이(Linux): 64자. 명명 규칙 및 제한 사항은 Azure 인프라 서비스 구현 지침을 참조하세요.
customData	string	사용자 지정 데이터의 Base-64로 인코딩된 문자열을 지정합니다. Base-64로 인코딩된 문자열은 가상 컴퓨터에 파일로 저장된 이진 배열로 디코딩됩니다. 이진 배열의 최대 길이는 65535바이트입니다. 참고: customData 속성에 비밀이나 암호를 전달하지 마세요. VM을 만든 후에는 이 속성을 업데이트할 수 없습니다. 'customData' 속성은 파일로 저장하기 위해 VM에 전달됩니다. 자세한 내용은 Azure VM의 사용자 지정 데이터를 참조하세요. Linux VM에 cloud-init를 사용하려면 cloud-init를 사용하여 만드는 동안 Linux VM 사용자 지정을 참조하세요.
linuxConfiguration	LinuxConfiguration	가상 머신에서 Linux 운영 체제 설정을 지정합니다. 지원되는 Linux 배포 목록은 Azure-Endorsed 배포판의 Linux를 참조하세요.
requireGuestProvisionSignal	boolean	True로 설정하거나 생략해야 하는 선택적 속성입니다.
secrets	VaultSecretGroup[]	가상 컴퓨터에 설치되어 있어야 하는 인증서 집합을 지정합니다. 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.
windowsConfiguration	WindowsConfiguration	가상 머신의 Windows 운영 체제 설정을 지정합니다.

PassNames

pass 이름입니다. 현재 허용 가능한 값은 OobeSystem뿐입니다.

Name	형식	Description
OobeSystem	string

PatchOperationStatus

작업의 전체 성공 또는 실패 상태. 작업이 완료될 때까지 "InProgress"로 유지됩니다. 이 시점에서 "알 수 없음", "실패", "성공" 또는 "CompletedWithWarnings"가 됩니다.

Name	형식	Description
CompletedWithWarnings	string
Failed	string
InProgress	string
Succeeded	string
Unknown	string

PatchSettings

[미리 보기 기능] Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.

Name	형식	Description
assessmentMode	WindowsPatchAssessmentMode	IaaS 가상 머신에 대한 VM 게스트 패치 평가 모드를 지정합니다. 가능한 값은 다음과 같습니다. ImageDefault - 가상 머신에서 패치 평가의 타이밍을 제어합니다. AutomaticByPlatform - 플랫폼은 주기적인 패치 평가를 트리거합니다. provisionVMAgent 속성은 true여야 합니다.
automaticByPlatformSettings	WindowsVMGuestPatchAutomaticByPlatformSettings	Windows의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.
enableHotpatching	boolean	고객이 다시 부팅하지 않고도 Azure VM을 패치할 수 있습니다. enableHotpatching의 경우 'provisionVMAgent'를 true로 설정하고 'patchMode'를 'AutomaticByPlatform'으로 설정해야 합니다.
patchMode	WindowsVMGuestPatchMode	OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다. 가능한 값은 다음과 같습니다. 수동 - 가상 머신에 패치 적용을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다. AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다. AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

Plan

가상 머신을 만드는 데 사용되는 마켓플레이스 이미지에 대한 정보를 지정합니다. 이 요소는 마켓플레이스 이미지에만 사용됩니다. API에서 마켓플레이스 이미지를 사용하려면 먼저 프로그래밍 방식으로 사용할 이미지를 사용하도록 설정해야 합니다. Azure Portal 사용하려는 마켓플레이스 이미지를 찾은 다음 프로그래밍 방식으로 배포하려는 시작 ->을 클릭합니다. 필요한 정보를 입력한 다음 저장을 클릭합니다.

Name	형식	Description
name	string	계획 ID입니다.
product	string	마켓플레이스에서 이미지의 곱을 지정합니다. imageReference 요소 아래의 Offer와 동일한 값입니다.
promotionCode	string	승격 코드입니다.
publisher	string	게시자 ID입니다.

ProtocolTypes

WinRM 수신기의 프로토콜을 지정합니다. 가능한 값은 http,https입니다.

Name	형식	Description
Http	string
Https	string

ProxyAgentSettings

가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.

Name	형식	Description
enabled	boolean	가상 머신 또는 가상 머신 확장 집합에서 ProxyAgent 기능을 사용하도록 설정할지 여부를 지정합니다.
keyIncarnationId	integer	이 속성의 값을 늘리면 사용자가 게스트와 호스트 간의 통신 채널을 보호하는 데 사용되는 키를 다시 설정할 수 있습니다.
mode	Mode	기능을 사용하는 경우 ProxyAgent가 실행할 모드를 지정합니다. ProxyAgent는 감사 또는 모니터링을 시작하지만 감사 모드에서 엔드포인트를 호스트하는 요청에 대한 액세스 제어를 적용하지는 않지만 적용 모드에서는 액세스 제어를 적용합니다. 기본값은 적용 모드입니다.

PublicIPAddressSku

공용 IP SKU에 대해 설명합니다. OrchestrationMode를 유연한 것으로만 설정할 수 있습니다.

Name	형식	Description
name	PublicIPAddressSkuName	공용 IP sku 이름 지정
tier	PublicIPAddressSkuTier	공용 IP sku 계층 지정

PublicIPAddressSkuName

공용 IP sku 이름 지정

Name	형식	Description
Basic	string
Standard	string

PublicIPAddressSkuTier

공용 IP sku 계층 지정

Name	형식	Description
Global	string
Regional	string

PublicIPAllocationMethod

공용 IP 할당 유형 지정

Name	형식	Description
Dynamic	string
Static	string

ResourceIdentityType

가상 머신에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.

Name	형식	Description
None	string
SystemAssigned	string
SystemAssigned, UserAssigned	string
UserAssigned	string

ScheduledEventsAdditionalPublishingTargets

scheduledEventsAdditionalPublishingTargets를 게시하는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
eventGridAndResourceGraph	EventGridAndResourceGraph	eventGridAndResourceGraph Scheduled Event 설정을 만드는 동안 사용되는 구성 매개 변수입니다.

ScheduledEventsPolicy

가상 머신에 대한 재배포, 다시 부팅 및 ScheduledEventsAdditionalPublishingTargets 예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
scheduledEventsAdditionalPublishingTargets	ScheduledEventsAdditionalPublishingTargets	scheduledEventsAdditionalPublishingTargets를 게시하는 동안 사용되는 구성 매개 변수입니다.
userInitiatedReboot	UserInitiatedReboot	userInitiatedReboot 예약된 이벤트 설정을 만드는 동안 사용되는 구성 매개 변수입니다.
userInitiatedRedeploy	UserInitiatedRedeploy	userInitiatedRedeploy 예약된 이벤트 설정 만들기를 만드는 동안 사용되는 구성 매개 변수입니다.

ScheduledEventsProfile

예약된 이벤트 관련 구성을 지정합니다.

Name	형식	Description
osImageNotificationProfile	OSImageNotificationProfile	OS 이미지 예약 이벤트 관련 구성을 지정합니다.
terminateNotificationProfile	TerminateNotificationProfile	예약된 이벤트 관련 구성 종료를 지정합니다.

securityEncryptionTypes

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

Name	형식	Description
DiskWithVMGuestState	string
NonPersistedTPM	string
VMGuestStateOnly	string

SecurityProfile

가상 머신에 대한 보안 관련 프로필 설정을 지정합니다.

Name	형식	Description
encryptionAtHost	boolean	이 속성은 요청에서 사용자가 가상 머신 또는 가상 머신 확장 집합에 대한 호스트 암호화를 사용하거나 사용하지 않도록 설정하는 데 사용할 수 있습니다. 이렇게 하면 호스트 자체의 리소스/임시 디스크를 비롯한 모든 디스크에 대한 암호화가 활성화됩니다. 기본 동작은 : 이 속성이 리소스에 대해 true로 설정되지 않으면 호스트의 암호화가 비활성화됩니다.
encryptionIdentity	EncryptionIdentity	ADE에서 keyvault 작업에 대한 액세스 토큰을 가져오는 데 사용하는 관리 ID를 지정합니다.
proxyAgentSettings	ProxyAgentSettings	가상 머신을 만드는 동안 ProxyAgent 설정을 지정합니다. 최소 api-version: 2024-03-01.
securityType	SecurityTypes	가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작은 다음과 같습니다. 이 속성을 설정하지 않으면 UefiSettings를 사용할 수 없습니다.
uefiSettings	UefiSettings	가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 최소 api-version: 2020-12-01.

SecurityTypes

가상 머신의 SecurityType을 지정합니다. UefiSettings를 사용하도록 설정하려면 지정된 값으로 설정해야 합니다. 기본 동작은 다음과 같습니다. 이 속성이 설정되지 않으면 UefiSettings가 사용하도록 설정되지 않습니다.

Name	형식	Description
ConfidentialVM	string
TrustedLaunch	string

SettingNames

콘텐츠가 적용되는 설정의 이름을 지정합니다. 가능한 값은 FirstLogonCommands 및 AutoLogon입니다.

Name	형식	Description
AutoLogon	string
FirstLogonCommands	string

SshConfiguration

Linux OS용 ssh 키 구성을 지정합니다.

Name	형식	Description
publicKeys	SshPublicKey[]	Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다.

SshPublicKey

Linux 기반 VM으로 인증하는 데 사용되는 SSH 공개 키 목록입니다.

Name	형식	Description
keyData	string	ssh를 통해 VM으로 인증하는 데 사용되는 SSH 공개 키 인증서입니다. 키는 2048비트 이상이어야 하며 ssh-rsa 형식이어야 합니다. ssh 키를 만들려면 [Azure에서 Linux 및 Linux VM용 Mac에서 SSH 키 만들기]를 참조하세요.https://docs.microsoft.com/azure/virtual-machines/linux/create-ssh-keys-detailed).
path	string	ssh 공개 키가 저장되는 생성된 VM의 전체 경로를 지정합니다. 파일이 이미 있으면 지정한 키는 파일에 추가됩니다. 예: /home/user/.ssh/authorized_keys

StatusLevelTypes

수준 코드입니다.

Name	형식	Description
Error	string
Info	string
Warning	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

비밀을 포함하는 Key Vault 상대 URL입니다.

Name	형식	Description
id	string	리소스 ID

TerminateNotificationProfile

Terminate Scheduled Event 관련 구성을 지정합니다.

Name	형식	Description
enable	boolean	Terminate Scheduled 이벤트를 사용할지 여부를 지정합니다.
notBeforeTimeout	string	가상 머신이 삭제되는 구성 가능한 기간은 이벤트가 자동 승인(시간 초과)되기 전에 잠재적으로 Terminate Scheduled Event를 승인해야 합니다. 구성은 ISO 8601 형식으로 지정해야 하며 기본값은 5분(PT5M)입니다.

UefiSettings

가상 머신을 만드는 동안 사용되는 보안 부팅 및 vTPM과 같은 보안 설정을 지정합니다. 최소 api-version: 2020-12-01.

Name	형식	Description
secureBootEnabled	boolean	가상 머신에서 보안 부팅을 사용하도록 설정할지 여부를 지정합니다. 최소 api-version: 2020-12-01.
vTpmEnabled	boolean	가상 머신에서 vTPM을 사용하도록 설정할지 여부를 지정합니다. 최소 api-version: 2020-12-01.

UserAssignedIdentities

Virtual Machine과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

Name	형식	Description

UserInitiatedReboot

userInitiatedReboot 예약된 이벤트 설정을 만드는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
automaticallyApprove	boolean	다시 부팅 예약된 이벤트 관련 구성을 지정합니다.

UserInitiatedRedeploy

userInitiatedRedeploy 예약된 이벤트 설정 만들기를 만드는 동안 사용되는 구성 매개 변수입니다.

Name	형식	Description
automaticallyApprove	boolean	예약된 이벤트 관련 구성 다시 배포를 지정합니다.

VaultCertificate

인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다.

Name	형식	Description
certificateStore	string	Windows VM의 경우 인증서를 추가해야 하는 Virtual Machine의 인증서 저장소를 지정합니다. 지정된 인증서 저장소는 LocalMachine 계정에 암시적으로 있습니다. Linux VM의 경우 인증서 파일은 /var/lib/waagent 디렉터리 아래에 배치되며, 파일 이름은 <X509 인증서 파일의 경우 UppercaseThumbprint.crt>이고 <프라이빗 키의 경우 UppercaseThumbprint.prv>입니다. 이 두 파일은 모두 .pem 형식입니다.
certificateUrl	string	비밀로 Key Vault 업로드된 인증서의 URL입니다. Key Vault 비밀을 추가하려면 키 자격 증명 모음에 키 또는 비밀 추가를 참조하세요. 이 경우 인증서는 UTF-8로 인코딩된 다음 JSON 개체의 Base64 인코딩이어야 합니다. { "data":"", "dataType":"pfx", "password":"" } 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.

VaultSecretGroup

가상 컴퓨터에 설치되어 있어야 하는 인증서 집합을 지정합니다. 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.

Name	형식	Description
sourceVault	SubResource	VaultCertificates에 있는 모든 인증서를 포함하는 Key Vault 상대 URL입니다.
vaultCertificates	VaultCertificate[]	인증서를 포함하는 SourceVault의 키 자격 증명 모음 참조 목록입니다.

VirtualHardDisk

가상 하드 디스크입니다.

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

VirtualMachine

Virtual Machine에 대해 설명합니다.

Name	형식	Description
etag	string	Etag는 고객이 낙관적 업데이트를 보장하기 위해 헤더에 제공할 수 있도록 VM의 만들기/업데이트/가져오기 응답에 반환되는 속성입니다.
extendedLocation	ExtendedLocation	Virtual Machine의 확장된 위치입니다.
id	string	리소스 ID
identity	VirtualMachineIdentity	구성된 경우 가상 머신의 ID입니다.
location	string	리소스 위치
managedBy	string	VM이 VMSS의 일부인 경우 ManagedBy는 VMSS(Virtual Machine Scale Set) flex ARM resourceID로 설정됩니다. 이 속성은 내부 리소스 그룹 삭제 최적화를 위해 플랫폼에서 사용됩니다.
name	string	리소스 이름
plan	Plan	가상 머신을 만드는 데 사용되는 마켓플레이스 이미지에 대한 정보를 지정합니다. 이 요소는 마켓플레이스 이미지에만 사용됩니다. API에서 마켓플레이스 이미지를 사용하려면 먼저 프로그래밍 방식으로 사용할 이미지를 사용하도록 설정해야 합니다. Azure Portal 사용하려는 마켓플레이스 이미지를 찾은 다음 프로그래밍 방식으로 배포하려는 시작 ->을 클릭합니다. 필요한 정보를 입력한 다음 저장을 클릭합니다.
properties.additionalCapabilities	AdditionalCapabilities	가상 머신에서 사용하거나 사용하지 않도록 설정된 추가 기능을 지정합니다.
properties.applicationProfile	ApplicationProfile	VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.
properties.availabilitySet	SubResource	가상 머신을 할당해야 하는 가용성 집합에 대한 정보를 지정합니다. 동일한 가용성 집합에 지정된 가상 컴퓨터는 가용성을 최대화하기 위해 서로 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가용성 집합 개요를 참조하세요. Azure 계획된 유지 관리에 대한 자세한 내용은 Azure의 Virtual Machines 대한 유지 관리 및 업데이트를 참조하세요. 현재 VM은 생성 시 가용성 집합에만 추가할 수 있습니다. VM이 추가되는 가용성 집합은 가용성 집합 리소스와 동일한 리소스 그룹 아래에 있어야 합니다. 기존 VM은 가용성 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.virtualMachineScaleSet 참조와 함께 존재할 수 없습니다.
properties.billingProfile	BillingProfile	Azure Spot 가상 머신의 청구 관련 세부 정보를 지정합니다. 최소 api-version: 2019-03-01.
properties.capacityReservation	CapacityReservationProfile	가상 머신을 할당하는 데 사용되는 용량 예약에 대한 정보를 지정합니다. 최소 api-version: 2021-04-01.
properties.diagnosticsProfile	DiagnosticsProfile	부팅 진단 설정 상태를 지정합니다. 최소 api-version: 2015-06-15.
properties.evictionPolicy	VirtualMachineEvictionPolicyTypes	Azure Spot 가상 머신 및 Azure 스폿 확장 집합에 대한 제거 정책을 지정합니다. Azure 스폿 가상 머신의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2019-03-01입니다. Azure 스폿 확장 집합의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2017-10-30-preview입니다.
properties.extensionsTimeBudget	string	모든 확장이 시작될 시간을 지정합니다. 기간은 15분에서 120분(포함) 사이여야 하며 ISO 8601 형식으로 지정해야 합니다. 기본값은 90분(PT1H30M)입니다. 최소 api-version: 2020-06-01.
properties.hardwareProfile	HardwareProfile	가상 머신에 대한 하드웨어 설정을 지정합니다.
properties.host	SubResource	가상 머신이 있는 전용 호스트에 대한 정보를 지정합니다. 최소 api-version: 2018-10-01.
properties.hostGroup	SubResource	가상 머신이 있는 전용 호스트 그룹에 대한 정보를 지정합니다. 참고: 사용자는 host 및 hostGroup 속성을 모두 지정할 수 없습니다. 최소 api-version: 2020-06-01.
properties.instanceView	VirtualMachineInstanceView	가상 머신 instance 보기입니다.
properties.licenseType	string	사용 중인 이미지 또는 디스크에 온-프레미스 라이선스가 부여되도록 지정합니다. Windows Server 운영 체제에 사용할 수 있는 값은 다음과 같습니다. Windows_Client Windows_Server Linux Server 운영 체제에 사용할 수 있는 값은 다음과 같습니다. RHEL_BYOS(RHEL의 경우) SLES_BYOS(SUSE의 경우) 자세한 내용은 Windows Server용 Azure 하이브리드 사용 혜택을 참조하세요. Linux Server에 대한 Azure 하이브리드 사용 혜택 최소 api-version: 2015-06-15
properties.networkProfile	NetworkProfile	가상 머신의 네트워크 인터페이스를 지정합니다.
properties.osProfile	OSProfile	가상 머신을 만드는 동안 사용되는 운영 체제 설정을 지정합니다. VM이 프로비전되면 일부 설정을 변경할 수 없습니다.
properties.platformFaultDomain	integer	Virtual Machine을 만들 확장 집합 논리 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다. 이 값은 이 Virtual Machine의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다. 참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount'가 1보다 커야 합니다. 가상 머신을 만든 후에는 이 속성을 업데이트할 수 없습니다. 장애 도메인 할당은 Virtual Machine 인스턴스 보기에서 볼 수 있습니다. 최소 api-version: 2020_12-01.
properties.priority	VirtualMachinePriorityTypes	가상 머신의 우선 순위를 지정합니다. 최소 api-version: 2019-03-01
properties.provisioningState	string	응답에만 표시되는 프로비전 상태입니다.
properties.proximityPlacementGroup	SubResource	가상 머신을 할당해야 하는 근접 배치 그룹에 대한 정보를 지정합니다. 최소 api-version: 2018-04-01.
properties.scheduledEventsPolicy	ScheduledEventsPolicy	가상 머신에 대한 재배포, 다시 부팅 및 ScheduledEventsAdditionalPublishingTargets 예약된 이벤트 관련 구성을 지정합니다.
properties.scheduledEventsProfile	ScheduledEventsProfile	예약된 이벤트 관련 구성을 지정합니다.
properties.securityProfile	SecurityProfile	가상 머신에 대한 보안 관련 프로필 설정을 지정합니다.
properties.storageProfile	StorageProfile	가상 머신 디스크에 대한 스토리지 설정을 지정합니다.
properties.timeCreated	string	Virtual Machine 리소스를 만든 시간을 지정합니다. 최소 api-version: 2021-11-01.
properties.userData	string	Base-64로 인코딩되어야 하는 VM의 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다. 최소 api-version: 2021-03-01.
properties.virtualMachineScaleSet	SubResource	가상 머신을 할당해야 하는 가상 머신 확장 집합에 대한 정보를 지정합니다. 동일한 가상 머신 확장 집합에 지정된 가상 머신은 가용성을 최대화하기 위해 다른 노드에 할당됩니다. 현재 VM은 생성 시 가상 머신 확장 집합에만 추가할 수 있습니다. 기존 VM은 가상 머신 확장 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.availabilitySet 참조와 함께 존재할 수 없습니다. 최소 api-version: 2019_03-01.
properties.vmId	string	모든 Azure IaaS VM SMBIOS에 인코딩 및 저장되며 플랫폼 BIOS 명령을 사용하여 읽을 수 있는 128비트 식별자인 VM 고유 ID를 지정합니다.
resources	VirtualMachineExtension[]	가상 머신 자식 확장 리소스입니다.
tags	object	리소스 태그
type	string	리소스 유형
zones	string[]	가상 머신 영역입니다.

VirtualMachineAgentInstanceView

가상 머신에서 실행되는 VM 에이전트입니다.

Name	형식	Description
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	가상 머신 확장 처리기는 보기를 instance.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.
vmAgentVersion	string	VM 에이전트 전체 버전입니다.

VirtualMachineEvictionPolicyTypes

Azure Spot 가상 머신 및 Azure 스폿 확장 집합에 대한 제거 정책을 지정합니다. Azure 스폿 가상 머신의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2019-03-01입니다. Azure 스폿 확장 집합의 경우 '할당 취소' 및 '삭제'가 모두 지원되며 최소 api-version은 2017-10-30-preview입니다.

Name	형식	Description
Deallocate	string
Delete	string

VirtualMachineExtension

가상 머신 자식 확장 리소스입니다.

Name	형식	Description
id	string	리소스 ID
location	string	리소스 위치
name	string	리소스 이름
properties.autoUpgradeMinorVersion	boolean	배포 시 사용할 수 있는 경우 확장에서 최신 부 버전을 사용해야 하는지 여부를 나타냅니다. 그러나 일단 배포되면 이 속성이 true로 설정된 경우에도 확장이 재배포되지 않는 한 부 버전을 업그레이드하지 않습니다.
properties.enableAutomaticUpgrade	boolean	사용 가능한 최신 버전의 확장이 있는 경우 플랫폼에서 확장을 자동으로 업그레이드해야 하는지 여부를 나타냅니다.
properties.forceUpdateTag	string	확장 구성이 변경되지 않은 경우에도 확장 처리기를 강제로 업데이트해야 하는 방법입니다.
properties.instanceView	VirtualMachineExtensionInstanceView	가상 머신 확장 instance 보기입니다.
properties.protectedSettings	object	확장에는 protectedSettings 또는 protectedSettingsFromKeyVault 또는 보호된 설정이 전혀 포함될 수 없습니다.
properties.protectedSettingsFromKeyVault	KeyVaultSecretReference	키 자격 증명 모음에서 참조로 전달되고 사용되는 확장 보호 설정
properties.provisionAfterExtensions	string[]	이 확장을 프로비전해야 하는 확장 이름 컬렉션입니다.
properties.provisioningState	string	응답에만 표시되는 프로비전 상태입니다.
properties.publisher	string	확장 처리기 게시자의 이름입니다.
properties.settings	object	확장에 대한 Json 형식의 공용 설정입니다.
properties.suppressFailures	boolean	확장에서 비롯되는 오류가 표시되지 않는지 여부를 나타냅니다(VM에 연결하지 않는 등의 운영 오류는 이 값에 관계없이 표시되지 않음). 기본값은 false입니다.
properties.type	string	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.
properties.typeHandlerVersion	string	스크립트 처리기의 버전을 지정합니다.
tags	object	리소스 태그
type	string	리소스 유형

VirtualMachineExtensionHandlerInstanceView

가상 머신 확장 처리기는 보기를 instance.

Name	형식	Description
status	InstanceViewStatus	확장 처리기가 상태.
type	string	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.
typeHandlerVersion	string	스크립트 처리기의 버전을 지정합니다.

VirtualMachineExtensionInstanceView

가상 머신 확장 instance 보기입니다.

Name	형식	Description
name	string	가상 머신 확장 이름입니다.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.
substatuses	InstanceViewStatus[]	리소스 상태 정보입니다.
type	string	확장의 형식을 지정합니다. 예를 들어 "CustomScriptExtension"이 있습니다.
typeHandlerVersion	string	스크립트 처리기의 버전을 지정합니다.

VirtualMachineHealthStatus

VM에 대한 상태 상태.

Name	형식	Description
status	InstanceViewStatus	VM에 대한 상태 상태 정보입니다.

VirtualMachineIdentity

구성된 경우 가상 머신의 ID입니다.

Name	형식	Description
principalId	string	가상 머신 ID의 보안 주체 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
tenantId	string	가상 머신과 연결된 테넌트 ID입니다. 이 속성은 시스템 할당 ID에 대해서만 제공됩니다.
type	ResourceIdentityType	가상 머신에 사용되는 ID 유형입니다. ‘SystemAssigned, UserAssigned’ 유형에는 암시적으로 만들어진 ID와 사용자 할당 ID 세트가 모두 포함되어 있습니다. 'None' 형식은 가상 머신에서 모든 ID를 제거합니다.
userAssignedIdentities	UserAssignedIdentities	Virtual Machine과 연결된 사용자 ID 목록입니다. 사용자 ID 사전 키 참조는 '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}' 형식의 ARM 리소스 ID입니다.

VirtualMachineInstanceView

가상 머신 instance 보기입니다.

Name	형식	Description
assignedHost	string	가상 머신이 자동 배치를 사용하도록 설정된 전용 호스트 그룹과 연결된 경우 가상 머신이 자동 배치를 통해 할당되는 전용 호스트의 리소스 ID입니다. 최소 api-version: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	부팅 진단은 콘솔 출력 및 스크린샷을 보고 VM 상태 진단할 수 있는 디버깅 기능입니다. 콘솔 로그의 출력을 쉽게 볼 수 있습니다. 또한 Azure를 사용하면 하이퍼바이저에서 VM의 스크린샷을 볼 수 있습니다.
computerName	string	가상 머신에 할당된 컴퓨터 이름입니다.
disks	DiskInstanceView[]	가상 머신 디스크 정보입니다.
extensions	VirtualMachineExtensionInstanceView[]	확장 정보입니다.
hyperVGeneration	HyperVGenerationType	리소스와 연결된 HyperVGeneration 형식을 지정합니다.
isVMInStandbyPool	boolean	[미리 보기 기능] VM이 현재 대기 풀에 있는지 여부를 지정합니다.
maintenanceRedeployStatus	MaintenanceRedeployStatus	유지 관리 작업은 가상 머신에서 상태.
osName	string	가상 머신에서 실행되는 운영 체제입니다.
osVersion	string	가상 머신에서 실행되는 운영 체제의 버전입니다.
patchStatus	VirtualMachinePatchStatus	[미리 보기 기능] 가상 머신 패치 작업의 상태.
platformFaultDomain	integer	가상 컴퓨터의 장애 도메인을 지정합니다.
platformUpdateDomain	integer	가상 컴퓨터의 업데이트 도메인을 지정합니다.
rdpThumbPrint	string	원격 데스크톱 인증서 지문입니다.
statuses	InstanceViewStatus[]	리소스 상태 정보입니다.
vmAgent	VirtualMachineAgentInstanceView	가상 머신에서 실행되는 VM 에이전트입니다.
vmHealth	VirtualMachineHealthStatus	VM에 대한 상태 상태.

VirtualMachineIpTag

공용 IP 주소와 연결된 IP 태그 목록입니다.

Name	형식	Description
ipTagType	string	IP 태그 유형입니다. 예: FirstPartyUsage.
tag	string	공용 IP와 연결된 IP 태그입니다. 예: SQL, 스토리지 등

VirtualMachineNetworkInterfaceConfiguration

가상 머신 네트워킹 리소스를 만드는 데 사용할 네트워킹 구성을 지정합니다.

Name	형식	Description
name	string	네트워크 인터페이스 구성 이름입니다.
properties.auxiliaryMode	NetworkInterfaceAuxiliaryMode	네트워크 인터페이스 리소스에 대해 보조 모드를 사용할 수 있는지 여부를 지정합니다.
properties.auxiliarySku	NetworkInterfaceAuxiliarySku	네트워크 인터페이스 리소스에 대해 보조 sku를 사용할 수 있는지 여부를 지정합니다.
properties.deleteOption	DeleteOptions	VM이 삭제되면 네트워크 인터페이스에 발생하는 작업 지정
properties.disableTcpStateTracking	boolean	tcp 상태 추적을 위해 네트워크 인터페이스를 사용하지 않도록 설정할지 여부를 지정합니다.
properties.dnsSettings	VirtualMachineNetworkInterfaceDnsSettingsConfiguration	네트워크 인터페이스에 적용할 dns 설정입니다.
properties.dscpConfiguration	SubResource
properties.enableAcceleratedNetworking	boolean	네트워크 인터페이스가 가속화된 네트워킹을 사용할 수 있는지 여부를 지정합니다.
properties.enableFpga	boolean	네트워크 인터페이스가 FPGA 네트워킹을 사용할 수 있는지 여부를 지정합니다.
properties.enableIPForwarding	boolean	이 NIC에서 IP 전달을 사용하도록 설정했는지 여부입니다.
properties.ipConfigurations	VirtualMachineNetworkInterfaceIPConfiguration[]	네트워크 인터페이스의 IP 구성을 지정합니다.
properties.networkSecurityGroup	SubResource	네트워크 보안 그룹입니다.
properties.primary	boolean	가상 머신에 1개 이상의 네트워크 인터페이스가 있는 경우 기본 네트워크 인터페이스를 지정합니다.

VirtualMachineNetworkInterfaceDnsSettingsConfiguration

네트워크 인터페이스에 적용할 dns 설정입니다.

Name	형식	Description
dnsServers	string[]	DNS 서버 IP 주소 목록

VirtualMachineNetworkInterfaceIPConfiguration

네트워크 인터페이스의 IP 구성을 지정합니다.

Name	형식	Description
name	string	IP 구성 이름입니다.
properties.applicationGatewayBackendAddressPools	SubResource[]	애플리케이션 게이트웨이의 백 엔드 주소 풀에 대한 참조 배열을 지정합니다. 가상 머신은 여러 애플리케이션 게이트웨이의 백 엔드 주소 풀을 참조할 수 있습니다. 여러 가상 머신은 동일한 애플리케이션 게이트웨이를 사용할 수 없습니다.
properties.applicationSecurityGroups	SubResource[]	애플리케이션 보안 그룹에 대한 참조 배열을 지정합니다.
properties.loadBalancerBackendAddressPools	SubResource[]	부하 분산 장치의 백 엔드 주소 풀에 대한 참조 배열을 지정합니다. 가상 머신은 하나의 공용 및 하나의 내부 부하 분산 장치의 백 엔드 주소 풀을 참조할 수 있습니다. [여러 가상 머신은 동일한 기본 sku 부하 분산 장치를 사용할 수 없습니다.].
properties.primary	boolean	가상 머신에 네트워크 인터페이스가 1개 이상 있는 경우 기본 네트워크 인터페이스를 지정합니다.
properties.privateIPAddressVersion	IPVersions	Api-Version 2017-03-30부터 사용할 수 있으며 특정 ipconfiguration이 IPv4 또는 IPv6인지 여부를 나타냅니다. 기본값은 IPv4로 사용됩니다. 가능한 값은 'IPv4' 및 'IPv6'입니다.
properties.publicIPAddressConfiguration	VirtualMachinePublicIPAddressConfiguration	publicIPAddressConfiguration입니다.
properties.subnet	SubResource	서브넷의 식별자를 지정합니다.

VirtualMachinePatchStatus

[미리 보기 기능] 가상 머신 패치 작업의 상태.

Name	형식	Description
availablePatchSummary	AvailablePatchSummary	가상 머신에 대한 최신 평가 작업의 사용 가능한 패치 요약입니다.
configurationStatuses	InstanceViewStatus[]	지정된 patchMode의 사용 상태
lastPatchInstallationSummary	LastPatchInstallationSummary	가상 머신에 대한 최신 설치 작업의 설치 요약입니다.

VirtualMachinePriorityTypes

가상 머신의 우선 순위를 지정합니다. 최소 api-version: 2019-03-01

Name	형식	Description
Low	string
Regular	string
Spot	string

VirtualMachinePublicIPAddressConfiguration

publicIPAddressConfiguration입니다.

Name	형식	Description
name	string	publicIP 주소 구성 이름입니다.
properties.deleteOption	DeleteOptions	VM이 삭제되면 공용 IP 주소에 어떤 일이 발생하는지 지정합니다.
properties.dnsSettings	VirtualMachinePublicIPAddressDnsSettingsConfiguration	publicIP 주소 에 적용할 dns 설정입니다.
properties.idleTimeoutInMinutes	integer	공용 IP 주소의 유휴 시간 제한입니다.
properties.ipTags	VirtualMachineIpTag[]	공용 IP 주소와 연결된 IP 태그 목록입니다.
properties.publicIPAddressVersion	IPVersions	Api-Version 2019-07-01부터 사용할 수 있으며 특정 ipconfiguration이 IPv4 또는 IPv6인지 여부를 나타냅니다. 기본값은 IPv4로 사용됩니다. 가능한 값은 'IPv4' 및 'IPv6'입니다.
properties.publicIPAllocationMethod	PublicIPAllocationMethod	공용 IP 할당 유형 지정
properties.publicIPPrefix	SubResource	publicIP 주소를 할당할 PublicIPPrefix입니다.
sku	PublicIPAddressSku	공용 IP SKU에 대해 설명합니다. OrchestrationMode를 유연한 것으로만 설정할 수 있습니다.

VirtualMachinePublicIPAddressDnsSettingsConfiguration

publicIP 주소 에 적용할 dns 설정입니다.

Name	형식	Description
domainNameLabel	string	만들 PublicIPAddress 리소스의 도메인 이름 레이블 접두사입니다. 생성된 이름 레이블은 도메인 이름 레이블 및 vm 네트워크 프로필 고유 ID의 연결입니다.
domainNameLabelScope	DomainNameLabelScopeTypes	도메인 이름 레이블은 만들 PublicIPAddress 리소스의 scope. 생성된 이름 레이블은 도메인 이름 레이블 scope 및 vm 네트워크 프로필 고유 ID에 따라 해시된 도메인 이름 레이블과 정책을 연결한 것입니다.

VirtualMachineSizeTypes

가상 컴퓨터의 크기를 지정합니다. 열거형 데이터 형식은 현재 사용되지 않으며 2023년 12월 23일까지 제거됩니다. 사용 가능한 크기 목록을 가져오는 권장 방법은 다음 API를 사용하는 것입니다. 가용성 집합에 사용 가능한 모든 가상 머신 크기 나열, 지역에서 사용 가능한 모든 가상 머신 크기 나열, 크기 조정을 위해 사용 가능한 모든 가상 머신 크기 나열. 가상 머신 크기에 대한 자세한 내용은 가상 머신의 크기를 참조하세요. 사용 가능한 VM 크기는 지역 및 가용성 집합에 따라 달라집니다.

Name	형식	Description
Basic_A0	string
Basic_A1	string
Basic_A2	string
Basic_A3	string
Basic_A4	string
Standard_A0	string
Standard_A1	string
Standard_A10	string
Standard_A11	string
Standard_A1_v2	string
Standard_A2	string
Standard_A2_v2	string
Standard_A2m_v2	string
Standard_A3	string
Standard_A4	string
Standard_A4_v2	string
Standard_A4m_v2	string
Standard_A5	string
Standard_A6	string
Standard_A7	string
Standard_A8	string
Standard_A8_v2	string
Standard_A8m_v2	string
Standard_A9	string
Standard_B1ms	string
Standard_B1s	string
Standard_B2ms	string
Standard_B2s	string
Standard_B4ms	string
Standard_B8ms	string
Standard_D1	string
Standard_D11	string
Standard_D11_v2	string
Standard_D12	string
Standard_D12_v2	string
Standard_D13	string
Standard_D13_v2	string
Standard_D14	string
Standard_D14_v2	string
Standard_D15_v2	string
Standard_D16_v3	string
Standard_D16s_v3	string
Standard_D1_v2	string
Standard_D2	string
Standard_D2_v2	string
Standard_D2_v3	string
Standard_D2s_v3	string
Standard_D3	string
Standard_D32_v3	string
Standard_D32s_v3	string
Standard_D3_v2	string
Standard_D4	string
Standard_D4_v2	string
Standard_D4_v3	string
Standard_D4s_v3	string
Standard_D5_v2	string
Standard_D64_v3	string
Standard_D64s_v3	string
Standard_D8_v3	string
Standard_D8s_v3	string
Standard_DS1	string
Standard_DS11	string
Standard_DS11_v2	string
Standard_DS12	string
Standard_DS12_v2	string
Standard_DS13	string
Standard_DS13-2_v2	string
Standard_DS13-4_v2	string
Standard_DS13_v2	string
Standard_DS14	string
Standard_DS14-4_v2	string
Standard_DS14-8_v2	string
Standard_DS14_v2	string
Standard_DS15_v2	string
Standard_DS1_v2	string
Standard_DS2	string
Standard_DS2_v2	string
Standard_DS3	string
Standard_DS3_v2	string
Standard_DS4	string
Standard_DS4_v2	string
Standard_DS5_v2	string
Standard_E16_v3	string
Standard_E16s_v3	string
Standard_E2_v3	string
Standard_E2s_v3	string
Standard_E32-16_v3	string
Standard_E32-8s_v3	string
Standard_E32_v3	string
Standard_E32s_v3	string
Standard_E4_v3	string
Standard_E4s_v3	string
Standard_E64-16s_v3	string
Standard_E64-32s_v3	string
Standard_E64_v3	string
Standard_E64s_v3	string
Standard_E8_v3	string
Standard_E8s_v3	string
Standard_F1	string
Standard_F16	string
Standard_F16s	string
Standard_F16s_v2	string
Standard_F1s	string
Standard_F2	string
Standard_F2s	string
Standard_F2s_v2	string
Standard_F32s_v2	string
Standard_F4	string
Standard_F4s	string
Standard_F4s_v2	string
Standard_F64s_v2	string
Standard_F72s_v2	string
Standard_F8	string
Standard_F8s	string
Standard_F8s_v2	string
Standard_G1	string
Standard_G2	string
Standard_G3	string
Standard_G4	string
Standard_G5	string
Standard_GS1	string
Standard_GS2	string
Standard_GS3	string
Standard_GS4	string
Standard_GS4-4	string
Standard_GS4-8	string
Standard_GS5	string
Standard_GS5-16	string
Standard_GS5-8	string
Standard_H16	string
Standard_H16m	string
Standard_H16mr	string
Standard_H16r	string
Standard_H8	string
Standard_H8m	string
Standard_L16s	string
Standard_L32s	string
Standard_L4s	string
Standard_L8s	string
Standard_M128-32ms	string
Standard_M128-64ms	string
Standard_M128ms	string
Standard_M128s	string
Standard_M64-16ms	string
Standard_M64-32ms	string
Standard_M64ms	string
Standard_M64s	string
Standard_NC12	string
Standard_NC12s_v2	string
Standard_NC12s_v3	string
Standard_NC24	string
Standard_NC24r	string
Standard_NC24rs_v2	string
Standard_NC24rs_v3	string
Standard_NC24s_v2	string
Standard_NC24s_v3	string
Standard_NC6	string
Standard_NC6s_v2	string
Standard_NC6s_v3	string
Standard_ND12s	string
Standard_ND24rs	string
Standard_ND24s	string
Standard_ND6s	string
Standard_NV12	string
Standard_NV24	string
Standard_NV6	string

VMDiskSecurityProfile

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

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

VMGalleryApplication

VM/VMSS에서 사용할 수 있도록 해야 하는 갤러리 애플리케이션을 지정합니다.

Name	형식	Description
configurationReference	string	선택 사항, 제공된 경우 패키지의 기본 구성을 대체할 Azure Blob에 대한 URI를 지정합니다.
enableAutomaticUpgrade	boolean	true로 설정된 경우 새 갤러리 애플리케이션 버전을 PIR/SIG에서 사용할 수 있는 경우 VM/VMSS에 대해 자동으로 업데이트됩니다.
order	integer	선택 사항, 패키지를 설치해야 하는 순서를 지정합니다.
packageReferenceId	string	/subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/applications/{application}/versions/{version} 형식으로 GalleryApplicationVersion 리소스 ID를 지정합니다.
tags	string	선택 사항으로, 더 많은 제네릭 컨텍스트에 대한 통과 값을 지정합니다.
treatFailureAsDeploymentFailure	boolean	선택 사항인 경우 true이면 VmApplication의 모든 작업에 대한 오류는 배포에 실패합니다.

VMSizeProperties

가상 머신의 크기를 사용자 지정하기 위한 속성을 지정합니다. 최소 api-version: 2021-07-01. 이 기능은 아직 미리 보기 모드이며 VirtualMachineScaleSet에서 지원되지 않습니다. 자세한 내용은 VM 사용자 지정 의 지침을 따르세요.

Name	형식	Description
vCPUsAvailable	integer	VM에 사용할 수 있는 vCPU 수를 지정합니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본 동작은 해당 지역의 사용 가능한 모든 가상 머신 크기 나열의 api 응답에 노출된 해당 VM 크기에 사용할 수 있는 vCPU 값으로 설정하는 것입니다.
vCPUsPerCore	integer	실제 코어 비율에 대한 vCPU를 지정합니다. 요청 본문에 이 속성을 지정하지 않은 경우 기본 동작은 지역에서 사용 가능한 모든 가상 머신 크기 나열의 api 응답에 노출된 VM 크기에 대한 vCPUsPerCore 값으로 설정됩니다. 또한 이 속성을 1로 설정하면 하이퍼 스레딩이 사용하지 않도록 설정됩니다.

WindowsConfiguration

가상 머신의 Windows 운영 체제 설정을 지정합니다.

Name	형식	Description
additionalUnattendContent	AdditionalUnattendContent[]	Windows 설치 프로그램에 사용되는 Unattend.xml 파일에 포함될 수 있는, base-64로 인코딩된 추가적인 XML 형식 정보를 지정합니다.
enableAutomaticUpdates	boolean	Windows 가상 머신에 대해 자동 업데이트 사용할 수 있는지 여부를 나타냅니다. 기본값은 true입니다. 가상 머신 확장 집합의 경우 이 속성을 업데이트할 수 있으며 업데이트는 OS 다시 프로비전에 적용됩니다.
enableVMAgentPlatformUpdates	boolean	Windows 가상 머신에 대해 VMAgent Platform 업데이트 사용하도록 설정되어 있는지 여부를 나타냅니다. 기본값은 false입니다.
patchSettings	PatchSettings	[미리 보기 기능] Windows의 VM 게스트 패치와 관련된 설정을 지정합니다.
provisionVMAgent	boolean	가상 컴퓨터에서 가상 컴퓨터 에이전트를 프로비전해야 하는지 여부를 나타냅니다. 이 속성이 요청 본문에 지정되지 않은 경우 기본적으로 true로 설정됩니다. 이렇게 하면 나중에 VM에 확장을 추가할 수 있도록 VM 에이전트가 VM에 설치됩니다.
timeZone	string	가상 머신의 표준 시간대를 지정합니다. 예: "태평양 표준시". 가능한 값은 TimeZoneInfo.GetSystemTimeZones에서 반환된 표준 시간대의 TimeZoneInfo.Id 값일 수 있습니다.
winRM	WinRMConfiguration	Windows 원격 관리 수신기를 지정합니다. 따라서 원격 Windows PowerShell을 사용할 수 있습니다.

WindowsPatchAssessmentMode

Name	형식	Description
AutomaticByPlatform	string
ImageDefault	string

WindowsVMGuestPatchAutomaticByPlatformRebootSetting

모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

Name	형식	Description
Always	string
IfRequired	string
Never	string
Unknown	string

WindowsVMGuestPatchAutomaticByPlatformSettings

Windows의 VM 게스트 패치에서 패치 모드 AutomaticByPlatform에 대한 추가 설정을 지정합니다.

Name	형식	Description
bypassPlatformSafetyChecksOnUserSchedule	boolean	고객이 실수로 업그레이드하지 않고 패치를 예약할 수 있습니다.
rebootSetting	WindowsVMGuestPatchAutomaticByPlatformRebootSetting	모든 AutomaticByPlatform 패치 설치 작업에 대한 다시 부팅 설정을 지정합니다.

WindowsVMGuestPatchMode

OrchestrationMode를 유연한 것으로 사용하여 가상 머신 확장 집합에 연결된 IaaS 가상 머신 또는 가상 머신에 대한 VM 게스트 패치 모드를 지정합니다.

가능한 값은 다음과 같습니다.

수동 - 가상 머신에 패치 적용을 제어합니다. VM 내에서 수동으로 패치를 적용하여 이 작업을 수행합니다. 이 모드에서는 자동 업데이트를 사용할 수 없습니다. 속성 WindowsConfiguration.enableAutomaticUpdates는 false여야 합니다.

AutomaticByOS - 가상 머신이 OS에 의해 자동으로 업데이트됩니다. WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

AutomaticByPlatform - 가상 머신이 플랫폼에서 자동으로 업데이트됩니다. provisionVMAgent 및 WindowsConfiguration.enableAutomaticUpdates 속성은 true여야 합니다.

Name	형식	Description
AutomaticByOS	string
AutomaticByPlatform	string
Manual	string

WinRMConfiguration

Windows 원격 관리 수신기를 지정합니다. 따라서 원격 Windows PowerShell을 사용할 수 있습니다.

Name	형식	Description
listeners	WinRMListener[]	Windows 원격 관리 수신기 목록

WinRMListener

Windows 원격 관리 수신기 목록

Name	형식	Description
certificateUrl	string	비밀로 Key Vault 업로드된 인증서의 URL입니다. Key Vault 비밀을 추가하려면 키 자격 증명 모음에 키 또는 비밀 추가를 참조하세요. 이 경우 인증서는 UTF-8로 인코딩된 다음 JSON 개체의 Base64 인코딩이어야 합니다. { "data":"", "dataType":"pfx", "password":"" } 가상 머신에 인증서를 설치하려면 Linux용 Azure Key Vault 가상 머신 확장 또는 Windows용 Azure Key Vault 가상 머신 확장을 사용하는 것이 좋습니다.
protocol	ProtocolTypes	WinRM 수신기의 프로토콜을 지정합니다. 가능한 값은 http,https입니다.

다음을 통해 공유

Virtual Machines - Get

URI 매개 변수

응답

보안

azure_auth

범위

예제

Get a virtual machine placed on a dedicated host group through automatic placement

샘플 요청

샘플 응답

Get a virtual machine with Disk Controller Type Properties

샘플 요청

샘플 응답

Get a virtual machine with VM Size Properties

샘플 요청

샘플 응답

Get a Virtual Machine.

샘플 요청

샘플 응답

정의

AdditionalCapabilities

AdditionalUnattendContent

ApiEntityReference

ApiError

ApiErrorBase

ApplicationProfile

AvailablePatchSummary

BillingProfile

BootDiagnostics

BootDiagnosticsInstanceView

CachingTypes

CapacityReservationProfile

CloudError

ComponentNames

DataDisk

DeleteOptions

DiagnosticsProfile

DiffDiskOptions

DiffDiskPlacement

DiffDiskSettings

DiskControllerTypes

DiskCreateOptionTypes

DiskDeleteOptionTypes

DiskDetachOptionTypes

DiskEncryptionSetParameters

DiskEncryptionSettings

DiskInstanceView

DomainNameLabelScopeTypes

EncryptionIdentity

EventGridAndResourceGraph

ExtendedLocation

ExtendedLocationTypes

HardwareProfile

HyperVGenerationType

ImageReference

InnerError

InstanceViewStatus

InstanceViewTypes

IPVersions

KeyVaultKeyReference

KeyVaultSecretReference

LastPatchInstallationSummary

LinuxConfiguration

LinuxPatchAssessmentMode

LinuxPatchSettings

LinuxVMGuestPatchAutomaticByPlatformRebootSetting

LinuxVMGuestPatchAutomaticByPlatformSettings

LinuxVMGuestPatchMode

MaintenanceOperationResultCodeTypes

MaintenanceRedeployStatus

ManagedDiskParameters

Mode

NetworkApiVersion

NetworkInterfaceAuxiliaryMode

NetworkInterfaceAuxiliarySku

NetworkInterfaceReference

NetworkProfile

OperatingSystemTypes

OSDisk