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=2022-08-01

Parámetros de identificador URI

Name In Required Type 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 Microsoft Azure suscripción. 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

Name Type Description
200 OK

Aceptar

Other Status Codes

Respuesta de error que describe el motivo del error de la operación.

Seguridad

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation suplantar la 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

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

Sample Response

{
  "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": "2022-08-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2022-08-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

ApiError

Error de API.

ApiErrorBase

Base de errores de API.

BootDiagnosticsInstanceView

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

CloudError

Respuesta de error del servicio Compute.

DiskEncryptionSettings

Describe un Configuración de cifrado para un disco

DiskInstanceView

Vista de instancia del disco.

InnerError

Detalles del error interno.

InstanceViewStatus

Estado de la vista de instancia.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault

MaintenanceOperationResultCodeTypes

El último código de resultado de la operación de mantenimiento.

MaintenanceRedeployStatus

Estado de la operación de mantenimiento.

StatusLevelTypes

Código de nivel.

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.

VirtualMachineScaleSetVMInstanceView

Vista de instancia de una máquina virtual del conjunto de escalado de máquinas virtuales.

ApiError

Error de API.

Name Type 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.

Name Type 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.

Name Type Description
consoleScreenshotBlobUri
  • string

El URI del blob de captura de pantalla 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

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.

Name Type Description
error

Error de API.

DiskEncryptionSettings

Describe un Configuración de cifrado para un disco

Name Type Description
diskEncryptionKey

Especifica la ubicación de la clave de cifrado de disco, que es un secreto 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.

Name Type Description
encryptionSettings

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

Información de estado del recurso.

InnerError

Detalles del error interno.

Name Type 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.

Name Type 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

Hora del estado.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault

Name Type 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 Key Vault que contiene la clave.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault

Name Type Description
secretUrl
  • string

Dirección URL que hace referencia a un secreto en un Key Vault.

sourceVault

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

MaintenanceOperationResultCodeTypes

El último código de resultado de la operación de mantenimiento.

Name Type Description
MaintenanceAborted
  • string
MaintenanceCompleted
  • string
None
  • string
RetryLater
  • string

MaintenanceRedeployStatus

Estado de la operación de mantenimiento.

Name Type Description
isCustomerInitiatedMaintenanceAllowed
  • boolean

True, si el cliente puede realizar el mantenimiento.

lastOperationMessage
  • string

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

lastOperationResultCode

El último código de resultado de la 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

Código de nivel.

Name Type Description
Error
  • string
Info
  • string
Warning
  • string

SubResource

Name Type Description
id
  • string

Id. de recurso

VirtualMachineAgentInstanceView

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

Name Type 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.

Name Type 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.

Name Type 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.

Name Type Description
status

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.

Name Type 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

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.

disks

La información de los discos.

extensions

La información de extensiones.

maintenanceRedeployStatus

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

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

Información de estado del recurso.

vmAgent

El agente de máquina virtual que se ejecuta en la máquina virtual.

vmHealth

Estado de mantenimiento de la máquina virtual.