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 |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
path | True |
string |
Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep. |
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
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
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
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 |
---|---|
Api |
Api-fout. |
Api |
Api-foutbasis. |
Available |
Het beschikbare patchoverzicht van de meest recente evaluatiebewerking voor de virtuele machine. |
Boot |
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. |
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 |
Interne foutdetails. |
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, een Sleutelkluisgeheim. |
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 succes- of foutstatus 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 sleutelkluis 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 uitbreidingsgegevens. |
Virtual |
De status van de VIRTUELE machine. |
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 |
Details van de API-fout |
|
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 |
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 |
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 |
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 |
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, een Sleutelkluisgeheim. |
|
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 naam van de schijf. |
statuses |
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 |
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 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 |
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 |
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 |
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 |
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 |
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. |
VirtualMachineExtensionInstanceView
De uitbreidingsgegevens.
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. |
VirtualMachineHealthStatus
De status van de VIRTUELE machine.
Name | Type | Description |
---|---|---|
status |
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 |
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 |
De schijfgegevens van de virtuele machine. |
|
extensions |
De uitbreidingsgegevens. |
|
hyperVGeneration |
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 |
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 |
[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 VIRTUELE machine. |
VirtualMachinePatchStatus
[Preview-functie] De status van patchbewerkingen voor virtuele machines.
Name | Type | Description |
---|---|---|
availablePatchSummary |
Het beschikbare patchoverzicht 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. |