Virtual Machines - Instance View
Recupera informações sobre o estado de tempo de execução de uma máquina virtual.
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2026-04-01
Parâmetros do URI
| Nome | Em | Obrigatório | Tipo | Descrição |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
O ID da assinatura de destino. |
|
vm
|
path | True |
string |
O nome da máquina virtual. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a utilizar para esta operação. |
Respostas
| Nome | Tipo | Descrição |
|---|---|---|
| 200 OK |
Operação do Azure concluída com sucesso. |
|
| Other Status Codes |
Uma resposta de erro inesperada. |
Segurança
azure_auth
Fluxo OAuth2 do Azure Active Directory.
Tipo:
oauth2
Fluxo:
implicit
URL de Autorização:
https://login.microsoftonline.com/common/oauth2/authorize
Âmbitos
| Nome | Descrição |
|---|---|
| user_impersonation | assumir a identidade da sua conta de utilizador |
Exemplos
| Get instance view of a virtual machine placed on a dedicated host group through automatic placement. |
| Get Virtual Machine Instance View. |
Get instance view of a virtual machine placed on a dedicated host group through automatic placement.
Pedido de amostra
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2026-04-01
Resposta da amostra
{
"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-04-01T23:11:22+00:00"
}
]
},
"disks": [
{
"name": "myOsDisk",
"statuses": [
{
"code": "ProvisioningState/succeeded",
"level": "Info",
"displayStatus": "Provisioning succeeded",
"time": "2026-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": "2026-04-01T21:30:12.8051917+00:00"
},
{
"code": "PowerState/running",
"level": "Info",
"displayStatus": "VM running"
}
]
}
Get Virtual Machine Instance View.
Pedido de amostra
GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2026-04-01
Resposta da amostra
{
"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,
"capacityReservationType": "Open",
"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"
}
]
}
Definições
| Nome | Descrição |
|---|---|
|
Api |
Erro de api. |
|
Api |
Base de erro da api. |
|
Available |
Descreve as propriedades de uma exibição de instância de máquina virtual para resumo de patch disponível. |
|
Boot |
A exibição de instância de um diagnóstico de inicialização de máquina virtual. |
|
Capacity |
Especifica de que tipo de reserva de capacidade a máquina virtual irá consumir capacidade, se elegível, ou se está explicitamente excluída de estar associada e de consumir capacidade de qualquer capacidade reservada disponível na subscrição. Versão mínima da API: 01-04-2026. |
|
Cloud |
Uma resposta de erro do serviço de computação. |
|
Disk |
Descreve uma configuração de criptografia para um disco |
|
Disk |
A exibição de instância do disco. |
|
Hyper |
Especifica o tipo de HyperVGeneration associado a um recurso |
|
Inner |
Detalhes do erro interno. |
|
Instance |
Status da exibição da instância. |
|
Interconnect |
Os detalhes da visualização da instância do Bloco de Interligação para uma Máquina Virtual ou uma VM com Conjunto de Escala. |
|
Key |
Descreve uma referência à chave do cofre da chave |
|
Key |
Descreve uma referência ao segredo do Key Vault |
|
Last |
Descreve as propriedades do último resumo do patch instalado. |
|
Maintenance |
O código do resultado da última operação de manutenção. |
|
Maintenance |
Estado da Operação de Manutenção. |
|
Patch |
O status geral de sucesso ou falha da operação. Ele permanece "InProgress" até que a operação seja concluída. Nesse ponto, ele se tornará "Desconhecido", "Falhado", "Sucedido" ou "CompletedWithWarnings". |
|
Status |
O código de nível. |
|
Storage |
Especifica o estado de alinhamento de armazenamento para o disco. |
|
Sub |
|
|
Virtual |
A exibição de instância do Agente de VM em execução na máquina virtual. |
|
Virtual |
A exibição de instância de um manipulador de extensão de máquina virtual. |
|
Virtual |
A exibição de instância de uma extensão de máquina virtual. |
|
Virtual |
O status de integridade da VM. |
|
Virtual |
A exibição de instância de uma máquina virtual. |
|
Virtual |
O status das operações de patch de máquina virtual. |
ApiError
Erro de api.
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro Api |
|
| innererror |
O erro interno da Api |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O alvo do erro específico. |
ApiErrorBase
Base de erro da api.
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
O código de erro. |
| message |
string |
A mensagem de erro. |
| target |
string |
O alvo do erro específico. |
AvailablePatchSummary
Descreve as propriedades de uma exibição de instância de máquina virtual para resumo de patch disponível.
| Nome | Tipo | Descrição |
|---|---|---|
| assessmentActivityId |
string |
O ID da atividade da operação que produziu esse resultado. Ele é usado para correlacionar entre CRP e logs de extensão. |
| criticalAndSecurityPatchCount |
integer (int32) |
O número de patches críticos ou de segurança que foram detetados como disponíveis e ainda não instalados. |
| error |
Os erros que foram encontrados durante a execução da operação. A matriz de detalhes contém a lista deles. |
|
| lastModifiedTime |
string (date-time) |
O carimbo de data/hora UTC quando a operação começou. |
| otherPatchCount |
integer (int32) |
O número de todos os patches disponíveis, excluindo críticos e de segurança. |
| rebootPending |
boolean |
O status geral de reinicialização da VM. Será verdade quando patches parcialmente instalados exigirem uma reinicialização para concluir a instalação, mas a reinicialização ainda não ocorreu. |
| startTime |
string (date-time) |
O carimbo de data/hora UTC quando a operação começou. |
| status |
O status geral de sucesso ou falha da operação. Ele permanece "InProgress" até que a operação seja concluída. Nesse ponto, ele se tornará "Desconhecido", "Falhado", "Sucedido" ou "CompletedWithWarnings". |
BootDiagnosticsInstanceView
A exibição de instância de um diagnóstico de inicialização de máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| consoleScreenshotBlobUri |
string |
O URI de blob da captura de tela do console. Nota: Isso não será definido se o diagnóstico de inicialização estiver atualmente habilitado com armazenamento gerenciado. |
| serialConsoleLogBlobUri |
string |
O Uri do blob de log do console serial. Nota: Isso não será definido se o diagnóstico de inicialização estiver atualmente habilitado com armazenamento gerenciado. |
| status |
As informações de status do diagnóstico de inicialização para a VM. Nota: Ele será definido somente se houver erros encontrados na ativação do diagnóstico de inicialização. |
CapacityReservationType
Especifica de que tipo de reserva de capacidade a máquina virtual irá consumir capacidade, se elegível, ou se está explicitamente excluída de estar associada e de consumir capacidade de qualquer capacidade reservada disponível na subscrição. Versão mínima da API: 01-04-2026.
| Valor | Descrição |
|---|---|
| NotEligible |
A máquina virtual não é elegível para ser implicitamente associada a uma reserva de capacidade aberta e não está explicitamente associada a qualquer grupo de reserva de capacidade, pelo que irá consumir capacidade da capacidade pública disponível. |
| Targeted |
A máquina virtual consumirá capacidade de uma reserva de capacidade correspondente específica quando associada a um recurso de grupo de reserva de capacidade do tipo alvo, mas pode recorrer para consumir capacidade da capacidade pública disponível se não houver capacidade disponível na reserva alvo. |
| Open |
A máquina virtual, se elegível, irá implicitamente associar e consumir qualquer capacidade disponível a partir de uma reserva de capacidade aberta correspondente criada ou partilhada na subscrição. Nota: A VM não deve estar explicitamente associada ao recurso do grupo de reservas de capacidade aberta que contém a reserva correspondente. |
| Disabled |
A máquina virtual tem a atribuição de reserva de capacidade desativada e não poderá associar-se implícita ou explicitamente a qualquer tipo de reserva de capacidade. |
| Block |
A máquina virtual consome capacidade de uma reserva de capacidade correspondente específica quando associada a um recurso de grupo de reserva de capacidade do tipo bloco, e sofrerá falhas de capacidade se não houver capacidade disponível na reserva do bloco. |
CloudError
Uma resposta de erro do serviço de computação.
| Nome | Tipo | Descrição |
|---|---|---|
| error |
Erro de api. |
DiskEncryptionSettings
Descreve uma configuração de criptografia para um disco
| Nome | Tipo | Descrição |
|---|---|---|
| diskEncryptionKey |
Especifica o local da chave de criptografia de disco, que é um segredo do Cofre da Chave. |
|
| enabled |
boolean |
Especifica se a criptografia de disco deve ser habilitada na máquina virtual. |
| keyEncryptionKey |
Especifica o local da chave de criptografia de chave no Cofre da Chave. |
DiskInstanceView
A exibição de instância do disco.
| Nome | Tipo | Descrição |
|---|---|---|
| encryptionSettings |
Especifica as configurações de criptografia para o disco do sistema operacional. |
|
| name |
string |
O nome do disco. |
| statuses |
As informações de status do recurso. |
|
| storageAlignmentStatus |
Especifica o estado de alinhamento de armazenamento para o disco. |
HyperVGenerationType
Especifica o tipo de HyperVGeneration associado a um recurso
| Valor | Descrição |
|---|---|
| V1 | |
| V2 |
InnerError
Detalhes do erro interno.
| Nome | Tipo | Descrição |
|---|---|---|
| errordetail |
string |
A mensagem de erro interna ou despejo de exceção. |
| exceptiontype |
string |
O tipo de exceção. |
InstanceViewStatus
Status da exibição da instância.
| Nome | Tipo | Descrição |
|---|---|---|
| code |
string |
O código de status. |
| displayStatus |
string |
O rótulo curto localizável para o status. |
| level |
O código de nível. |
|
| message |
string |
A mensagem de status detalhada, inclusive para alertas e mensagens de erro. |
| time |
string (date-time) |
A hora do status. |
InterconnectInstanceView
Os detalhes da visualização da instância do Bloco de Interligação para uma Máquina Virtual ou uma VM com Conjunto de Escala.
| Nome | Tipo | Descrição |
|---|---|---|
| interconnectSubgroupId |
string |
O ID (GUID) do subgrupo de Interligação onde a Máquina Virtual foi colocada. |
KeyVaultKeyReference
Descreve uma referência à chave do cofre da chave
| Nome | Tipo | Descrição |
|---|---|---|
| keyUrl |
string |
O URL que faz referência a uma chave de criptografia de chave no Cofre da Chave. |
| sourceVault |
O URL relativo do Cofre da Chave que contém a chave. |
KeyVaultSecretReference
Descreve uma referência ao segredo do Key Vault
| Nome | Tipo | Descrição |
|---|---|---|
| secretUrl |
string |
O URL que faz referência a um segredo em um Cofre de Chaves. |
| sourceVault |
O URL relativo do Cofre da Chave que contém o segredo. |
LastPatchInstallationSummary
Descreve as propriedades do último resumo do patch instalado.
| Nome | Tipo | Descrição |
|---|---|---|
| error |
Os erros que foram encontrados durante a execução da operação. A matriz de detalhes contém a lista deles. |
|
| excludedPatchCount |
integer (int32) |
O número de todos os patches disponíveis, mas excluídos explicitamente por uma lista de exclusão especificada pelo cliente, corresponde. |
| failedPatchCount |
integer (int32) |
A contagem de patches que falharam na instalação. |
| installationActivityId |
string |
O ID da atividade da operação que produziu esse resultado. Ele é usado para correlacionar entre CRP e logs de extensão. |
| installedPatchCount |
integer (int32) |
A contagem de patches instalados com êxito. |
| lastModifiedTime |
string (date-time) |
O carimbo de data/hora UTC quando a operação começou. |
| maintenanceWindowExceeded |
boolean |
Descreve se a operação ficou sem tempo antes de concluir todas as ações pretendidas |
| notSelectedPatchCount |
integer (int32) |
O número de todos os patches disponíveis, mas que não serão instalados porque não corresponderam a uma entrada de classificação ou lista de inclusão. |
| pendingPatchCount |
integer (int32) |
O número de todos os patches disponíveis que se espera que sejam instalados durante a operação de instalação do patch. |
| startTime |
string (date-time) |
O carimbo de data/hora UTC quando a operação começou. |
| status |
O status geral de sucesso ou falha da operação. Ele permanece "InProgress" até que a operação seja concluída. Nesse ponto, ele se tornará "Desconhecido", "Falhado", "Sucedido" ou "CompletedWithWarnings". |
MaintenanceOperationResultCodeTypes
O código do resultado da última operação de manutenção.
| Valor | Descrição |
|---|---|
| None | |
| RetryLater | |
| MaintenanceAborted | |
| MaintenanceCompleted |
MaintenanceRedeployStatus
Estado da Operação de Manutenção.
| Nome | Tipo | Descrição |
|---|---|---|
| isCustomerInitiatedMaintenanceAllowed |
boolean |
True, se o cliente tiver permissão para realizar a Manutenção. |
| lastOperationMessage |
string |
Mensagem retornada para a última Operação de Manutenção. |
| lastOperationResultCode |
O código do resultado da última operação de manutenção. |
|
| maintenanceWindowEndTime |
string (date-time) |
Hora de Fim da Janela de Manutenção. |
| maintenanceWindowStartTime |
string (date-time) |
Hora de início da janela de manutenção. |
| preMaintenanceWindowEndTime |
string (date-time) |
Hora de término da janela de pré-manutenção. |
| preMaintenanceWindowStartTime |
string (date-time) |
Hora de início da janela de pré-manutenção. |
PatchOperationStatus
O status geral de sucesso ou falha da operação. Ele permanece "InProgress" até que a operação seja concluída. Nesse ponto, ele se tornará "Desconhecido", "Falhado", "Sucedido" ou "CompletedWithWarnings".
| Valor | Descrição |
|---|---|
| Unknown | |
| InProgress | |
| Failed | |
| Succeeded | |
| CompletedWithWarnings |
StatusLevelTypes
O código de nível.
| Valor | Descrição |
|---|---|
| Info | |
| Warning | |
| Error |
StorageAlignmentStatus
Especifica o estado de alinhamento de armazenamento para o disco.
| Valor | Descrição |
|---|---|
| Unaligned |
O disco não tem Domínio de Falha de Armazenamento para Calcular o mapeamento do Domínio de Falha. Uma única falha no Domínio de Falha de Armazenamento pode afetar todas as VMs que referenciam este perfil de disco. |
| Aligned |
O disco tem Domínio de Falha de Armazenamento para Calcular o mapeamento do Domínio de Falha. A falha do Domínio de Falha de Armazenamento está contida nas VMs num único Domínio de Falha de Computação. |
SubResource
| Nome | Tipo | Descrição |
|---|---|---|
| id |
string |
ID do recurso |
VirtualMachineAgentInstanceView
A exibição de instância do Agente de VM em execução na máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| extensionHandlers |
A exibição da instância do manipulador de extensão de máquina virtual. |
|
| statuses |
As informações de status do recurso. |
|
| vmAgentVersion |
string |
A versão completa do VM Agent. |
VirtualMachineExtensionHandlerInstanceView
A exibição de instância de um manipulador de extensão de máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| status |
O status do manipulador de extensão. |
|
| type |
string |
Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". |
| typeHandlerVersion |
string |
Especifica a versão Major.Minor.Patch.Hotfix do handler de script. A plataforma Azure fornecerá a versão mais recente do Patch.Hotfix da série Major.Minor. |
VirtualMachineExtensionInstanceView
A exibição de instância de uma extensão de máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| name |
string |
O nome da extensão da máquina virtual. |
| statuses |
As informações de status do recurso. |
|
| substatuses |
As informações de status do recurso. |
|
| type |
string |
Especifica o tipo da extensão; um exemplo é "CustomScriptExtension". |
| typeHandlerVersion |
string |
Especifica a versão Major.Minor.Patch.Hotfix do handler de script. A plataforma Azure fornecerá a versão mais recente do Patch.Hotfix da série Major.Minor. |
VirtualMachineHealthStatus
O status de integridade da VM.
| Nome | Tipo | Descrição |
|---|---|---|
| status |
As informações de status de integridade para a VM. |
VirtualMachineInstanceView
A exibição de instância de uma máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| assignedHost |
string |
ID de recurso do host dedicado, no qual a máquina virtual é alocada por meio do posicionamento automático, quando a máquina virtual está associada a um grupo de hosts dedicados que tem o posicionamento automático habilitado. Versão api mínima: 2020-06-01. |
| bootDiagnostics |
O Diagnóstico de Inicialização é um recurso de depuração que permite visualizar a saída do console e a captura de tela para diagnosticar o status da VM. Você pode visualizar facilmente a saída do log do console. O Azure também permite que você veja uma captura de tela da VM do hipervisor. |
|
| capacityReservationType |
Especifica de que tipo de reserva de capacidade a máquina virtual irá consumir capacidade, se elegível, ou se está explicitamente excluída de estar associada e de consumir capacidade de qualquer capacidade reservada disponível na subscrição. Versão mínima da API: 01-04-2026. |
|
| computerName |
string |
O nome do computador atribuído à máquina virtual. |
| disks |
As informações de disco da máquina virtual. |
|
| extensions |
As informações de extensões. |
|
| hyperVGeneration |
Especifica o tipo de HyperVGeneration associado a um recurso |
|
| interconnectInstanceView |
A vista de execução Interconnect da Máquina Virtual. Versão mínima da API: 2026-03-01. |
|
| isVMInStandbyPool |
boolean |
[Funcionalidade de pré-visualização] Especifica se a VM está atualmente dentro ou fora do Pool em Espera. |
| maintenanceRedeployStatus |
O status da Operação de Manutenção na máquina virtual. |
|
| osName |
string |
O sistema operacional em execução na máquina virtual. |
| osVersion |
string |
A versão do sistema operacional em execução na máquina virtual. |
| patchStatus |
[Funcionalidade de pré-visualização] O status das operações de patch de máquina virtual. |
|
| platformFaultDomain |
integer (int32) |
Especifica o domínio de falha da máquina virtual. |
| platformUpdateDomain |
integer (int32) |
Especifica o domínio de atualização da máquina virtual. |
| rdpThumbPrint |
string |
A impressão digital do certificado da área de trabalho remota. |
| statuses |
As informações de status do recurso. |
|
| vmAgent |
O Agente de VM em execução na máquina virtual. |
|
| vmHealth |
O status de integridade da VM. |
VirtualMachinePatchStatus
O status das operações de patch de máquina virtual.
| Nome | Tipo | Descrição |
|---|---|---|
| availablePatchSummary |
O resumo de patch disponível da operação de avaliação mais recente para a máquina virtual. |
|
| configurationStatuses |
O status de ativação do patchMode especificado |
|
| lastPatchInstallationSummary |
O resumo da instalação da operação de instalação mais recente para a máquina virtual. |