Virtual Machines - Instance View

Servizio:: Compute

Versione API:: 2025-11-01

Recupera informazioni sullo stato di runtime di una macchina virtuale.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2025-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
vmName	path	True	string	Nome della macchina virtuale.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	VirtualMachineInstanceView	Operazione Azure completata con successo.
Other Status Codes	CloudError	Risposta di errore imprevista.

Sicurezza

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

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.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2025-11-01

Risposta di esempio

Codice di stato:: 200

{
  "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.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2025-11-01

Risposta di esempio

Codice di stato:: 200

{
  "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"
    }
  ]
}

Definizioni

Nome	Descrizione
ApiError	Errore API.
ApiErrorBase	Base di errore API.
AvailablePatchSummary	Descrive le proprietà di una visualizzazione dell'istanza di macchina virtuale per il riepilogo delle patch disponibili.
BootDiagnosticsInstanceView	Visualizzazione dell'istanza di diagnostica di avvio di una macchina virtuale.
CloudError	Risposta di errore dal servizio di calcolo.
DiskEncryptionSettings	Descrive le impostazioni di crittografia per un disco
DiskInstanceView	Visualizzazione dell'istanza del disco.
HyperVGenerationType	Specifica il tipo di HyperVGeneration associato a una risorsa
InnerError	Dettagli dell'errore interno.
InstanceViewStatus	Stato di visualizzazione dell'istanza.
KeyVaultKeyReference	Descrive un riferimento a Key Vault Key
KeyVaultSecretReference	Descrive un riferimento a Key Vault Secret
LastPatchInstallationSummary	Descrive le proprietà dell'ultimo riepilogo della patch installata.
MaintenanceOperationResultCodeTypes	Codice risultato dell'ultima operazione di manutenzione.
MaintenanceRedeployStatus	Stato dell'operazione di manutenzione.
PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "In corso" fino al completamento dell'operazione. A quel punto diventerà "Sconosciuto", "Non riuscito", "Riuscito" o "Completato conavvisi".
StatusLevelTypes	Codice a livello.
StorageAlignmentStatus	Specifica lo stato di allineamento dello storage per il disco.
SubResource
VirtualMachineAgentInstanceView	Visualizzazione dell'istanza dell'agente di macchine virtuali in esecuzione nella macchina virtuale.
VirtualMachineExtensionHandlerInstanceView	Visualizzazione dell'istanza di un gestore di estensioni di una macchina virtuale.
VirtualMachineExtensionInstanceView	Visualizzazione dell'istanza di un'estensione macchina virtuale.
VirtualMachineHealthStatus	Stato di integrità della macchina virtuale.
VirtualMachineInstanceView	Visualizzazione dell'istanza di una macchina virtuale.
VirtualMachinePatchStatus	Stato delle operazioni di patch della macchina virtuale.

ApiError

Oggetto

Errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore Api
innererror	InnerError	L'errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

AvailablePatchSummary

Oggetto

Descrive le proprietà di una visualizzazione dell'istanza di macchina virtuale per il riepilogo delle patch disponibili.

Nome	Tipo	Descrizione
assessmentActivityId	string	ID attività dell'operazione che ha prodotto il risultato. Viene utilizzato per correlare i registri CRP e di estensione.
criticalAndSecurityPatchCount	integer (int32)	Il numero di patch critiche o di sicurezza che sono state rilevate come disponibili e non ancora installate.
error	ApiError	Gli errori riscontrati durante l'esecuzione dell'operazione. L'array dei dettagli contiene l'elenco di essi.
lastModifiedTime	string (date-time)	Il timestamp UTC all'inizio dell'operazione.
otherPatchCount	integer (int32)	Il numero di tutte le patch disponibili, escluse quelle critiche e di sicurezza.
rebootPending	boolean	Stato generale di riavvio della macchina virtuale. Sarà vero quando le patch parzialmente installate richiedono un riavvio per completare l'installazione, ma il riavvio non è ancora avvenuto.
startTime	string (date-time)	Il timestamp UTC all'inizio dell'operazione.
status	PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "In corso" fino al completamento dell'operazione. A quel punto diventerà "Sconosciuto", "Non riuscito", "Riuscito" o "Completato conavvisi".

BootDiagnosticsInstanceView

Oggetto

Visualizzazione dell'istanza di diagnostica di avvio di una macchina virtuale.

Nome	Tipo	Descrizione
consoleScreenshotBlobUri	string	URI del BLOB dello screenshot della console. Nota: Questa impostazione non verrà impostata se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
serialConsoleLogBlobUri	string	URI del BLOB di log della console seriale. Nota: Questa impostazione non verrà impostata se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
status	InstanceViewStatus	Informazioni sullo stato della diagnostica di avvio per la macchina virtuale. Nota: Verrà impostato solo se si verificano errori nell'abilitazione della diagnostica di avvio.

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

DiskEncryptionSettings

Oggetto

Descrive le impostazioni di crittografia per un disco

Nome	Tipo	Descrizione
diskEncryptionKey	KeyVaultSecretReference	Specifica la posizione della chiave di crittografia del disco, che è un Key Vault Secret.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica la posizione della chiave di crittografia della chiave in Key Vault.

DiskInstanceView

Oggetto

Visualizzazione dell'istanza del disco.

Nome	Tipo	Descrizione
encryptionSettings	DiskEncryptionSettings[]	Specifica le impostazioni di crittografia per il disco del sistema operativo. Versione minima api: 2015-06-15
name	string	Nome del disco.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
storageAlignmentStatus	StorageAlignmentStatus	Specifica lo stato di allineamento dello storage per il disco.

HyperVGenerationType

Enumerazione

Specifica il tipo di HyperVGeneration associato a una risorsa

Valore	Descrizione
V1
V2

InnerError

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

InstanceViewStatus

Oggetto

Stato di visualizzazione dell'istanza.

Nome	Tipo	Descrizione
code	string	Codice di stato.
displayStatus	string	Etichetta localizzabile breve per lo stato.
level	StatusLevelTypes	Codice a livello.
message	string	Messaggio di stato dettagliato, inclusi gli avvisi e i messaggi di errore.
time	string (date-time)	Ora dello stato.

KeyVaultKeyReference

Oggetto

Descrive un riferimento a Key Vault Key

Nome	Tipo	Descrizione
keyUrl	string	L'URL che fa riferimento a una chiave di cifratura della chiave in Key Vault.
sourceVault	SubResource	L'URL relativo del Key Vault che contiene la chiave.

KeyVaultSecretReference

Oggetto

Descrive un riferimento a Key Vault Secret

Nome	Tipo	Descrizione
secretUrl	string	L'URL che fa riferimento a un segreto in un Key Vault.
sourceVault	SubResource	L'URL relativo del Key Vault che contiene il segreto.

LastPatchInstallationSummary

Oggetto

Descrive le proprietà dell'ultimo riepilogo della patch installata.

Nome	Tipo	Descrizione
error	ApiError	Gli errori riscontrati durante l'esecuzione dell'operazione. L'array dei dettagli contiene l'elenco di essi.
excludedPatchCount	integer (int32)	Il numero di tutte le patch disponibili, ma escluse in modo esplicito da un elenco di esclusione specificato dal cliente, corrisponde.
failedPatchCount	integer (int32)	Il conteggio delle patch che non sono state installate.
installationActivityId	string	ID attività dell'operazione che ha prodotto il risultato. Viene utilizzato per correlare i registri CRP e di estensione.
installedPatchCount	integer (int32)	Il numero di patch installate correttamente.
lastModifiedTime	string (date-time)	Il timestamp UTC all'inizio dell'operazione.
maintenanceWindowExceeded	boolean	Viene descritto se l'operazione ha esaurito il tempo prima di completare tutte le azioni previste
notSelectedPatchCount	integer (int32)	Il numero di tutte le patch disponibili ma che non verranno installate perché non corrispondono a una voce dell'elenco di classificazione o inclusione.
pendingPatchCount	integer (int32)	Il numero di tutte le patch disponibili che si prevede di installare nel corso dell'operazione di installazione della patch.
startTime	string (date-time)	Il timestamp UTC all'inizio dell'operazione.
status	PatchOperationStatus	Stato complessivo di esito positivo o negativo dell'operazione. Rimane "In corso" fino al completamento dell'operazione. A quel punto diventerà "Sconosciuto", "Non riuscito", "Riuscito" o "Completato conavvisi".

MaintenanceOperationResultCodeTypes

Enumerazione

Codice risultato dell'ultima operazione di manutenzione.

Valore	Descrizione
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Oggetto

Stato dell'operazione di manutenzione.

Nome	Tipo	Descrizione
isCustomerInitiatedMaintenanceAllowed	boolean	Vero, se il Cliente è autorizzato a eseguire la Manutenzione.
lastOperationMessage	string	Messaggio restituito per l'ultima operazione di manutenzione.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	Codice risultato dell'ultima operazione di manutenzione.
maintenanceWindowEndTime	string (date-time)	Ora di fine per la finestra di manutenzione.
maintenanceWindowStartTime	string (date-time)	Ora di inizio per la finestra di manutenzione.
preMaintenanceWindowEndTime	string (date-time)	Ora di fine per la finestra di pre-manutenzione.
preMaintenanceWindowStartTime	string (date-time)	Ora di inizio per la finestra di pre-manutenzione.

PatchOperationStatus

Enumerazione

Stato complessivo di esito positivo o negativo dell'operazione. Rimane "In corso" fino al completamento dell'operazione. A quel punto diventerà "Sconosciuto", "Non riuscito", "Riuscito" o "Completato conavvisi".

Valore	Descrizione
Unknown
InProgress
Failed
Succeeded
CompletedWithWarnings

StatusLevelTypes

Enumerazione

Codice a livello.

Valore	Descrizione
Info
Warning
Error

StorageAlignmentStatus

Enumerazione

Specifica lo stato di allineamento dello storage per il disco.

Valore	Descrizione
Unaligned	Il disco non dispone di Storage Fault Domain per Calcolare la mappatura del Fault Domain. Un singolo guasto del Dominio di Errore di Memoria può colpire tutte le VM che fanno riferimento a questo profilo disco.
Aligned	Il disco ha il Dominio di Errore di Memoria per Calcolare la mappatura del Dominio di Errore. Il fallimento del dominio di errore di memoria è contenuto nelle VM in un singolo dominio di errore di calcolo.

SubResource

Oggetto

Nome	Tipo	Descrizione
id	string	ID risorsa

VirtualMachineAgentInstanceView

Oggetto

Visualizzazione dell'istanza dell'agente di macchine virtuali in esecuzione nella macchina virtuale.

Nome	Tipo	Descrizione
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Visualizzazione dell'istanza del gestore dell'estensione della macchina virtuale.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgentVersion	string	La versione completa dell'agente di macchine virtuali.

VirtualMachineExtensionHandlerInstanceView

Oggetto

Visualizzazione dell'istanza di un gestore di estensioni di una macchina virtuale.

Nome	Tipo	Descrizione
status	InstanceViewStatus	Stato del gestore di estensioni.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

VirtualMachineExtensionInstanceView

Oggetto

Visualizzazione dell'istanza di un'estensione macchina virtuale.

Nome	Tipo	Descrizione
name	string	Nome dell'estensione della macchina virtuale.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
substatuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
type	string	Specifica il tipo di estensione; un esempio è "CustomScriptExtension".
typeHandlerVersion	string	Specifica la versione del gestore di script.

VirtualMachineHealthStatus

Oggetto

Stato di integrità della macchina virtuale.

Nome	Tipo	Descrizione
status	InstanceViewStatus	Informazioni sullo stato di integrità della macchina virtuale.

VirtualMachineInstanceView

Oggetto

Visualizzazione dell'istanza di una macchina virtuale.

Nome	Tipo	Descrizione
assignedHost	string	ID risorsa dell'host dedicato, in cui viene allocata la macchina virtuale tramite selezione host automatica, quando la macchina virtuale è associata a un gruppo host dedicato in cui è abilitata la selezione host automatica. Versione minima api: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Diagnostica di avvio è una funzionalità di debug che consente di visualizzare l'output e lo screenshot della console per diagnosticare lo stato della macchina virtuale. È possibile visualizzare facilmente l'output del log della console. Azure ti permette anche di vedere uno screenshot della VM dall'hypervisor.
computerName	string	Nome del computer assegnato alla macchina virtuale.
disks	DiskInstanceView[]	Informazioni sul disco della macchina virtuale.
extensions	VirtualMachineExtensionInstanceView[]	Le informazioni sulle estensioni.
hyperVGeneration	HyperVGenerationType	Specifica il tipo di HyperVGeneration associato a una risorsa
isVMInStandbyPool	boolean	[Funzione di anteprima] Specifica se la macchina virtuale si trova attualmente all'interno o all'esterno del pool di standby.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Stato dell'operazione di manutenzione nella macchina virtuale.
osName	string	Sistema operativo in esecuzione nella macchina virtuale.
osVersion	string	La versione del sistema operativo in esecuzione nella macchina virtuale.
patchStatus	VirtualMachinePatchStatus	[Funzione di anteprima] Stato delle operazioni di patch della macchina virtuale.
platformFaultDomain	integer (int32)	Specifica il dominio di errore della macchina virtuale.
platformUpdateDomain	integer (int32)	Specifica il dominio di aggiornamento della macchina virtuale.
rdpThumbPrint	string	Identificazione personale del certificato Desktop remoto.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgent	VirtualMachineAgentInstanceView	L'agente di macchine virtuali in esecuzione nella macchina virtuale.
vmHealth	VirtualMachineHealthStatus	Stato di integrità della macchina virtuale.

VirtualMachinePatchStatus

Oggetto

Stato delle operazioni di patch della macchina virtuale.

Nome	Tipo	Descrizione
availablePatchSummary	AvailablePatchSummary	Riepilogo delle patch disponibili dell'operazione di valutazione più recente per la macchina virtuale.
configurationStatuses	InstanceViewStatus[]	Stato di abilitazione del patchMode specificato
lastPatchInstallationSummary	LastPatchInstallationSummary	Riepilogo dell'installazione dell'operazione di installazione più recente per la macchina virtuale.