Virtual Machine Scale Set VMs - Get Instance View

Tjänst:: Compute

API-version:: 2026-04-01

Hämtar status för en virtuell dator från en VM-skalningsuppsättning.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
instanceId	path	True	string	Instans-ID för den virtuella datorn.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Namnet på resursgruppen. Namnet är skiftlägesokänsligt.
subscriptionId	path	True	string minLength: 1	ID för målprenumerationen.
vmScaleSetName	path	True	string	Namnet på VM-skalningsuppsättningen.
api-version	query	True	string minLength: 1	Den API-version som ska användas för den här åtgärden.

Svar

Name	Typ	Description
200 OK	VirtualMachineScaleSetVMInstanceView	Azure-operationen slutfördes framgångsrikt.
Other Status Codes	CloudError	Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

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.

Exempelbegäran

HTTP

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

Exempelsvar

Statuskod:: 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.

Exempelbegäran

HTTP

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

Exempelsvar

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

Definitioner

Name	Description
ApiError	Api-fel.
ApiErrorBase	Api-felbas.
BootDiagnosticsInstanceView	Instansvyn för en startdiagnostik för en virtuell dator.
CapacityReservationType	Specificerar vilken typ av kapacitetsreservation den virtuella maskinen kommer att förbruka kapacitet från om den är berättigad, eller om den uttryckligen är bortvald från att vara associerad och använda kapacitet från någon reserverad kapacitet som finns tillgänglig i prenumerationen. Minsta API-version: 2026-04-01.
CloudError	Ett felsvar från Compute-tjänsten.
DiskEncryptionSettings	Beskriver krypteringsinställningar för en disk
DiskInstanceView	Instansvyn för disken.
HyperVGeneration	Hypervisor-genereringen av den virtuella datorn [V1, V2]
InnerError	Inre felinformation.
InstanceViewStatus	Status för instansvy.
InterconnectInstanceView	Detaljer om Instansens Interconnect Block-instans för en virtuell maskin eller Scale Set VM-instans.
KeyVaultKeyReference	Beskriver en referens till Key Vault Key
KeyVaultSecretReference	Beskriver en referens till Key Vault Secret
MaintenanceOperationResultCodeTypes	Resultatkoden för den senaste underhållsåtgärden.
MaintenanceRedeployStatus	Status för underhållsåtgärd.
StatusLevelTypes	Nivåkoden.
StorageAlignmentStatus	Specificerar lagringsjusteringsstatus för disken.
SubResource
VirtualMachineAgentInstanceView	Instansvyn för vm-agenten som körs på den virtuella datorn.
VirtualMachineExtensionHandlerInstanceView	Instansvyn för en tilläggshanterare för virtuella datorer.
VirtualMachineExtensionInstanceView	Instansvyn för ett tillägg för virtuella datorer.
VirtualMachineHealthStatus	Hälsostatus för den virtuella datorn.
VirtualMachineScaleSetVMInstanceView	Instansvyn för en virtuell dators skalningsuppsättning virtuell dator.

ApiError

Objekt

Api-fel.

Name	Typ	Description
code	string	Felkoden.
details	ApiErrorBase[]	Api-felinformationen
innererror	InnerError	Api:ets inre fel
message	string	Felmeddelandet.
target	string	Målet för det specifika felet.

ApiErrorBase

Objekt

Api-felbas.

Name	Typ	Description
code	string	Felkoden.
message	string	Felmeddelandet.
target	string	Målet för det specifika felet.

BootDiagnosticsInstanceView

Objekt

Instansvyn för en startdiagnostik för en virtuell dator.

Name	Typ	Description
consoleScreenshotBlobUri	string	Konsolens skärmbild av blob-URI: URI. Obs! Detta inte anges om startdiagnostik för närvarande är aktiverat med hanterad lagring.
serialConsoleLogBlobUri	string	Blob-URI:n för seriekonsolloggen. Obs! Detta inte anges om startdiagnostik för närvarande är aktiverat med hanterad lagring.
status	InstanceViewStatus	Statusinformation för startdiagnostik för den virtuella datorn. Obs! Det anges endast om det finns fel vid aktivering av startdiagnostik.

CapacityReservationType

Uppräkning

Specificerar vilken typ av kapacitetsreservation den virtuella maskinen kommer att förbruka kapacitet från om den är berättigad, eller om den uttryckligen är bortvald från att vara associerad och använda kapacitet från någon reserverad kapacitet som finns tillgänglig i prenumerationen. Minsta API-version: 2026-04-01.

Värde	Description
NotEligible	Den virtuella maskinen är inte berättigad att implicit associeras med en öppen kapacitetsreservation och är inte uttryckligen kopplad till någon kapacitetsreservationsgrupp, så den kommer att förbruka kapacitet från den offentligt tillgängliga kapaciteten.
Targeted	Den virtuella maskinen kommer att förbruka kapacitet från en specifik matchande kapacitetsreservation när den är kopplad till en kapacitetsreservationsgruppresurs av den typ som är riktad, men kan falla tillbaka på att använda kapacitet från den offentligt tillgängliga kapaciteten om det inte finns någon kapacitet tillgänglig i den riktade reservationen.
Open	Den virtuella maskinen, om den är berättigad, kommer implicit att associera och använda all tillgänglig kapacitet från en matchande öppen kapacitetsreservation som skapats eller delats i prenumerationen. Notera: VM:n bör inte uttryckligen associeras med resursen för öppen kapacitetsreservationsgrupp som innehåller den matchande reservationen.
Disabled	Den virtuella maskinen har kapacitetsreservationstilldelning inaktiverad och får inte implicit eller explicit associeras med någon typ av kapacitetsreservation.
Block	Den virtuella maskinen förbrukar kapacitet från en specifik matchande kapacitetsreservation när den är kopplad till en resurs av typen av block, och kommer att stöta på kapacitetsfel om det inte finns tillgänglig kapacitet i blockreservationen.

CloudError

Objekt

Ett felsvar från Compute-tjänsten.

Name	Typ	Description
error	ApiError	Api-fel.

DiskEncryptionSettings

Objekt

Beskriver krypteringsinställningar för en disk

Name	Typ	Description
diskEncryptionKey	KeyVaultSecretReference	Anger platsen för diskkrypteringsnyckeln, som är en Nyckelvalvshemlighet.
enabled	boolean	Anger om diskkryptering ska aktiveras på den virtuella datorn.
keyEncryptionKey	KeyVaultKeyReference	Anger platsen för nyckelkrypteringsnyckeln i Key Vault.

DiskInstanceView

Objekt

Instansvyn för disken.

Name	Typ	Description
encryptionSettings	DiskEncryptionSettings[]	Anger krypteringsinställningarna för OS-disken. Lägsta API-version: 2015-06-15
name	string	Disknamnet.
statuses	InstanceViewStatus[]	Information om resursstatus.
storageAlignmentStatus	StorageAlignmentStatus	Specificerar lagringsjusteringsstatus för disken.

HyperVGeneration

Uppräkning

Hypervisor-genereringen av den virtuella datorn [V1, V2]

Värde	Description
V1
V2

InnerError

Objekt

Inre felinformation.

Name	Typ	Description
errordetail	string	Det interna felmeddelandet eller undantagsdumpen.
exceptiontype	string	Typen av undantag.

InstanceViewStatus

Objekt

Status för instansvy.

Name	Typ	Description
code	string	Statuskoden.
displayStatus	string	Den korta localizable-etiketten för statusen.
level	StatusLevelTypes	Nivåkoden.
message	string	Det detaljerade statusmeddelandet, inklusive för aviseringar och felmeddelanden.
time	string (date-time)	Tidpunkten för statusen.

InterconnectInstanceView

Objekt

Detaljer om Instansens Interconnect Block-instans för en virtuell maskin eller Scale Set VM-instans.

Name	Typ	Description
interconnectSubgroupId	string	ID:t (GUID) för Interconnect-subgruppen där den virtuella maskinen placerades.

KeyVaultKeyReference

Objekt

Beskriver en referens till Key Vault Key

Name	Typ	Description
keyUrl	string	URL:en som refererar till en nyckelkrypteringsnyckel i Key Vault.
sourceVault	SubResource	Den relativa URL:en för nyckelvalvet som innehåller nyckeln.

KeyVaultSecretReference

Objekt

Beskriver en referens till Key Vault Secret

Name	Typ	Description
secretUrl	string	URL:en som refererar till en hemlighet i ett Nyckelvalv.
sourceVault	SubResource	Den relativa URL:en för nyckelvalvet som innehåller hemligheten.

MaintenanceOperationResultCodeTypes

Uppräkning

Resultatkoden för den senaste underhållsåtgärden.

Värde	Description
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Objekt

Status för underhållsåtgärd.

Name	Typ	Description
isCustomerInitiatedMaintenanceAllowed	boolean	Sant, om kunden har tillåtelse att utföra underhåll.
lastOperationMessage	string	Meddelande returnerat för den senaste underhållsåtgärden.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	Resultatkoden för den senaste underhållsåtgärden.
maintenanceWindowEndTime	string (date-time)	Sluttid för underhållsfönstret.
maintenanceWindowStartTime	string (date-time)	Starttid för underhållsfönstret.
preMaintenanceWindowEndTime	string (date-time)	Sluttid för förunderhållsfönstret.
preMaintenanceWindowStartTime	string (date-time)	Starttid för förunderhållsfönstret.

StatusLevelTypes

Uppräkning

Nivåkoden.

Värde	Description
Info
Warning
Error

StorageAlignmentStatus

Uppräkning

Specificerar lagringsjusteringsstatus för disken.

Värde	Description
Unaligned	Disken har inte Storage Fault Domain to Compute Fault Domain-mappning. Ett enda misslyckande lagringsfeldomän kan påverka alla VM:ar som refererar till denna diskprofil.
Aligned	Disken har Storage Fault Domain för att beräkna feldomänmappning. Fel i lagringsdomänen är begränsat till VM:ar i en enda beräkningsfeldomän.

SubResource

Objekt

Name	Typ	Description
id	string	Resurs-ID

VirtualMachineAgentInstanceView

Objekt

Instansvyn för vm-agenten som körs på den virtuella datorn.

Name	Typ	Description
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Instansvyn för hanteraren av tillägget för den virtuella datorn.
statuses	InstanceViewStatus[]	Information om resursstatus.
vmAgentVersion	string	Den fullständiga versionen av VM-agenten.

VirtualMachineExtensionHandlerInstanceView

Objekt

Instansvyn för en tilläggshanterare för virtuella datorer.

Name	Typ	Description
status	InstanceViewStatus	Status för tilläggshanteraren.
type	string	Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".
typeHandlerVersion	string	Specificerar Major.Minor.Patch.Hotfix-versionen av skripthanteraren. Azure-plattformen kommer att leverera den senaste versionen av Patch.Hotfix i Major.Minor-serien.

VirtualMachineExtensionInstanceView

Objekt

Instansvyn för ett tillägg för virtuella datorer.

Name	Typ	Description
name	string	Namnet på det virtuella datortillägget.
statuses	InstanceViewStatus[]	Information om resursstatus.
substatuses	InstanceViewStatus[]	Information om resursstatus.
type	string	Anger filnamnstilläggets typ. ett exempel är "CustomScriptExtension".
typeHandlerVersion	string	Specificerar Major.Minor.Patch.Hotfix-versionen av skripthanteraren. Azure-plattformen kommer att leverera den senaste versionen av Patch.Hotfix i Major.Minor-serien.

VirtualMachineHealthStatus

Objekt

Hälsostatus för den virtuella datorn.

Name	Typ	Description
status	InstanceViewStatus	Hälsostatusinformationen för den virtuella datorn.

VirtualMachineScaleSetVMInstanceView

Objekt

Instansvyn för en virtuell dators skalningsuppsättning virtuell dator.

Name	Typ	Description
assignedHost	string	Resurs-ID för den dedikerade värden, där den virtuella datorn allokeras via automatisk placering, när den virtuella datorn är associerad med en dedikerad värdgrupp som har automatisk placering aktiverad. Lägsta API-version: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Startdiagnostik är en felsökningsfunktion som gör att du kan visa konsolutdata och skärmbild för att diagnostisera VM-status. Du kan enkelt visa utdata från konsolloggen. Med Azure kan du också se en skärmbild av den virtuella datorn från hypervisor-programmet.
capacityReservationType	CapacityReservationType	Specificerar vilken typ av kapacitetsreservation den virtuella maskinskalningsuppsättningen VM-instansen ska använda kapacitet från om den är berättigad, eller om den uttryckligen är avstängd från att vara associerad och använda kapacitet från någon reserverad kapacitet som finns tillgänglig i prenumerationen. Minsta API-version: 2026-04-01.
computerName	string	Anger värdoperativsystemets namn på den virtuella datorn. Det går inte att uppdatera det här namnet när den virtuella datorn har skapats. maxlängd (Windows): 15 tecken Maxlängd (Linux): 64 tecken. Namngivningskonventioner och begränsningar finns i riktlinjer för implementering av Azure-infrastrukturtjänster.
disks	DiskInstanceView[]	Diskinformationen.
extensions	VirtualMachineExtensionInstanceView[]	Tilläggsinformationen.
hyperVGeneration	HyperVGeneration	Hypervisor-genereringen av den virtuella datorn [V1, V2]
interconnectInstanceView	InterconnectInstanceView	Interconnect-runtimevyn för Scale Set VM-instansen. Minsta API-version: 2026-03-01.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Status för underhållsåtgärd på den virtuella datorn.
osName	string	Operativsystemet som körs på hybriddatorn.
osVersion	string	Den version av operativsystemet som körs på hybriddatorn.
placementGroupId	string	Placeringsgruppen där den virtuella datorn körs. Om den virtuella datorn frigörs kommer den inte att ha ett placementGroupId.
platformFaultDomain	integer (int32)	Antal feldomäner.
platformUpdateDomain	integer (int32)	Antalet uppdateringsdomäner.
rdpThumbPrint	string	Tumavtrycket fjärrskrivbordscertifikat.
statuses	InstanceViewStatus[]	Information om resursstatus.
vmAgent	VirtualMachineAgentInstanceView	Vm-agenten som körs på den virtuella datorn.
vmHealth	VirtualMachineHealthStatus	Hälsostatus för den virtuella datorn.