Virtual Machine Scale Set VMs - Get Instance View
Obtiene el estado de una máquina virtual de un conjunto de escalado de máquinas virtuales.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/instanceView?api-version=2026-03-01
Parámetros de identificador URI
| Nombre | En | Requerido | Tipo | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Identificador de instancia de la máquina virtual. |
|
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 |
Nombre del conjunto de escalado de máquinas virtuales. |
|
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 from a VM scale set 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/virtualMachineScaleSets/myVirtualMachineScaleSet/virtualMachines/0/instanceView?api-version=2026-03-01
Respuesta de muestra
{
"platformUpdateDomain": 0,
"platformFaultDomain": 0,
"rdpThumbPrint": null,
"vmAgent": {
"vmAgentVersion": "Unknown",
"statuses": [
{
"code": "ProvisioningState/Unavailable",
"level": "Warning",
"displayStatus": "Not Ready",
"message": "VM status blob is found but not yet populated.",
"time": "2025-04-01T05:00:32+00:00"
}
],
"extensionHandlers": null
},
"disks": [
{
"name": "myOSDisk",
"encryptionSettings": null,
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"message": null,
"time": "2025-04-01T04:58:58.0882815+00:00"
}
]
}
],
"extensions": null,
"assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
"bootDiagnostics": null,
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"message": null,
"time": "2020-06-05T04:59:58.1852966+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running",
"message": null,
"time": null
}
]
}
Definiciones
| Nombre | Description |
|---|---|
|
Api |
Error de API. |
|
Api |
Base de errores de api. |
|
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 |
Generación del hipervisor de la máquina virtual [V1, V2] |
|
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. |
|
Maintenance |
Código de resultado de la última operación de mantenimiento. |
|
Maintenance |
Estado de la operación de mantenimiento. |
|
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 de conjunto de escalado de máquinas virtuales. |
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. |
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. |
HyperVGeneration
Generación del hipervisor de la máquina virtual [V1, V2]
| 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. |
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. |
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. |
VirtualMachineScaleSetVMInstanceView
Vista de instancia de una máquina virtual de conjunto de escalado de máquinas virtuales.
| 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 |
Especifica el nombre del sistema operativo host de la máquina virtual. |
| disks |
La información de los discos. |
|
| extensions |
La información de extensiones. |
|
| hyperVGeneration |
Generación del hipervisor de la máquina virtual [V1, V2] |
|
| interconnectInstanceView |
La vista de ejecución de Interconnect de la instancia de la máquina virtual Scale Set. Versión mínima de la API: 01-03-2026. |
|
| maintenanceRedeployStatus |
Estado de la operación de mantenimiento en la máquina virtual. |
|
| osName |
string |
Sistema operativo que se ejecuta en la máquina híbrida. |
| osVersion |
string |
La versión del sistema operativo que se ejecuta en la máquina híbrida. |
| placementGroupId |
string |
Grupo de selección de ubicación en el que se ejecuta la máquina virtual. Si la máquina virtual está desasignada, no tendrá un placementGroupId. |
| platformFaultDomain |
integer (int32) |
Recuento de dominios de error. |
| platformUpdateDomain |
integer (int32) |
Recuento de dominios de actualización. |
| 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. |