다음을 통해 공유


VirtualMachineUpdate 클래스

Virtual Machine 업데이트에 대해 설명합니다.

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

상속
azure.mgmt.compute.v2023_07_01.models._models_py3.UpdateResource
VirtualMachineUpdate

생성자

VirtualMachineUpdate(*, tags: Dict[str, str] | None = None, plan: _models.Plan | None = None, identity: _models.VirtualMachineIdentity | None = None, zones: List[str] | 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, application_profile: _models.ApplicationProfile | None = None, **kwargs: Any)

키워드 전용 매개 변수

Name Description
tags

리소스 태그.

plan

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

identity

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

zones

가상 머신 영역입니다.

hardware_profile

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

storage_profile

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

additional_capabilities

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

os_profile

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

network_profile

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

security_profile

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

diagnostics_profile

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

availability_set

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

virtual_machine_scale_set

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

proximity_placement_group

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

priority

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

eviction_policy

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

billing_profile

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

host

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

host_group

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

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)입니다. 최소 api-version: 2020-06-01.

platform_fault_domain
int

Virtual Machine을 만들 확장 집합 논리적 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다. 이 가상 머신의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다. 참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount'가 보다 커야 합니다.

  1. Virtual Machine을 만든 후에는 이 속성을 업데이트할 수 없습니다. 장애 도메인 할당은 Virtual Machine 인스턴스 보기에서 볼 수 있습니다. 최소 api-version: 2020-12-01.
scheduled_events_profile

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

user_data
str

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

capacity_reservation

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

application_profile

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

변수

Name Description
tags

리소스 태그.

plan

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

identity

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

zones

가상 머신 영역입니다.

hardware_profile

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

storage_profile

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

additional_capabilities

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

os_profile

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

network_profile

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

security_profile

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

diagnostics_profile

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

availability_set

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

virtual_machine_scale_set

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

proximity_placement_group

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

priority

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

eviction_policy

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

billing_profile

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

host

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

host_group

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

provisioning_state
str

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

instance_view

가상 머신 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최소 api-version: 2015-06-15 버전의 Windows Server <br>``<br><br>``<br>Azure 하이브리드 사용 혜택을 참조하세요.

vm_id
str

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

extensions_time_budget
str

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

platform_fault_domain
int

Virtual Machine을 만들 확장 집합 논리적 장애 도메인을 지정합니다. 기본적으로 Virtual Machine은 사용 가능한 장애 도메인 간에 균형을 가장 잘 유지하는 장애 도메인에 자동으로 할당됩니다. 이 가상 머신의 'virtualMachineScaleSet' 속성이 설정된 경우에만 적용됩니다. 참조되는 Virtual Machine Scale Set에는 'platformFaultDomainCount'가 보다 커야 합니다.

  1. Virtual Machine을 만든 후에는 이 속성을 업데이트할 수 없습니다. 장애 도메인 할당은 Virtual Machine 인스턴스 보기에서 볼 수 있습니다. 최소 api-version: 2020-12-01.
scheduled_events_profile

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

user_data
str

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

capacity_reservation

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

application_profile

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

time_created

Virtual Machine 리소스를 만든 시간을 지정합니다. 최소 api-version: 2021-11-01.