Delen via


Virtual Machines - Instance View

Hiermee wordt informatie opgehaald over de runtimestatus van een virtuele machine.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2024-07-01

URI-parameters

Name In Vereist Type Description
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

vmName
path True

string

De naam van de virtuele machine.

api-version
query True

string

Client-API-versie.

Antwoorden

Name Type Description
200 OK

VirtualMachineInstanceView

OK

Other Status Codes

CloudError

Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

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 placed on a dedicated host group through automatic placement.
Get Virtual Machine Instance View.

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

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2024-07-01

Voorbeeldrespons

{
  "computerName": "myVM",
  "osName": "Windows Server 2016 Datacenter",
  "osVersion": "Microsoft Windows NT 10.0.14393.0",
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.949",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and accepting new configurations.",
        "time": "2024-07-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2024-07-01T21:29:47.477089+00:00"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2024-07-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Get Virtual Machine Instance View.

Voorbeeldaanvraag

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2024-07-01

Voorbeeldrespons

{
  "platformUpdateDomain": 1,
  "platformFaultDomain": 1,
  "computerName": "myVM",
  "osName": "Windows Server 2016 Datacenter",
  "osVersion": "Microsoft Windows NT 10.0.14393.0",
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.949",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and accepting new configurations.",
        "time": "2019-10-14T23:11:22+00:00"
      }
    ],
    "extensionHandlers": [
      {
        "type": "Microsoft.Azure.Security.IaaSAntimalware",
        "typeHandlerVersion": "1.5.5.9",
        "status": {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Ready"
        }
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2019-10-14T21:29:47.477089+00:00"
        }
      ]
    },
    {
      "name": "myDataDisk0",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2019-10-14T21:29:47.461517+00:00"
        }
      ]
    }
  ],
  "bootDiagnostics": {
    "consoleScreenshotBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.screenshot.bmp",
    "serialConsoleLogBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.serialconsole.log"
  },
  "extensions": [
    {
      "name": "IaaSAntiMalware-ext0",
      "type": "Microsoft.Azure.Security.IaaSAntimalware",
      "typeHandlerVersion": "1.5.5.9",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": "Microsoft Antimalware enabled"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "patchStatus": {
    "availablePatchSummary": {
      "status": "Succeeded",
      "assessmentActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
      "rebootPending": true,
      "criticalAndSecurityPatchCount": 1,
      "otherPatchCount": 2,
      "startTime": "2020-04-24T21:02:04.2556154Z",
      "lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
      "error": null
    },
    "lastPatchInstallationSummary": {
      "status": "Succeeded",
      "installationActivityId": "68f8b292-dfc2-4646-9981-33cc88631968",
      "maintenanceWindowExceeded": false,
      "notSelectedPatchCount": 1,
      "excludedPatchCount": 1,
      "pendingPatchCount": 1,
      "installedPatchCount": 1,
      "failedPatchCount": 1,
      "startTime": "2020-04-24T21:02:04.2556154Z",
      "lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
      "error": null
    },
    "configurationStatuses": [
      {
        "code": "PatchModeConfigurationState/Ready",
        "level": "Info",
        "displayStatus": "Status_PatchModeConfigurationState_Ready",
        "time": "2020-04-24T21:02:04.2556154Z"
      },
      {
        "code": "AssessmentModeConfigurationState/Pending",
        "level": "Info",
        "displayStatus": "Status_AssessmentModeConfigurationState_Pending",
        "time": "2020-04-24T21:02:04.2556154Z"
      }
    ]
  },
  "isVMInStandbyPool": false,
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2019-10-14T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Definities

Name Description
ApiError

Api-fout.

ApiErrorBase

Api-foutbasis.

AvailablePatchSummary

Het beschikbare patchoverzicht van de meest recente evaluatiebewerking voor de virtuele machine.

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. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.

CloudError

Een foutreactie van de Compute-service.

DiskEncryptionSettings

Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf.

Minimale API-versie: 2015-06-15

DiskInstanceView

De schijfgegevens van de virtuele machine.

HyperVGenerationType

Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource

InnerError

Interne foutdetails.

InstanceViewStatus

Status van exemplaarweergave.

KeyVaultKeyReference

Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.

KeyVaultSecretReference

Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.

LastPatchInstallationSummary

Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine.

MaintenanceOperationResultCodeTypes

De resultaatcode van de laatste onderhoudsbewerking.

MaintenanceRedeployStatus

De onderhoudsbewerkingsstatus op de virtuele machine.

PatchOperationStatus

De algehele succes- of foutstatus van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.

StatusLevelTypes

De niveaucode.

SubResource

De relatieve URL van de sleutelkluis die het geheim bevat.

VirtualMachineAgentInstanceView

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

VirtualMachineExtensionHandlerInstanceView

De instantieweergave van de extensie-handler van de virtuele machine.

VirtualMachineExtensionInstanceView

De uitbreidingsgegevens.

VirtualMachineHealthStatus

De status van de VIRTUELE machine.

VirtualMachineInstanceView

De exemplaarweergave van een virtuele machine.

VirtualMachinePatchStatus

[Preview-functie] De status van patchbewerkingen voor virtuele machines.

ApiError

Api-fout.

Name Type Description
code

string

De foutcode.

details

ApiErrorBase[]

Details van de API-fout

innererror

InnerError

De interne API-fout

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

ApiErrorBase

Api-foutbasis.

Name Type Description
code

string

De foutcode.

message

string

Het foutbericht.

target

string

Het doel van de specifieke fout.

AvailablePatchSummary

Het beschikbare patchoverzicht van de meest recente evaluatiebewerking voor de virtuele machine.

Name Type Description
assessmentActivityId

string

De activiteits-id van de bewerking die dit resultaat heeft geproduceerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken.

criticalAndSecurityPatchCount

integer

Het aantal kritieke of beveiligingspatches dat is gedetecteerd als beschikbaar en nog niet is geïnstalleerd.

error

ApiError

De fouten die zijn opgetreden tijdens de uitvoering van de bewerking. De detailmatrix bevat de lijst met deze.

lastModifiedTime

string

De UTC-tijdstempel waarop de bewerking is gestart.

otherPatchCount

integer

Het aantal beschikbare patches, met uitzondering van kritieke en beveiliging.

rebootPending

boolean

De algehele herstartstatus van de virtuele machine. Dit geldt wanneer gedeeltelijk geïnstalleerde patches opnieuw moeten worden opgestart om de installatie te voltooien, maar het opnieuw opstarten nog niet is opgetreden.

startTime

string

De UTC-tijdstempel waarop de bewerking is gestart.

status

PatchOperationStatus

De algehele succes- of foutstatus van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.

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. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.

Name Type Description
consoleScreenshotBlobUri

string

De schermafbeelding van de blob-URI van de console. Opmerking: Dit niet worden ingesteld als diagnostische gegevens over opstarten momenteel zijn ingeschakeld met beheerde opslag.

serialConsoleLogBlobUri

string

De blob-URI van het seriële consolelogboek. Opmerking: Dit niet worden ingesteld als diagnostische gegevens over opstarten momenteel zijn ingeschakeld met beheerde opslag.

status

InstanceViewStatus

De statusinformatie over diagnostische gegevens over opstarten voor de virtuele machine. Opmerking: Deze wordt alleen ingesteld als er fouten zijn opgetreden bij het inschakelen van diagnostische gegevens over opstarten.

CloudError

Een foutreactie van de Compute-service.

Name Type Description
error

ApiError

Api-fout.

DiskEncryptionSettings

Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf.

Minimale API-versie: 2015-06-15

Name Type Description
diskEncryptionKey

KeyVaultSecretReference

Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.

enabled

boolean

Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine.

keyEncryptionKey

KeyVaultKeyReference

Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.

DiskInstanceView

De schijfgegevens van de virtuele machine.

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.

HyperVGenerationType

Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource

Waarde Description
V1
V2

InnerError

Interne foutdetails.

Name Type Description
errordetail

string

Het interne foutbericht of de uitzonderingsdump.

exceptiontype

string

Het uitzonderingstype.

InstanceViewStatus

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

Het tijdstip van de status.

KeyVaultKeyReference

Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.

Name Type Description
keyUrl

string

De URL die verwijst naar een sleutelversleutelingssleutel in Key Vault.

sourceVault

SubResource

De relatieve URL van de sleutelkluis die de sleutel bevat.

KeyVaultSecretReference

Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.

Name Type Description
secretUrl

string

De URL die verwijst naar een geheim in een Sleutelkluis.

sourceVault

SubResource

De relatieve URL van de sleutelkluis die het geheim bevat.

LastPatchInstallationSummary

Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine.

Name Type Description
error

ApiError

De fouten die zijn opgetreden tijdens de uitvoering van de bewerking. De detailmatrix bevat de lijst met deze.

excludedPatchCount

integer

Het aantal beschikbare patches, maar expliciet uitgesloten door een door de klant opgegeven uitsluitingslijst.

failedPatchCount

integer

Het aantal patches waarvoor de installatie is mislukt.

installationActivityId

string

De activiteits-id van de bewerking die dit resultaat heeft geproduceerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken.

installedPatchCount

integer

Het aantal patches dat is geïnstalleerd.

lastModifiedTime

string

De UTC-tijdstempel waarop de bewerking is gestart.

maintenanceWindowExceeded

boolean

Beschrijft of de bewerking onvoldoende tijd heeft voordat alle beoogde acties zijn voltooid

notSelectedPatchCount

integer

Het aantal beschikbare patches, maar niet wordt geïnstalleerd omdat deze niet overeenkomt met een classificatie- of opnamelijstvermelding.

pendingPatchCount

integer

Het aantal beschikbare patches dat naar verwachting tijdens de installatie van de patch wordt geïnstalleerd.

startTime

string

De UTC-tijdstempel waarop de bewerking is gestart.

status

PatchOperationStatus

De algehele succes- of foutstatus van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.

MaintenanceOperationResultCodeTypes

De resultaatcode van de laatste onderhoudsbewerking.

Waarde Description
MaintenanceAborted
MaintenanceCompleted
None
RetryLater

MaintenanceRedeployStatus

De onderhoudsbewerkingsstatus op de virtuele machine.

Name Type Description
isCustomerInitiatedMaintenanceAllowed

boolean

Waar, als de klant onderhoud mag uitvoeren.

lastOperationMessage

string

Bericht geretourneerd voor de laatste onderhoudsbewerking.

lastOperationResultCode

MaintenanceOperationResultCodeTypes

De resultaatcode van de laatste onderhoudsbewerking.

maintenanceWindowEndTime

string

Eindtijd voor het onderhoudsvenster.

maintenanceWindowStartTime

string

Begintijd voor het onderhoudsvenster.

preMaintenanceWindowEndTime

string

Eindtijd voor het venster Voor onderhoud.

preMaintenanceWindowStartTime

string

Begintijd voor het venster Voor onderhoud.

PatchOperationStatus

De algehele succes- of foutstatus van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.

Waarde Description
CompletedWithWarnings
Failed
InProgress
Succeeded
Unknown

StatusLevelTypes

De niveaucode.

Waarde Description
Error
Info
Warning

SubResource

De relatieve URL van de sleutelkluis die het geheim bevat.

Name Type Description
id

string

Resource-id

VirtualMachineAgentInstanceView

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

Name Type Description
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

De instantieweergave van de extensie-handler van de virtuele machine.

statuses

InstanceViewStatus[]

De informatie over de resourcestatus.

vmAgentVersion

string

De volledige versie van de VM-agent.

VirtualMachineExtensionHandlerInstanceView

De instantieweergave van de extensie-handler van de 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

De uitbreidingsgegevens.

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

De status van de VIRTUELE machine.

Name Type Description
status

InstanceViewStatus

De statusinformatie voor de VIRTUELE machine.

VirtualMachineInstanceView

De exemplaarweergave van een virtuele machine.

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. Met Azure kunt u ook een schermopname van de virtuele machine bekijken vanuit de hypervisor.

computerName

string

De computernaam die is toegewezen aan de virtuele machine.

disks

DiskInstanceView[]

De schijfgegevens van de virtuele machine.

extensions

VirtualMachineExtensionInstanceView[]

De uitbreidingsgegevens.

hyperVGeneration

HyperVGenerationType

Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource

isVMInStandbyPool

boolean

[Preview-functie] Hiermee geeft u op of de VIRTUELE machine zich momenteel in of buiten de stand-bypool bevindt.

maintenanceRedeployStatus

MaintenanceRedeployStatus

De onderhoudsbewerkingsstatus op de virtuele machine.

osName

string

Het besturingssysteem dat wordt uitgevoerd op de virtuele machine.

osVersion

string

De versie van het besturingssysteem die wordt uitgevoerd op de virtuele machine.

patchStatus

VirtualMachinePatchStatus

[Preview-functie] De status van patchbewerkingen voor virtuele machines.

platformFaultDomain

integer

Hiermee geeft u het foutdomein van de virtuele machine.

platformUpdateDomain

integer

Hiermee geeft u het updatedomein van de virtuele machine.

rdpThumbPrint

string

De vingerafdruk van het extern bureaublad-certificaat.

statuses

InstanceViewStatus[]

De informatie over de resourcestatus.

vmAgent

VirtualMachineAgentInstanceView

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

vmHealth

VirtualMachineHealthStatus

De status van de VIRTUELE machine.

VirtualMachinePatchStatus

[Preview-functie] De status van patchbewerkingen voor virtuele machines.

Name Type Description
availablePatchSummary

AvailablePatchSummary

Het beschikbare patchoverzicht van de meest recente evaluatiebewerking voor de virtuele machine.

configurationStatuses

InstanceViewStatus[]

De activeringsstatus van de opgegeven patchMode

lastPatchInstallationSummary

LastPatchInstallationSummary

Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine.