Virtual Machines - Instance View
Ruft Informationen zum Laufzeitzustand eines virtuellen Computers ab.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2024-03-01
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
resource
|
path | True |
string |
Der Name der Ressourcengruppe. |
subscription
|
path | True |
string |
Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf. |
vm
|
path | True |
string |
Der Name des virtuellen Computers. |
api-version
|
query | True |
string |
Client-API-Version. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Fehlerantwort mit Beschreibung des Grunds für den Fehler. |
Sicherheit
azure_auth
Azure Active Directory-OAuth2-Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
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.
Sample Request
Sample Response
{
"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": "2024-03-01T23:11:22+00:00"
}
]
},
"disks": [
{
"name": "myOsDisk",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2024-03-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": "2024-03-01T21:30:12.8051917+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running"
}
]
}
Get Virtual Machine Instance View.
Sample Request
Sample Response
{
"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 |
Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer. |
Boot |
Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um vm-status zu diagnostizieren. Sie können die Ausgabe Ihres Konsolenprotokolls problemlos anzeigen. Mit Azure können Sie auch einen Screenshot des virtuellen Computers aus dem Hypervisor anzeigen. |
Cloud |
Eine Fehlerantwort des Computediensts. |
Disk |
Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. |
Disk |
Die Datenträgerinformationen des virtuellen Computers. |
Hyper |
Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist. |
Inner |
Innere Fehlerdetails. |
Instance |
Instanzansicht status. |
Key |
Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels in Key Vault an. |
Key |
Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an, bei dem es sich um einen Key Vault Geheimnis handelt. |
Last |
Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer. |
Maintenance |
Der Ergebniscode des letzten Wartungsvorgangs. |
Maintenance |
Der Wartungsvorgang status auf dem virtuellen Computer. |
Patch |
Der Gesamterfolg oder Fehler status des Vorgangs. Es bleibt "InProgress", bis der Vorgang abgeschlossen ist. An diesem Punkt wird es zu "Unbekannt", "Failed", "Succeeded" oder "CompletedWithWarnings". |
Status |
Der Ebenencode. |
Sub |
Die relative URL der Key Vault, die das Geheimnis enthält. |
Virtual |
Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird. |
Virtual |
Der Vm-Erweiterungshandler instance Ansicht. |
Virtual |
Die Erweiterungsinformationen. |
Virtual |
Die Integrität status für den virtuellen Computer. |
Virtual |
Die instance Ansicht eines virtuellen Computers. |
Virtual |
[Vorschaufunktion] Die status von Vm-Patchvorgängen. |
ApiError
API-Fehler.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Fehlercode. |
details |
Details zu API-Fehlern |
|
innererror |
Innerer 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 jeweiligen Fehlers. |
AvailablePatchSummary
Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer.
Name | Typ | Beschreibung |
---|---|---|
assessmentActivityId |
string |
Die Aktivitäts-ID des Vorgangs, der dieses Ergebnis erzeugt hat. Es wird verwendet, um CRP- und Erweiterungsprotokolle hinweg zu korrelieren. |
criticalAndSecurityPatchCount |
integer |
Die Anzahl kritischer Patches 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 Daten. |
|
lastModifiedTime |
string |
Der UTC-Zeitstempel, zu dem der Vorgang gestartet wurde. |
otherPatchCount |
integer |
Die Anzahl aller verfügbaren Patches mit Ausnahme von "Kritisch" und "Sicherheit". |
rebootPending |
boolean |
Der allgemeine Neustart status des virtuellen Computers. Dies trifft zu, wenn teilweise installierte Patches einen Neustart erfordern, um die Installation abzuschließen, der Neustart jedoch noch nicht erfolgt ist. |
startTime |
string |
Der UTC-Zeitstempel, zu dem der Vorgang gestartet wurde. |
status |
Der gesamte Erfolg oder Fehler status des Vorgangs. Es bleibt "InProgress", bis der Vorgang abgeschlossen ist. An diesem Punkt wird es zu "Unknown", "Failed", "Succeeded" oder "CompletedWithWarnings". |
BootDiagnosticsInstanceView
Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um vm-status zu diagnostizieren. Sie können die Ausgabe Ihres Konsolenprotokolls problemlos anzeigen. Mit Azure können Sie auch einen Screenshot des virtuellen Computers aus dem Hypervisor anzeigen.
Name | Typ | Beschreibung |
---|---|---|
consoleScreenshotBlobUri |
string |
Der Blob-URI der Konsole. Hinweis: Dies wird nicht festgelegt, wenn der Start Diagnose derzeit mit verwaltetem Speicher aktiviert ist. |
serialConsoleLogBlobUri |
string |
Der Protokollblob-URI der seriellen Konsole. Hinweis: Dies wird nicht festgelegt, wenn der Start Diagnose derzeit mit verwaltetem Speicher aktiviert ist. |
status |
Der Start Diagnose status Informationen für den virtuellen Computer. Hinweis: Sie wird nur festgelegt, wenn Fehler beim Aktivieren des Startvorgangs Diagnose auftreten. |
CloudError
Eine Fehlerantwort des Computediensts.
Name | Typ | Beschreibung |
---|---|---|
error |
API-Fehler. |
DiskEncryptionSettings
Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an.
Api-Mindestversion: 2015-06-15
Name | Typ | Beschreibung |
---|---|---|
diskEncryptionKey |
Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an, der ein Key Vault Geheimnis ist. |
|
enabled |
boolean |
Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll. |
keyEncryptionKey |
Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels in Key Vault an. |
DiskInstanceView
Die Datenträgerinformationen des virtuellen Computers.
Name | Typ | Beschreibung |
---|---|---|
encryptionSettings |
Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. |
|
name |
string |
Der Name des Datenträgers |
statuses |
Die Ressource status Informationen. |
HyperVGenerationType
Gibt den HyperVGeneration-Typ an, der einer Ressource zugeordnet ist.
Name | Typ | Beschreibung |
---|---|---|
V1 |
string |
|
V2 |
string |
InnerError
Innere Fehlerdetails.
Name | Typ | Beschreibung |
---|---|---|
errordetail |
string |
Das interne Fehlermeldungs- oder Ausnahmedump. |
exceptiontype |
string |
Der Ausnahmetyp. |
InstanceViewStatus
Instanzansicht status.
Name | Typ | Beschreibung |
---|---|---|
code |
string |
Der Statuscode. |
displayStatus |
string |
Die kurze lokalisierbare Bezeichnung für die status. |
level |
Der Ebenencode. |
|
message |
string |
Die detaillierte status Meldung, einschließlich Warnungen und Fehlermeldungen. |
time |
string |
Die Zeit der status. |
KeyVaultKeyReference
Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels in Key Vault an.
Name | Typ | Beschreibung |
---|---|---|
keyUrl |
string |
Die URL, die auf einen Schlüsselverschlüsselungsschlüssel in Key Vault verweist. |
sourceVault |
Die relative URL der Key Vault, die den Schlüssel enthält. |
KeyVaultSecretReference
Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an, bei dem es sich um einen Key Vault Geheimnis handelt.
Name | Typ | Beschreibung |
---|---|---|
secretUrl |
string |
Die URL, die auf ein Geheimnis in einer Key Vault verweist. |
sourceVault |
Die relative URL der Key Vault, die das Geheimnis enthält. |
LastPatchInstallationSummary
Die Installationszusammenfassung des neuesten Installationsvorgangs für den virtuellen Computer.
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 |
Die Anzahl aller verfügbaren Patches, die jedoch explizit durch eine vom Kunden angegebene Ausschlussliste übereinstimmen. |
failedPatchCount |
integer |
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 CRP- und Erweiterungsprotokolle hinweg zu korrelieren. |
installedPatchCount |
integer |
Die Anzahl der Patches, die erfolgreich installiert wurden. |
lastModifiedTime |
string |
Der UTC-Zeitstempel, zu dem der Vorgang gestartet wurde. |
maintenanceWindowExceeded |
boolean |
Beschreibt, ob der Vorgang keine Zeit mehr hatte, bevor er alle beabsichtigten Aktionen abgeschlossen hat. |
notSelectedPatchCount |
integer |
Die Anzahl aller verfügbaren Patches, die jedoch nicht installiert werden sollen, da sie nicht mit einem Klassifizierungs- oder Einschlusslisteneintrag übereinstimmten. |
pendingPatchCount |
integer |
Die Anzahl aller verfügbaren Patches, die während des Patchinstallationsvorgangs installiert werden sollen. |
startTime |
string |
Der UTC-Zeitstempel, zu dem der Vorgang gestartet wurde. |
status |
Der Gesamterfolg oder Fehler status des Vorgangs. Es bleibt "InProgress", bis der Vorgang abgeschlossen ist. An diesem Punkt wird es zu "Unbekannt", "Failed", "Succeeded" oder "CompletedWithWarnings". |
MaintenanceOperationResultCodeTypes
Der Ergebniscode des letzten Wartungsvorgangs.
Name | Typ | Beschreibung |
---|---|---|
MaintenanceAborted |
string |
|
MaintenanceCompleted |
string |
|
None |
string |
|
RetryLater |
string |
MaintenanceRedeployStatus
Der Wartungsvorgang status auf dem virtuellen Computer.
Name | Typ | Beschreibung |
---|---|---|
isCustomerInitiatedMaintenanceAllowed |
boolean |
True, wenn der Kunde die Wartung durchführen darf. |
lastOperationMessage |
string |
Meldung, die für den letzten Wartungsvorgang zurückgegeben wird. |
lastOperationResultCode |
Der Ergebniscode des letzten Wartungsvorgangs. |
|
maintenanceWindowEndTime |
string |
Endzeit für das Wartungsfenster. |
maintenanceWindowStartTime |
string |
Startzeit für das Wartungsfenster. |
preMaintenanceWindowEndTime |
string |
Endzeit für das Fenster "Vorwartung". |
preMaintenanceWindowStartTime |
string |
Startzeit für das Fenster vor der Wartung. |
PatchOperationStatus
Der Gesamterfolg oder Fehler status des Vorgangs. Es bleibt "InProgress", bis der Vorgang abgeschlossen ist. An diesem Punkt wird es zu "Unbekannt", "Failed", "Succeeded" oder "CompletedWithWarnings".
Name | Typ | Beschreibung |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
StatusLevelTypes
Der Ebenencode.
Name | Typ | Beschreibung |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResource
Die relative URL der Key Vault, die das Geheimnis enthält.
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Ressourcen-ID |
VirtualMachineAgentInstanceView
Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird.
Name | Typ | Beschreibung |
---|---|---|
extensionHandlers |
Der Vm-Erweiterungshandler instance Ansicht. |
|
statuses |
Die Ressource status Informationen. |
|
vmAgentVersion |
string |
Die Vollversion des VM-Agents. |
VirtualMachineExtensionHandlerInstanceView
Der Vm-Erweiterungshandler instance Ansicht.
Name | Typ | Beschreibung |
---|---|---|
status |
Der Erweiterungshandler status. |
|
type |
string |
Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". |
typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |
VirtualMachineExtensionInstanceView
Die Erweiterungsinformationen.
Name | Typ | Beschreibung |
---|---|---|
name |
string |
Der Name der VM-Erweiterung. |
statuses |
Die Ressource status Informationen. |
|
substatuses |
Die Ressource status Informationen. |
|
type |
string |
Gibt den Typ der Erweiterung an. Ein Beispiel ist "CustomScriptExtension". |
typeHandlerVersion |
string |
Gibt die Version des Skripthandlers an. |
VirtualMachineHealthStatus
Die Integrität status für den virtuellen Computer.
Name | Typ | Beschreibung |
---|---|---|
status |
Die Integrität status Informationen für den virtuellen Computer. |
VirtualMachineInstanceView
Die instance Ansicht eines virtuellen Computers.
Name | Typ | Beschreibung |
---|---|---|
assignedHost |
string |
Ressourcen-ID des dedizierten Hosts, auf dem der virtuelle Computer durch automatische Platzierung zugeordnet wird, wenn der virtuelle Computer einer dedizierten Hostgruppe zugeordnet ist, für die die automatische Platzierung aktiviert ist. Api-Mindestversion: 2020-06-01. |
bootDiagnostics |
Die Startdiagnose ist ein Debugfeature, mit dem Sie die Konsolenausgabe und den Screenshot anzeigen können, um vm-status zu diagnostizieren. Sie können die Ausgabe Ihres Konsolenprotokolls problemlos anzeigen. Mit Azure können Sie auch einen Screenshot des virtuellen Computers aus dem Hypervisor anzeigen. |
|
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 |
[Vorschaufunktion] Gibt an, ob sich der virtuelle Computer derzeit im Standbypool befindet oder nicht. |
maintenanceRedeployStatus |
Der Wartungsvorgang status 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 |
[Vorschaufunktion] Die status von Vm-Patchvorgängen. |
|
platformFaultDomain |
integer |
Gibt die Fehlerdomäne des virtuellen Computers an. |
platformUpdateDomain |
integer |
Gibt die Updatedomäne des virtuellen Computers an. |
rdpThumbPrint |
string |
Der Remotedesktop-Zertifikatfingerabdruck. |
statuses |
Die Ressource status Informationen. |
|
vmAgent |
Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird. |
|
vmHealth |
Die Integrität status für den virtuellen Computer. |
VirtualMachinePatchStatus
[Vorschaufunktion] Die status von Vm-Patchvorgängen.
Name | Typ | Beschreibung |
---|---|---|
availablePatchSummary |
Die verfügbare Patchzusammenfassung des neuesten Bewertungsvorgangs für den virtuellen Computer. |
|
configurationStatuses |
Die aktivierungs-status des angegebenen patchMode |
|
lastPatchInstallationSummary |
Die Installationszusammenfassung des letzten Installationsvorgangs für den virtuellen Computer. |