Virtual Machines - Instance View
Hiermee haalt u informatie op 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-03-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
path | True |
string |
Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep. |
vm
|
path | True |
string |
De naam van de virtuele machine. |
api-version
|
query | True |
string |
Client-API-versie. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
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.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2024-03-01
Sample Response
{
"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-03-01T23:11:22+00:00"
}
]
},
"disks": [
{
"name": "myOsDisk",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2024-03-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-03-01T21:30:12.8051917+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running"
}
]
}
Get Virtual Machine Instance View.
Sample Request
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2024-03-01
Sample Response
{
"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 |
---|---|
Api |
API-fout. |
Api |
API-foutbasis. |
Available |
De beschikbare patchsamenvatting van de meest recente evaluatiebewerking voor de virtuele machine. |
Boot |
Diagnostische gegevens over opstarten is een foutopsporingsfunctie waarmee u console-uitvoer en schermopname kunt weergeven om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. In Azure kunt u ook een schermopname van de virtuele machine zien vanuit de hypervisor. |
Cloud |
Een foutreactie van de Compute-service. |
Disk |
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. |
Disk |
De schijfgegevens van de virtuele machine. |
Hyper |
Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource |
Inner |
Details van interne fout. |
Instance |
Status van exemplaarweergave. |
Key |
Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault. |
Key |
Hiermee geeft u de locatie van de schijfversleutelingssleutel op. Dit is een Key Vault Geheim. |
Last |
Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine. |
Maintenance |
De resultaatcode van de laatste onderhoudsbewerking. |
Maintenance |
De onderhoudsbewerkingsstatus op de virtuele machine. |
Patch |
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'. |
Status |
De niveaucode. |
Sub |
De relatieve URL van de Key Vault die het geheim bevat. |
Virtual |
De VM-agent die wordt uitgevoerd op de virtuele machine. |
Virtual |
De instantieweergave van de extensie-handler van de virtuele machine. |
Virtual |
De informatie over extensies. |
Virtual |
De status van de VM. |
Virtual |
De exemplaarweergave van een virtuele machine. |
Virtual |
[Preview-functie] De status van patchbewerkingen voor virtuele machines. |
ApiError
API-fout.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
details |
De API-foutdetails |
|
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
De beschikbare patchsamenvatting van de meest recente evaluatiebewerking voor de virtuele machine.
Name | Type | Description |
---|---|---|
assessmentActivityId |
string |
De activiteits-id van de bewerking die dit resultaat heeft gegenereerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken. |
criticalAndSecurityPatchCount |
integer |
Het aantal kritieke patches of beveiligingspatches dat is gedetecteerd als beschikbaar en nog niet geïnstalleerd. |
error |
De fouten die zijn opgetreden tijdens het uitvoeren van de bewerking. De matrix met details bevat de lijst ervan. |
|
lastModifiedTime |
string |
De UTC-tijdstempel wanneer de bewerking is gestart. |
otherPatchCount |
integer |
Het aantal beschikbare patches, met uitzondering van kritiek en beveiliging. |
rebootPending |
boolean |
De algehele status van opnieuw opstarten van de VM. Dit is waar 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 wanneer de bewerking is gestart. |
status |
De algehele geslaagde of mislukte status 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 foutopsporingsfunctie waarmee u console-uitvoer en schermopname kunt weergeven om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. In Azure kunt u ook een schermopname van de virtuele machine zien vanuit de hypervisor.
Name | Type | Description |
---|---|---|
consoleScreenshotBlobUri |
string |
De blob-URI voor schermopname van de console. Opmerking: Dit wordt niet ingesteld als diagnostische gegevens over opstarten momenteel zijn ingeschakeld met beheerde opslag. |
serialConsoleLogBlobUri |
string |
De blob-URI van het seriële consolelogboek. Opmerking: Dit wordt niet ingesteld als diagnostische gegevens over opstarten momenteel zijn ingeschakeld met beheerde opslag. |
status |
De statusinformatie over diagnostische opstartgegevens voor de VM. 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 |
API-fout. |
DiskEncryptionSettings
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf.
Minimale API-versie: 2015-06-15
Name | Type | Description |
---|---|---|
diskEncryptionKey |
Hiermee geeft u de locatie van de schijfversleutelingssleutel op. Dit is een Key Vault Geheim. |
|
enabled |
boolean |
Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine. |
keyEncryptionKey |
Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault. |
DiskInstanceView
De schijfgegevens van de virtuele machine.
Name | Type | Description |
---|---|---|
encryptionSettings |
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. |
|
name |
string |
De schijfnaam. |
statuses |
De informatie over de resourcestatus. |
HyperVGenerationType
Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource
Name | Type | Description |
---|---|---|
V1 |
string |
|
V2 |
string |
InnerError
Details van interne fout.
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 |
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 |
De relatieve URL van de Key Vault die de sleutel bevat. |
KeyVaultSecretReference
Hiermee geeft u de locatie van de schijfversleutelingssleutel op. Dit is een Key Vault Geheim.
Name | Type | Description |
---|---|---|
secretUrl |
string |
De URL die verwijst naar een geheim in een Key Vault. |
sourceVault |
De relatieve URL van de Key Vault die het geheim bevat. |
LastPatchInstallationSummary
Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine.
Name | Type | Description |
---|---|---|
error |
De fouten die zijn opgetreden tijdens het uitvoeren van de bewerking. De detailmatrix bevat de lijst met de details. |
|
excludedPatchCount |
integer |
Het aantal beschikbare patches dat expliciet is uitgesloten door een door de klant opgegeven uitsluitingslijst komt overeen. |
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 wanneer de bewerking is gestart. |
maintenanceWindowExceeded |
boolean |
Beschrijft of de bewerking te veel tijd heeft bereikt voordat alle beoogde acties zijn voltooid |
notSelectedPatchCount |
integer |
Het aantal beschikbare patches dat niet wordt geïnstalleerd omdat het niet overeenkomt met een vermelding in een classificatie- of opnamelijst. |
pendingPatchCount |
integer |
Het aantal beschikbare patches dat naar verwachting tijdens de installatie van de patch moet worden geïnstalleerd. |
startTime |
string |
De UTC-tijdstempel wanneer de bewerking is gestart. |
status |
De algehele geslaagde of mislukte status 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.
Name | Type | Description |
---|---|---|
MaintenanceAborted |
string |
|
MaintenanceCompleted |
string |
|
None |
string |
|
RetryLater |
string |
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 |
De resultaatcode van de laatste onderhoudsbewerking. |
|
maintenanceWindowEndTime |
string |
Eindtijd voor het onderhoudsvenster. |
maintenanceWindowStartTime |
string |
Begintijd voor het onderhoudsvenster. |
preMaintenanceWindowEndTime |
string |
Eindtijd voor het venster Pre-onderhoud. |
preMaintenanceWindowStartTime |
string |
Begintijd voor het pre-onderhoudsvenster. |
PatchOperationStatus
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.
Name | Type | Description |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
StatusLevelTypes
De niveaucode.
Name | Type | Description |
---|---|---|
Error |
string |
|
Info |
string |
|
Warning |
string |
SubResource
De relatieve URL van de Key Vault 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 |
De instantieweergave van de extensie-handler van de virtuele machine. |
|
statuses |
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 |
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 op. |
VirtualMachineExtensionInstanceView
De informatie over extensies.
Name | Type | Description |
---|---|---|
name |
string |
De naam van de extensie van de virtuele machine. |
statuses |
De informatie over de resourcestatus. |
|
substatuses |
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 op. |
VirtualMachineHealthStatus
De status van de VM.
Name | Type | Description |
---|---|---|
status |
De statusinformatie voor de VM. |
VirtualMachineInstanceView
De exemplaarweergave van een virtuele machine.
Name | Type | Description |
---|---|---|
assignedHost |
string |
Resource-id van de toegewezen host, waarop de virtuele machine is 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 |
Diagnostische gegevens over opstarten is een foutopsporingsfunctie waarmee u console-uitvoer en schermopname kunt weergeven om de VM-status te diagnosticeren. U kunt eenvoudig de uitvoer van uw consolelogboek bekijken. In Azure kunt u ook een schermopname van de virtuele machine zien vanuit de hypervisor. |
|
computerName |
string |
De computernaam die is toegewezen aan de virtuele machine. |
disks |
De schijfgegevens van de virtuele machine. |
|
extensions |
De informatie over extensies. |
|
hyperVGeneration |
Hiermee geeft u het HyperVGeneration-type dat is gekoppeld aan een resource |
|
isVMInStandbyPool |
boolean |
[Preview-functie] Hiermee geeft u op of de VM zich momenteel in of buiten de stand-bygroep bevindt. |
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 dat wordt uitgevoerd op de virtuele machine. |
patchStatus |
[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 |
De informatie over de resourcestatus. |
|
vmAgent |
De VM-agent die wordt uitgevoerd op de virtuele machine. |
|
vmHealth |
De status van de VM. |
VirtualMachinePatchStatus
[Preview-functie] De status van patchbewerkingen voor virtuele machines.
Name | Type | Description |
---|---|---|
availablePatchSummary |
De beschikbare patchsamenvatting van de meest recente evaluatiebewerking voor de virtuele machine. |
|
configurationStatuses |
De activeringsstatus van de opgegeven patchMode |
|
lastPatchInstallationSummary |
Het installatieoverzicht van de meest recente installatiebewerking voor de virtuele machine. |