VirtualMachine クラス
仮想マシンについて説明します。
変数はサーバーによってのみ設定され、要求の送信時には無視されます。
Azure に送信するには、必要なすべてのパラメーターを設定する必要があります。
- 継承
-
azure.mgmt.compute.v2022_08_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, capacity_reservation: _models.CapacityReservationProfile | None = None, application_profile: _models.ApplicationProfile | None = None, **kwargs: Any)
Keyword-Only Parameters
- location
- str
リソースの場所。 必須。
- plan
- Plan
仮想マシンの作成に使用されるマーケットプレース イメージに関する情報を指定します。 この要素は、マーケットプレース イメージにのみ使用されます。 API からマーケットプレース イメージを使用する前に、プログラムで使用するためにイメージを有効にする必要があります。 Azure portalで、使用するマーケットプレース イメージを見つけて、[プログラムでデプロイする]、[作業の開始] の順>にクリックします。 必要な情報を入力し、[ 保存] をクリックします。
- identity
- VirtualMachineIdentity
構成されている場合は、仮想マシンの ID。
- 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>
Minimum api-version: 2015-06-15。
- availability_set
- SubResource
仮想マシンを割り当てる可用性セットに関する情報を指定します。 同じ可用性セットで指定された仮想マシンは、可用性を最大化するために別々のノードに割り当てられます。 可用性セットの詳細については、「可用性セット の概要」を参照してください。
<br>``<br>
Azure の計画メンテナンスの詳細については、「Azure <br>``<br>
でのVirtual Machinesのメンテナンスと更新」を参照してください。現時点では、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 スポット仮想マシンと Azure スポット スケール セットの削除ポリシーを指定します。 <br>``<br>
Azure Spot 仮想マシンでは、'Deallocate' と 'Delete' の両方がサポートされており、api-version の最小値は 2019-03-01 です。
:code:<br>
:code:>><<<br>
Azure スポット スケール セットでは、'Deallocate' と 'Delete' の両方がサポートされており、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 プロパティの両方を指定できません。
- license_type
- str
使用されているイメージまたはディスクがオンプレミスでライセンスされたことを指定します。 <br>``<br>
Windows Server オペレーティング システムで使用できる値は次のとおりです。 <br>``<br>
Windows_Client Windows_Server <br>``<br>
<br>``<br>
Linux Server オペレーティング システムで使用できる値は、 <br>``<br>
RHEL_BYOS (RHEL の場合) <br>``<br>
SLES_BYOS (SUSE の場合) <br>``<br>
です。詳細については、「Azure Hybrid Use Benefit for Windows ServerAzure Hybrid Use Benefit for Linux Server<br>``<br>
<br>``<br>
Minimum api-version: 2015-06-15」を参照してください。
- extensions_time_budget
- str
すべての拡張機能の開始時間を指定します。 期間は 15 分から 120 分 (含む) で、ISO 8601 形式で指定する必要があります。 既定値は 90 分 (PT1H30M) です。 <br>``<br>
最小 api-version: 2020-06-01。
- platform_fault_domain
- int
仮想マシンを作成するスケール セットの論理障害ドメインを指定します。 既定では、仮想マシンは、使用可能な障害ドメイン間のバランスを最も適切に維持する障害ドメインに自動的に割り当てられます。:code:<li>
これは、この仮想マシンの 'virtualMachineScaleSet' プロパティが set.:code:<li>
The Virtual Machine Scale Set that is referenced, must have 'platformFaultDomainCount' > 1.:code:<li>
This property cannot be updated once the Virtual Machine Is created.:code:<li>
Fault domain assignment can be view in the Virtual Machine Instance View.:code:<br>
:code:>><<<br>
Minimum api‐version: 2020‐12‐01.
- scheduled_events_profile
- ScheduledEventsProfile
スケジュールされたイベント関連の構成を指定します。
- user_data
- str
VM の UserData。Base-64 でエンコードする必要があります。 顧客はここでシークレットを渡すべきではありません。 <br>
:code:>><<<br>
Minimum api-version: 2021-03-01。
- capacity_reservation
- CapacityReservationProfile
仮想マシンの割り当てに使用される容量予約に関する情報を指定します。 <br>
:code:>><<<br>
Minimum api-version: 2021-04-01。
- application_profile
- ApplicationProfile
VM/VMSS で使用できるようにするギャラリー アプリケーションを指定します。
変数
- id
- str
リソース ID。
- name
- str
リソース名。
- type
- str
リソースの種類。
- location
- str
リソースの場所。 必須です。
- plan
- Plan
仮想マシンの作成に使用されるマーケットプレース イメージに関する情報を指定します。 この要素は、マーケットプレース イメージにのみ使用されます。 API からマーケットプレース イメージを使用する前に、プログラムで使用するためにイメージを有効にする必要があります。 Azure portalで、使用するマーケットプレース イメージを見つけて、[プログラムでデプロイする]、[作業の開始] の順>にクリックします。 必要な情報を入力し、[ 保存] をクリックします。
- resources
- list[VirtualMachineExtension]
仮想マシンの子拡張機能リソース。
- identity
- VirtualMachineIdentity
構成されている場合は、仮想マシンの ID。
- 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>
Minimum api-version: 2015-06-15。
- availability_set
- SubResource
仮想マシンを割り当てる可用性セットに関する情報を指定します。 同じ可用性セットで指定された仮想マシンは、可用性を最大化するために別々のノードに割り当てられます。 可用性セットの詳細については、「可用性 セットの概要」を参照してください。
<br>``<br>
Azure の計画メンテナンスの詳細については、「Azure <br>``<br>
でのVirtual Machinesのメンテナンスと更新」を参照してください。現時点では、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 スポット仮想マシンと Azure スポット スケール セットの削除ポリシーを指定します。 <br>``<br>
Azure Spot 仮想マシンの場合、"割り当て解除" と "削除" の両方がサポートされており、最小 api バージョンは 2019-03-01 です。
:code:<br>
:code:>><<<br>
Azure スポット スケール セットの場合、'割り当て解除' と 'Delete' の両方がサポートされており、最小 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
仮想マシン インスタンス ビュー。
- license_type
- str
使用されているイメージまたはディスクがオンプレミスでライセンスされていることを指定します。 <br>``<br>
Windows Server オペレーティング システムで使用できる値は次のとおりです。 <br>``<br>
Windows_Client <br>``<br>
Windows_Server <br>``<br>
Linux Server オペレーティング システムで使用できる値は、 <br>``<br>
RHEL_BYOS (RHEL の場合) <br>``<br>
SLES_BYOS (SUSE の場合) <br>``<br>
です。詳細については、「 Azure Hybrid Use Benefit for Windows Server<br>``<br>
Azure Hybrid Use Benefit for Linux Server<br>``<br>
Minimum api-version: 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
仮想マシンを作成するスケール セットの論理障害ドメインを指定します。 既定では、仮想マシンは、使用可能な障害ドメイン間のバランスを最もよく維持する障害ドメインに自動的に割り当てられます。:code:<li>
これは、この仮想マシンの 'virtualMachineScaleSet' プロパティが設定されている場合にのみ適用されます。:code:<li>
参照される仮想マシン スケール セットは、"platformFaultDomainCount' > 1.:code:<li>
このプロパティは、仮想マシンが作成されると更新できません。:code:<li>
Fault ドメインの割り当ては、仮想マシン インスタンス ビューで表示できます。:code::code:<br>
>><<<br>
Minimum api‐version: 2020‐12‐01.
- scheduled_events_profile
- ScheduledEventsProfile
スケジュールされたイベント関連の構成を指定します。
- user_data
- str
VM の UserData。Base-64 でエンコードする必要があります。 お客様はここでシークレットを渡さないでください。 <br>
:code:>><<<br>
Minimum api-version: 2021-03-01。
- capacity_reservation
- CapacityReservationProfile
仮想マシンの割り当てに使用される容量予約に関する情報を指定します。 <br>
:code:>><<<br>
Minimum api-version: 2021-04-01。
- application_profile
- ApplicationProfile
VM/VMSS で使用できるようにするギャラリー アプリケーションを指定します。
- time_created
- datetime
仮想マシン リソースが作成された時刻を指定します。:code:
:code:>><<<br>
Minimum api-version: 2021-11-01。
Azure SDK for Python