Virtual Machine Scale Set VMs - Get Instance View

Referencia

Service:: Compute

API Version:: 2024-03-01

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=2024-03-01

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
instanceId	path	True	string	Identificador de instancia de la máquina virtual.
resourceGroupName	path	True	string	Nombre del grupo de recursos.
subscriptionId	path	True	string	Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio.
vmScaleSetName	path	True	string	Nombre del conjunto de escalado de máquinas virtuales.
api-version	query	True	string	Versión de api de cliente.

Respuestas

Nombre	Tipo	Description
200 OK	VirtualMachineScaleSetVMInstanceView	Aceptar
Other Status Codes	CloudError	Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Flujo OAuth2 de Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nombre	Description
user_impersonation	suplantación de 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.

Sample Request

HTTP

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

Sample Response

Status code:: 200

{
  "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": "2024-03-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2024-03-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
ApiError	Error de api.
ApiErrorBase	Base de errores de api.
BootDiagnosticsInstanceView	Diagnósticos 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.
CloudError	Respuesta de error del servicio Compute.
DiskEncryptionSettings	Especifica la configuración de cifrado del disco del sistema operativo. Versión mínima de api: 2015-06-15
DiskInstanceView	La información de los discos.
HyperVGeneration	Generación del hipervisor de la máquina virtual [V1, V2]
InnerError	Detalles del error interno.
InstanceViewStatus	Estado de la vista de instancia.
KeyVaultKeyReference	Especifica la ubicación de la clave de cifrado de claves en Key Vault.
KeyVaultSecretReference	Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault.
MaintenanceOperationResultCodeTypes	Código de resultado de la última operación de mantenimiento.
MaintenanceRedeployStatus	Estado de la operación de mantenimiento en la máquina virtual.
StatusLevelTypes	El código de nivel.
SubResource	Dirección URL relativa del Key Vault que contiene el secreto.
VirtualMachineAgentInstanceView	Agente de máquina virtual que se ejecuta en la máquina virtual.
VirtualMachineExtensionHandlerInstanceView	Vista de instancia del controlador de extensión de máquina virtual.
VirtualMachineExtensionInstanceView	Información de extensiones.
VirtualMachineHealthStatus	Estado de mantenimiento de la máquina virtual.
VirtualMachineScaleSetVMInstanceView	Vista de instancia de una máquina virtual del conjunto de escalado de máquinas virtuales.

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 determinado.

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 determinado.

BootDiagnosticsInstanceView

Diagnósticos 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.

Nombre	Tipo	Description
consoleScreenshotBlobUri	string	URI del blob de la consola. Nota: Esto no se establecerá si el diagnóstico de arranque está habilitado actualmente con el almacenamiento administrado.
serialConsoleLogBlobUri	string	Uri del blob de registro de la consola serie. Nota: Esto no se establecerá si el diagnóstico de arranque está habilitado actualmente con el almacenamiento administrado.
status	InstanceViewStatus	Información de estado de diagnóstico de arranque de la máquina virtual. Nota: Solo se establecerá si se producen errores en la habilitación de diagnósticos de arranque.

CloudError

Respuesta de error del servicio Compute.

Nombre	Tipo	Description
error	ApiError	Error de api.

DiskEncryptionSettings

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

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

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

La información de los discos.

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	El nombre del disco.
statuses	InstanceViewStatus[]	Información de estado del recurso.

HyperVGeneration

Generación del hipervisor de la máquina virtual [V1, V2]

Nombre	Tipo	Description
V1	string
V2	string

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	El código de nivel.
message	string	Mensaje de estado detallado, incluidas las alertas y los mensajes de error.
time	string	Hora del estado.

KeyVaultKeyReference

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

Nombre	Tipo	Description
keyUrl	string	Dirección URL que hace referencia a una clave de cifrado de clave en Key Vault.
sourceVault	SubResource	Dirección URL relativa del Key Vault que contiene la clave.

KeyVaultSecretReference

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

Nombre	Tipo	Description
secretUrl	string	Dirección URL que hace referencia a un secreto en un Key Vault.
sourceVault	SubResource	Dirección URL relativa del Key Vault que contiene el secreto.

MaintenanceOperationResultCodeTypes

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

Nombre	Tipo	Description
MaintenanceAborted	string
MaintenanceCompleted	string
None	string
RetryLater	string

MaintenanceRedeployStatus

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

Nombre	Tipo	Description
isCustomerInitiatedMaintenanceAllowed	boolean	True, si el cliente puede realizar 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	Hora de finalización de la ventana de mantenimiento.
maintenanceWindowStartTime	string	Hora de inicio de la ventana de mantenimiento.
preMaintenanceWindowEndTime	string	Hora de finalización de la ventana de mantenimiento previo.
preMaintenanceWindowStartTime	string	Hora de inicio de la ventana de mantenimiento previo.

StatusLevelTypes

El código de nivel.

Nombre	Tipo	Description
Error	string
Info	string
Warning	string

SubResource

Dirección URL relativa del Key Vault que contiene el secreto.

Nombre	Tipo	Description
id	string	Id. de recurso

VirtualMachineAgentInstanceView

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 del 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

Información de extensiones.

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.

VirtualMachineScaleSetVMInstanceView

Vista de instancia de una máquina virtual del 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 selección de ubicació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	Diagnósticos 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. Este nombre no se puede actualizar después de crear la máquina virtual. Longitud máxima (Windows): 15 caracteres Longitud máxima (Linux): 64 caracteres. Para conocer las convenciones de nomenclatura y las restricciones, consulte Las directrices de implementación de los servicios de infraestructura de Azure.
disks	DiskInstanceView[]	La información de los discos.
extensions	VirtualMachineExtensionInstanceView[]	Información de extensiones.
hyperVGeneration	HyperVGeneration	Generación del hipervisor de la máquina virtual [V1, V2]
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 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	Recuento de dominios de error.
platformUpdateDomain	integer	Recuento de dominios de actualización.
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.