VirtualMachine 類別
描述虛擬機器。
變數只會由伺服器填入,而且會在傳送要求時予以忽略。
必須填入所有必要的參數,才能傳送至 Azure。
- 繼承
-
azure.mgmt.compute.v2021_03_01.models._models_py3.ResourceVirtualMachine
建構函式
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, **kwargs: Any)
Keyword-Only Parameters
- location
- str
資源位置。 必要。
- plan
- Plan
指定用來建立虛擬機器之 Marketplace 映射的相關資訊。 此元素僅用於市集映射。 您必須先啟用映射以程式設計方式使用,才能從 API 使用市集映射。 在Azure 入口網站中,尋找您想要使用的市集映射,然後按一下 [想要以程式設計方式部署],[開始使用] - > 。 輸入任何必要資訊,然後按一下 [ 儲存]。
- identity
- VirtualMachineIdentity
如果已設定,則為虛擬機器的身分識別。
- 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
指定開機診斷設定狀態。
<br>
:code: >><<<br>
最低 api-version:2015-06-15。
- availability_set
- SubResource
指定虛擬機器應指派給的可用性設定組相關資訊。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。
<br>``<br>
如需 Azure 計劃性維護的詳細資訊,請參閱 Azure <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>
最低 api-version:2018-04-01。
- priority
- str 或 VirtualMachinePriorityTypes
指定虛擬機器的優先順序。
<br>
:code: >><<<br>
最低 api-version:2019-03-01。 已知值為:「Regular」、「Low」 和 「Spot」。
- eviction_policy
- str 或 VirtualMachineEvictionPolicyTypes
指定 Azure Spot 虛擬機器和 Azure Spot 擴展集的收回原則。 <br>``<br>
針對 Azure Spot 虛擬機器,同時支援「解除配置」和「刪除」,且最低 API 版本為 2019-03-01。
:code: <br>
:code: >><<<br>
For Azure Spot 擴展集支援 'Deallocate' 和 'Delete',而最低 api 版本是 2017-10-30-preview。 已知值為:「Deallocate」 和 「Delete」。
- billing_profile
- BillingProfile
指定 Azure Spot 虛擬機器的計費相關詳細資料。 <br>
:code: >><<<br>
最低 api-version:2019-03-01。
- host
- SubResource
指定虛擬機器所在專用主機的相關資訊。 <br>
:code: >><<<br>
最低 api-version:2018-10-01。
- host_group
- SubResource
指定虛擬機器所在的專用主機群組相關資訊。 <br>``<br>
API 版本下限:2020-06-01。
:code: <br>
:code: >><<<br>
NOTE:使用者無法同時指定 host 和 hostGroup 屬性。
- license_type
- str
指定正在使用的映射或磁片是內部部署授權的。 <br>``<br>
Windows Server 作業系統的可能值為: <br>``<br>
適用于 Linux Server 作業系統的Windows_Client <br>``<br>
Windows_Server <br>``<br>
可能的值為 RHEL_BYOS (: <br>``<br>
適用于 S) <br>``<br>
USE 的 RHEL) <br>``<br>
) SLES_BYOS (如需詳細資訊,請參閱適用于Linux Server 的 Azure Hybrid Use Benefit forLinux Server<br>``<br>
<br>``<br>
最低 api-version:2015-06-15。
- extensions_time_budget
- str
指定要啟動之所有延伸模組的加注時間。 持續時間應介於 15 分鐘到 120 分鐘之間, (包含) ,且應以 ISO 8601 格式指定。 預設值為 90 分鐘 (PT1H30M) 。 <br>``<br>
API 版本下限:2020-06-01。
- platform_fault_domain
- int
指定要在其中建立虛擬機器的擴展集邏輯容錯網域。 根據預設,虛擬機器會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。:code:<li>
只有在已設定此虛擬機器的 'virtualMachineScaleSet' 屬性時適用。:code: <li>
參考的虛擬機器擴展集必須具有 'platformFaultDomainCount' > 1.:code:code: <li>
這個屬性在虛擬機器建立後無法更新。:code: <li>
容錯網域指派可以在虛擬機器實例檢視中檢視。:code::code::code: <br>
:code: >><<<br>
Minimum api?version: 2020‐12‐01.
- scheduled_events_profile
- ScheduledEventsProfile
指定排程的事件相關組態。
- user_data
- str
VM 的 UserData,必須是 base-64 編碼。 客戶不應在此傳遞任何秘密。 <br>
:code: >><<<br>
最低 api-version:2021-03-01。
變數
- id
- str
資源識別碼。
- name
- str
資源名稱。
- type
- str
資源類型。
- location
- str
資源位置。 必要。
- plan
- Plan
指定用來建立虛擬機器之 Marketplace 映射的相關資訊。 此元素僅用於市集映射。 您必須先啟用映射以程式設計方式使用,才能從 API 使用市集映射。 在Azure 入口網站中,尋找您想要使用的市集映射,然後按一下 [想要以程式設計方式部署],[開始使用] - > 。 輸入任何必要資訊,然後按一下 [ 儲存]。
- resources
- list[VirtualMachineExtension]
虛擬機器子擴充功能資源。
- identity
- VirtualMachineIdentity
如果已設定,則為虛擬機器的身分識別。
- 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
指定開機診斷設定狀態。
<br>
:code: >><<<br>
最低 api-version:2015-06-15。
- availability_set
- SubResource
指定虛擬機器應指派給的可用性設定組相關資訊。 在相同可用性設定組中指定的虛擬機器會配置到不同的節點,以便將可用性最大化。 如需可用性設定組的詳細資訊,請參閱 可用性設定組概觀。
<br>``<br>
如需 Azure 計劃性維護的詳細資訊,請參閱 Azure <br>``<br>
中虛擬機器的維護和更新目前,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>
最低 api-version:2018-04-01。
- priority
- str 或 VirtualMachinePriorityTypes
指定虛擬機器的優先順序。 <br>
:code: >><<<br>
最低 api-version:2019-03-01。 已知值為:「Regular」、「Low」 和 「Spot」。
- eviction_policy
- str 或 VirtualMachineEvictionPolicyTypes
指定 Azure Spot 虛擬機器和 Azure Spot 擴展集的收回原則。 <br>``<br>
針對 Azure Spot 虛擬機器,支援「解除配置」和「刪除」,而最低 API 版本為 2019-03-01。
:code: <br>
:code: >><<<br>
For Azure Spot 擴展集,同時支援 'Deallocate' 和 'Delete',而最低 API 版本是 2017-10-30-preview。 已知值為:「Deallocate」 和 「Delete」。
- billing_profile
- BillingProfile
指定 Azure Spot 虛擬機器的計費相關詳細資料。
<br>
:code: >><<<br>
最低 api-version:2019-03-01。
- host
- SubResource
指定虛擬機器所在專用主機的相關資訊。
<br>
:code: >><<<br>
最低 api-version:2018-10-01。
- host_group
- SubResource
指定虛擬機器所在專用主機群組的相關資訊。 <br>``<br>
API 版本下限:2020-06-01。
:code: <br>
:code: >><<<br>
NOTE:使用者無法同時指定 host 和 hostGroup 屬性。
- provisioning_state
- str
布建狀態,只會出現在回應中。
- instance_view
- VirtualMachineInstanceView
虛擬機器實例檢視。
- license_type
- str
指定正在使用的映射或磁片是在內部部署授權。 <br>``<br>
Windows Server 作業系統的可能值為: <br>``<br>
適用于 Linux Server 作業系統的Windows_Client <br>``<br>
Windows_Server <br>``<br>
可能的值為 RHEL_BYOS (: <br>``<br>
適用于 S) <br>``<br>
USE 的 RHEL) <br>``<br>
) SLES_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) 。 <br>``<br>
API 版本下限:2020-06-01。
- platform_fault_domain
- int
指定要在其中建立虛擬機器的擴展集邏輯容錯網域。 根據預設,虛擬機器會自動指派給容錯網域,以在可用的容錯網域之間維持平衡。:code:<li>
只有當此虛擬機器的 'virtualMachineScaleSet' 屬性已設定時,才適用。:code: <li>
參考的虛擬機器擴展集必須具有 'platformFaultDomainCount' > 1.:code:code: <li>
這個屬性,在虛擬機器實例檢視中可以檢視。:code: <li>
容錯網域指派可以在虛擬機器實例檢視中檢視。:code::code::code: <br>
>><<<br>
Minimum api-version: 2020‐12‐01.
- scheduled_events_profile
- ScheduledEventsProfile
指定排程的事件相關組態。
- user_data
- str
VM 的 UserData,必須以 base-64 編碼。 客戶不應在此傳遞任何秘密。 <br>
:code: >><<<br>
最低 api-version:2021-03-01。