Virtual Machine Scale Set VMs - Get Instance View

Service:: Compute

API-versie:: 2025-11-01

Hiermee haalt u de status van een virtuele machine op uit een VM-schaalset.

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

URI-parameters

Name	In	Vereist	Type	Description
instanceId	path	True	string	De exemplaar-id van de virtuele machine.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De ID van het doelabonnement.
vmScaleSetName	path	True	string	De naam van de VM-schaalset.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.

Antwoorden

Name	Type	Description
200 OK	VirtualMachineScaleSetVMInstanceView	Azure-operatie succesvol voltooid.
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

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

Voorbeeldaanvraag

HTTP

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

Voorbeeldrespons

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

Definities

Name	Description
ApiError	Api-fout.
ApiErrorBase	Api-foutbasis.
BootDiagnosticsInstanceView	De exemplaarweergave van een diagnostische diagnose bij het opstarten van een virtuele machine.
CloudError	Een foutreactie van de Compute-service.
DiskEncryptionSettings	Beschrijft een versleutelingsinstelling voor een schijf
DiskInstanceView	De instantieweergave van de schijf.
HyperVGeneration	De hypervisorgeneratie van de virtuele machine [V1, V2]
InnerError	Interne foutdetails.
InstanceViewStatus	Status van exemplaarweergave.
KeyVaultKeyReference	Beschrijft een verwijzing naar Key Vault Key
KeyVaultSecretReference	Beschrijft een verwijzing naar Key Vault Secret
MaintenanceOperationResultCodeTypes	De resultaatcode van de laatste onderhoudsbewerking.
MaintenanceRedeployStatus	Status van de onderhoudsoperatie.
StatusLevelTypes	De niveaucode.
StorageAlignmentStatus	Specificeert de opslaguitlijningsstatus voor de schijf.
SubResource
VirtualMachineAgentInstanceView	De instantieweergave van de VM-agent die op de virtuele machine wordt uitgevoerd.
VirtualMachineExtensionHandlerInstanceView	De instantieweergave van een voorzetter voor extensies van een virtuele machine.
VirtualMachineExtensionInstanceView	De exemplaarweergave van een virtuele-machineextensie.
VirtualMachineHealthStatus	De gezondheidsstatus van de VM.
VirtualMachineScaleSetVMInstanceView	De exemplaarweergave van een virtuele-machineschaalset-VM.

ApiError

Object

Api-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	Details van de Api-fout
innererror	InnerError	De innerlijke fout van de Api
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

Object

Api-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

BootDiagnosticsInstanceView

Object

De exemplaarweergave van een diagnostische diagnose bij het opstarten van een virtuele machine.

Name	Type	Description
consoleScreenshotBlobUri	string	De URI van de console-screenshot-blob. Notitie: Dit wordt niet ingesteld als diagnostische opstartdiagnostiek momenteel is ingeschakeld voor beheerde opslag.
serialConsoleLogBlobUri	string	De seriële consolelog-blob Uri. Notitie: Dit wordt niet ingesteld als diagnostische opstartdiagnostiek momenteel is ingeschakeld voor beheerde opslag.
status	InstanceViewStatus	De statusinformatie van de opstartdiagnose voor de VM. Notitie: Het wordt alleen ingesteld als er fouten optreden bij het inschakelen van opstartdiagnose.

CloudError

Object

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	Api-fout.

DiskEncryptionSettings

Object

Beschrijft een versleutelingsinstelling voor een schijf

Name	Type	Description
diskEncryptionKey	KeyVaultSecretReference	Specificeert de locatie van de schijfencryptiesleutel, die een Key Vault Secret is.
enabled	boolean	Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine.
keyEncryptionKey	KeyVaultKeyReference	Specificeert de locatie van de sleutelsleutel voor encryptie in Key Vault.

DiskInstanceView

Object

De instantieweergave van de schijf.

Name	Type	Description
encryptionSettings	DiskEncryptionSettings[]	Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15
name	string	De naam van de schijf.
statuses	InstanceViewStatus[]	De informatie over de resourcestatus.
storageAlignmentStatus	StorageAlignmentStatus	Specificeert de opslaguitlijningsstatus voor de schijf.

HyperVGeneration

Opsomming

De hypervisorgeneratie van de virtuele machine [V1, V2]

Waarde	Description
V1
V2

InnerError

Object

Interne foutdetails.

Name	Type	Description
errordetail	string	De interne foutmelding of uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.

InstanceViewStatus

Object

Status van exemplaarweergave.

Name	Type	Description
code	string	De statuscode.
displayStatus	string	Het korte lokaliseerbare label voor de status.
level	StatusLevelTypes	De niveaucode.
message	string	Het gedetailleerde statusbericht, inclusief voor waarschuwingen en foutberichten.
time	string (date-time)	Het tijdstip van de status.

KeyVaultKeyReference

Object

Beschrijft een verwijzing naar Key Vault Key

Name	Type	Description
keyUrl	string	De URL verwijst naar een sleutelversleutelsleutel in Key Vault.
sourceVault	SubResource	De relatieve URL van de Key Vault die de sleutel bevat.

KeyVaultSecretReference

Object

Beschrijft een verwijzing naar Key Vault Secret

Name	Type	Description
secretUrl	string	De URL verwijst naar een geheim in een Key Vault.
sourceVault	SubResource	De relatieve URL van de Key Vault die het geheim bevat.

MaintenanceOperationResultCodeTypes

Opsomming

De resultaatcode van de laatste onderhoudsbewerking.

Waarde	Description
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Object

Status van de onderhoudsoperatie.

Name	Type	Description
isCustomerInitiatedMaintenanceAllowed	boolean	Waar, als de klant toestemming heeft om onderhoud uit te voeren.
lastOperationMessage	string	Bericht geretourneerd voor de laatste onderhoudsoperatie.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	De resultaatcode van de laatste onderhoudsbewerking.
maintenanceWindowEndTime	string (date-time)	Eindtijd voor het onderhoudsvenster.
maintenanceWindowStartTime	string (date-time)	Begintijd voor het onderhoudsvenster.
preMaintenanceWindowEndTime	string (date-time)	Eindtijd voor het vooronderhoudsvenster.
preMaintenanceWindowStartTime	string (date-time)	Starttijd voor het vooronderhoudsvenster.

StatusLevelTypes

Opsomming

De niveaucode.

Waarde	Description
Info
Warning
Error

StorageAlignmentStatus

Opsomming

Specificeert de opslaguitlijningsstatus voor de schijf.

Waarde	Description
Unaligned	De schijf heeft geen mapping van Storage Fault Domain naar Compute Fault Domain. Een enkele storing in het Storage Fault Domain kan alle VM's beïnvloeden die naar dit schijfprofiel verwijzen.
Aligned	De schijf heeft Storage Fault Domain om Fault Domain mapping te berekenen. Storing van het Storage Fault Domain is beperkt tot VM's in één Compute Fault Domain.

SubResource

Object

Name	Type	Description
id	string	Resource-id

VirtualMachineAgentInstanceView

Object

De instantieweergave van de VM-agent die op de virtuele machine wordt uitgevoerd.

Name	Type	Description
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	De weergave van de voorzetter van de extensie van de virtuele machine.
statuses	InstanceViewStatus[]	De informatie over de resourcestatus.
vmAgentVersion	string	De volledige versie van VM Agent.

VirtualMachineExtensionHandlerInstanceView

Object

De instantieweergave van een voorzetter voor extensies van een virtuele machine.

Name	Type	Description
status	InstanceViewStatus	De status van de extensie-handler.
type	string	Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.
typeHandlerVersion	string	Hiermee geeft u de versie van de scripthandler.

VirtualMachineExtensionInstanceView

Object

De exemplaarweergave van een virtuele-machineextensie.

Name	Type	Description
name	string	De naam van de extensie van de virtuele machine.
statuses	InstanceViewStatus[]	De informatie over de resourcestatus.
substatuses	InstanceViewStatus[]	De informatie over de resourcestatus.
type	string	Hiermee geeft u het type van de extensie; een voorbeeld is CustomScriptExtension.
typeHandlerVersion	string	Hiermee geeft u de versie van de scripthandler.

VirtualMachineHealthStatus

Object

De gezondheidsstatus van de VM.

Name	Type	Description
status	InstanceViewStatus	De statusinformatie voor de VM.

VirtualMachineScaleSetVMInstanceView

Object

De exemplaarweergave van een virtuele-machineschaalset-VM.

Name	Type	Description
assignedHost	string	Resource-id van de toegewezen host, waarop de virtuele machine wordt toegewezen via automatische plaatsing, wanneer de virtuele machine is gekoppeld aan een toegewezen hostgroep waarvoor automatische plaatsing is ingeschakeld. Minimale API-versie: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Diagnostische gegevens over opstarten is een functie voor foutopsporing waarmee u console-uitvoer en schermopname kunt bekijken om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. Azure stelt je ook in staat om een screenshot van de VM te zien vanuit de hypervisor.
computerName	string	Hiermee geeft u de naam van het host-besturingssysteem van de virtuele machine. Deze naam kan niet worden bijgewerkt nadat de virtuele machine is gemaakt. Maximale lengte (Windows): 15 tekens Maximale lengte (Linux): 64 tekens. Voor naamgevingsconventies en beperkingen, zie Azure infrastructuurdiensten implementatierichtlijnen.
disks	DiskInstanceView[]	De gegevens van de schijven.
extensions	VirtualMachineExtensionInstanceView[]	De extensies informatie.
hyperVGeneration	HyperVGeneration	De hypervisorgeneratie van de virtuele machine [V1, V2]
maintenanceRedeployStatus	MaintenanceRedeployStatus	De status van de onderhoudsbewerking op de virtuele machine.
osName	string	Het besturingssysteem dat wordt uitgevoerd op de hybride machine.
osVersion	string	De versie van het besturingssysteem die wordt uitgevoerd op de hybride machine.
placementGroupId	string	De plaatsingsgroep waarin de VIRTUELE machine wordt uitgevoerd. Als de toewijzing van de VIRTUELE machine ongedaan is gemaakt, heeft deze geen placementGroupId.
platformFaultDomain	integer (int32)	Het aantal foutdomeinen.
platformUpdateDomain	integer (int32)	Het aantal updatedomeinen.
rdpThumbPrint	string	De vingerafdruk van het Remote Desktop-certificaat.
statuses	InstanceViewStatus[]	De informatie over de resourcestatus.
vmAgent	VirtualMachineAgentInstanceView	De VM-agent die op de virtuele machine wordt uitgevoerd.
vmHealth	VirtualMachineHealthStatus	De status van de VM.