Virtual Machine Scale Set VMs - Get Instance View

Dienst:

Compute

API-Version:

2026-04-01

Ruft den Status eines virtuellen Computers aus einer VM-Skalierungsgruppe ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
instanceId	path	True	string	Die Instanz-ID des virtuellen Computers.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
vmScaleSetName	path	True	string	Der Name des VM-Skalierungssatzes.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	VirtualMachineScaleSetVMInstanceView	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	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	Sich als Ihr Benutzerkonto ausgeben

Beispiele

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.

Get instance view of a virtual machine from a VM scale set that is eligible for and consuming an open capacity reservation.

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

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": "2026-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": "2026-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
    }
  ]
}

Get instance view of a virtual machine from a VM scale set that is eligible for and consuming an open capacity reservation.

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "platformUpdateDomain": 0,
  "platformFaultDomain": 0,
  "rdpThumbPrint": null,
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.1010",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and processing the extensions.",
        "time": "2026-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": "2026-04-01T04:58:58.0882815+00:00"
        }
      ]
    }
  ],
  "extensions": null,
  "bootDiagnostics": null,
  "capacityReservationType": "Open",
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": null,
      "time": "2026-04-01T04:59:58.1852966+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running",
      "message": null,
      "time": null
    }
  ]
}

Definitionen

Name	Beschreibung
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
BootDiagnosticsInstanceView	Die Instanzansicht einer Startdiagnose eines virtuellen Computers.
CapacityReservationType	Spezifiziert, von welcher Art der Kapazitätsreservierung die virtuelle Maschine Kapazität verbraucht, wenn sie berechtigt ist, oder ob sie explizit davon abgelehnt ist, zugeordnet und Kapazität aus einer im Abonnement verfügbaren reservierten Kapazität zu verbrauchen. Minimale API-Version: 01.04.2026.
CloudError	Eine Fehlerantwort vom Compute-Dienst.
DiskEncryptionSettings	Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger
DiskInstanceView	Die Instanzansicht des Datenträgers.
HyperVGeneration	Die Hypervisorgenerierung des virtuellen Computers [V1, V2]
InnerError	Innere Fehlerdetails.
InstanceViewStatus	Instanzansichtsstatus.
InterconnectInstanceView	Die Details der Interconnect Block-Instanz für eine virtuelle Maschine oder Scale Set VM-Instanz.
KeyVaultKeyReference	Beschreibt einen Verweis auf Key Vault Key
KeyVaultSecretReference	Beschreibt einen Verweis auf Key Vault Secret
MaintenanceOperationResultCodeTypes	Der letzte Ergebniscode des Wartungsvorgangs.
MaintenanceRedeployStatus	Wartungsvorgangsstatus.
StatusLevelTypes	Der Ebenencode.
StorageAlignmentStatus	Spezifiziert den Speicherausrichtungsstatus für die Festplatte.
SubResource
VirtualMachineAgentInstanceView	Die Instanzansicht des VM-Agents, der auf dem virtuellen Computer ausgeführt wird.
VirtualMachineExtensionHandlerInstanceView	Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer.
VirtualMachineExtensionInstanceView	Die Instanzansicht einer Erweiterung eines virtuellen Computers.
VirtualMachineHealthStatus	Der Integritätsstatus des virtuellen Computers.
VirtualMachineScaleSetVMInstanceView	Die Instanzansicht eines VM-Skalierungssatzes für virtuelle Computer.

ApiError

Objekt

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Die Details zum API-Fehler
innererror	InnerError	Der innere API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

BootDiagnosticsInstanceView

Objekt

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	InstanceViewStatus	Die Statusinformationen zur Startdiagnose für den virtuellen Computer. Hinweis: Es wird nur festgelegt, wenn Fehler beim Aktivieren der Startdiagnose aufgetreten sind.

CapacityReservationType

Enumeration

Spezifiziert, von welcher Art der Kapazitätsreservierung die virtuelle Maschine Kapazität verbraucht, wenn sie berechtigt ist, oder ob sie explizit davon abgelehnt ist, zugeordnet und Kapazität aus einer im Abonnement verfügbaren reservierten Kapazität zu verbrauchen. Minimale API-Version: 01.04.2026.

Wert	Beschreibung
NotEligible	Die virtuelle Maschine ist nicht berechtigt, implizit mit einer offenen Kapazitätsreservierung verknüpft zu werden, und ist auch nicht explizit mit einer Kapazitätsreservierungsgruppe verbunden, sodass sie Kapazität aus der öffentlich verfügbaren Kapazität verbraucht.
Targeted	Die virtuelle Maschine verbraucht Kapazität aus einer bestimmten Matching-Kapazitätsreservierung, wenn sie mit einer gezielten Kapazitätsreservierungsgruppe verknüpft ist, kann aber auf Kapazität aus der öffentlich verfügbaren Kapazität zurückfallen, wenn in der Zielreservierung keine verfügbare Kapazität vorhanden ist.
Open	Die virtuelle Maschine, falls sie berechtigt ist, wird implizit jede verfügbare Kapazität aus einer im Abonnement erstellten oder geteilten offenen Reservierungen verknüpfen und verbrauchen. Hinweis: Die VM sollte nicht explizit mit der offenen Kapazitätsreservierungsgruppe verknüpft sein, die die passende Reservierung enthält.
Disabled	Die virtuelle Maschine hat die Kapazitätsreservierung deaktiviert und darf sich nicht implizit oder explizit mit irgendeiner Art von Kapazitätsreservierung verknüpfen.
Block	Die virtuelle Maschine verbraucht Kapazität aus einer bestimmten Kapazitätsreservierung, wenn sie mit einer Kapazitätsreservierungsgruppe des Blocktyps verknüpft ist, und tritt auf Kapazitätsausfälle, wenn keine verfügbare Kapazität in der Blockreservierung vorhanden ist.

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

DiskEncryptionSettings

Objekt

Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger

Name	Typ	Beschreibung
diskEncryptionKey	KeyVaultSecretReference	Gibt den Speicherort des Datenträgerverschlüsselungsschlüssels an, bei dem es sich um einen Schlüsseltresorschlüssel handelt.
enabled	boolean	Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll.
keyEncryptionKey	KeyVaultKeyReference	Gibt den Speicherort des Schlüsselverschlüsselungsschlüssels im Key Vault an.

DiskInstanceView

Objekt

Die Instanzansicht des Datenträgers.

Name	Typ	Beschreibung
encryptionSettings	DiskEncryptionSettings[]	Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15
name	string	Der Datenträgername.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
storageAlignmentStatus	StorageAlignmentStatus	Spezifiziert den Speicherausrichtungsstatus für die Festplatte.

HyperVGeneration

Enumeration

Die Hypervisorgenerierung des virtuellen Computers [V1, V2]

Wert	Beschreibung
V1
V2

InnerError

Objekt

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype	string	Der Ausnahmetyp.

InstanceViewStatus

Objekt

Instanzansichtsstatus.

Name	Typ	Beschreibung
code	string	Der Statuscode.
displayStatus	string	Die kurze lokalisierbare Bezeichnung für den Status.
level	StatusLevelTypes	Der Ebenencode.
message	string	Die detaillierte Statusmeldung, einschließlich warnungen und Fehlermeldungen.
time	string (date-time)	Die Uhrzeit des Status.

InterconnectInstanceView

Objekt

Die Details der Interconnect Block-Instanz für eine virtuelle Maschine oder Scale Set VM-Instanz.

Name	Typ	Beschreibung
interconnectSubgroupId	string	Die ID (GUID) der Interconnect-Untergruppe, in die die virtuelle Maschine eingeordnet wurde.

KeyVaultKeyReference

Objekt

Beschreibt einen Verweis auf Key Vault Key

Name	Typ	Beschreibung
keyUrl	string	Die URL, die auf einen Schlüsselverschlüsselungsschlüssel im Key Vault verweist.
sourceVault	SubResource	Die relative URL des Schlüsseltresors, der den Schlüssel enthält.

KeyVaultSecretReference

Objekt

Beschreibt einen Verweis auf Key Vault Secret

Name	Typ	Beschreibung
secretUrl	string	Die URL, die auf einen geheimen Schlüssel in einem Key Vault verweist.
sourceVault	SubResource	Die relative URL des Schlüsseltresors, der den geheimen Schlüssel enthält.

MaintenanceOperationResultCodeTypes

Enumeration

Der letzte Ergebniscode des Wartungsvorgangs.

Wert	Beschreibung
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Objekt

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	MaintenanceOperationResultCodeTypes	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.

StatusLevelTypes

Enumeration

Der Ebenencode.

Wert	Beschreibung
Info
Warning
Error

StorageAlignmentStatus

Enumeration

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

Objekt

Name	Typ	Beschreibung
id	string	Ressourcen-ID

VirtualMachineAgentInstanceView

Objekt

Die Instanzansicht des VM-Agents, der auf dem virtuellen Computer ausgeführt wird.

Name	Typ	Beschreibung
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Die Instanzansicht der Erweiterungshandler für virtuelle Computer.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
vmAgentVersion	string	Die Vollversion des VM-Agents.

VirtualMachineExtensionHandlerInstanceView

Objekt

Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer.

Name	Typ	Beschreibung
status	InstanceViewStatus	Der Erweiterungshandlerstatus.
type	string	Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
typeHandlerVersion	string	Spezifiziert die Major.Minor.Patch.Hotfix-Version des Skripthandlers. Die Azure-Plattform wird die neueste Patch.Hotfix-Version der Major.Minor-Reihe liefern.

VirtualMachineExtensionInstanceView

Objekt

Die Instanzansicht einer Erweiterung eines virtuellen Computers.

Name	Typ	Beschreibung
name	string	Der Erweiterungsname des virtuellen Computers.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
substatuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
type	string	Gibt den Typ der Erweiterung an; Ein Beispiel ist "CustomScriptExtension".
typeHandlerVersion	string	Spezifiziert die Major.Minor.Patch.Hotfix-Version des Skripthandlers. Die Azure-Plattform wird die neueste Patch.Hotfix-Version der Major.Minor-Reihe liefern.

VirtualMachineHealthStatus

Objekt

Der Integritätsstatus des virtuellen Computers.

Name	Typ	Beschreibung
status	InstanceViewStatus	Die Integritätsstatusinformationen für den virtuellen Computer.

VirtualMachineScaleSetVMInstanceView

Objekt

Die Instanzansicht eines VM-Skalierungssatzes für virtuelle Computer.

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	BootDiagnosticsInstanceView	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 ihnen auch das Anzeigen eines Screenshots des virtuellen Computers vom Hypervisor.
capacityReservationType	CapacityReservationType	Spezifiziert, von welcher Art der Kapazitätsreservierung die VM-Instanz des virtuellen Maschinen-Skalierungssets Kapazität verbrauchen wird, falls sie berechtigt ist, oder ob sie explizit nicht zugeordnet und Kapazität von einer im Abonnement verfügbaren reservierten Kapazitäten verbraucht. Minimale API-Version: 01.04.2026.
computerName	string	Gibt den Hostnamen des virtuellen Computers an. Dieser Name kann nicht aktualisiert werden, nachdem der virtuelle Computer erstellt wurde. Max. Länge (Windows): 15 Zeichen Max-Length (Linux): 64 Zeichen. Benennungskonventionen und Einschränkungen finden Sie in Implementierungsrichtlinien für Azure-Infrastrukturdienste.
disks	DiskInstanceView[]	Die Datenträgerinformationen.
extensions	VirtualMachineExtensionInstanceView[]	Die Erweiterungsinformationen.
hyperVGeneration	HyperVGeneration	Die Hypervisorgenerierung des virtuellen Computers [V1, V2]
interconnectInstanceView	InterconnectInstanceView	Die Interconnect-Laufzeitansicht der Scale Set VM-Instanz. Mindest-API-Version: 01.03.2026.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Der Wartungsvorgangsstatus auf dem virtuellen Computer.
osName	string	Das Betriebssystem, das auf dem Hybridcomputer ausgeführt wird.
osVersion	string	Die Version des Betriebssystems, das auf dem Hybridcomputer ausgeführt wird.
placementGroupId	string	Die Platzierungsgruppe, in der der virtuelle Computer ausgeführt wird. Wenn der virtuelle Computer deallocated ist, verfügt er nicht über eine placementGroupId.
platformFaultDomain	integer (int32)	Die Anzahl der Fehlerdomänen.
platformUpdateDomain	integer (int32)	Die Anzahl der Updatedomänen.
rdpThumbPrint	string	Fingerabdruck des Remotedesktopzertifikats.
statuses	InstanceViewStatus[]	Die Ressourcenstatusinformationen.
vmAgent	VirtualMachineAgentInstanceView	Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird.
vmHealth	VirtualMachineHealthStatus	Der Integritätsstatus für den virtuellen Computer.