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 |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Die Instanz-ID des virtuellen Computers. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
|
vm
|
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 |
Azure-Operation erfolgreich abgeschlossen. |
|
| Other Status Codes |
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
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 |
|---|---|
|
Api |
API-Fehler. |
|
Api |
API-Fehlerbasis. |
|
Boot |
Die Instanzansicht einer Startdiagnose eines virtuellen Computers. |
|
Cloud |
Eine Fehlerantwort vom Compute-Dienst. |
|
Disk |
Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger |
|
Disk |
Die Instanzansicht des Datenträgers. |
|
Hyper |
Die Hypervisorgenerierung des virtuellen Computers [V1, V2] |
|
Inner |
Innere Fehlerdetails. |
|
Instance |
Instanzansichtsstatus. |
|
Key |
Beschreibt einen Verweis auf Key Vault Key |
|
Key |
Beschreibt einen Verweis auf Key Vault Secret |
|
Maintenance |
Der letzte Ergebniscode des Wartungsvorgangs. |
|
Maintenance |
Wartungsvorgangsstatus. |
|
Status |
Der Ebenencode. |
|
Storage |
Spezifiziert den Speicherausrichtungsstatus für die Festplatte. |
|
Sub |
|
|
Virtual |
Die Instanzansicht des VM-Agents, der auf dem virtuellen Computer ausgeführt wird. |
|
Virtual |
Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer. |
|
Virtual |
Die Instanzansicht einer Erweiterung eines virtuellen Computers. |
|
Virtual |
Der Integritätsstatus des virtuellen Computers. |
|
Virtual |
Die Instanzansicht eines VM-Skalierungssatzes für virtuelle Computer. |
ApiError
API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| details |
Die Details zum API-Fehler |
|
| 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 |
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 |
API-Fehler. |
DiskEncryptionSettings
Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger
| Name | Typ | Beschreibung |
|---|---|---|
| diskEncryptionKey |
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 |
Spezifiziert den Standort des Schlüsselverschlüsselungsschlüssels in Key Vault. |
DiskInstanceView
Die Instanzansicht des Datenträgers.
| Name | Typ | Beschreibung |
|---|---|---|
| encryptionSettings |
Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. |
|
| name |
string |
Der Datenträgername. |
| statuses |
Die Ressourcenstatusinformationen. |
|
| 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 |
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 |
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 |
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 |
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 |
Die Instanzansicht der Erweiterungshandler für virtuelle Computer. |
|
| statuses |
Die Ressourcenstatusinformationen. |
|
| vmAgentVersion |
string |
Die Vollversion des VM-Agents. |
VirtualMachineExtensionHandlerInstanceView
Die Instanzansicht eines Erweiterungshandlers für virtuelle Computer.
| Name | Typ | Beschreibung |
|---|---|---|
| status |
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 |
Die Ressourcenstatusinformationen. |
|
| substatuses |
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 |
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 |
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. |
| disks |
Die Datenträgerinformationen. |
|
| extensions |
Die Erweiterungsinformationen. |
|
| hyperVGeneration |
Die Hypervisorgenerierung des virtuellen Computers [V1, V2] |
|
| 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 |
Die Ressourcenstatusinformationen. |
|
| vmAgent |
Der VM-Agent, der auf dem virtuellen Computer ausgeführt wird. |
|
| vmHealth |
Der Integritätsstatus für den virtuellen Computer. |