Virtual Machine Scale Set VMs - Get Instance View

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=2025-11-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

Azure-Operation 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 Identitätswechsel ihres Benutzerkontos

Beispiele

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

Beispielanforderung

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

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

BootDiagnosticsInstanceView

Die Instanzansicht einer Startdiagnose eines virtuellen Computers.

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.

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

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

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

BootDiagnosticsInstanceView

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.

CloudError

Eine Fehlerantwort vom Compute-Dienst.

Name Typ Beschreibung
error

ApiError

API-Fehler.

DiskEncryptionSettings

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

Name Typ Beschreibung
diskEncryptionKey

KeyVaultSecretReference

Spezifiziert den Standort des Festplatten-Verschlüsselungsschlüssels, der ein Key Vault Secret ist.

enabled

boolean

Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll.

keyEncryptionKey

KeyVaultKeyReference

Spezifiziert den Standort des Schlüsselverschlüsselungsschlüssels in Key Vault.

DiskInstanceView

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

Die Hypervisorgenerierung des virtuellen Computers [V1, V2]

Wert Beschreibung
V1
V2

InnerError

Innere Fehlerdetails.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder der Ausnahmedump.

exceptiontype

string

Der Ausnahmetyp.

InstanceViewStatus

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.

KeyVaultKeyReference

Beschreibt einen Verweis auf Key Vault Key

Name Typ Beschreibung
keyUrl

string

Die URL, die auf einen Schlüsselverschlüsselungsschlüssel in Key Vault verweist.

sourceVault

SubResource

Die relative URL des Key Vault, der den Schlüssel enthält.

KeyVaultSecretReference

Beschreibt einen Verweis auf Key Vault Secret

Name Typ Beschreibung
secretUrl

string

Die URL bezieht sich auf ein Geheimnis in einem Key Vault.

sourceVault

SubResource

Die relative URL des Key Vault, der das Geheimnis enthält.

MaintenanceOperationResultCodeTypes

Der letzte Ergebniscode des Wartungsvorgangs.

Wert Beschreibung
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

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

Der Ebenencode.

Wert Beschreibung
Info
Warning
Error

StorageAlignmentStatus

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

Name Typ Beschreibung
id

string

Ressourcen-ID

VirtualMachineAgentInstanceView

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

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

Gibt die Version des Skripthandlers an.

VirtualMachineExtensionInstanceView

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

Gibt die Version des Skripthandlers an.

VirtualMachineHealthStatus

Der Integritätsstatus des virtuellen Computers.

Name Typ Beschreibung
status

InstanceViewStatus

Die Integritätsstatusinformationen für den virtuellen Computer.

VirtualMachineScaleSetVMInstanceView

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 es Ihnen außerdem, einen Screenshot der VM vom Hypervisor aus zu sehen.

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.

Für Namenskonventionen und Einschränkungen siehe Azure Infrastructure Services implementation guidelines.

disks

DiskInstanceView[]

Die Datenträgerinformationen.

extensions

VirtualMachineExtensionInstanceView[]

Die Erweiterungsinformationen.

hyperVGeneration

HyperVGeneration

Die Hypervisorgenerierung des virtuellen Computers [V1, V2]

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.