VirtualMachine クラス

仮想マシンについて説明します。

変数はサーバーによってのみ設定され、要求の送信時には無視されます。

Azure に送信するには、必要なすべてのパラメーターを設定する必要があります。

継承
azure.mgmt.compute.v2022_08_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

仮想マシンの作成に使用されるマーケットプレース イメージに関する情報を指定します。 この要素は、マーケットプレース イメージにのみ使用されます。 API からマーケットプレース イメージを使用する前に、プログラムで使用するためにイメージを有効にする必要があります。 Azure portalで、使用するマーケットプレース イメージを見つけて、[プログラムでデプロイする]、[作業の開始] の順>にクリックします。 必要な情報を入力し、[ 保存] をクリックします。

identity
VirtualMachineIdentity

構成されている場合は、仮想マシンの ID。

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

ブート診断設定の状態を指定します。 <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

リソースの場所。 必須です。

tags
dict[str, str]

リソース タグ。

plan
Plan

仮想マシンの作成に使用されるマーケットプレース イメージに関する情報を指定します。 この要素は、マーケットプレース イメージにのみ使用されます。 API からマーケットプレース イメージを使用する前に、プログラムで使用するためにイメージを有効にする必要があります。 Azure portalで、使用するマーケットプレース イメージを見つけて、[プログラムでデプロイする]、[作業の開始] の順>にクリックします。 必要な情報を入力し、[ 保存] をクリックします。

resources
list[VirtualMachineExtension]

仮想マシンの子拡張機能リソース。

identity
VirtualMachineIdentity

構成されている場合は、仮想マシンの ID。

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

ブート診断設定の状態を指定します。 <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。