Machines - Get

Referência

Serviço:: Service Map

Versão da API:: 2015-11-01-preview

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

Com parâmetros opcionais:

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 minLength: 3 maxLength: 64	Nome do recurso do computador.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nome do grupo de recursos na subscriptionId especificada.
subscriptionId	path	True	string	Identificador de assinatura do Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Workspace do OMS que contém os recursos de interesse.
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 êxito.
Other Status Codes	ErrorResponse	Erro ao processar a solicitação. Consulte o parâmetro error.code para identificar o erro específico.

Segurança

azure_auth

Fluxo 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

HTTP

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

Código de status:: 200

{
  "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 a 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. Pode ser monitorada, ou seja, um Agente de Dependência está em execução nele ou descoberta, 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 do computador são preservadas e disponíveis para acesso. Um computador fica ativo durante um intervalo de tempo, se seu Agente de Dependência tiver relatado dados durante (partes) desse intervalo ou um agente de dependência em execução em outros computadores tiver relatado 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

Enumeração

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

Valor	Description
actual
estimated

AgentConfiguration

Objeto

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 (int32)	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

Objeto

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 serviço de nuvem
roleType	AzureCloudServiceRoleType	Usado para especificar o tipo de uma função do Serviço de Nuvem do Azure

AzureCloudServiceRoleType

Enumeração

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

Valor	Description
unknown
web
worker

AzureHostingConfiguration

Objeto

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	Tamanho da VM.
subscriptionId	string	ID da assinatura.
updateDomain	string	Atualizar 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

Objeto

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

Objeto

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

Enumeração

Especifica a bitness de um computador ou processo.

Valor	Description
32bit
64bit

Error

Objeto

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

Objeto

Uma resposta de erro da API.

Nome	Tipo	Description
error	Error	Informações de erro.

HypervisorConfiguration

Objeto

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

Enumeração

Especifica o tipo de hipervisor de um computador.

Valor	Description
hyperv
unknown

ImageConfiguration

Objeto

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

Objeto

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

Objeto

Descreve um adaptador de rede IPv6.

Nome	Tipo	Description
ipAddress	string	Endereço IPv6.

Machine

Objeto

Um recurso de computador representa um sistema de computador descoberto. Pode ser monitorada, ou seja, um Agente de Dependência está em execução nele ou descoberta, 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 do computador são preservadas e disponíveis para acesso. Um computador fica ativo durante um intervalo de tempo, se seu Agente de Dependência tiver relatado dados durante (partes) desse intervalo ou um agente de dependência em execução em outros computadores tiver relatado 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 (date-time)	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. Apresente se as informações de hospedagem são descobertas para a VM.
properties.hypervisor	HypervisorConfiguration	Configuração relacionada ao hipervisor. Presente somente quando 'virtualizationState' é `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 (date-time)	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. Presente somente quando `virtualizationState` é `virtual`.
properties.virtualizationState	VirtualizationState	Especifica se a máquina está virtualizada.
type	string	Tipo de recurso.

MachineRebootStatus

Enumeração

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

Valor	Description
notRebooted
rebooted
unknown

MachineResourcesConfiguration

Objeto

Descreve os recursos de um computador.

Nome	Tipo	Description
cpuSpeed	integer (int32)	Velocidade da CPU em megahertz (Mhz).
cpuSpeedAccuracy	Accuracy	Descreve a precisão do campo cpuSpeed.
cpus	integer (int32)	Número de CPUs.
physicalMemory	integer (int32)	Memória física em megabytes (MB).

MonitoringState

Enumeração

Usado para especificar se um recurso é monitorado ou descoberto.

Valor	Description
discovered
monitored

NetworkConfiguration

Objeto

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

Objeto

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

Enumeração

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

Valor	Description
aix
linux
solaris
unknown
windows

Timezone

Objeto

Descreve um fuso horário.

Nome	Tipo	Description
fullName	string	Nome completo do fuso horário.

VirtualizationState

Enumeração

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

Valor	Description
hypervisor
physical
unknown
virtual

VirtualMachineConfiguration

Objeto

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 pela máquina (hyperv, vmware etc.)

VirtualMachineType

Enumeração

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

Valor	Description
hyperv
ldom
lpar
unknown
virtualPc
vmware
xen

Compartilhar via

Machines - Get

Parâmetros de URI

Respostas

Segurança

azure_auth

Escopos

Exemplos

SMMachinesGetGet

Solicitação de exemplo

Resposta de exemplo

Definições

Accuracy

AgentConfiguration

AzureCloudServiceConfiguration

AzureCloudServiceRoleType

AzureHostingConfiguration

AzureServiceFabricClusterConfiguration

AzureVmScaleSetConfiguration

Bitness

Error

ErrorResponse

HypervisorConfiguration

HypervisorType

ImageConfiguration

Ipv4NetworkInterface

Ipv6NetworkInterface

Machine

MachineRebootStatus

MachineResourcesConfiguration

MonitoringState

NetworkConfiguration

OperatingSystemConfiguration

OperatingSystemFamily

Timezone

VirtualizationState

VirtualMachineConfiguration

VirtualMachineType