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.v2023_03_01.models._models_py3.ResourceVirtualMachine
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.
- 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 nach dem 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.
- 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. Api-Mindestversion: 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. Weitere Informationen zur geplanten Wartung in Azure finden Sie unter Wartung und Updates für Virtual Machines in Azure. Derzeit kann eine VM nur zur Erstellungszeit der Verfügbarkeitsgruppe hinzugefügt werden. 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. 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. Diese Eigenschaft kann nicht zusammen mit einem Properties.availabilitySet-Verweis ungleich NULL vorhanden sein. Api-Mindestversion: 2019‐03‐01.
- proximity_placement_group
- SubResource
Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Api-Mindestversion: 2018-04-01.
- priority
- str oder VirtualMachinePriorityTypes
Gibt die Priorität für den virtuellen Computer an. Api-Mindestversion: 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. Für virtuelle Azure Spot-Computer werden sowohl "Zuordnung aufheben" als auch "Löschen" unterstützt, und die API-Mindestversion ist 2019-03-01. Für Azure Spot-Skalierungsgruppen werden sowohl "Zuordnung aufheben" als auch "Löschen" 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. Api-Mindestversion: 2019-03-01.
- host
- SubResource
Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. Api-Mindestversion: 2018-10-01.
- host_group
- SubResource
Gibt Informationen zu der dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. Hinweis: Der Benutzer kann nicht sowohl host- als auch hostGroup-Eigenschaften angeben. Api-Mindestversion: 2020-06-01.
- 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). 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 das Gleichgewicht zwischen den verfügbaren Fehlerdomänen am besten verwaltet. Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist. Die VM-Skalierungsgruppe, auf die verwiesen wird, muss "platformFaultDomainCount" größer als sein.
- Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Die Fehlerdomänenzuweisung kann in der Vm-Instanzansicht angezeigt werden. Api-Mindestversion: 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. Api-Mindestversion: 2021-03-01.
- capacity_reservation
- CapacityReservationProfile
Gibt Informationen zur Kapazitätsreservierung an, die zum Zuweisen des virtuellen Computers verwendet wird. Api-Mindestversion: 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.
- 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 nach dem 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.
- 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. Api-Mindestversion: 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. Weitere Informationen zur geplanten Wartung in Azure finden Sie unter Wartung und Updates für Virtual Machines in Azure. Derzeit kann eine VM nur zur Erstellungszeit der Verfügbarkeitsgruppe hinzugefügt werden. 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. 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. Diese Eigenschaft kann nicht zusammen mit einem Properties.availabilitySet-Verweis ungleich NULL vorhanden sein. Api-Mindestversion: 2019‐03‐01.
- proximity_placement_group
- SubResource
Gibt Informationen zur Näherungsplatzierungsgruppe an, der der virtuelle Computer zugewiesen werden soll. Api-Mindestversion: 2018-04-01.
- priority
- str oder VirtualMachinePriorityTypes
Gibt die Priorität für den virtuellen Computer an. Api-Mindestversion: 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. Für virtuelle Azure Spot-Computer werden sowohl "Zuordnung aufheben" als auch "Löschen" unterstützt, und die API-Mindestversion ist 2019-03-01. Für Azure Spot-Skalierungsgruppen werden sowohl "Zuordnung aufheben" als auch "Löschen" 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. Api-Mindestversion: 2019-03-01.
- host
- SubResource
Gibt Informationen zum dedizierten Host an, in dem sich der virtuelle Computer befindet. Api-Mindestversion: 2018-10-01.
- host_group
- SubResource
Gibt Informationen zu der dedizierten Hostgruppe an, in der sich der virtuelle Computer befindet. Hinweis: Der Benutzer kann nicht sowohl host- als auch hostGroup-Eigenschaften angeben. Api-Mindestversion: 2020-06-01.
- 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. Hierbei handelt es sich um einen 128-Bit-Bezeichner, 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). 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 das Gleichgewicht zwischen den verfügbaren Fehlerdomänen am besten verwaltet. Dies gilt nur, wenn die Eigenschaft "virtualMachineScaleSet" dieses virtuellen Computers festgelegt ist. Die VM-Skalierungsgruppe, auf die verwiesen wird, muss "platformFaultDomainCount" größer als sein.
- Diese Eigenschaft kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Die Fehlerdomänenzuweisung kann in der Vm-Instanzansicht angezeigt werden. Api-Mindestversion: 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. Api-Mindestversion: 2021-03-01.
- capacity_reservation
- CapacityReservationProfile
Gibt Informationen zur Kapazitätsreservierung an, die zum Zuweisen des virtuellen Computers verwendet wird. Api-Mindestversion: 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. Api-Mindestversion: 2021-11-01.
Azure SDK for Python