共用方式為


VirtualMachine 類別

描述虛擬機器。

變數只會由伺服器填入,而且會在傳送要求時予以忽略。

必須填入所有必要的參數,才能傳送至 Azure。

繼承
azure.mgmt.compute.v2023_07_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, application_profile: _models.ApplicationProfile | None = None, **kwargs: Any)

Keyword-Only Parameters

location
str

資源位置。 必要。

tags
dict[str, str]

資源標籤。

plan
Plan

指定用來建立虛擬機器之 Marketplace 映射的相關資訊。 此元素僅用於市集映射。 您必須先啟用映射以供程式設計使用,才能從 API 使用市集映射。 在Azure 入口網站中,尋找您想要使用的市集映射,然後按一下 [以程式設計方式部署] [開始使用] - > 。 輸入任何必要資訊,然後按一下 [ 儲存]。

identity
VirtualMachineIdentity

如果已設定,則為虛擬機器的身分識別。

zones
list[str]

虛擬機器區域。

extended_location
ExtendedLocation

虛擬機器的擴充位置。

hardware_profile
HardwareProfile

指定虛擬機器的硬體設定。

storage_profile
StorageProfile

指定虛擬機器磁碟的儲存體設定。

additional_capabilities
AdditionalCapabilities

指定在虛擬機器上啟用或停用的其他功能。

os_profile
OSProfile

指定建立虛擬機器時所使用的作業系統設定。 布建 VM 之後,就無法變更部分設定。

network_profile
NetworkProfile

指定虛擬機器的網路介面。

security_profile
SecurityProfile

指定虛擬機器的安全性相關設定檔設定。

diagnostics_profile
DiagnosticsProfile

指定開機診斷設定狀態。 API 版本下限:2015-06-15。

availability_set
SubResource

指定虛擬機器應指派給的可用性設定組相關資訊。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。 如需 Azure 計劃性維護的詳細資訊,請參閱Azure 中虛擬機器的維護和更新。 目前,VM 只能在建立時新增至可用性設定組。 要新增 VM 的可用性設定組應該位於與可用性設定組資源相同的資源群組之下。 現有的 VM 無法新增至可用性設定組。 此屬性不能與非 Null 屬性一起存在。virtualMachineScaleSet 參考。

virtual_machine_scale_set
SubResource

指定要指派虛擬機器之虛擬機器擴展集的相關資訊。 相同虛擬機器擴展集中指定的虛擬機器會配置給不同的節點,以最大化可用性。 目前,VM 只能在建立時新增至虛擬機器擴展集。 現有的 VM 無法新增至虛擬機器擴展集。 這個屬性不能與非 Null properties.availabilitySet 參考一起存在。 最低 api-version:2019?03\01。

proximity_placement_group
SubResource

指定虛擬機器應指派給之鄰近放置群組的相關資訊。 API 版本下限:2018-04-01。

priority
strVirtualMachinePriorityTypes

指定虛擬機器的優先順序。 API 版本下限:2019-03-01。 已知值為:「Regular」、「Low」 和 「Spot」。

eviction_policy
strVirtualMachineEvictionPolicyTypes

指定 Azure Spot 虛擬機器和 Azure Spot 擴展集的收回原則。 針對 Azure Spot 虛擬機器,支援「解除配置」和「刪除」,而最低 API 版本為 2019-03-01。 針對 Azure Spot 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。 已知值為:「Deallocate」 和 「Delete」。

billing_profile
BillingProfile

指定 Azure Spot 虛擬機器的計費相關詳細資料。 API 版本下限:2019-03-01。

host
SubResource

指定虛擬機器所在專用主機的相關資訊。 API 版本下限:2018-10-01。

host_group
SubResource

指定虛擬機器所在專用主機群組的相關資訊。 注意: 使用者無法同時指定 host 和 hostGroup 屬性。 API 版本下限:2020-06-01。

license_type
str

指定正在使用的映射或磁片是在內部部署授權。 <br>``<br>Windows Server 作業系統的可能值為. <br>``<br> .Windows_Client Windows_Server <br>``<br><br>``<br> Linux Server 作業系統的可能值為: <br>``<br> 適用于 S) <br>``<br> USE 的 RHEL) <br>``<br> SLES_BYOS (RHEL_BYOS (如需詳細資訊,請參閱適用于 Linux Server<br>``<br> 的 AzureHybrid Use Benefit for Linux Server<br>``<br> 最低 api-version:2015-06-15。

extensions_time_budget
str

指定要啟動之所有延伸模組加上批註的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為 90 分鐘 (PT1H30M) 。 API 版本下限:2020-06-01。

platform_fault_domain
int

指定要在其中建立虛擬機器的擴展集邏輯容錯網域。 根據預設,虛擬機器會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。 只有在設定此虛擬機器的 'virtualMachineScaleSet' 屬性時,才適用這個屬性。 參考的虛擬機器擴展集必須大於 'platformFaultDomainCount'

  1. 建立虛擬機器之後,就無法更新此屬性。 容錯網域指派可以在虛擬機器實例檢視中檢視。 最低 api-version:2020?12?01。
scheduled_events_profile
ScheduledEventsProfile

指定排程的事件相關組態。

user_data
str

VM 的 UserData,必須以 base-64 編碼。 客戶不應在此傳遞任何秘密。 最低 api-version:2021-03-01。

capacity_reservation
CapacityReservationProfile

指定用來配置虛擬機器之容量保留區的相關資訊。 API 版本下限:2021-04-01。

application_profile
ApplicationProfile

指定應該提供給 VM/VMSS 的資源庫應用程式。

變數

id
str

資源識別碼。

name
str

資源名稱。

type
str

資源類型。

location
str

資源位置。 必要。

tags
dict[str, str]

資源標籤。

plan
Plan

指定用來建立虛擬機器之 Marketplace 映射的相關資訊。 此元素僅用於市集映射。 您必須先啟用映射以供程式設計使用,才能從 API 使用市集映射。 在Azure 入口網站中,尋找您想要使用的市集映射,然後按一下 [以程式設計方式部署] [開始使用] - > 。 輸入任何必要資訊,然後按一下 [ 儲存]。

resources
list[VirtualMachineExtension]

虛擬機器子擴充功能資源。

identity
VirtualMachineIdentity

如果已設定,則為虛擬機器的身分識別。

zones
list[str]

虛擬機器區域。

extended_location
ExtendedLocation

虛擬機器的擴充位置。

hardware_profile
HardwareProfile

指定虛擬機器的硬體設定。

storage_profile
StorageProfile

指定虛擬機器磁碟的儲存體設定。

additional_capabilities
AdditionalCapabilities

指定在虛擬機器上啟用或停用的其他功能。

os_profile
OSProfile

指定建立虛擬機器時所使用的作業系統設定。 布建 VM 之後,就無法變更部分設定。

network_profile
NetworkProfile

指定虛擬機器的網路介面。

security_profile
SecurityProfile

指定虛擬機器的安全性相關設定檔設定。

diagnostics_profile
DiagnosticsProfile

指定開機診斷設定狀態。 API 版本下限:2015-06-15。

availability_set
SubResource

指定虛擬機器應指派給的可用性設定組相關資訊。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。 如需 Azure 計劃性維護的詳細資訊,請參閱Azure 中虛擬機器的維護和更新。 目前,VM 只能在建立時新增至可用性設定組。 要新增 VM 的可用性設定組應該位於與可用性設定組資源相同的資源群組之下。 現有的 VM 無法新增至可用性設定組。 此屬性不能與非 Null 屬性一起存在。virtualMachineScaleSet 參考。

virtual_machine_scale_set
SubResource

指定要指派虛擬機器之虛擬機器擴展集的相關資訊。 相同虛擬機器擴展集中指定的虛擬機器會配置給不同的節點,以最大化可用性。 目前,VM 只能在建立時新增至虛擬機器擴展集。 現有的 VM 無法新增至虛擬機器擴展集。 這個屬性不能與非 Null properties.availabilitySet 參考一起存在。 最低 api-version:2019?03\01。

proximity_placement_group
SubResource

指定虛擬機器應指派給之鄰近放置群組的相關資訊。 API 版本下限:2018-04-01。

priority
strVirtualMachinePriorityTypes

指定虛擬機器的優先順序。 API 版本下限:2019-03-01。 已知值為:「Regular」、「Low」 和 「Spot」。

eviction_policy
strVirtualMachineEvictionPolicyTypes

指定 Azure Spot 虛擬機器和 Azure Spot 擴展集的收回原則。 針對 Azure Spot 虛擬機器,支援「解除配置」和「刪除」,而最低 API 版本為 2019-03-01。 針對 Azure Spot 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本為 2017-10-30-preview。 已知值為:「Deallocate」 和 「Delete」。

billing_profile
BillingProfile

指定 Azure Spot 虛擬機器的計費相關詳細資料。 API 版本下限:2019-03-01。

host
SubResource

指定虛擬機器所在專用主機的相關資訊。 API 版本下限:2018-10-01。

host_group
SubResource

指定虛擬機器所在專用主機群組的相關資訊。 注意: 使用者無法同時指定 host 和 hostGroup 屬性。 API 版本下限:2020-06-01。

provisioning_state
str

布建狀態,只會出現在回應中。

instance_view
VirtualMachineInstanceView

虛擬機器實例檢視。

license_type
str

指定正在使用的映射或磁片是在內部部署授權。 <br>``<br>Windows Server 作業系統的可能值為. <br>``<br> .Windows_Client Windows_Server <br>``<br><br>``<br> Linux Server 作業系統的可能值為: <br>``<br> 適用于 S) <br>``<br> USE 的 RHEL) <br>``<br> SLES_BYOS (RHEL_BYOS (如需詳細資訊,請參閱適用于 Linux Server<br>``<br> 的 AzureHybrid Use Benefit for Linux Server<br>``<br> 最低 api-version:2015-06-15。

vm_id
str

指定 VM 唯一識別碼,這是編碼並儲存在所有 Azure IaaS VM SMBIOS 中的 128 位識別碼,而且可以使用平臺 BIOS 命令來讀取。

extensions_time_budget
str

指定要啟動之所有延伸模組加上批註的時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為 90 分鐘 (PT1H30M) 。 API 版本下限:2020-06-01。

platform_fault_domain
int

指定要在其中建立虛擬機器的擴展集邏輯容錯網域。 根據預設,虛擬機器會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。 只有在設定此虛擬機器的 'virtualMachineScaleSet' 屬性時,才適用這個屬性。 參考的虛擬機器擴展集必須大於 'platformFaultDomainCount'

  1. 建立虛擬機器之後,就無法更新此屬性。 容錯網域指派可以在虛擬機器實例檢視中檢視。 最低 api-version:2020?12?01。
scheduled_events_profile
ScheduledEventsProfile

指定排程的事件相關組態。

user_data
str

VM 的 UserData,必須以 base-64 編碼。 客戶不應在此傳遞任何秘密。 最低 api-version:2021-03-01。

capacity_reservation
CapacityReservationProfile

指定用來配置虛擬機器之容量保留區的相關資訊。 API 版本下限:2021-04-01。

application_profile
ApplicationProfile

指定應該提供給 VM/VMSS 的資源庫應用程式。

time_created
datetime

指定虛擬機器資源建立的時間。 最低 api-version:2021-11-01。