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 |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
Identificador de la suscripción de destino. |
|
vm
|
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 |
La operación de Azure se completó correctamente. |
|
| Other Status Codes |
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.
Solicitud de ejemplo
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
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
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 |
|---|---|
|
Api |
Error de API. |
|
Api |
Base de errores de api. |
|
Available |
Describe las propiedades de una vista de instancia de máquina virtual para el resumen de revisión disponible. |
|
Boot |
Vista de instancia de un diagnóstico de arranque de máquina virtual. |
|
Cloud |
Respuesta de error del servicio Compute. |
|
Disk |
Describe una configuración de cifrado para un disco |
|
Disk |
Vista de instancia del disco. |
|
Hyper |
Especifica el tipo hyperVGeneration asociado a un recurso. |
|
Inner |
Detalles del error interno. |
|
Instance |
Estado de la vista de instancia. |
|
Interconnect |
Los detalles de la vista de la instancia de Interconnect Block para una máquina virtual o una VM con conjunto de escalas. |
|
Key |
Describe una referencia a la clave de Key Vault. |
|
Key |
Describe una referencia al secreto de Key Vault. |
|
Last |
Describe las propiedades del último resumen de revisión instalado. |
|
Maintenance |
Código de resultado de la última operación de mantenimiento. |
|
Maintenance |
Estado de la operación de mantenimiento. |
|
Patch |
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". |
|
Status |
Código de nivel. |
|
Storage |
Especifica el estado de alineación de almacenamiento para el disco. |
|
Sub |
|
|
Virtual |
Vista de instancia del agente de máquina virtual que se ejecuta en la máquina virtual. |
|
Virtual |
Vista de instancia de un controlador de extensión de máquina virtual. |
|
Virtual |
Vista de instancia de una extensión de máquina virtual. |
|
Virtual |
Estado de mantenimiento de la máquina virtual. |
|
Virtual |
Vista de instancia de una máquina virtual. |
|
Virtual |
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 |
Detalles del error de api |
|
| 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 |
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 |
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 |
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 |
Error de API. |
DiskEncryptionSettings
Describe una configuración de cifrado para un disco
| Nombre | Tipo | Description |
|---|---|---|
| diskEncryptionKey |
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 |
Especifica la ubicación de la clave de cifrado de claves en Key Vault. |
DiskInstanceView
Vista de instancia del disco.
| Nombre | Tipo | Description |
|---|---|---|
| encryptionSettings |
Especifica la configuración de cifrado del disco del sistema operativo. |
|
| name |
string |
Nombre del disco. |
| statuses |
Información de estado del recurso. |
|
| 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 |
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 |
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 |
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 |
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 |
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 |
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 |
Vista de instancia del controlador de extensión de máquina virtual. |
|
| statuses |
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 |
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 |
Información de estado del recurso. |
|
| substatuses |
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 |
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 |
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 |
Información del disco de la máquina virtual. |
|
| extensions |
La información de extensiones. |
|
| hyperVGeneration |
Especifica el tipo hyperVGeneration asociado a un recurso. |
|
| 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 |
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 |
[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 |
Información de estado del recurso. |
|
| vmAgent |
Agente de máquina virtual que se ejecuta en la máquina virtual. |
|
| vmHealth |
Estado de mantenimiento de la máquina virtual. |
VirtualMachinePatchStatus
Estado de las operaciones de revisión de máquina virtual.
| Nombre | Tipo | Description |
|---|---|---|
| availablePatchSummary |
El resumen de revisión disponible de la operación de evaluación más reciente para la máquina virtual. |
|
| configurationStatuses |
Estado de habilitación del patchMode especificado |
|
| lastPatchInstallationSummary |
Resumen de instalación de la operación de instalación más reciente para la máquina virtual. |