Virtual Machine Scale Set VMs - Get Instance View

Servizio:: Compute

Versione API:: 2025-11-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=2025-11-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

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 from a VM scale set placed on a dedicated host group through automatic placement.

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineScaleSetExamples/VirtualMachineScaleSetVM_Get_InstanceViewAutoPlacedOnDedicatedHostGroup.json
// this example is just showing the usage of "VirtualMachineScaleSetVMs_GetInstanceView" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineScaleSetVmResource created on azure
// for more information of creating VirtualMachineScaleSetVmResource, please refer to the document of VirtualMachineScaleSetVmResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string virtualMachineScaleSetName = "myVirtualMachineScaleSet";
string instanceId = "0";
ResourceIdentifier virtualMachineScaleSetVmResourceId = VirtualMachineScaleSetVmResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, virtualMachineScaleSetName, instanceId);
VirtualMachineScaleSetVmResource virtualMachineScaleSetVm = client.GetVirtualMachineScaleSetVmResource(virtualMachineScaleSetVmResourceId);

// invoke the operation
VirtualMachineScaleSetVmInstanceView result = await virtualMachineScaleSetVm.GetInstanceViewAsync();

Console.WriteLine($"Succeeded: {result}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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 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.
KeyVaultKeyReference	Descrive un riferimento a Key Vault Key
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 di estensioni di una 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 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.

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.

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.

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.

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.

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 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	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 convenzioni e restrizioni di denominazione vedi Azure linee guida per l'implementazione dei servizi infrastrutturali.
disks	DiskInstanceView[]	Informazioni sui dischi.
extensions	VirtualMachineExtensionInstanceView[]	Le informazioni sulle estensioni.
hyperVGeneration	HyperVGeneration	Generazione dell'hypervisor della macchina virtuale [V1, V2]
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	L'agente di macchine virtuali in esecuzione nella macchina virtuale.
vmHealth	VirtualMachineHealthStatus	Stato di integrità della macchina virtuale.