다음을 통해 공유


VirtualMachine 클래스

Virtual Machine에 대해 설명합니다.

변수는 서버에서만 채워지고 요청을 보낼 때 무시됩니다.

Azure로 보내려면 모든 필수 매개 변수를 채워야 합니다.

상속
azure.mgmt.compute.v2021_04_01.models._models_py3.Resource
VirtualMachine

생성자

VirtualMachine(*, location: str, tags: Dict[str, str] | None = None, plan: _models.Plan | None = None, identity: _models.VirtualMachineIdentity | None = None, zones: List[str] | None = None, extended_location: _models.ExtendedLocation | None = None, hardware_profile: _models.HardwareProfile | None = None, storage_profile: _models.StorageProfile | None = None, additional_capabilities: _models.AdditionalCapabilities | None = None, os_profile: _models.OSProfile | None = None, network_profile: _models.NetworkProfile | None = None, security_profile: _models.SecurityProfile | None = None, diagnostics_profile: _models.DiagnosticsProfile | None = None, availability_set: _models.SubResource | None = None, virtual_machine_scale_set: _models.SubResource | None = None, proximity_placement_group: _models.SubResource | None = None, priority: str | _models.VirtualMachinePriorityTypes | None = None, eviction_policy: str | _models.VirtualMachineEvictionPolicyTypes | None = None, billing_profile: _models.BillingProfile | None = None, host: _models.SubResource | None = None, host_group: _models.SubResource | None = None, license_type: str | None = None, extensions_time_budget: str | None = None, platform_fault_domain: int | None = None, scheduled_events_profile: _models.ScheduledEventsProfile | None = None, user_data: str | None = None, capacity_reservation: _models.CapacityReservationProfile | None = None, **kwargs: Any)

Keyword-Only Parameters

location
str

리소스 위치. 필수 요소.

tags
dict[str, str]

리소스 태그.

plan
Plan

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

identity
VirtualMachineIdentity

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

zones
list[str]

가상 머신 영역입니다.

extended_location
ExtendedLocation

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

hardware_profile
HardwareProfile

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

storage_profile
StorageProfile

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

additional_capabilities
AdditionalCapabilities

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

os_profile
OSProfile

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

network_profile
NetworkProfile

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

security_profile
SecurityProfile

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

diagnostics_profile
DiagnosticsProfile

부팅 진단 설정 상태를 지정합니다. <br>:code:>><<<br>Minimum api-version: 2015-06-15.

availability_set
SubResource

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

virtual_machine_scale_set
SubResource

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

proximity_placement_group
SubResource

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

priority
str 또는 VirtualMachinePriorityTypes

가상 머신의 우선 순위를 지정합니다. <br>:code:>><<<br>Minimum api-version: 2019-03-01. 알려진 값은 "Regular", "Low" 및 "Spot"입니다.

eviction_policy
str 또는 VirtualMachineEvictionPolicyTypes

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

billing_profile
BillingProfile

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

host
SubResource

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

host_group
SubResource

가상 머신이 있는 전용 호스트 그룹에 대한 정보를 지정합니다. <br>``<br>최소 api-version: 2020-06-01. :code::<br>code:>><<<br>NOTE: 사용자는 호스트 및 hostGroup 속성을 둘 다 지정할 수 없습니다.

license_type
str

사용 중인 이미지 또는 디스크가 온-프레미스에서 사용이 허가되었음을 지정합니다. <br>``<br>Windows Server 운영 체제의 가능한 값은 다음과 같습니다<br>``<br>. Windows_Client Windows_Server <br>``<br><br>``<br> Linux Server 운영 체제에 사용할 수 있는 값은 다음과 같습니다. <br>``<br> RHEL_BYOS(RHEL의 경우) SLES_BYOS(SUSE의 경우) <br>``<br><br>``<br> 자세한 내용은 Linux Server최소 api-version: 2015-06-15 버전의 Windows Server <br>``<br><br>``<br>Azure 하이브리드 사용 혜택을 참조하세요.

extensions_time_budget
str

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

platform_fault_domain
int

Virtual Machine을 만들 확장 집합 논리적 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다.:code:
<li>이 가상 머신의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다.:code:<li>참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount' > 1.:code:<li>이 속성은 가상 머신이 만들어지면 업데이트할 수 없습니다.:code:<li>Fault 도메인 할당은 Virtual Machine 인스턴스 보기.:code::code:<br>>><<<br>Minimum api}버전에서 볼 수 있습니다. 2020‐12‐01.

scheduled_events_profile
ScheduledEventsProfile

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

user_data
str

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

capacity_reservation
CapacityReservationProfile

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

변수

id
str

리소스 ID입니다.

name
str

리소스 이름입니다.

type
str

리소스 종류.

location
str

리소스 위치. 필수 요소.

tags
dict[str, str]

리소스 태그.

plan
Plan

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

resources
list[VirtualMachineExtension]

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

identity
VirtualMachineIdentity

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

zones
list[str]

가상 머신 영역입니다.

extended_location
ExtendedLocation

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

hardware_profile
HardwareProfile

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

storage_profile
StorageProfile

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

additional_capabilities
AdditionalCapabilities

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

os_profile
OSProfile

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

network_profile
NetworkProfile

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

security_profile
SecurityProfile

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

diagnostics_profile
DiagnosticsProfile

부팅 진단 설정 상태를 지정합니다. <br>:code:>><<<br>Minimum api-version: 2015-06-15.

availability_set
SubResource

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

virtual_machine_scale_set
SubResource

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

proximity_placement_group
SubResource

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

priority
str 또는 VirtualMachinePriorityTypes

가상 머신의 우선 순위를 지정합니다. <br>:code:>><<<br>Minimum api-version: 2019-03-01. 알려진 값은 "Regular", "Low", "Spot"입니다.

eviction_policy
str 또는 VirtualMachineEvictionPolicyTypes

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

billing_profile
BillingProfile

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

host
SubResource

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

host_group
SubResource

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

provisioning_state
str

응답에만 표시되는 프로비전 상태입니다.

instance_view
VirtualMachineInstanceView

가상 머신 instance 보기입니다.

license_type
str

사용 중인 이미지 또는 디스크에 온-프레미스 라이선스가 부여되도록 지정합니다. <br>``<br>Windows Server 운영 체제에 대한 가능한 값은 <br>``<br> 다음과 Windows_Client Windows_Server <br>``<br><br>``<br> Linux Server 운영 체제의 가능한 값은 다음과 같습니다. <br>``<br> RHEL_BYOS(RHEL의 경우) SLES_BYOS(SUSE의 경우) <br>``<br><br>``<br>자세한 내용은 Linux Server<br>``<br><br>``<br> 최소 API 버전에대한 Azure 하이브리드 사용 혜택: 2015-06-15를 참조하세요.

vm_id
str

모든 Azure IaaS VM SMBIOS에 인코딩 및 저장되며 플랫폼 BIOS 명령을 사용하여 읽을 수 있는 128비트 식별자인 VM 고유 ID를 지정합니다.

extensions_time_budget
str

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

platform_fault_domain
int

Virtual Machine을 만들 확장 집합 논리 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다.:code:
<li>이 가상 머신의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다.:code:<li>참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount' > 1.:code:<li>이 속성은 가상 머신이 만들어지면 업데이트할 수 없습니다.:code:<li>Fault 도메인 할당은 Virtual Machine Instance View.:code::code:<br>>><<<br>Minimum api-version에서 볼 수 있습니다. 2020‐12‐01.

scheduled_events_profile
ScheduledEventsProfile

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

user_data
str

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

capacity_reservation
CapacityReservationProfile

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