Virtual Machine Scale Set VMs - Get Instance View

Serviço:: Compute

Versão da API:: 2025-11-01

Obtém o status de uma máquina virtual de um conjunto de dimensionamento de VM.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/instanceView?api-version=2025-11-01

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
instanceId	path	True	string	A ID da instância da máquina virtual.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	O ID da assinatura de destino.
vmScaleSetName	path	True	string	O nome do conjunto de dimensionamento da VM.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Respostas

Nome	Tipo	Description
200 OK	VirtualMachineScaleSetVMInstanceView	Operação do Azure concluída com sucesso.
Other Status Codes	CloudError	Uma resposta de erro inesperada.

Segurança

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flow: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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": "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
    }
  ]
}

Definições

Nome	Description
ApiError	Erro de API.
ApiErrorBase	Base de erros de API.
BootDiagnosticsInstanceView	A exibição de instância de um diagnóstico de inicialização de máquina virtual.
CloudError	Uma resposta de erro do serviço de computação.
DiskEncryptionSettings	Descreve uma configuração de criptografia para um disco
DiskInstanceView	A exibição de instância do disco.
HyperVGeneration	A geração do hipervisor da Máquina Virtual [V1, V2]
InnerError	Detalhes do erro interno.
InstanceViewStatus	Status da exibição da instância.
KeyVaultKeyReference	Descreve uma referência ao Key Vault Key
KeyVaultSecretReference	Descreve uma referência a Key Vault Secret
MaintenanceOperationResultCodeTypes	O último código de resultado da operação de manutenção.
MaintenanceRedeployStatus	Status da operação de manutenção.
StatusLevelTypes	O código de nível.
StorageAlignmentStatus	Especifica o status de alinhamento de armazenamento do disco.
SubResource
VirtualMachineAgentInstanceView	A exibição de instância do Agente de VM em execução na máquina virtual.
VirtualMachineExtensionHandlerInstanceView	A exibição de instância de um manipulador de extensão de máquina virtual.
VirtualMachineExtensionInstanceView	A exibição de instância de uma extensão de máquina virtual.
VirtualMachineHealthStatus	O status de integridade da VM.
VirtualMachineScaleSetVMInstanceView	A exibição de instância de uma VM do conjunto de dimensionamento de máquinas virtuais.

ApiError

Objeto

Erro de API.

Nome	Tipo	Description
code	string	O código de erro.
details	ApiErrorBase[]	Os detalhes do erro da API
innererror	InnerError	O erro interno da API
message	string	A mensagem de erro.
target	string	O destino do erro específico.

ApiErrorBase

Objeto

Base de erros de API.

Nome	Tipo	Description
code	string	O código de erro.
message	string	A mensagem de erro.
target	string	O destino do erro específico.

BootDiagnosticsInstanceView

Objeto

A exibição de instância de um diagnóstico de inicialização de máquina virtual.

Nome	Tipo	Description
consoleScreenshotBlobUri	string	O URI do blob de captura de tela do console. Observação: Isso não ser definido se o diagnóstico de inicialização estiver habilitado no momento com o armazenamento gerenciado.
serialConsoleLogBlobUri	string	O Uri do blob de log do console serial. Observação: Isso não ser definido se o diagnóstico de inicialização estiver habilitado no momento com o armazenamento gerenciado.
status	InstanceViewStatus	As informações de status de diagnóstico de inicialização para a VM. Observação: Ele será definido somente se houver erros encontrados na habilitação do diagnóstico de inicialização.

CloudError

Objeto

Uma resposta de erro do serviço de computação.

Nome	Tipo	Description
error	ApiError	Erro de API.

DiskEncryptionSettings

Objeto

Descreve uma configuração de criptografia para um disco

Nome	Tipo	Description
diskEncryptionKey	KeyVaultSecretReference	Especifica a localização da chave de criptografia de disco, que é um Key Vault Secret.
enabled	boolean	Especifica se a criptografia de disco deve ser habilitada na máquina virtual.
keyEncryptionKey	KeyVaultKeyReference	Especifica a localização da chave de criptografia de chave no Key Vault.

DiskInstanceView

Objeto

A exibição de instância do disco.

Nome	Tipo	Description
encryptionSettings	DiskEncryptionSettings[]	Especifica as configurações de criptografia para o disco do sistema operacional. Versão mínima da API: 2015-06-15
name	string	O nome do disco.
statuses	InstanceViewStatus[]	As informações de status do recurso.
storageAlignmentStatus	StorageAlignmentStatus	Especifica o status de alinhamento de armazenamento do disco.

HyperVGeneration

Enumeração

A geração do hipervisor da Máquina Virtual [V1, V2]

Valor	Description
V1
V2

InnerError

Objeto

Detalhes do erro interno.

Nome	Tipo	Description
errordetail	string	A mensagem de erro interna ou o despejo de exceção.
exceptiontype	string	O tipo de exceção.

InstanceViewStatus

Objeto

Status da exibição da instância.

Nome	Tipo	Description
code	string	O código de status.
displayStatus	string	O rótulo localizável curto para o status.
level	StatusLevelTypes	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.

KeyVaultKeyReference

Objeto

Descreve uma referência ao Key Vault Key

Nome	Tipo	Description
keyUrl	string	A URL que faz referência a uma chave de criptografia de chave no Key Vault.
sourceVault	SubResource	A URL relativa do Key Vault contendo a chave.

KeyVaultSecretReference

Objeto

Descreve uma referência a Key Vault Secret

Nome	Tipo	Description
secretUrl	string	A URL que faz referência a um segredo em um Key Vault.
sourceVault	SubResource	A URL relativa do Key Vault contendo o segredo.

MaintenanceOperationResultCodeTypes

Enumeração

O último código de resultado da operação de manutenção.

Valor	Description
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Objeto

Status da operação de manutenção.

Nome	Tipo	Description
isCustomerInitiatedMaintenanceAllowed	boolean	True, se o cliente tiver permissão para executar a Manutenção.
lastOperationMessage	string	Mensagem retornada para a última Operação de Manutenção.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	O último código de resultado da operação de manutenção.
maintenanceWindowEndTime	string (date-time)	Hora de término para a 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 para a janela de pré-manutenção.
preMaintenanceWindowStartTime	string (date-time)	Hora de início da janela de pré-manutenção.

StatusLevelTypes

Enumeração

O código de nível.

Valor	Description
Info
Warning
Error

StorageAlignmentStatus

Enumeração

Especifica o status de alinhamento de armazenamento do disco.

Valor	Description
Unaligned	O disco não possui 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 impactar todas as VMs que referenciam esse perfil de disco.
Aligned	O disco possui o Domínio de Falha de Armazenamento para Calcular o mapeamento do Domínio de Falha. A falha do Domínio de Falha de Armazenamento é contida às VMs em um único Domínio de Falha de Computação.

SubResource

Objeto

Nome	Tipo	Description
id	string	ID do recurso

VirtualMachineAgentInstanceView

Objeto

A exibição de instância do Agente de VM em execução na máquina virtual.

Nome	Tipo	Description
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	A exibição da instância do manipulador de extensão da máquina virtual.
statuses	InstanceViewStatus[]	As informações de status do recurso.
vmAgentVersion	string	A versão completa do Agente de VM.

VirtualMachineExtensionHandlerInstanceView

Objeto

A exibição de instância de um manipulador de extensão de máquina virtual.

Nome	Tipo	Description
status	InstanceViewStatus	O status do manipulador de extensão.
type	string	Especifica o tipo da extensão; um exemplo é "CustomScriptExtension".
typeHandlerVersion	string	Especifica a versão do manipulador de script.

VirtualMachineExtensionInstanceView

Objeto

A exibição de instância de uma extensão de máquina virtual.

Nome	Tipo	Description
name	string	O nome da extensão da máquina virtual.
statuses	InstanceViewStatus[]	As informações de status do recurso.
substatuses	InstanceViewStatus[]	As informações de status do recurso.
type	string	Especifica o tipo da extensão; um exemplo é "CustomScriptExtension".
typeHandlerVersion	string	Especifica a versão do manipulador de script.

VirtualMachineHealthStatus

Objeto

O status de integridade da VM.

Nome	Tipo	Description
status	InstanceViewStatus	As informações de status de integridade da VM.

VirtualMachineScaleSetVMInstanceView

Objeto

A exibição de instância de uma VM do conjunto de dimensionamento de máquinas virtuais.

Nome	Tipo	Description
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 é associada a um grupo de hosts dedicado que tem o posicionamento automático habilitado. Versão mínima da API: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	O Diagnóstico de Inicialização é um recurso de depuração que permite exibir a Saída do Console e a Captura de Tela para diagnosticar o status da VM. Você pode exibir facilmente a saída do log do console. O Azure também permite que você veja uma captura de tela da VM pelo hipervisor.
computerName	string	Especifica o nome do sistema operacional do host da máquina virtual. Esse nome não pode ser atualizado após a criação da VM. tamanho máximo (Windows): 15 caracteres Comprimento máximo (Linux): 64 caracteres. Para convenções e restrições de nomenclatura, veja Azure diretrizes de implementação de serviços de infraestrutura.
disks	DiskInstanceView[]	As informações dos discos.
extensions	VirtualMachineExtensionInstanceView[]	As informações de extensões.
hyperVGeneration	HyperVGeneration	A geração do hipervisor da Máquina Virtual [V1, V2]
maintenanceRedeployStatus	MaintenanceRedeployStatus	O status da Operação de Manutenção na máquina virtual.
osName	string	O sistema operacional em execução no computador híbrido.
osVersion	string	A versão do Sistema Operacional em execução no computador híbrido.
placementGroupId	string	O grupo de posicionamento no qual a VM está em execução. Se a VM for desalocada, ela não terá um placementGroupId.
platformFaultDomain	integer (int32)	A contagem de domínios de falha.
platformUpdateDomain	integer (int32)	A contagem de domínios de atualização.
rdpThumbPrint	string	A impressão digital do certificado da área de trabalho remota.
statuses	InstanceViewStatus[]	As informações de status do recurso.
vmAgent	VirtualMachineAgentInstanceView	O Agente de VM em execução na máquina virtual.
vmHealth	VirtualMachineHealthStatus	O status de integridade da VM.