Machines - Get

Restituisce il computer specificato.

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}

Parametri dell'URI

Name In Required Type Description
machineName
path True
  • string

Nome risorsa del computer.

resourceGroupName
path True
  • string

Nome del gruppo di risorse all'interno dell'oggetto subscriptionId specificato.

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

subscriptionId
path True
  • string

Identificatore della sottoscrizione di Azure.

workspaceName
path True
  • string

Area di lavoro OMS contenente le risorse di interesse.

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

api-version
query True
  • string

Versione dell'API.

timestamp
query
  • string
date-time

Data e ora UTC specificando un'istanza di ora relativa alla quale valutare la risorsa del computer. Se non specificato, il servizio usa DateTime.UtcNow.

Risposte

Name Type Description
200 OK

Operazione riuscita.

Other Status Codes

Si è verificato un errore durante l'elaborazione della richiesta. Per identificare l'errore specifico, vedere il parametro error.code.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2

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

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

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

Definizioni

Accuracy

Specifica l'accuratezza di un calcolo.

AgentConfiguration

Descrive la configurazione dell'agente di dipendenza installata in un computer.

AzureCloudServiceConfiguration

Descrive un servizio cloud di Azure

AzureCloudServiceRoleType

Usato per specificare il tipo di un ruolo del servizio cloud di Azure

AzureHostingConfiguration

Fornisce informazioni sul modo in cui un computer è ospitato in Azure

AzureServiceFabricClusterConfiguration

Descrive un cluster di Azure Service Fabric

AzureVmScaleSetConfiguration

Descrive un set di scalabilità di macchine virtuali di Azure

Bitness

Specifica il bitness di un computer o di un processo.

Error

Dettagli degli errori.

ErrorResponse

Risposta di errore dall'API.

HypervisorConfiguration

Descrive la configurazione dell'hypervisor di un computer.

HypervisorType

Specifica il tipo di hypervisor di un computer.

ImageConfiguration

Descrive l'immagine della macchina virtuale di un computer.

Ipv4NetworkInterface

Descrive un'interfaccia di rete IPv4.

Ipv6NetworkInterface

Descrive un'interfaccia di rete IPv6.

Machine

Una risorsa computer rappresenta un sistema computer individuato. Può essere monitorato, ad esempio, un agente di dipendenza è in esecuzione su di esso o scoperto, ovvero la sua esistenza è stata derivata osservando il flusso di dati dai computer monitorati. Quando i computer cambiano, le versioni precedenti della risorsa del computer vengono mantenute e disponibili per l'accesso. Un computer è attivo durante un intervallo di tempo, se l'agente di dipendenza ha segnalato i dati durante (parti) di tale intervallo o un agente di dipendenza in esecuzione in altri computer ha segnalato attività associate al computer.

MachineRebootStatus

Specifica se il computer è stato riavviato dopo l'installazione dell'agente di dipendenza.

MachineResourcesConfiguration

Descrive le risorse di un computer.

MonitoringState

Utilizzato per specificare se una risorsa viene monitorata o individuata.

NetworkConfiguration

Descrive la configurazione di rete di un computer.

OperatingSystemConfiguration

Descrive la configurazione del sistema operativo di un computer.

OperatingSystemFamily

Specifica la famiglia di sistemi operativi, ad esempio Linux, Windows e così via.

Timezone

Descrive un fuso orario.

VirtualizationState

Specifica se la macchina è fisica, virtuale, hypervisor o sconosciuta.

VirtualMachineConfiguration

Descrive la configurazione correlata alla virtualizzazione di un computer.

VirtualMachineType

Specifica il tipo di virtualizzazione di un computer.

Accuracy

Specifica l'accuratezza di un calcolo.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

Descrive la configurazione dell'agente di dipendenza installata in un computer.

Name Type Description
agentId
  • string

Servizio integrità identificatore univoco dell'agente.

clockGranularity
  • integer

Granularità del clock del computer in millisecondi.

dependencyAgentId
  • string

Identificatore univoco dell'agente di dipendenza.

dependencyAgentRevision
  • string

Numero di revisione dell'agente di dipendenza.

dependencyAgentVersion
  • string

Numero di versione dell'agente di dipendenza.

rebootStatus

Specifica se il computer è stato riavviato dopo l'installazione dell'agente di dipendenza.

AzureCloudServiceConfiguration

Descrive un servizio cloud di Azure

Name Type Description
deployment
  • string

Identificatore di distribuzione del servizio cloud

instanceId
  • string

Identificatore dell'istanza del servizio cloud

name
  • string

Nome servizio cloud

roleName
  • string

Nome del ruolo del servizio cloud

roleType

Usato per specificare il tipo di un ruolo del servizio cloud di Azure

AzureCloudServiceRoleType

Usato per specificare il tipo di un ruolo del servizio cloud di Azure

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

AzureHostingConfiguration

Fornisce informazioni sul modo in cui un computer è ospitato in Azure

Name Type Description
cloudService

Contiene informazioni sui computer ospitati come servizio cloud di Azure

faultDomain
  • string

Dominio di errore della macchina virtuale.

image

Immagine del computer.

kind string:
  • provider:azure

Qualificatore aggiuntivo del tipo di configurazione di hosting.

location
  • string

Posizione geografica della macchina virtuale.

name
  • string

Nome del computer in base al provider di hosting.

provider enum:
  • azure

Provider di hosting della macchina virtuale.

resourceGroup
  • string

Nome del gruppo di risorse all'interno della sottoscrizione specificata.

resourceId
  • string

Identificatore univoco della risorsa.

serviceFabricCluster

Contiene informazioni sui computer appartenenti a un cluster di Azure Service Fabric

size
  • string

Dimensioni della macchina virtuale.

subscriptionId
  • string

l'ID sottoscrizione.

updateDomain
  • string

Aggiornare il dominio della macchina virtuale.

vmId
  • string

ID macchina virtuale (identificatore univoco).

vmScaleSet

Contiene informazioni sulle macchine ospitate come set di scalabilità di macchine virtuali di Azure

AzureServiceFabricClusterConfiguration

Descrive un cluster di Azure Service Fabric

Name Type Description
clusterId
  • string

Service Fabric identificatore del cluster.

name
  • string

Service Fabric nome del cluster.

AzureVmScaleSetConfiguration

Descrive un set di scalabilità di macchine virtuali di Azure

Name Type Description
deployment
  • string

Identificatore di distribuzione del set di scalabilità di macchine virtuali

instanceId
  • string

Identificatore dell'istanza del set di scalabilità di macchine virtuali

name
  • string

Nome del set di scalabilità di macchine virtuali

resourceId
  • string

Identificatore univoco della risorsa.

Bitness

Specifica il bitness di un computer o di un processo.

Name Type Description
32bit
  • string
64bit
  • string

Error

Dettagli degli errori.

Name Type Description
code
  • string

Codice errore che identifica l'errore specifico.

message
  • string

Messaggio di errore nelle impostazioni locali del chiamante.

ErrorResponse

Risposta di errore dall'API.

Name Type Description
error

Informazioni sugli errori.

HypervisorConfiguration

Descrive la configurazione dell'hypervisor di un computer.

Name Type Description
hypervisorType

Specifica la tecnologia di virtualizzazione usata dall'hypervisor (hyperv, vmware e così via)

nativeHostMachineId
  • string

Identificatore univoco del computer hypervisor come segnalato dal sistema di virtualizzazione sottostante.

HypervisorType

Specifica il tipo di hypervisor di un computer.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Descrive l'immagine della macchina virtuale di un computer.

Name Type Description
offering
  • string

Offerta dell'immagine della macchina virtuale.

publisher
  • string

Publisher dell'immagine della macchina virtuale.

sku
  • string

SKU dell'immagine della macchina virtuale.

version
  • string

Versione dell'immagine della macchina virtuale.

Ipv4NetworkInterface

Descrive un'interfaccia di rete IPv4.

Name Type Default Value Description
ipAddress
  • string

Indirizzo IPv4.

subnetMask
  • string
255.255.255.255

Subnet mask IPv4.

Ipv6NetworkInterface

Descrive un'interfaccia di rete IPv6.

Name Type Description
ipAddress
  • string

Indirizzo IPv6.

Machine

Una risorsa computer rappresenta un sistema computer individuato. Può essere monitorato, ad esempio, un agente di dipendenza è in esecuzione su di esso o scoperto, ovvero la sua esistenza è stata derivata osservando il flusso di dati dai computer monitorati. Quando i computer cambiano, le versioni precedenti della risorsa del computer vengono mantenute e disponibili per l'accesso. Un computer è attivo durante un intervallo di tempo, se l'agente di dipendenza ha segnalato i dati durante (parti) di tale intervallo o un agente di dipendenza in esecuzione in altri computer ha segnalato attività associate al computer.

Name Type Description
etag
  • string

ETAG delle risorse.

id
  • string

Identificatore di risorsa.

kind string:
  • machine

Qualificatore di tipo di risorsa aggiuntivo.

name
  • string

Nome risorsa.

properties.agent

Configurazione dell'agente di dipendenza.

properties.bootTime
  • string

Data e ora UTC dell'ultimo avvio del computer

properties.computerName
  • string

Nome del computer, ad esempio server

properties.displayName
  • string

Nome da usare a scopo di visualizzazione

properties.fullyQualifiedDomainName
  • string

Nome completo del computer, ad esempio server.company.com

properties.hosting HostingConfiguration:

Configurazione correlata all'hosting. Presentare se le informazioni di hosting vengono individuate per la macchina virtuale.

properties.hypervisor

Configurazione correlata all'Hypervisor. Presente solo quando 'virtualizationState' è hypervisor.

properties.monitoringState

Specifica se il computer è monitorato o individuato attivamente.

properties.networking

Configurazione di rete (ips, gateway, dns e così via)

properties.operatingSystem

Informazioni sul sistema operativo.

properties.resources

Risorse del computer (memoria, CPU e così via).

properties.timestamp
  • string

Data UTC e ora in cui questa risorsa è stata aggiornata nel sistema.

properties.timezone

Fuso orario del computer.

properties.virtualMachine

Configurazione correlata alla virtualizzazione. Presente solo quando virtualizationState è virtual.

properties.virtualizationState

Specifica se la macchina è virtualizzata.

type
  • string

Tipo di risorsa.

MachineRebootStatus

Specifica se il computer è stato riavviato dopo l'installazione dell'agente di dipendenza.

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

MachineResourcesConfiguration

Descrive le risorse di un computer.

Name Type Description
cpuSpeed
  • integer

Velocità della CPU in megahertz (Mhz).

cpuSpeedAccuracy

Descrive l'accuratezza del campo cpuSpeed.

cpus
  • integer

Numero di CPU.

physicalMemory
  • integer

Memoria fisica in megabyte (MB).

MonitoringState

Utilizzato per specificare se una risorsa viene monitorata o individuata.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Descrive la configurazione di rete di un computer.

Name Type Description
defaultIpv4Gateways
  • string[]

Gateway IPv4 predefiniti.

dnsNames
  • string[]

Nomi DNS associati al computer.

ipv4Interfaces

Interfacce IPv4.

ipv6Interfaces

Interfacce IPv6.

macAddresses
  • string[]

Indirizzi MAC di tutte le interfacce di rete attive.

OperatingSystemConfiguration

Descrive la configurazione del sistema operativo di un computer.

Name Type Description
bitness

Bit del sistema operativo (32 bit o 64 bit).

family

Windows, Linux e così via.

fullName
  • string

Nome completo del sistema operativo.

OperatingSystemFamily

Specifica la famiglia di sistemi operativi, ad esempio Linux, Windows e così via.

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

Timezone

Descrive un fuso orario.

Name Type Description
fullName
  • string

Nome completo del fuso orario.

VirtualizationState

Specifica se la macchina è fisica, virtuale, hypervisor o sconosciuta.

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

VirtualMachineConfiguration

Descrive la configurazione correlata alla virtualizzazione di un computer.

Name Type Description
nativeHostMachineId
  • string

Identificatore univoco dell'host di questa macchina virtuale come segnalato dal sistema di virtualizzazione sottostante.

nativeMachineId
  • string

Identificatore univoco della macchina virtuale come segnalato dal sistema di virtualizzazione sottostante.

virtualMachineName
  • string

Nome della macchina virtuale.

virtualMachineType

Specifica la tecnologia di virtualizzazione usata dal computer (hyperv, vmware e così via)

VirtualMachineType

Specifica il tipo di virtualizzazione di un computer.

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