Virtual Machines - Instance View

Recupera información sobre el estado en tiempo de ejecución de una máquina virtual.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

Identificador de la suscripción de destino.

vmName
path True

string

El nombre de la máquina virtual.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Respuestas

Nombre Tipo Description
200 OK

VirtualMachineInstanceView

La operación de Azure se completó correctamente.

Other Status Codes

CloudError

Una respuesta de error inesperada.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre Description
user_impersonation suplantar su cuenta de usuario

Ejemplos

Get instance view of a virtual machine associated with an Interconnect Block.
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 associated with an Interconnect Block.

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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": "2026-03-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2026-03-01T21:29:47.477089+00:00"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "interconnectInstanceView": {
    "interconnectSubgroupId": "{GUID}"
  },
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2026-03-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

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

Solicitud de ejemplo

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

Respuesta de muestra

{
  "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": "2025-04-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2025-04-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": "2025-04-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Get Virtual Machine Instance View.

Solicitud de ejemplo

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

Respuesta de muestra

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

Definiciones

Nombre Description
ApiError

Error de API.

ApiErrorBase

Base de errores de api.

AvailablePatchSummary

Describe las propiedades de una vista de instancia de máquina virtual para el resumen de revisión disponible.

BootDiagnosticsInstanceView

Vista de instancia de un diagnóstico de arranque de máquina virtual.

CloudError

Respuesta de error del servicio Compute.

DiskEncryptionSettings

Describe una configuración de cifrado para un disco

DiskInstanceView

Vista de instancia del disco.

HyperVGenerationType

Especifica el tipo hyperVGeneration asociado a un recurso.

InnerError

Detalles del error interno.

InstanceViewStatus

Estado de la vista de instancia.

InterconnectInstanceView

Los detalles de la vista de la instancia de Interconnect Block para una máquina virtual o una VM con conjunto de escalas.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault.

LastPatchInstallationSummary

Describe las propiedades del último resumen de revisión instalado.

MaintenanceOperationResultCodeTypes

Código de resultado de la última operación de mantenimiento.

MaintenanceRedeployStatus

Estado de la operación de mantenimiento.

PatchOperationStatus

El estado general de éxito o fracaso de la operación. Permanece "InProgress" hasta que se completa la operación. En ese momento, se convertirá en "Desconocido", "Error", "Correcto" o "CompletedWithWarnings".

StatusLevelTypes

Código de nivel.

StorageAlignmentStatus

Especifica el estado de alineación de almacenamiento para el disco.

SubResource
VirtualMachineAgentInstanceView

Vista de instancia del agente de máquina virtual que se ejecuta en la máquina virtual.

VirtualMachineExtensionHandlerInstanceView

Vista de instancia de un controlador de extensión de máquina virtual.

VirtualMachineExtensionInstanceView

Vista de instancia de una extensión de máquina virtual.

VirtualMachineHealthStatus

Estado de mantenimiento de la máquina virtual.

VirtualMachineInstanceView

Vista de instancia de una máquina virtual.

VirtualMachinePatchStatus

Estado de las operaciones de revisión de máquina virtual.

ApiError

Error de API.

Nombre Tipo Description
code

string

Código de error.

details

ApiErrorBase[]

Detalles del error de api

innererror

InnerError

Error interno de api

message

string

El mensaje de error.

target

string

Destino del error concreto.

ApiErrorBase

Base de errores de api.

Nombre Tipo Description
code

string

Código de error.

message

string

El mensaje de error.

target

string

Destino del error concreto.

AvailablePatchSummary

Describe las propiedades de una vista de instancia de máquina virtual para el resumen de revisión disponible.

Nombre Tipo Description
assessmentActivityId

string

El identificador de actividad de la operación que produjo este resultado. Se usa para correlacionar los registros de CRP y de extensión.

criticalAndSecurityPatchCount

integer (int32)

Número de revisiones críticas o de seguridad que se han detectado como disponibles y que aún no están instaladas.

error

ApiError

Los errores que se encontraron durante la ejecución de la operación. La matriz details contiene la lista de ellos.

lastModifiedTime

string (date-time)

La marca de tiempo UTC cuando comenzó la operación.

otherPatchCount

integer (int32)

El número de todas las revisiones disponibles, excepto la crítica y la seguridad.

rebootPending

boolean

El estado general de reinicio de la máquina virtual. Será cierto cuando los parches instalados parcialmente requieran un reinicio para completar la instalación, pero el reinicio aún no se haya producido.

startTime

string (date-time)

La marca de tiempo UTC cuando comenzó la operación.

status

PatchOperationStatus

El estado general de éxito o fracaso de la operación. Permanece "InProgress" hasta que se completa la operación. En ese momento, se convertirá en "Desconocido", "Error", "Correcto" o "CompletedWithWarnings".

BootDiagnosticsInstanceView

Vista de instancia de un diagnóstico de arranque de máquina virtual.

Nombre Tipo Description
consoleScreenshotBlobUri

string

El URI del blob de la consola. Nota: Esto no establecer si el diagnóstico de arranque está habilitado actualmente con almacenamiento administrado.

serialConsoleLogBlobUri

string

Uri del blob de registro de la consola serie. Nota: Esto no establecer si el diagnóstico de arranque está habilitado actualmente con almacenamiento administrado.

status

InstanceViewStatus

La información de estado de diagnóstico de arranque de la máquina virtual. Nota: Solo se establecerá si se producen errores al habilitar los diagnósticos de arranque.

CloudError

Respuesta de error del servicio Compute.

Nombre Tipo Description
error

ApiError

Error de API.

DiskEncryptionSettings

Describe una configuración de cifrado para un disco

Nombre Tipo Description
diskEncryptionKey

KeyVaultSecretReference

Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault.

enabled

boolean

Especifica si se debe habilitar el cifrado de disco en la máquina virtual.

keyEncryptionKey

KeyVaultKeyReference

Especifica la ubicación de la clave de cifrado de claves en Key Vault.

DiskInstanceView

Vista de instancia del disco.

Nombre Tipo Description
encryptionSettings

DiskEncryptionSettings[]

Especifica la configuración de cifrado del disco del sistema operativo.

Versión mínima de api: 2015-06-15

name

string

Nombre del disco.

statuses

InstanceViewStatus[]

Información de estado del recurso.

storageAlignmentStatus

StorageAlignmentStatus

Especifica el estado de alineación de almacenamiento para el disco.

HyperVGenerationType

Especifica el tipo hyperVGeneration asociado a un recurso.

Valor Description
V1
V2

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

Mensaje de error interno o volcado de memoria de excepciones.

exceptiontype

string

Tipo de la excepción.

InstanceViewStatus

Estado de la vista de instancia.

Nombre Tipo Description
code

string

Código de estado.

displayStatus

string

Etiqueta localizable corta para el estado.

level

StatusLevelTypes

Código de nivel.

message

string

Mensaje de estado detallado, incluido para alertas y mensajes de error.

time

string (date-time)

Hora del estado.

InterconnectInstanceView

Los detalles de la vista de la instancia de Interconnect Block para una máquina virtual o una VM con conjunto de escalas.

Nombre Tipo Description
interconnectSubgroupId

string

El ID (GUID) del subgrupo de Interconexión en el que se colocó la Máquina Virtual.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault.

Nombre Tipo Description
keyUrl

string

Dirección URL que hace referencia a una clave de cifrado de claves en Key Vault.

sourceVault

SubResource

Dirección URL relativa del almacén de claves que contiene la clave.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault.

Nombre Tipo Description
secretUrl

string

Dirección URL que hace referencia a un secreto en un almacén de claves.

sourceVault

SubResource

Dirección URL relativa del almacén de claves que contiene el secreto.

LastPatchInstallationSummary

Describe las propiedades del último resumen de revisión instalado.

Nombre Tipo Description
error

ApiError

Los errores que se encontraron durante la ejecución de la operación. La matriz details contiene la lista de ellos.

excludedPatchCount

integer (int32)

Número de todas las revisiones disponibles pero excluidas explícitamente por una coincidencia de lista de exclusión especificada por el cliente.

failedPatchCount

integer (int32)

Recuento de revisiones con errores de instalación.

installationActivityId

string

El identificador de actividad de la operación que produjo este resultado. Se usa para correlacionar los registros de CRP y de extensión.

installedPatchCount

integer (int32)

Recuento de revisiones que se instalaron correctamente.

lastModifiedTime

string (date-time)

La marca de tiempo UTC cuando comenzó la operación.

maintenanceWindowExceeded

boolean

Describe si la operación se agotó el tiempo antes de completar todas sus acciones deseadas.

notSelectedPatchCount

integer (int32)

Número de todas las revisiones disponibles, pero no se instalarán porque no coincide con una entrada de lista de clasificación o inclusión.

pendingPatchCount

integer (int32)

Número de todas las revisiones disponibles que se espera que se instalen durante la operación de instalación de revisiones.

startTime

string (date-time)

La marca de tiempo UTC cuando comenzó la operación.

status

PatchOperationStatus

El estado general de éxito o fracaso de la operación. Permanece "InProgress" hasta que se completa la operación. En ese momento, se convertirá en "Desconocido", "Error", "Correcto" o "CompletedWithWarnings".

MaintenanceOperationResultCodeTypes

Código de resultado de la última operación de mantenimiento.

Valor Description
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Estado de la operación de mantenimiento.

Nombre Tipo Description
isCustomerInitiatedMaintenanceAllowed

boolean

True, si el cliente puede realizar el mantenimiento.

lastOperationMessage

string

Mensaje devuelto para la última operación de mantenimiento.

lastOperationResultCode

MaintenanceOperationResultCodeTypes

Código de resultado de la última operación de mantenimiento.

maintenanceWindowEndTime

string (date-time)

Hora de finalización de la ventana de mantenimiento.

maintenanceWindowStartTime

string (date-time)

Hora de inicio de la ventana de mantenimiento.

preMaintenanceWindowEndTime

string (date-time)

Hora de finalización de la ventana de mantenimiento previo.

preMaintenanceWindowStartTime

string (date-time)

Hora de inicio de la ventana de mantenimiento previo.

PatchOperationStatus

El estado general de éxito o fracaso de la operación. Permanece "InProgress" hasta que se completa la operación. En ese momento, se convertirá en "Desconocido", "Error", "Correcto" o "CompletedWithWarnings".

Valor Description
Unknown
InProgress
Failed
Succeeded
CompletedWithWarnings

StatusLevelTypes

Código de nivel.

Valor Description
Info
Warning
Error

StorageAlignmentStatus

Especifica el estado de alineación de almacenamiento para el disco.

Valor Description
Unaligned

El disco no tiene Dominio de Fallas de Almacenamiento para Calcular el mapeo del Dominio de Fallas. Un único fallo en el Dominio de Fallo de Almacenamiento puede afectar a todas las máquinas virtuales que hacen referencia a este perfil de disco.

Aligned

El disco tiene Dominio de Fallas de Almacenamiento para Calcular el mapeo del dominio de fallos. El fallo del dominio de fallo de almacenamiento está contenido en las máquinas virtuales en un único dominio de fallo de cálculo.

SubResource

Nombre Tipo Description
id

string

Identificador de recurso

VirtualMachineAgentInstanceView

Vista de instancia del agente de máquina virtual que se ejecuta en la máquina virtual.

Nombre Tipo Description
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

Vista de instancia del controlador de extensión de máquina virtual.

statuses

InstanceViewStatus[]

Información de estado del recurso.

vmAgentVersion

string

Versión completa del agente de máquina virtual.

VirtualMachineExtensionHandlerInstanceView

Vista de instancia de un controlador de extensión de máquina virtual.

Nombre Tipo Description
status

InstanceViewStatus

Estado del controlador de extensión.

type

string

Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

typeHandlerVersion

string

Especifica la versión del controlador de script.

VirtualMachineExtensionInstanceView

Vista de instancia de una extensión de máquina virtual.

Nombre Tipo Description
name

string

Nombre de la extensión de máquina virtual.

statuses

InstanceViewStatus[]

Información de estado del recurso.

substatuses

InstanceViewStatus[]

Información de estado del recurso.

type

string

Especifica el tipo de la extensión; Un ejemplo es "CustomScriptExtension".

typeHandlerVersion

string

Especifica la versión del controlador de script.

VirtualMachineHealthStatus

Estado de mantenimiento de la máquina virtual.

Nombre Tipo Description
status

InstanceViewStatus

Información de estado de mantenimiento de la máquina virtual.

VirtualMachineInstanceView

Vista de instancia de una máquina virtual.

Nombre Tipo Description
assignedHost

string

Identificador de recurso del host dedicado, en el que se asigna la máquina virtual a través de la colocación automática, cuando la máquina virtual está asociada a un grupo host dedicado que tiene habilitada la selección de ubicación automática. Versión mínima de api: 2020-06-01.

bootDiagnostics

BootDiagnosticsInstanceView

El diagnóstico de arranque es una característica de depuración que permite ver la salida de la consola y la captura de pantalla para diagnosticar el estado de la máquina virtual. Puede ver fácilmente la salida del registro de consola. Azure también le permite ver una captura de pantalla de la máquina virtual desde el hipervisor.

computerName

string

Nombre de equipo asignado a la máquina virtual.

disks

DiskInstanceView[]

Información del disco de la máquina virtual.

extensions

VirtualMachineExtensionInstanceView[]

La información de extensiones.

hyperVGeneration

HyperVGenerationType

Especifica el tipo hyperVGeneration asociado a un recurso.

interconnectInstanceView

InterconnectInstanceView

La vista de ejecución de Interconnect de la Máquina Virtual. Versión mínima de la API: 01-03-2026.

isVMInStandbyPool

boolean

[Característica de vista previa] Especifica si la máquina virtual está actualmente dentro o fuera del grupo de espera.

maintenanceRedeployStatus

MaintenanceRedeployStatus

Estado de la operación de mantenimiento en la máquina virtual.

osName

string

Sistema operativo que se ejecuta en la máquina virtual.

osVersion

string

Versión del sistema operativo que se ejecuta en la máquina virtual.

patchStatus

VirtualMachinePatchStatus

[Característica de vista previa] Estado de las operaciones de revisión de máquina virtual.

platformFaultDomain

integer (int32)

Especifica el dominio de error de la máquina virtual.

platformUpdateDomain

integer (int32)

Especifica el dominio de actualización de la máquina virtual.

rdpThumbPrint

string

Huella digital del certificado de Escritorio remoto.

statuses

InstanceViewStatus[]

Información de estado del recurso.

vmAgent

VirtualMachineAgentInstanceView

Agente de máquina virtual que se ejecuta en la máquina virtual.

vmHealth

VirtualMachineHealthStatus

Estado de mantenimiento de la máquina virtual.

VirtualMachinePatchStatus

Estado de las operaciones de revisión de máquina virtual.

Nombre Tipo Description
availablePatchSummary

AvailablePatchSummary

El resumen de revisión disponible de la operación de evaluación más reciente para la máquina virtual.

configurationStatuses

InstanceViewStatus[]

Estado de habilitación del patchMode especificado

lastPatchInstallationSummary

LastPatchInstallationSummary

Resumen de instalación de la operación de instalación más reciente para la máquina virtual.