Compartilhar via


Machines - Get

Retorna o computador especificado.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}?api-version=2015-11-01-preview
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}?api-version=2015-11-01-preview&timestamp={timestamp}

Parâmetros de URI

Nome Em Obrigatório Tipo Description
machineName
path True

string

Nome do recurso do computador.

resourceGroupName
path True

string

Nome do grupo de recursos na subscriptionId especificada.

Padrão Regex: [a-zA-Z0-9_-]+

subscriptionId
path True

string

O identificador da assinatura do Azure.

workspaceName
path True

string

Workspace do OMS que contém os recursos de interesse.

Padrão Regex: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]

api-version
query True

string

Versão da API.

timestamp
query

string

date-time

Data e hora UTC especificando uma instância de hora relativa à qual avaliar o recurso do computador. Quando não especificado, o serviço usa DateTime.UtcNow.

Respostas

Nome Tipo Description
200 OK

Machine

A operação foi concluída com sucesso.

Other Status Codes

ErrorResponse

Ocorreu um erro ao processar a solicitação. Consulte o parâmetro error.code para identificar o erro específico.

Segurança

azure_auth

Fluxo do OAuth2 do Azure Active Directory

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

SMMachinesGetGet

Solicitação de exemplo

GET https://management.azure.com/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/features/serviceMap/machines/m-A4AB1C69-03E9-42D2-B822-B42555569FB4?api-version=2015-11-01-preview&timestamp=2018-01-07T07:01:16.1556059Z

Resposta de exemplo

{
  "kind": "machine",
  "properties": {
    "monitoringState": "monitored",
    "virtualizationState": "unknown",
    "displayName": "my machine"
  },
  "id": "/subscriptions/63BE4E24-FDF0-4E9C-9342-6A5D5A359722/resourceGroups/rg-sm/providers/Microsoft.OperationalInsights/workspaces/D6F79F14-E563-469B-84B5-9286D2803B2F/machines/m-A4AB1C69-03E9-42D2-B822-B42555569FB4",
  "type": "Microsoft.OperationalInsights/workspaces/features/machines",
  "name": "m-A4AB1C69-03E9-42D2-B822-B42555569FB4"
}

Definições

Nome Description
Accuracy

Especifica a precisão de uma computação.

AgentConfiguration

Descreve a configuração do Dependency Agent instalado em um computador.

AzureCloudServiceConfiguration

Descreve um Serviço de Nuvem do Azure

AzureCloudServiceRoleType

Usado para especificar o tipo de uma função do Serviço de Nuvem do Azure

AzureHostingConfiguration

Fornece informações sobre como um computador é hospedado no Azure

AzureServiceFabricClusterConfiguration

Descreve um cluster do Azure Service Fabric

AzureVmScaleSetConfiguration

Descreve um conjunto de dimensionamento de máquinas virtuais do Azure

Bitness

Especifica o bitness de um computador ou processo.

Error

Detalhes do erro.

ErrorResponse

Uma resposta de erro da API.

HypervisorConfiguration

Descreve a configuração do hipervisor de um computador.

HypervisorType

Especifica o tipo de hipervisor de um computador.

ImageConfiguration

Descreve a imagem da VM de um computador.

Ipv4NetworkInterface

Descreve um adaptador de rede IPv4.

Ipv6NetworkInterface

Descreve um adaptador de rede IPv6.

Machine

Um recurso de computador representa um sistema de computador descoberto. Ele pode ser monitorado, ou seja, um Dependency Agent está em execução nele ou descoberto, ou seja, sua existência foi inferida observando o fluxo de dados de computadores monitorados. À medida que os computadores mudam, as versões anteriores do recurso de computador são preservadas e disponíveis para acesso. Um computador fica ativo durante um intervalo de tempo, se seu Dependency Agent tiver relatado dados durante (partes) desse intervalo ou um Agente de dependência em execução em outros computadores tiver relatado a atividade associada ao computador.

MachineRebootStatus

Especifica se o computador foi reinicializado desde a instalação do agente de dependência.

MachineResourcesConfiguration

Descreve os recursos de um computador.

MonitoringState

Usado para especificar se um recurso é monitorado ou descoberto.

NetworkConfiguration

Descreve a configuração de rede de um computador.

OperatingSystemConfiguration

Descreve a configuração do sistema operacional de um computador.

OperatingSystemFamily

Especifica a família do sistema operacional, por exemplo, Linux, Windows etc.

Timezone

Descreve um fuso horário.

VirtualizationState

Especifica se o computador é físico, virtual, hipervisor ou desconhecido.

VirtualMachineConfiguration

Descreve a configuração relacionada à virtualização de um computador.

VirtualMachineType

Especifica o tipo de virtualização de um computador.

Accuracy

Especifica a precisão de uma computação.

Nome Tipo Description
actual

string

estimated

string

AgentConfiguration

Descreve a configuração do Dependency Agent instalado em um computador.

Nome Tipo Description
agentId

string

Identificador exclusivo do Agente de Serviço de Integridade.

clockGranularity

integer

Granularidade do relógio do computador em milissegundos.

dependencyAgentId

string

Identificador exclusivo do Dependency Agent.

dependencyAgentRevision

string

Número de revisão do Dependency Agent.

dependencyAgentVersion

string

Número de versão do Dependency Agent.

rebootStatus

MachineRebootStatus

Especifica se o computador foi reinicializado desde a instalação do Dependency Agent.

AzureCloudServiceConfiguration

Descreve um Serviço de Nuvem do Azure

Nome Tipo Description
deployment

string

Identificador de implantação do Serviço de Nuvem

instanceId

string

Identificador de instância do Serviço de Nuvem

name

string

Nome do Serviço de Nuvem

roleName

string

Nome da função do Serviço de Nuvem

roleType

AzureCloudServiceRoleType

Usado para especificar o tipo de uma função do Serviço de Nuvem do Azure

AzureCloudServiceRoleType

Usado para especificar o tipo de uma função do Serviço de Nuvem do Azure

Nome Tipo Description
unknown

string

web

string

worker

string

AzureHostingConfiguration

Fornece informações sobre como um computador é hospedado no Azure

Nome Tipo Description
cloudService

AzureCloudServiceConfiguration

Contém informações sobre computadores hospedados como um Serviço de Nuvem do Azure

faultDomain

string

Domínio de falha da VM.

image

ImageConfiguration

Imagem do computador.

kind string:

provider:azure

Qualificador de tipo de configuração de hospedagem adicional.

location

string

Localização geográfica da VM.

name

string

Nome do computador de acordo com o provedor de hospedagem.

provider enum:

azure

O provedor de hospedagem da VM.

resourceGroup

string

Nome do grupo de recursos na assinatura especificada.

resourceId

string

Identificador exclusivo do recurso.

serviceFabricCluster

AzureServiceFabricClusterConfiguration

Contém informações sobre computadores que pertencem a um Cluster do Azure Service Fabric

size

string

O tamanho da VM.

subscriptionId

string

ID da assinatura.

updateDomain

string

Atualize o domínio da VM.

vmId

string

ID da máquina virtual (identificador exclusivo).

vmScaleSet

AzureVmScaleSetConfiguration

Contém informações sobre computadores hospedados como um Conjunto de Dimensionamento de Máquinas Virtuais do Azure

AzureServiceFabricClusterConfiguration

Descreve um cluster do Azure Service Fabric

Nome Tipo Description
clusterId

string

Identificador de cluster do Service Fabric.

name

string

Nome do cluster do Service Fabric.

AzureVmScaleSetConfiguration

Descreve um conjunto de dimensionamento de máquinas virtuais do Azure

Nome Tipo Description
deployment

string

Identificador de implantação do Conjunto de Dimensionamento de Máquinas Virtuais

instanceId

string

Identificador de instância do Conjunto de Dimensionamento de Máquinas Virtuais

name

string

Nome do Conjunto de dimensionamento de máquinas virtuais

resourceId

string

Identificador exclusivo do recurso.

Bitness

Especifica o bitness de um computador ou processo.

Nome Tipo Description
32bit

string

64bit

string

Error

Detalhes do erro.

Nome Tipo Description
code

string

Código de erro que identifica o erro específico.

message

string

Mensagem de erro na localidade do chamador.

ErrorResponse

Uma resposta de erro da API.

Nome Tipo Description
error

Error

Informações de erro.

HypervisorConfiguration

Descreve a configuração do hipervisor de um computador.

Nome Tipo Description
hypervisorType

HypervisorType

Especifica a tecnologia de virtualização usada pelo hipervisor (hyperv, vmware etc.)

nativeHostMachineId

string

O identificador exclusivo da máquina de hipervisor, conforme relatado pelo sistema de virtualização subjacente.

HypervisorType

Especifica o tipo de hipervisor de um computador.

Nome Tipo Description
hyperv

string

unknown

string

ImageConfiguration

Descreve a imagem da VM de um computador.

Nome Tipo Description
offering

string

Oferta da imagem da VM.

publisher

string

Publicador da imagem da VM.

sku

string

SKU da imagem da VM.

version

string

Versão da imagem da VM.

Ipv4NetworkInterface

Descreve um adaptador de rede IPv4.

Nome Tipo Valor padrão Description
ipAddress

string

Endereço IPv4.

subnetMask

string

255.255.255.255

Máscara de sub-rede IPv4.

Ipv6NetworkInterface

Descreve um adaptador de rede IPv6.

Nome Tipo Description
ipAddress

string

Endereço IPv6.

Machine

Um recurso de computador representa um sistema de computador descoberto. Ele pode ser monitorado, ou seja, um Dependency Agent está em execução nele ou descoberto, ou seja, sua existência foi inferida observando o fluxo de dados de computadores monitorados. À medida que os computadores mudam, as versões anteriores do recurso de computador são preservadas e disponíveis para acesso. Um computador fica ativo durante um intervalo de tempo, se seu Dependency Agent tiver relatado dados durante (partes) desse intervalo ou um Agente de dependência em execução em outros computadores tiver relatado a atividade associada ao computador.

Nome Tipo Description
etag

string

ETAG de recurso.

id

string

Identificador de recurso.

kind string:

machine

Qualificador de tipo de recurso adicional.

name

string

Nome do recurso.

properties.agent

AgentConfiguration

Configuração do Dependency Agent.

properties.bootTime

string

Data e hora UTC em que o computador foi inicializado pela última vez

properties.computerName

string

Nome do computador, por exemplo, servidor

properties.displayName

string

Nome a ser usado para fins de exibição

properties.fullyQualifiedDomainName

string

Nome totalmente qualificado do computador, por exemplo, server.company.com

properties.hosting HostingConfiguration:

AzureHostingConfiguration

Configuração relacionada à hospedagem. Presente se as informações de hospedagem forem descobertas para a VM.

properties.hypervisor

HypervisorConfiguration

Configuração relacionada ao hipervisor. Presente somente quando 'virtualizationState' for hypervisor.

properties.monitoringState

MonitoringState

Especifica se o computador é monitorado ou descoberto ativamente.

properties.networking

NetworkConfiguration

Configuração de rede (ips, gateways, dns etc.)

properties.operatingSystem

OperatingSystemConfiguration

Informações do sistema operacional.

properties.resources

MachineResourcesConfiguration

Recursos do computador (memória, cpu etc.).

properties.timestamp

string

Data e hora UTC em que esse recurso foi atualizado no sistema.

properties.timezone

Timezone

Fuso horário do computador.

properties.virtualMachine

VirtualMachineConfiguration

Configuração relacionada à virtualização. Apresentar somente quando virtualizationState for virtual.

properties.virtualizationState

VirtualizationState

Especifica se a máquina está virtualizada.

type

string

Tipo de recurso.

MachineRebootStatus

Especifica se o computador foi reinicializado desde a instalação do agente de dependência.

Nome Tipo Description
notRebooted

string

rebooted

string

unknown

string

MachineResourcesConfiguration

Descreve os recursos de um computador.

Nome Tipo Description
cpuSpeed

integer

Velocidade da CPU em megahertz (Mhz).

cpuSpeedAccuracy

Accuracy

Descreve a precisão do campo cpuSpeed.

cpus

integer

Número de CPUs.

physicalMemory

integer

Memória física em megabytes (MB).

MonitoringState

Usado para especificar se um recurso é monitorado ou descoberto.

Nome Tipo Description
discovered

string

monitored

string

NetworkConfiguration

Descreve a configuração de rede de um computador.

Nome Tipo Description
defaultIpv4Gateways

string[]

Gateways IPv4 padrão.

dnsNames

string[]

Nomes DNS associados ao computador.

ipv4Interfaces

Ipv4NetworkInterface[]

Interfaces IPv4.

ipv6Interfaces

Ipv6NetworkInterface[]

Interfaces IPv6.

macAddresses

string[]

Endereços MAC de todos os adaptadores de rede ativos.

OperatingSystemConfiguration

Descreve a configuração do sistema operacional de um computador.

Nome Tipo Description
bitness

Bitness

Bitness do sistema operacional (32 bits ou 64 bits).

family

OperatingSystemFamily

Windows, Linux etc.

fullName

string

Nome completo do sistema operacional.

OperatingSystemFamily

Especifica a família do sistema operacional, por exemplo, Linux, Windows etc.

Nome Tipo Description
aix

string

linux

string

solaris

string

unknown

string

windows

string

Timezone

Descreve um fuso horário.

Nome Tipo Description
fullName

string

Nome completo do fuso horário.

VirtualizationState

Especifica se o computador é físico, virtual, hipervisor ou desconhecido.

Nome Tipo Description
hypervisor

string

physical

string

unknown

string

virtual

string

VirtualMachineConfiguration

Descreve a configuração relacionada à virtualização de um computador.

Nome Tipo Description
nativeHostMachineId

string

O identificador exclusivo do host dessa máquina virtual, conforme relatado pelo sistema de virtualização subjacente.

nativeMachineId

string

O identificador exclusivo da máquina virtual, conforme relatado pelo sistema de virtualização subjacente.

virtualMachineName

string

O Nome da máquina virtual.

virtualMachineType

VirtualMachineType

Especifica a tecnologia de virtualização usada pelo computador (hyperv, vmware etc.)

VirtualMachineType

Especifica o tipo de virtualização de um computador.

Nome Tipo Description
hyperv

string

ldom

string

lpar

string

unknown

string

virtualPc

string

vmware

string

xen

string