Virtual Machine Scale Set VMs - Get Instance View

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

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

Parâmetros do URI

Name Em Obrigatório Tipo Descrição
instanceId
path True

string

O 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 escala de VM.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Respostas

Name Tipo Descrição
200 OK

VirtualMachineScaleSetVMInstanceView

Operação do Azure concluída com sucesso.

Other Status Codes

CloudError

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

Name Descrição
user_impersonation assumir a identidade da sua conta de utilizador

Exemplos

Get instance view of a virtual machine from a VM scale set 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/virtualMachineScaleSets/myVirtualMachineScaleSet/virtualMachines/0/instanceView?api-version=2026-03-01

Resposta da amostra

{
  "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

Name Descrição
ApiError

Erro de api.

ApiErrorBase

Base de erro da 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.

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.

KeyVaultKeyReference

Descreve uma referência à chave do cofre da chave

KeyVaultSecretReference

Descreve uma referência ao segredo do Key Vault

MaintenanceOperationResultCodeTypes

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

MaintenanceRedeployStatus

Estado da Operação de Manutenção.

StatusLevelTypes

O código de nível.

StorageAlignmentStatus

Especifica o estado de alinhamento de armazenamento para o 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 de conjunto de dimensionamento de máquina virtual.

ApiError

Erro de api.

Name Tipo Descrição
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro Api

innererror

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.

Name Tipo Descrição
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

BootDiagnosticsInstanceView

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

Name 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

InstanceViewStatus

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.

CloudError

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

Name Tipo Descrição
error

ApiError

Erro de api.

DiskEncryptionSettings

Descreve uma configuração de criptografia para um disco

Name Tipo Descrição
diskEncryptionKey

KeyVaultSecretReference

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

KeyVaultKeyReference

Especifica o local da chave de criptografia de chave no Cofre da Chave.

DiskInstanceView

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

Name Tipo Descrição
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 estado de alinhamento de armazenamento para o disco.

HyperVGeneration

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

Valor Descrição
V1
V2

InnerError

Detalhes do erro interno.

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

Name Tipo Descrição
code

string

O código de status.

displayStatus

string

O rótulo curto localizável 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.

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.

Name 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

Name Tipo Descrição
keyUrl

string

O URL que faz referência a uma chave de criptografia de chave no Cofre da Chave.

sourceVault

SubResource

O URL relativo do Cofre da Chave que contém a chave.

KeyVaultSecretReference

Descreve uma referência ao segredo do Key Vault

Name Tipo Descrição
secretUrl

string

O URL que faz referência a um segredo em um Cofre de Chaves.

sourceVault

SubResource

O URL relativo do Cofre da Chave que contém o segredo.

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.

Name 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

MaintenanceOperationResultCodeTypes

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.

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

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

Name Tipo Descrição
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

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

statuses

InstanceViewStatus[]

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.

Name Tipo Descrição
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

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

Name Tipo Descrição
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

O status de integridade da VM.

Name Tipo Descrição
status

InstanceViewStatus

As informações de status de integridade para a VM.

VirtualMachineScaleSetVMInstanceView

A exibição de instância de uma VM de conjunto de dimensionamento de máquina virtual.

Name 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

BootDiagnosticsInstanceView

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.

computerName

string

Especifica o nome do sistema operacional host da máquina virtual.

Esse nome não pode ser atualizado após a criação da VM.

Max-length (Windows): 15 caracteres

Max-length (Linux): 64 caracteres.

Para convenções e restrições de nomenclatura, consulte diretrizes de implementação de serviços de infraestrutura do Azure.

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]

interconnectInstanceView

InterconnectInstanceView

A vista de execução Interconnect da instância Scale Set VM. Versão mínima da API: 2026-03-01.

maintenanceRedeployStatus

MaintenanceRedeployStatus

O status da Operação de Manutenção na máquina virtual.

osName

string

O sistema operacional em execução na máquina híbrida.

osVersion

string

A versão do sistema operacional em execução na máquina híbrida.

placementGroupId

string

O grupo de posicionamento no qual a VM está sendo executada. Se a VM for desalocada, ela não terá um placementGroupId.

platformFaultDomain

integer (int32)

A contagem de Domínio de Falha.

platformUpdateDomain

integer (int32)

A contagem de Domínio 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.