Machines - Get

Devolve a máquina especificada.

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 do URI

Name In Required Type Description
machineName
path True
  • string

Nome de recurso da máquina.

resourceGroupName
path True
  • string

Nome do grupo de recursos dentro da subscrição especificadaId.

Regex pattern: [a-zA-Z0-9_-]+

subscriptionId
path True
  • string

Identificador de assinatura Azure.

workspaceName
path True
  • string

Espaço de trabalho da OMS contendo os recursos de interesse.

Regex pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]

api-version
query True
  • string

Versão API.

timestamp
query
  • string
date-time

Data e hora utc especificando uma instância de tempo relativamente à qual avaliar o recurso da máquina. Quando não especificado, o serviço utiliza DateTime.UtcNow.

Respostas

Name Type Description
200 OK

A operação terminou com sucesso.

Other Status Codes

Ocorreu um erro durante o processamento do pedido. Consulte o parâmetro error.code para identificar o erro específico.

Segurança

azure_auth

Flow de Azure Ative Directory OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

SMMachinesGetGet

Sample Request

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

Sample Response

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

Accuracy

Especifica a precisão de um cálculo.

AgentConfiguration

Descreve a configuração do Agente de Dependência instalado numa máquina.

AzureCloudServiceConfiguration

Descreve um Serviço de Nuvem Azure

AzureCloudServiceRoleType

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

AzureHostingConfiguration

Fornece informações sobre como uma máquina é hospedada em Azure

AzureServiceFabricClusterConfiguration

Descreve um aglomerado de Service Fabric Azure

AzureVmScaleSetConfiguration

Descreve um conjunto de escala de máquina virtual Azure

Bitness

Especifica a mordida de uma máquina ou processo.

Error

Detalhes de erro.

ErrorResponse

Uma resposta de erro da API.

HypervisorConfiguration

Descreve a configuração hipervisor de uma máquina.

HypervisorType

Especifica o tipo de hipervisor de uma máquina.

ImageConfiguration

Descreve a imagem VM de uma máquina.

Ipv4NetworkInterface

Descreve uma interface de rede IPv4.

Ipv6NetworkInterface

Descreve uma interface de rede IPv6.

Machine

Um recurso de máquina representa um sistema informático descoberto. Pode ser monitorizado, ou seja, um Agente de Dependência está a funcionar nele, ou descoberto, ou seja, a sua existência foi inferida observando o fluxo de dados a partir de máquinas monitorizadas. À medida que as máquinas mudam, as versões anteriores do recurso da máquina são preservadas e disponíveis para acesso. Uma máquina está ao vivo durante um intervalo de tempo, se o seu Agente de Dependência tiver comunicado dados durante (partes) desse intervalo, ou se um agente de dependência que funciona noutras máquinas tiver relatado atividade associada à máquina.

MachineRebootStatus

Especifica se a máquina foi reiniciada desde a instalação do agente de dependência.

MachineResourcesConfiguration

Descreve os recursos de uma máquina.

MonitoringState

Usado para especificar se um recursos é monitorizado ou descoberto.

NetworkConfiguration

Descreve a configuração de rede de uma máquina.

OperatingSystemConfiguration

Descreve a configuração do sistema operativo de uma máquina.

OperatingSystemFamily

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

Timezone

Descreve um timezone.

VirtualizationState

Especifica se a máquina é física, virtual, hipervisora ou desconhecida.

VirtualMachineConfiguration

Descreve a configuração relacionada com a virtualização de uma máquina.

VirtualMachineType

Especifica o tipo de virtualização de uma máquina.

Accuracy

Especifica a precisão de um cálculo.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

Descreve a configuração do Agente de Dependência instalado numa máquina.

Name Type Description
agentId
  • string

Serviço de Estado de Funcionamento agente identificador único.

clockGranularity
  • integer

Granularidade do relógio da máquina em milissegundos.

dependencyAgentId
  • string

Agente de dependência identificador único.

dependencyAgentRevision
  • string

Número de revisão do Agente de Dependência.

dependencyAgentVersion
  • string

Número da versão do Agente de Dependência.

rebootStatus

Especifica se a máquina foi reiniciada desde a instalação do Agente de Dependência.

AzureCloudServiceConfiguration

Descreve um Serviço de Nuvem Azure

Name Type Description
deployment
  • string

Identificador de implementação de serviço de nuvem

instanceId
  • string

Identificador de instância de serviço de nuvem

name
  • string

Nome do Serviço de Nuvem

roleName
  • string

Nome da função de serviço de nuvem

roleType

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

AzureCloudServiceRoleType

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

Name Type Description
unknown
  • string
web
  • string
worker
  • string

AzureHostingConfiguration

Fornece informações sobre como uma máquina é hospedada em Azure

Name Type Description
cloudService

Contém informações sobre máquinas hospedadas como um Serviço de Nuvem Azure

faultDomain
  • string

Domínio de avaria do VM.

image

Imagem da máquina.

kind string:
  • provider:azure

Classificação adicional do tipo de configuração de hospedagem.

location
  • string

Localização geográfica do VM.

name
  • string

Nome da máquina de acordo com o fornecedor de alojamento.

provider enum:
  • azure

O fornecedor de hospedagem do VM.

resourceGroup
  • string

Nome do grupo de recursos dentro da subscrição especificada.

resourceId
  • string

Identificador único do recurso.

serviceFabricCluster

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

size
  • string

Tamanho do VM.

subscriptionId
  • string

ID da Subscrição.

updateDomain
  • string

Atualizar o domínio do VM.

vmId
  • string

ID de máquina virtual (identificador único).

vmScaleSet

Contém informações sobre máquinas hospedadas como um conjunto de balança de máquina virtual Azure

AzureServiceFabricClusterConfiguration

Descreve um aglomerado de Service Fabric Azure

Name Type Description
clusterId
  • string

Service Fabric identificador de aglomerados.

name
  • string

Service Fabric nome de aglomerado.

AzureVmScaleSetConfiguration

Descreve um conjunto de escala de máquina virtual Azure

Name Type Description
deployment
  • string

Identificador de configuração de escala de máquina virtual

instanceId
  • string

Identificador de identificação de conjunto de máquinas virtuais

name
  • string

Nome de conjunto de escala de máquina virtual

resourceId
  • string

Identificador único do recurso.

Bitness

Especifica a mordida de uma máquina ou processo.

Name Type Description
32bit
  • string
64bit
  • string

Error

Detalhes de erro.

Name Type Description
code
  • string

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

message
  • string

Mensagem de erro no local do chamador.

ErrorResponse

Uma resposta de erro da API.

Name Type Description
error

Informação de erro.

HypervisorConfiguration

Descreve a configuração hipervisor de uma máquina.

Name Type Description
hypervisorType

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

nativeHostMachineId
  • string

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

HypervisorType

Especifica o tipo de hipervisor de uma máquina.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Descreve a imagem VM de uma máquina.

Name Type Description
offering
  • string

Oferta da imagem VM.

publisher
  • string

Publisher da imagem VM.

sku
  • string

SKU da imagem VM.

version
  • string

Versão da imagem VM.

Ipv4NetworkInterface

Descreve uma interface de rede IPv4.

Name Type Default Value Description
ipAddress
  • string

Endereço IPv4.

subnetMask
  • string
255.255.255.255

Máscara de sub-rede IPv4.

Ipv6NetworkInterface

Descreve uma interface de rede IPv6.

Name Type Description
ipAddress
  • string

Endereço IPv6.

Machine

Um recurso de máquina representa um sistema informático descoberto. Pode ser monitorizado, ou seja, um Agente de Dependência está a funcionar nele, ou descoberto, ou seja, a sua existência foi inferida observando o fluxo de dados a partir de máquinas monitorizadas. À medida que as máquinas mudam, as versões anteriores do recurso da máquina são preservadas e disponíveis para acesso. Uma máquina está ao vivo durante um intervalo de tempo, se o seu Agente de Dependência tiver comunicado dados durante (partes) desse intervalo, ou se um agente de dependência que funciona noutras máquinas tiver relatado atividade associada à máquina.

Name Type Description
etag
  • string

ETAG de recurso.

id
  • string

Identificador de recursos.

kind string:
  • machine

Qualificação adicional do tipo de recurso.

name
  • string

Nome de recurso.

properties.agent

Configuração do Agente de Dependência.

properties.bootTime
  • string

Data e hora utc quando a máquina foi arrancada pela última vez

properties.computerName
  • string

Nome da máquina, por exemplo, servidor

properties.displayName
  • string

Nome a usar para efeitos de exibição

properties.fullyQualifiedDomainName
  • string

Nome totalmente qualificado da máquina, por exemplo, server.company.com

properties.hosting HostingConfiguration:

Configuração relacionada com o alojamento. Presente se forem descobertas informações de hospedagem para o VM.

properties.hypervisor

Configuração relacionada com hipervisor. Presente apenas quando o 'VirtualizationState' estiver hypervisor.

properties.monitoringState

Especifica se a máquina está ativamente monitorizada ou descoberta.

properties.networking

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

properties.operatingSystem

Informação do sistema operativo.

properties.resources

Recursos de máquina (memória, cpu, etc.).

properties.timestamp
  • string

Data e hora da UTC quando este recurso foi atualizado no sistema.

properties.timezone

O tempo da máquina.

properties.virtualMachine

Configuração relacionada com a virtualização. Presente apenas quando virtualizationState estiver virtual.

properties.virtualizationState

Especifica se a máquina está virtualizada.

type
  • string

Tipo de recurso.

MachineRebootStatus

Especifica se a máquina foi reiniciada desde a instalação do agente de dependência.

Name Type Description
notRebooted
  • string
rebooted
  • string
unknown
  • string

MachineResourcesConfiguration

Descreve os recursos de uma máquina.

Name Type Description
cpuSpeed
  • integer

Velocidade do CPU em megahertz (Mhz).

cpuSpeedAccuracy

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 recursos é monitorizado ou descoberto.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Descreve a configuração de rede de uma máquina.

Name Type Description
defaultIpv4Gateways
  • string[]

Gateways IPv4 padrão.

dnsNames
  • string[]

Os nomes dns associados à máquina.

ipv4Interfaces

Interfaces IPv4.

ipv6Interfaces

Interfaces IPv6.

macAddresses
  • string[]

Endereços MAC de todas as interfaces de rede ativas.

OperatingSystemConfiguration

Descreve a configuração do sistema operativo de uma máquina.

Name Type Description
bitness

Bitidão do sistema operativo (32 bits ou 64-bit).

family

Windows, Linux, etc.

fullName
  • string

Sistema operativo nome completo.

OperatingSystemFamily

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

Name Type Description
aix
  • string
linux
  • string
solaris
  • string
unknown
  • string
windows
  • string

Timezone

Descreve um timezone.

Name Type Description
fullName
  • string

Nome completo do timezone.

VirtualizationState

Especifica se a máquina é física, virtual, hipervisora ou desconhecida.

Name Type Description
hypervisor
  • string
physical
  • string
unknown
  • string
virtual
  • string

VirtualMachineConfiguration

Descreve a configuração relacionada com a virtualização de uma máquina.

Name Type Description
nativeHostMachineId
  • string

O identificador único do anfitrião desta máquina virtual, conforme relatado pelo sistema de virtualização subjacente.

nativeMachineId
  • string

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

virtualMachineName
  • string

O nome da máquina virtual.

virtualMachineType

Especifica a tecnologia de virtualização utilizada pela máquina (hiperv, vmware, etc.)

VirtualMachineType

Especifica o tipo de virtualização de uma máquina.

Name Type Description
hyperv
  • string
ldom
  • string
lpar
  • string
unknown
  • string
virtualPc
  • string
vmware
  • string
xen
  • string