Virtual Machine Scale Set VMs - Get Instance View

Servizio:: Compute

Versione API:: 2026-03-01

Ottiene lo stato di una macchina virtuale da un set di scalabilità di macchine virtuali.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/instanceView?api-version=2026-03-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
instanceId	path	True	string	ID istanza della macchina virtuale.
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.
vmScaleSetName	path	True	string	Nome del set di scalabilità di macchine virtuali.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

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

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Ambiti

Nome	Descrizione
user_impersonation	impersonare il tuo account utente

Esempio

Get instance view of a virtual machine from a VM scale set 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/virtualMachineScaleSets/myVirtualMachineScaleSet/virtualMachines/0/instanceView?api-version=2026-03-01

Risposta di esempio

Codice di stato:: 200

{
  "platformUpdateDomain": 0,
  "platformFaultDomain": 0,
  "rdpThumbPrint": null,
  "vmAgent": {
    "vmAgentVersion": "Unknown",
    "statuses": [
      {
        "code": "ProvisioningState/Unavailable",
        "level": "Warning",
        "displayStatus": "Not Ready",
        "message": "VM status blob is found but not yet populated.",
        "time": "2025-04-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2025-04-01T04:58:58.0882815+00:00"
        }
      ]
    }
  ],
  "extensions": null,
  "assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
  "bootDiagnostics": null,
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": null,
      "time": "2020-06-05T04:59:58.1852966+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running",
      "message": null,
      "time": null
    }
  ]
}

Definizioni

Nome	Descrizione
ApiError	Errore API.
ApiErrorBase	Base di errore API.
BootDiagnosticsInstanceView	Visualizzazione dell'istanza di una 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.
HyperVGeneration	Generazione dell'hypervisor della macchina virtuale [V1, V2]
InnerError	Dettagli dell'errore interno.
InstanceViewStatus	Stato di visualizzazione dell'istanza.
InterconnectInstanceView	I dettagli della visualizzazione dell'istanza Interconnect Block per un'istanza di una Virtual Machine o di una VM Scale Set.
KeyVaultKeyReference	Descrive un riferimento alla chiave di Key Vault
KeyVaultSecretReference	Descrive un riferimento a Key Vault Secret
MaintenanceOperationResultCodeTypes	Codice risultato dell'ultima operazione di manutenzione.
MaintenanceRedeployStatus	Stato dell'operazione di manutenzione.
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 dell'estensione macchina virtuale.
VirtualMachineExtensionInstanceView	Visualizzazione dell'istanza di un'estensione macchina virtuale.
VirtualMachineHealthStatus	Stato di integrità della macchina virtuale.
VirtualMachineScaleSetVMInstanceView	Visualizzazione dell'istanza di una macchina virtuale del set di scalabilità di macchine virtuali.

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.

BootDiagnosticsInstanceView

Oggetto

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

Nome	Tipo	Descrizione
consoleScreenshotBlobUri	string	Screenshot dell'URI BLOB della console. Nota: Questa impostazione non se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
serialConsoleLogBlobUri	string	Uri BLOB del log della console seriale. Nota: Questa impostazione non se la diagnostica di avvio è attualmente abilitata con l'archiviazione gestita.
status	InstanceViewStatus	Informazioni sullo stato di diagnostica di avvio per la macchina virtuale. Nota: Verrà impostato solo se si verificano errori durante l'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 il percorso della chiave di crittografia del disco, ovvero un segreto dell'insieme di credenziali delle chiavi.
enabled	boolean	Specifica se la crittografia del disco deve essere abilitata nella macchina virtuale.
keyEncryptionKey	KeyVaultKeyReference	Specifica il percorso 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.

HyperVGeneration

Enumerazione

Generazione dell'hypervisor della macchina virtuale [V1, V2]

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.

InterconnectInstanceView

Oggetto

I dettagli della visualizzazione dell'istanza Interconnect Block per un'istanza di una Virtual Machine o di una VM Scale Set.

Nome	Tipo	Descrizione
interconnectSubgroupId	string	L'ID (GUID) del sottogruppo Interconnect in cui era posizionata la Macchina Virtuale.

KeyVaultKeyReference

Oggetto

Descrive un riferimento alla chiave di Key Vault

Nome	Tipo	Descrizione
keyUrl	string	URL che fa riferimento a una chiave di crittografia della chiave in Key Vault.
sourceVault	SubResource	URL relativo dell'insieme di credenziali delle chiavi contenente 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.

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	True, 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 manutenzione preliminare.
preMaintenanceWindowStartTime	string (date-time)	Ora di inizio per la finestra di manutenzione preliminare.

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 macchina virtuale.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgentVersion	string	Versione completa dell'agente di macchine virtuali.

VirtualMachineExtensionHandlerInstanceView

Oggetto

Visualizzazione dell'istanza di un gestore dell'estensione macchina virtuale.

Nome	Tipo	Descrizione
status	InstanceViewStatus	Stato del gestore dell'estensione.
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à per la macchina virtuale.

VirtualMachineScaleSetVMInstanceView

Oggetto

Visualizzazione dell'istanza di una macchina virtuale del set di scalabilità di macchine virtuali.

Nome	Tipo	Descrizione
assignedHost	string	ID risorsa dell'host dedicato, in cui la macchina virtuale viene allocata tramite posizionamento automatico, quando la macchina virtuale è associata a un gruppo host dedicato con posizionamento automatico abilitato. 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	Specifica il nome del sistema operativo host della macchina virtuale. Questo nome non può essere aggiornato dopo la creazione della macchina virtuale. Lunghezza massima (Windows): 15 caratteri Lunghezza massima (Linux): 64 caratteri. Per le convenzioni di denominazione e le restrizioni, vedere linee guida per l'implementazione dei servizi dell'infrastruttura di Azure.
disks	DiskInstanceView[]	Informazioni sui dischi.
extensions	VirtualMachineExtensionInstanceView[]	Informazioni sulle estensioni.
hyperVGeneration	HyperVGeneration	Generazione dell'hypervisor della macchina virtuale [V1, V2]
interconnectInstanceView	InterconnectInstanceView	La vista runtime Interconnect dell'istanza Scale Set VM. Versione minima API: 01-03-2026.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Stato dell'operazione di manutenzione nella macchina virtuale.
osName	string	Sistema operativo in esecuzione nel computer ibrido.
osVersion	string	Versione del sistema operativo in esecuzione nel computer ibrido.
placementGroupId	string	Gruppo di posizionamento in cui è in esecuzione la macchina virtuale. Se la macchina virtuale viene deallocata, non avrà un placementGroupId.
platformFaultDomain	integer (int32)	Numero di domini di errore.
platformUpdateDomain	integer (int32)	Numero di domini di aggiornamento.
rdpThumbPrint	string	Identificazione personale del certificato desktop remoto.
statuses	InstanceViewStatus[]	Informazioni sullo stato della risorsa.
vmAgent	VirtualMachineAgentInstanceView	Agente di macchine virtuali in esecuzione nella macchina virtuale.
vmHealth	VirtualMachineHealthStatus	Stato di integrità per la macchina virtuale.