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=2024-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 |
Nombre del grupo de recursos. |
subscription
|
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. |
vm
|
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 |
Aceptar |
|
Other Status Codes |
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
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
{
"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 |
---|---|
Api |
Error de api. |
Api |
Base de errores de api. |
Boot |
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. |
Cloud |
Respuesta de error del servicio Compute. |
Disk |
Especifica la configuración de cifrado del disco del sistema operativo. |
Disk |
La información de los discos. |
Hyper |
Generación del hipervisor de la máquina virtual [V1, V2] |
Inner |
Detalles del error interno. |
Instance |
Estado de la vista de instancia. |
Key |
Especifica la ubicación de la clave de cifrado de claves en Key Vault. |
Key |
Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault. |
Maintenance |
Código de resultado de la última operación de mantenimiento. |
Maintenance |
Estado de la operación de mantenimiento en la máquina virtual. |
Status |
El código de nivel. |
Sub |
Dirección URL relativa del Key Vault que contiene el secreto. |
Virtual |
Agente de máquina virtual que se ejecuta en la máquina virtual. |
Virtual |
Vista de instancia del controlador de extensión de máquina virtual. |
Virtual |
Información de extensiones. |
Virtual |
Estado de mantenimiento de la máquina virtual. |
Virtual |
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 |
Detalles del error de api |
|
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 |
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 |
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 |
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
La información de los discos.
Nombre | Tipo | Description |
---|---|---|
encryptionSettings |
Especifica la configuración de cifrado del disco del sistema operativo. |
|
name |
string |
El nombre del disco. |
statuses |
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 |
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 |
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 |
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 |
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 |
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 del 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
Información de extensiones.
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 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 |
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. |
disks |
La información de los discos. |
|
extensions |
Información de extensiones. |
|
hyperVGeneration |
Generación del hipervisor de la máquina virtual [V1, V2] |
|
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 |
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. |