Share via


VirtualMachine Klasse

Beschreibt einen virtuellen Computer.

Variablen werden nur vom Server aufgefüllt und beim Senden einer Anforderung ignoriert.

Alle erforderlichen Parameter müssen aufgefüllt werden, um an Azure senden zu können.

Vererbung
azure.mgmt.compute.v2022_08_01.models._models_py3.Resource
VirtualMachine

Konstruktor

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

Ressourcenspeicherort Erforderlich.

tags
dict[str, str]

Ressourcentags.

plan
Plan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Images verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Programmgesteuerte Bereitstellung, Erste Schritte> - . Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

identity
VirtualMachineIdentity

Die Identität des virtuellen Computers, sofern konfiguriert.

zones
list[str]

Die Zonen des virtuellen Computers.

extended_location
ExtendedLocation

Der erweiterte Speicherort des virtuellen Computers.

hardware_profile
HardwareProfile

Legt die Hardwareeinstellungen für den virtuellen Computer fest.

storage_profile
StorageProfile

Legt die Speichereinstellungen für die Datenträger des virtuellen Computers fest.

additional_capabilities
AdditionalCapabilities

Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.

os_profile
OSProfile

Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nach der Bereitstellung des virtuellen Computers nicht mehr geändert werden.

network_profile
NetworkProfile

Legt die Netzwerkschnittstellen des virtuellen Computers fest.

security_profile
SecurityProfile

Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.

diagnostics_profile
DiagnosticsProfile

Gibt den Status der Startdiagnoseeinstellungen an. <br>:code:>><<<br>Minimum api-version: 2015-06-15.

availability_set
SubResource

Gibt Informationen zu der Verfügbarkeitsgruppe an, der der virtuelle Computer zugewiesen werden soll. Die virtuellen Computern, die in derselben Verfügbarkeitsgruppe angegeben werden, sind verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitsgruppen finden Sie unter Übersicht über Verfügbarkeitsgruppen. <br>``<br>Weitere Informationen zur geplanten Azure-Wartung finden Sie unter Wartung und Updates für Virtual Machines in Azure<br>``<br> Derzeit kann eine VM nur zur Verfügbarkeitsgruppe hinzugefügt werden, die zum Zeitpunkt der Erstellung festgelegt wurde. Die Verfügbarkeitsgruppe, der die VM hinzugefügt wird, sollte sich unter derselben Ressourcengruppe wie die Verfügbarkeitsgruppenressource befinden. Eine vorhandene VM kann einer Verfügbarkeitsgruppe nicht hinzugefügt werden. <br>:code:>><<<br>Diese Eigenschaft kann nicht zusammen mit einem Properties.virtualMachineScaleSet-Verweis ungleich NULL vorhanden sein.

virtual_machine_scale_set
SubResource

Gibt Informationen zur VM-Skalierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die in derselben VM-Skalierungsgruppe angegeben sind, werden verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Derzeit kann eine VM nur zur Erstellungszeit der VM-Skalierungsgruppe hinzugefügt werden. Eine vorhandene VM kann nicht zu einer VM-Skalierungsgruppe hinzugefügt werden. <br>``<br>Diese Eigenschaft kann nicht zusammen mit einem Properties.availabilitySet-Verweis ungleich NULL vorhanden sein. :code:<br>:code:>><<<br>Minimum api‐version: 2019‐03‐01.

proximity_placement_group
SubResource

Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. <br>:code:>><<<br>Minimum api-version: 2018-04-01.

priority
str oder VirtualMachinePriorityTypes

Gibt die Priorität für den virtuellen Computer an. <br>:code:>><<<br>Minimum api-version: 2019-03-01. Bekannte Werte sind: "Regular", "Low" und "Spot".

eviction_policy
str oder VirtualMachineEvictionPolicyTypes

Gibt die Entfernungsrichtlinie für den virtuellen Azure Spot-Computer und die Azure Spot-Skalierungsgruppe an. <br>``<br>Für virtuelle Azure Spot-Computer werden sowohl "Zuordnung aufheben" als auch "Löschen" unterstützt, und die API-Mindestversion ist 2019-03-01. :code:<br>:code:>><<<br>Für Azure Spot-Skalierungsgruppen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die api-Mindestversion ist 2017-10-30-preview. Bekannte Werte sind: "Zuordnung aufheben" und "Löschen".

billing_profile
BillingProfile

Gibt die Abrechnungsdetails eines virtuellen Azure Spot-Computers an. <br>:code:>><<<br>Minimum api-version: 2019-03-01.

host
SubResource

Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. <br>:code:>><<<br>Minimum api-version: 2018-10-01.

host_group
SubResource

Gibt Informationen zu der dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. <br>``<br>Api-Mindestversion: 2020-06-01. :code:<br>:code:>><<<br>HINWEIS: Der Benutzer kann nicht sowohl host- als auch hostGroup-Eigenschaften angeben.

license_type
str

Gibt an, dass das verwendete Image oder der verwendete Datenträger lokal lizenziert wurde. <br>``<br> Mögliche Werte für das Windows Server-Betriebssystem sind: <br>``<br> Windows_Client <br>``<br> Windows_Server <br>``<br> Mögliche Werte für Linux Server-Betriebssystem: <br>``<br> RHEL_BYOS (für RHEL) <br>``<br> SLES_BYOS (für SUSE) <br>``<br> Weitere Informationen finden Sie unter Azure Hybrid Use Benefit for Windows Server<br>``<br>Azure Hybrid Use Benefit for Linux Server<br>``<br> Minimum API-version: 2015-06-15.

extensions_time_budget
str

Gibt die Zeit an, die für den Start aller Erweiterungen zugewiesen wird. Die Dauer sollte zwischen 15 Minuten und 120 Minuten (einschließlich) liegen und im ISO 8601-Format angegeben werden. Der Standardwert ist 90 Minuten (PT1H30M). <br>``<br> Api-Mindestversion: 2020-06-01.

platform_fault_domain
int

Gibt die logische Fehlerdomäne der Skalierungsgruppe an, in der der virtuelle Computer erstellt wird. Standardmäßig wird der virtuelle Computer automatisch einer Fehlerdomäne zugewiesen, die am besten das Gleichgewicht zwischen verfügbaren Fehlerdomänen verwaltet.:code:
<li>Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist.:code:<li>Die VM-Skalierungsgruppe, auf die verwiesen wird, muss "platformFaultDomainCount" > 1 aufweisen.:code:<li>Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde.:code:<li>Fehlerdomänenzuweisung kann in der Vm-Instanzansicht angezeigt werden.:code:<br>code:>><<<br>Minimum api‐version: 2020‐12‐01.

scheduled_events_profile
ScheduledEventsProfile

Gibt Konfigurationen im Zusammenhang mit geplanten Ereignissen an.

user_data
str

UserData für den virtuellen Computer, der Base64-codiert sein muss. Der Kunde sollte hier keine Geheimnisse übergeben. <br>:code:>><<<br>Minimum api-version: 2021-03-01.

capacity_reservation
CapacityReservationProfile

Gibt Informationen zur Kapazitätsreservierung an, die zum Zuweisen des virtuellen Computers verwendet wird. <br>:code:>><<<br>Minimum api-version: 2021-04-01.

application_profile
ApplicationProfile

Gibt die Kataloganwendungen an, die der VM/VMSS zur Verfügung gestellt werden sollen.

Variablen

id
str

Ressourcen-ID.

name
str

Name der Ressource.

type
str

Der Ressourcentyp.

location
str

Ressourcenspeicherort Erforderlich.

tags
dict[str, str]

Ressourcentags.

plan
Plan

Gibt Informationen zum Marketplace-Image an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Element wird nur für Marketplace-Images verwendet. Bevor Sie ein Marketplace-Image aus einer API verwenden können, müssen Sie das Image für die programmgesteuerte Verwendung aktivieren. Suchen Sie im Azure-Portal das Marketplace-Image, das Sie verwenden möchten, und klicken Sie dann auf Programmgesteuerte Bereitstellung, Erste Schritte> - . Geben Sie alle erforderlichen Informationen ein, und klicken Sie dann auf Speichern.

resources
list[VirtualMachineExtension]

Die ressourcen der untergeordneten Erweiterung des virtuellen Computers.

identity
VirtualMachineIdentity

Die Identität des virtuellen Computers, sofern konfiguriert.

zones
list[str]

Die Zonen des virtuellen Computers.

extended_location
ExtendedLocation

Der erweiterte Speicherort des virtuellen Computers.

hardware_profile
HardwareProfile

Legt die Hardwareeinstellungen für den virtuellen Computer fest.

storage_profile
StorageProfile

Legt die Speichereinstellungen für die Datenträger des virtuellen Computers fest.

additional_capabilities
AdditionalCapabilities

Gibt zusätzliche Funktionen an, die auf dem virtuellen Computer aktiviert oder deaktiviert sind.

os_profile
OSProfile

Gibt die Betriebssystemeinstellungen an, die beim Erstellen des virtuellen Computers verwendet werden. Einige der Einstellungen können nach der Bereitstellung des virtuellen Computers nicht mehr geändert werden.

network_profile
NetworkProfile

Legt die Netzwerkschnittstellen des virtuellen Computers fest.

security_profile
SecurityProfile

Gibt die Sicherheitsbezogenen Profileinstellungen für den virtuellen Computer an.

diagnostics_profile
DiagnosticsProfile

Gibt den Status der Startdiagnoseeinstellungen an. <br>:code:>><<<br>Minimum api-version: 2015-06-15.

availability_set
SubResource

Gibt Informationen zu der Verfügbarkeitsgruppe an, der der virtuelle Computer zugewiesen werden soll. Die virtuellen Computern, die in derselben Verfügbarkeitsgruppe angegeben werden, sind verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Weitere Informationen zu Verfügbarkeitsgruppen finden Sie unter Übersicht über Verfügbarkeitsgruppen. <br>``<br>Weitere Informationen zur geplanten Azure-Wartung finden Sie unter Wartung und Updates für Virtual Machines in Azure<br>``<br> Derzeit kann eine VM nur zur Verfügbarkeitsgruppe hinzugefügt werden, die zum Zeitpunkt der Erstellung festgelegt wurde. Die Verfügbarkeitsgruppe, der die VM hinzugefügt wird, sollte sich unter derselben Ressourcengruppe wie die Verfügbarkeitsgruppenressource befinden. Eine vorhandene VM kann einer Verfügbarkeitsgruppe nicht hinzugefügt werden. <br>:code:>><<<br>Diese Eigenschaft kann nicht zusammen mit einem Properties.virtualMachineScaleSet-Verweis ungleich NULL vorhanden sein.

virtual_machine_scale_set
SubResource

Gibt Informationen zur VM-Skalierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Virtuelle Computer, die in derselben VM-Skalierungsgruppe angegeben sind, werden verschiedenen Knoten zugeordnet, um die Verfügbarkeit zu maximieren. Derzeit kann eine VM nur zur Erstellungszeit der VM-Skalierungsgruppe hinzugefügt werden. Eine vorhandene VM kann nicht zu einer VM-Skalierungsgruppe hinzugefügt werden. <br>``<br>Diese Eigenschaft kann nicht zusammen mit einem Properties.availabilitySet-Verweis ungleich NULL vorhanden sein. :code:<br>:code:>><<<br>Minimum api‐version: 2019‐03‐01.

proximity_placement_group
SubResource

Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. <br>:code:>><<<br>Minimum api-version: 2018-04-01.

priority
str oder VirtualMachinePriorityTypes

Gibt die Priorität für den virtuellen Computer an. <br>:code:>><<<br>Minimum api-version: 2019-03-01. Bekannte Werte sind: "Regular", "Low" und "Spot".

eviction_policy
str oder VirtualMachineEvictionPolicyTypes

Gibt die Entfernungsrichtlinie für den virtuellen Azure Spot-Computer und die Azure Spot-Skalierungsgruppe an. <br>``<br>Für virtuelle Azure Spot-Computer werden sowohl "Zuordnung aufheben" als auch "Löschen" unterstützt, und die API-Mindestversion ist 2019-03-01. :code:<br>:code:>><<<br>Für Azure Spot-Skalierungsgruppen werden sowohl "Deallocate" als auch "Delete" unterstützt, und die api-Mindestversion ist 2017-10-30-preview. Bekannte Werte sind: "Zuordnung aufheben" und "Löschen".

billing_profile
BillingProfile

Gibt die Abrechnungsdetails eines virtuellen Azure Spot-Computers an. <br>:code:>><<<br>Minimum api-version: 2019-03-01.

host
SubResource

Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. <br>:code:>><<<br>Minimum api-version: 2018-10-01.

host_group
SubResource

Gibt Informationen zu der dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. <br>``<br>Api-Mindestversion: 2020-06-01. :code:<br>:code:>><<<br>HINWEIS: Der Benutzer kann nicht sowohl host- als auch hostGroup-Eigenschaften angeben.

provisioning_state
str

Der Bereitstellungsstatus, der nur in der Antwort angezeigt wird.

instance_view
VirtualMachineInstanceView

Der virtuelle Computer instance Ansicht.

license_type
str

Gibt an, dass das verwendete Image oder der verwendete Datenträger lokal lizenziert wurde. <br>``<br> Mögliche Werte für das Windows Server-Betriebssystem sind: <br>``<br> Windows_Client <br>``<br> Windows_Server <br>``<br> Mögliche Werte für Linux Server-Betriebssystem: <br>``<br> RHEL_BYOS (für RHEL) <br>``<br> SLES_BYOS (für SUSE) <br>``<br> Weitere Informationen finden Sie unter 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

Gibt die eindeutige VM-ID an, bei der es sich um einen 128-Bit-Bezeichner handelt, der auf allen Azure IaaS-VMs-SMBIOS codiert und gespeichert ist und mithilfe von Bios-Befehlen der Plattform gelesen werden kann.

extensions_time_budget
str

Gibt die Zeit an, die für den Start aller Erweiterungen zugewiesen wird. Die Dauer sollte zwischen 15 Minuten und 120 Minuten (einschließlich) liegen und im ISO 8601-Format angegeben werden. Der Standardwert ist 90 Minuten (PT1H30M). <br>``<br> Api-Mindestversion: 2020-06-01.

platform_fault_domain
int

Gibt die logische Fehlerdomäne der Skalierungsgruppe an, in der der virtuelle Computer erstellt wird. Standardmäßig wird der virtuelle Computer automatisch einer Fehlerdomäne zugewiesen, die am besten das Gleichgewicht zwischen verfügbaren Fehlerdomänen verwaltet.:code:
<li>Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist.:code:<li>Die VM-Skalierungsgruppe, auf die verwiesen wird, muss "platformFaultDomainCount" > 1 aufweisen.:code:<li>Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde.:code:<li>Fehlerdomänenzuweisung kann in der Vm-Instanzansicht angezeigt werden.:code:<br>code:>><<<br>Minimum api‐version: 2020‐12‐01.

scheduled_events_profile
ScheduledEventsProfile

Gibt Konfigurationen im Zusammenhang mit geplanten Ereignissen an.

user_data
str

UserData für den virtuellen Computer, der Base64-codiert sein muss. Der Kunde sollte hier keine Geheimnisse übergeben. <br>:code:>><<<br>Minimum api-version: 2021-03-01.

capacity_reservation
CapacityReservationProfile

Gibt Informationen zur Kapazitätsreservierung an, die zum Zuweisen des virtuellen Computers verwendet wird. <br>:code:>><<<br>Minimum api-version: 2021-04-01.

application_profile
ApplicationProfile

Gibt die Kataloganwendungen an, die der VM/VMSS zur Verfügung gestellt werden sollen.

time_created
datetime

Gibt den Zeitpunkt an, zu dem die Vm-Ressource erstellt wurde.:code:
:code:>><<<br>Minimum api-version: 2021-11-01.