Virtual Machines - Instance View
Ruft Informationen über den Laufzeitstatus eines virtuellen Computers ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2025-11-01
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
|
vm
|
path | True |
string |
Der Name des virtuellen Computers. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Azure-Operation erfolgreich abgeschlossen. |
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
| Get instance view of a virtual machine placed on a dedicated host group through automatic placement. |
| Get Virtual Machine Instance View. |
Get instance view of a virtual machine placed on a dedicated host group through automatic placement.
Beispielanforderung
Beispiel für eine Antwort
{
"computerName": "myVM",
"osName": "Windows Server 2016 Datacenter",
"osVersion": "Microsoft Windows NT 10.0.14393.0",
"vmAgent": {
"vmAgentVersion": "2.7.41491.949",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Ready",
"message": "GuestAgent is running and accepting new configurations.",
"time": "2025-04-01T23:11:22+00:00"
}
]
},
"disks": [
{
"name": "myOsDisk",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2025-04-01T21:29:47.477089+00:00"
}
]
}
],
"hyperVGeneration": "V1",
"assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2025-04-01T21:30:12.8051917+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running"
}
]
}
Get Virtual Machine Instance View.
Beispielanforderung
Beispiel für eine Antwort
{
"platformUpdateDomain": 1,
"platformFaultDomain": 1,
"computerName": "myVM",
"osName": "Windows Server 2016 Datacenter",
"osVersion": "Microsoft Windows NT 10.0.14393.0",
"vmAgent": {
"vmAgentVersion": "2.7.41491.949",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Ready",
"message": "GuestAgent is running and accepting new configurations.",
"time": "2019-10-14T23:11:22+00:00"
}
],
"extensionHandlers": [
{
"type": "Microsoft.Azure.Security.IaaSAntimalware",
"typeHandlerVersion": "1.5.5.9",
"status": {
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Ready"
}
}
]
},
"disks": [
{
"name": "myOsDisk",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2019-10-14T21:29:47.477089+00:00"
}
]
},
{
"name": "myDataDisk0",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2019-10-14T21:29:47.461517+00:00"
}
]
}
],
"bootDiagnostics": {
"consoleScreenshotBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.screenshot.bmp",
"serialConsoleLogBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.serialconsole.log"
},
"extensions": [
{
"name": "IaaSAntiMalware-ext0",
"type": "Microsoft.Azure.Security.IaaSAntimalware",
"typeHandlerVersion": "1.5.5.9",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"message": "Microsoft Antimalware enabled"
}
]
}
],
"hyperVGeneration": "V1",
"patchStatus": {
"availablePatchSummary": {
"status": "Succeeded",
"assessmentActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"rebootPending": true,
"criticalAndSecurityPatchCount": 1,
"otherPatchCount": 2,
"startTime": "2020-04-24T21:02:04.2556154Z",
"lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
"error": null
},
"lastPatchInstallationSummary": {
"status": "Succeeded",
"installationActivityId": "68f8b292-dfc2-4646-9981-33cc88631968",
"maintenanceWindowExceeded": false,
"notSelectedPatchCount": 1,
"excludedPatchCount": 1,
"pendingPatchCount": 1,
"installedPatchCount": 1,
"failedPatchCount": 1,
"startTime": "2020-04-24T21:02:04.2556154Z",
"lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
"error": null
},
"configurationStatuses": [
{
"code": "PatchModeConfigurationState/Ready",
"level": "Info",
"displayStatus": "Status_PatchModeConfigurationState_Ready",
"time": "2020-04-24T21:02:04.2556154Z"
},
{
"code": "AssessmentModeConfigurationState/Pending",
"level": "Info",
"displayStatus": "Status_AssessmentModeConfigurationState_Pending",
"time": "2020-04-24T21:02:04.2556154Z"
}
]
},
"isVMInStandbyPool": false,
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2019-10-14T21:30:12.8051917+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running"
}
]
}
Definitionen
| Name | Beschreibung |
|---|---|
|
Api |
API-Fehler. |
|
Api |
API-Fehlerbasis. |
|
Available |
Beschreibt die Eigenschaften einer Instanzansicht eines virtuellen Computers für die verfügbare Patchzusammenfassung. |
|
Boot |
Die Instanzansicht einer Startdiagnose eines virtuellen Computers. |
|
Cloud |
Eine Fehlerantwort vom Compute-Dienst. |
|
Disk |
Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger |
|
Disk |
Die Instanzansicht des Datenträgers. |
|
Hyper |
Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist. |
|
Inner |
Innere Fehlerdetails. |
|
Instance |
Instanzansichtsstatus. |
|
Key |
Beschreibt einen Verweis auf Key Vault Key |
|
Key |
Beschreibt einen Verweis auf Key Vault Secret |
|
Last |
Beschreibt die Eigenschaften der letzten installierten Patchzusammenfassung. |
|
Maintenance |
Der letzte Ergebniscode des Wartungsvorgangs. |
|
Maintenance |
Wartungsvorgangsstatus. |
|
Patch |
Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden. |
|
Status |
Der Ebenencode. |
|
Storage |
Spezifiziert den Speicherausrichtungsstatus für die Festplatte. |
|
Sub |
|
|
Virtual |
Die Instanzansicht des VM-Agents, der auf dem virtuellen Computer ausgeführt wird. |
|
Virtual |
Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer. |
|
Virtual |
Die Instanzansicht einer Erweiterung eines virtuellen Computers. |
|
Virtual |
Der Integritätsstatus des virtuellen Computers. |
|
Virtual |
Die Instanzansicht eines virtuellen Computers. |
|
Virtual |
Der Status von Patchvorgängen für virtuelle Computer. |
ApiError
API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| details |
Die Details zum API-Fehler |
|
| innererror |
Der innere API-Fehler |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
ApiErrorBase
API-Fehlerbasis.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
AvailablePatchSummary
Beschreibt die Eigenschaften einer Instanzansicht eines virtuellen Computers für die verfügbare Patchzusammenfassung.
| Name | Typ | Beschreibung |
|---|---|---|
| assessmentActivityId |
string |
Die Aktivitäts-ID des Vorgangs, der dieses Ergebnis erzeugt hat. Es wird verwendet, um in CRP- und Erweiterungsprotokollen zu korrelieren. |
| criticalAndSecurityPatchCount |
integer (int32) |
Die Anzahl kritischer oder Sicherheitspatches, die als verfügbar erkannt und noch nicht installiert wurden. |
| error |
Die Fehler, die während der Ausführung des Vorgangs aufgetreten sind. Das Detailarray enthält die Liste dieser Elemente. |
|
| lastModifiedTime |
string (date-time) |
Der UTC-Zeitstempel, als der Vorgang begonnen hat. |
| otherPatchCount |
integer (int32) |
Die Anzahl aller verfügbaren Patches mit Ausnahme kritischer und sicherheitsrelevanter Patches. |
| rebootPending |
boolean |
Der allgemeine Neustartstatus der VM. Es trifft zu, wenn teilweise installierte Patches einen Neustart erfordern, um die Installation abzuschließen, aber der Neustart ist noch nicht aufgetreten. |
| startTime |
string (date-time) |
Der UTC-Zeitstempel, als der Vorgang begonnen hat. |
| status |
Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden. |
BootDiagnosticsInstanceView
Die Instanzansicht einer Startdiagnose eines virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| consoleScreenshotBlobUri |
string |
Der Blob-URI des Konsolenfotos. Hinweis: Dies wird nicht festgelegt, wenn die Startdiagnose derzeit mit verwaltetem Speicher aktiviert ist. |
| serialConsoleLogBlobUri |
string |
Der BLOB-Uri der seriellen Konsole. Hinweis: Dies wird nicht festgelegt, wenn die Startdiagnose derzeit mit verwaltetem Speicher aktiviert ist. |
| status |
Die Statusinformationen zur Startdiagnose für den virtuellen Computer. Hinweis: Es wird nur festgelegt, wenn Fehler beim Aktivieren der Startdiagnose aufgetreten sind. |
CloudError
Eine Fehlerantwort vom Compute-Dienst.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
API-Fehler. |
DiskEncryptionSettings
Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger
| Name | Typ | Beschreibung |
|---|---|---|
| diskEncryptionKey |
Spezifiziert den Standort des Festplatten-Verschlüsselungsschlüssels, der ein Key Vault Secret ist. |
|
| enabled |
boolean |
Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll. |
| keyEncryptionKey |
Spezifiziert den Standort des Schlüsselverschlüsselungsschlüssels in Key Vault. |
DiskInstanceView
Die Instanzansicht des Datenträgers.
| Name | Typ | Beschreibung |
|---|---|---|
| encryptionSettings |
Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. |
|
| name |
string |
Der Datenträgername. |
| statuses |
Die Ressourcenstatusinformationen. |
|
| storageAlignmentStatus |
Spezifiziert den Speicherausrichtungsstatus für die Festplatte. |
HyperVGenerationType
Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist.
| Wert | Beschreibung |
|---|---|
| V1 | |
| V2 |
InnerError
Innere Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errordetail |
string |
Die interne Fehlermeldung oder der Ausnahmedump. |
| exceptiontype |
string |
Der Ausnahmetyp. |
InstanceViewStatus
Instanzansichtsstatus.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Statuscode. |
| displayStatus |
string |
Die kurze lokalisierbare Bezeichnung für den Status. |
| level |
Der Ebenencode. |
|
| message |
string |
Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen. |
| time |
string (date-time) |
Die Uhrzeit des Status. |
KeyVaultKeyReference
Beschreibt einen Verweis auf Key Vault Key
| Name | Typ | Beschreibung |
|---|---|---|
| keyUrl |
string |
Die URL, die auf einen Schlüsselverschlüsselungsschlüssel in Key Vault verweist. |
| sourceVault |
Die relative URL des Key Vault, der den Schlüssel enthält. |
KeyVaultSecretReference
Beschreibt einen Verweis auf Key Vault Secret
| Name | Typ | Beschreibung |
|---|---|---|
| secretUrl |
string |
Die URL bezieht sich auf ein Geheimnis in einem Key Vault. |
| sourceVault |
Die relative URL des Key Vault, der das Geheimnis enthält. |
LastPatchInstallationSummary
Beschreibt die Eigenschaften der letzten installierten Patchzusammenfassung.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
Die Fehler, die während der Ausführung des Vorgangs aufgetreten sind. Das Detailarray enthält die Liste dieser Elemente. |
|
| excludedPatchCount |
integer (int32) |
Die Anzahl aller verfügbaren Patches, aber explizit von einer vom Kunden angegebenen Ausschlussliste ausgeschlossen. |
| failedPatchCount |
integer (int32) |
Die Anzahl der Patches, bei denen die Installation fehlgeschlagen ist. |
| installationActivityId |
string |
Die Aktivitäts-ID des Vorgangs, der dieses Ergebnis erzeugt hat. Es wird verwendet, um in CRP- und Erweiterungsprotokollen zu korrelieren. |
| installedPatchCount |
integer (int32) |
Die Anzahl der Patches, die erfolgreich installiert wurden. |
| lastModifiedTime |
string (date-time) |
Der UTC-Zeitstempel, als der Vorgang begonnen hat. |
| maintenanceWindowExceeded |
boolean |
Beschreibt, ob der Vorgang nicht mehr genügend Zeit hat, bevor er alle beabsichtigten Aktionen abgeschlossen hat. |
| notSelectedPatchCount |
integer (int32) |
Die Anzahl aller verfügbaren Patches, aber nicht installiert werden, da sie nicht mit einem Eintrag für Klassifizierungen oder Einschlusslisten übereinstimmte. |
| pendingPatchCount |
integer (int32) |
Die Anzahl aller verfügbaren Patches, die im Verlauf des Patchinstallationsvorgangs installiert werden sollen. |
| startTime |
string (date-time) |
Der UTC-Zeitstempel, als der Vorgang begonnen hat. |
| status |
Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden. |
MaintenanceOperationResultCodeTypes
Der letzte Ergebniscode des Wartungsvorgangs.
| Wert | Beschreibung |
|---|---|
| None | |
| RetryLater | |
| MaintenanceAborted | |
| MaintenanceCompleted |
MaintenanceRedeployStatus
Wartungsvorgangsstatus.
| Name | Typ | Beschreibung |
|---|---|---|
| isCustomerInitiatedMaintenanceAllowed |
boolean |
True, wenn der Kunde Wartungsvorgänge durchführen darf. |
| lastOperationMessage |
string |
Die Nachricht, die für den letzten Wartungsvorgang zurückgegeben wurde. |
| lastOperationResultCode |
Der letzte Ergebniscode des Wartungsvorgangs. |
|
| maintenanceWindowEndTime |
string (date-time) |
Endzeit für das Wartungsfenster. |
| maintenanceWindowStartTime |
string (date-time) |
Startzeit für das Wartungsfenster. |
| preMaintenanceWindowEndTime |
string (date-time) |
Endzeit für das Fenster vor der Wartung. |
| preMaintenanceWindowStartTime |
string (date-time) |
Startzeit für das Fenster vor der Wartung. |
PatchOperationStatus
Der Gesamterfolgs- oder Fehlerstatus des Vorgangs. Es bleibt "InProgress" bis zum Abschluss des Vorgangs. An diesem Punkt wird es zu "Unbekannt", "Fehlgeschlagen", "Erfolgreich" oder "CompletedWithWarnings" werden.
| Wert | Beschreibung |
|---|---|
| Unknown | |
| InProgress | |
| Failed | |
| Succeeded | |
| CompletedWithWarnings |
StatusLevelTypes
Der Ebenencode.
| Wert | Beschreibung |
|---|---|
| Info | |
| Warning | |
| Error |
StorageAlignmentStatus
Spezifiziert den Speicherausrichtungsstatus für die Festplatte.
| Wert | Beschreibung |
|---|---|
| Unaligned |
Die Festplatte hat keine Zuordnung von Storage Fault Domain zur Berechnung der Fehlerdomäne. Ein einzelner Speicherfehler-Domain-Fehler kann alle VMs betreffen, die auf dieses Festplattenprofil verweisen. |
| Aligned |
Die Festplatte hat Storage Fault Domain zur Berechnung der Fehlerdomänen-Mapping. Der Speicherfehler-Domain-Fehler ist auf VMs in einer einzigen Compute-Fehlerdomäne beschränkt. |
SubResource
| Name | Typ | Beschreibung |
|---|---|---|
| id |
string |
Ressourcen-ID |
VirtualMachineAgentInstanceView
Die Instanzansicht des VM-Agents, der auf dem virtuellen Computer ausgeführt wird.
| Name | Typ | Beschreibung |
|---|---|---|
| extensionHandlers |
Die Instanzansicht der Erweiterungshandler für virtuelle Computer. |
|
| statuses |
Die Ressourcenstatusinformationen. |
|
| vmAgentVersion |
string |
Die Vollversion des VM-Agents. |
VirtualMachineExtensionHandlerInstanceView
Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer.
| Name | Typ | Beschreibung |
|---|---|---|
| status |
Der Erweiterungshandlerstatus. |
|
| type |
string |
Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". |
| typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |
VirtualMachineExtensionInstanceView
Die Instanzansicht einer Erweiterung eines virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| name |
string |
Der Erweiterungsname des virtuellen Computers. |
| statuses |
Die Ressourcenstatusinformationen. |
|
| substatuses |
Die Ressourcenstatusinformationen. |
|
| type |
string |
Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension". |
| typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |
VirtualMachineHealthStatus
Der Integritätsstatus des virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| status |
Die Integritätsstatusinformationen für den virtuellen Computer. |
VirtualMachineInstanceView
Die Instanzansicht eines virtuellen Computers.
| Name | Typ | Beschreibung |
|---|---|---|
| assignedHost |
string |
Ressourcen-ID des dedizierten Hosts, auf dem der virtuelle Computer über die automatische Platzierung zugewiesen wird, wenn der virtuelle Computer einer dedizierten Hostgruppe zugeordnet ist, für die die automatische Platzierung aktiviert ist. Mindest-API-Version: 2020-06-01. |
| bootDiagnostics |
Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um den VM-Status zu diagnostizieren. Sie können die Ausgabe ihres Konsolenprotokolls ganz einfach anzeigen. Azure ermöglicht es Ihnen außerdem, einen Screenshot der VM vom Hypervisor aus zu sehen. |
|
| computerName |
string |
Der Computername, der dem virtuellen Computer zugewiesen ist. |
| disks |
Die Datenträgerinformationen des virtuellen Computers. |
|
| extensions |
Die Erweiterungsinformationen. |
|
| hyperVGeneration |
Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist. |
|
| isVMInStandbyPool |
boolean |
[Vorschaufeature] Gibt an, ob sich der virtuelle Computer derzeit im Standbypool befindet oder nicht. |
| maintenanceRedeployStatus |
Der Wartungsvorgangsstatus auf dem virtuellen Computer. |
|
| osName |
string |
Das Betriebssystem, das auf dem virtuellen Computer ausgeführt wird. |
| osVersion |
string |
Die Version des Betriebssystems, das auf dem virtuellen Computer ausgeführt wird. |
| patchStatus |
[Vorschaufeature] Der Status von Patchvorgängen für virtuelle Computer. |
|
| platformFaultDomain |
integer (int32) |
Gibt die Fehlerdomäne des virtuellen Computers an. |
| platformUpdateDomain |
integer (int32) |
Gibt die Updatedomäne des virtuellen Computers an. |
| rdpThumbPrint |
string |
Fingerabdruck des Remotedesktopzertifikats. |
| statuses |
Die Ressourcenstatusinformationen. |
|
| vmAgent |
Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird. |
|
| vmHealth |
Der Integritätsstatus für den virtuellen Computer. |
VirtualMachinePatchStatus
Der Status von Patchvorgängen für virtuelle Computer.
| Name | Typ | Beschreibung |
|---|---|---|
| availablePatchSummary |
Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer. |
|
| configurationStatuses |
Der Aktivierungsstatus des angegebenen patchMode |
|
| lastPatchInstallationSummary |
Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer. |