VirtualMachine interface

Virtual Machine에 대해 설명합니다.

Extends

속성

additionalCapabilities

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

applicationProfile

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

availabilitySet

가상 머신을 할당해야 하는 가용성 집합에 대한 정보를 지정합니다. 동일한 가용성 집합에 지정된 가상 컴퓨터는 가용성을 최대화하기 위해 서로 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가용성 집합 개요를 참조하세요. Azure 계획된 유지 관리에 대한 자세한 내용은 Azure의 Virtual Machines 대한 유지 관리 및 업데이트를 참조하세요. 현재 VM은 생성 시 가용성 집합에만 추가할 수 있습니다. VM이 추가되는 가용성 집합은 가용성 집합 리소스와 동일한 리소스 그룹 아래에 있어야 합니다. 기존 VM은 가용성 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.virtualMachineScaleSet 참조와 함께 존재할 수 없습니다.

billingProfile

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

capacityReservation

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

diagnosticsProfile

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

etag

Etag는 고객이 낙관적 업데이트를 보장하기 위해 헤더에 제공할 수 있도록 VM의 Create/업데이트/가져오기 응답에 반환되는 속성입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

evictionPolicy

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

extendedLocation

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

extensionsTimeBudget

모든 확장이 시작될 시간을 지정합니다. 기간은 15분에서 120분(포함) 사이여야 하며 ISO 8601 형식으로 지정해야 합니다. 기본값은 90분(PT1H30M)입니다. 최소 api-version: 2020-06-01.

hardwareProfile

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

host

가상 머신이 있는 전용 호스트에 대한 정보를 지정합니다. 최소 api-version: 2018-10-01.

hostGroup

가상 머신이 있는 전용 호스트 그룹에 대한 정보를 지정합니다. 참고: 사용자는 host 및 hostGroup 속성을 모두 지정할 수 없습니다. 최소 api-version: 2020-06-01.

identity

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

instanceView

가상 머신 instance 보기입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

licenseType

사용 중인 이미지 또는 디스크에 온-프레미스 라이선스가 부여되도록 지정합니다.

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

managedBy

VM이 VMSS의 일부인 경우 ManagedBy는 VMSS(Virtual Machine Scale Set) flex ARM resourceID로 설정됩니다. 이 속성은 내부 리소스 그룹 삭제 최적화를 위해 플랫폼에서 사용됩니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

networkProfile

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

osProfile

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

plan

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

platformFaultDomain

Virtual Machine을 만들 확장 집합 논리 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다. 이 값은 이 Virtual Machine의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다. 참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount'가 1보다 커야 합니다. 가상 머신을 만든 후에는 이 속성을 업데이트할 수 없습니다. 장애 도메인 할당은 Virtual Machine 인스턴스 보기에서 볼 수 있습니다. 최소 api-version: 2020_12-01.

priority

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

provisioningState

응답에만 표시되는 프로비전 상태입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

proximityPlacementGroup

가상 머신을 할당해야 하는 근접 배치 그룹에 대한 정보를 지정합니다. 최소 api-version: 2018-04-01.

resources

가상 머신 자식 확장 리소스입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

scheduledEventsPolicy

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

scheduledEventsProfile

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

securityProfile

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

storageProfile

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

timeCreated

Virtual Machine 리소스를 만든 시간을 지정합니다. 최소 api-version: 2021-11-01. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

userData

Base-64로 인코딩되어야 하는 VM의 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다. 최소 api-version: 2021-03-01.

virtualMachineScaleSet

가상 머신을 할당해야 하는 가상 머신 확장 집합에 대한 정보를 지정합니다. 동일한 가상 머신 확장 집합에 지정된 가상 머신은 가용성을 최대화하기 위해 다른 노드에 할당됩니다. 현재 VM은 생성 시 가상 머신 확장 집합에만 추가할 수 있습니다. 기존 VM은 가상 머신 확장 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.availabilitySet 참조와 함께 존재할 수 없습니다. 최소 api-version: 2019_03-01.

vmId

모든 Azure IaaS VM SMBIOS에 인코딩 및 저장되며 플랫폼 BIOS 명령을 사용하여 읽을 수 있는 128비트 식별자인 VM 고유 ID를 지정합니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

zones

가상 머신 영역입니다.

상속된 속성

id

리소스 ID 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

location

리소스 위치

name

리소스 이름 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

tags

리소스 태그

type

리소스 종류 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

속성 세부 정보

additionalCapabilities

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

additionalCapabilities?: AdditionalCapabilities

속성 값

applicationProfile

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

applicationProfile?: ApplicationProfile

속성 값

availabilitySet

가상 머신을 할당해야 하는 가용성 집합에 대한 정보를 지정합니다. 동일한 가용성 집합에 지정된 가상 컴퓨터는 가용성을 최대화하기 위해 서로 다른 노드에 할당됩니다. 가용성 집합에 대한 자세한 내용은 가용성 집합 개요를 참조하세요. Azure 계획된 유지 관리에 대한 자세한 내용은 Azure의 Virtual Machines 대한 유지 관리 및 업데이트를 참조하세요. 현재 VM은 생성 시 가용성 집합에만 추가할 수 있습니다. VM이 추가되는 가용성 집합은 가용성 집합 리소스와 동일한 리소스 그룹 아래에 있어야 합니다. 기존 VM은 가용성 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.virtualMachineScaleSet 참조와 함께 존재할 수 없습니다.

availabilitySet?: SubResource

속성 값

billingProfile

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

billingProfile?: BillingProfile

속성 값

capacityReservation

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

capacityReservation?: CapacityReservationProfile

속성 값

diagnosticsProfile

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

diagnosticsProfile?: DiagnosticsProfile

속성 값

etag

Etag는 고객이 낙관적 업데이트를 보장하기 위해 헤더에 제공할 수 있도록 VM의 Create/업데이트/가져오기 응답에 반환되는 속성입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

etag?: string

속성 값

string

evictionPolicy

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

evictionPolicy?: string

속성 값

string

extendedLocation

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

extendedLocation?: ExtendedLocation

속성 값

extensionsTimeBudget

모든 확장이 시작될 시간을 지정합니다. 기간은 15분에서 120분(포함) 사이여야 하며 ISO 8601 형식으로 지정해야 합니다. 기본값은 90분(PT1H30M)입니다. 최소 api-version: 2020-06-01.

extensionsTimeBudget?: string

속성 값

string

hardwareProfile

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

hardwareProfile?: HardwareProfile

속성 값

host

가상 머신이 있는 전용 호스트에 대한 정보를 지정합니다. 최소 api-version: 2018-10-01.

host?: SubResource

속성 값

hostGroup

가상 머신이 있는 전용 호스트 그룹에 대한 정보를 지정합니다. 참고: 사용자는 host 및 hostGroup 속성을 모두 지정할 수 없습니다. 최소 api-version: 2020-06-01.

hostGroup?: SubResource

속성 값

identity

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

identity?: VirtualMachineIdentity

속성 값

instanceView

가상 머신 instance 보기입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

instanceView?: VirtualMachineInstanceView

속성 값

licenseType

사용 중인 이미지 또는 디스크에 온-프레미스 라이선스가 부여되도록 지정합니다.

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

licenseType?: string

속성 값

string

managedBy

VM이 VMSS의 일부인 경우 ManagedBy는 VMSS(Virtual Machine Scale Set) flex ARM resourceID로 설정됩니다. 이 속성은 내부 리소스 그룹 삭제 최적화를 위해 플랫폼에서 사용됩니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

managedBy?: string

속성 값

string

networkProfile

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

networkProfile?: NetworkProfile

속성 값

osProfile

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

osProfile?: OSProfile

속성 값

plan

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

plan?: Plan

속성 값

platformFaultDomain

Virtual Machine을 만들 확장 집합 논리 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다. 이 값은 이 Virtual Machine의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다. 참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount'가 1보다 커야 합니다. 가상 머신을 만든 후에는 이 속성을 업데이트할 수 없습니다. 장애 도메인 할당은 Virtual Machine 인스턴스 보기에서 볼 수 있습니다. 최소 api-version: 2020_12-01.

platformFaultDomain?: number

속성 값

number

priority

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

priority?: string

속성 값

string

provisioningState

응답에만 표시되는 프로비전 상태입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

provisioningState?: string

속성 값

string

proximityPlacementGroup

가상 머신을 할당해야 하는 근접 배치 그룹에 대한 정보를 지정합니다. 최소 api-version: 2018-04-01.

proximityPlacementGroup?: SubResource

속성 값

resources

가상 머신 자식 확장 리소스입니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

resources?: VirtualMachineExtension[]

속성 값

scheduledEventsPolicy

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

scheduledEventsPolicy?: ScheduledEventsPolicy

속성 값

scheduledEventsProfile

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

scheduledEventsProfile?: ScheduledEventsProfile

속성 값

securityProfile

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

securityProfile?: SecurityProfile

속성 값

storageProfile

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

storageProfile?: StorageProfile

속성 값

timeCreated

Virtual Machine 리소스를 만든 시간을 지정합니다. 최소 api-version: 2021-11-01. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

timeCreated?: Date

속성 값

Date

userData

Base-64로 인코딩되어야 하는 VM의 UserData입니다. 고객은 여기에 비밀을 전달해서는 안됩니다. 최소 api-version: 2021-03-01.

userData?: string

속성 값

string

virtualMachineScaleSet

가상 머신을 할당해야 하는 가상 머신 확장 집합에 대한 정보를 지정합니다. 동일한 가상 머신 확장 집합에 지정된 가상 머신은 가용성을 최대화하기 위해 다른 노드에 할당됩니다. 현재 VM은 생성 시 가상 머신 확장 집합에만 추가할 수 있습니다. 기존 VM은 가상 머신 확장 집합에 추가할 수 없습니다. 이 속성은 null이 아닌 properties.availabilitySet 참조와 함께 존재할 수 없습니다. 최소 api-version: 2019_03-01.

virtualMachineScaleSet?: SubResource

속성 값

vmId

모든 Azure IaaS VM SMBIOS에 인코딩 및 저장되며 플랫폼 BIOS 명령을 사용하여 읽을 수 있는 128비트 식별자인 VM 고유 ID를 지정합니다. 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

vmId?: string

속성 값

string

zones

가상 머신 영역입니다.

zones?: string[]

속성 값

string[]

상속된 속성 세부 정보

id

리소스 ID 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

id?: string

속성 값

string

상속된Resource.id

location

리소스 위치

location: string

속성 값

string

Resource.location에서 상속됨

name

리소스 이름 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

name?: string

속성 값

string

상속된Resource.name

tags

리소스 태그

tags?: {[propertyName: string]: string}

속성 값

{[propertyName: string]: string}

Resource.tags에서 상속됨

type

리소스 종류 참고: 이 속성은 직렬화되지 않습니다. 서버에서만 채울 수 있습니다.

type?: string

속성 값

string

Resource.type에서 상속됨