Machines - Get

Vrátí zadaný počítač.

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}

Parametry identifikátoru URI

Name In Required Type Description
machineName
path True
  • string

Název prostředku počítače.

resourceGroupName
path True
  • string

Název skupiny prostředků v zadaném ID předplatného

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

subscriptionId
path True
  • string

Identifikátor předplatného Azure.

workspaceName
path True
  • string

Pracovní prostor OMS obsahující prostředky, které mají zájem.

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

api-version
query True
  • string

Verze rozhraní API.

timestamp
query
  • string
date-time

Datum a čas UTC určující instanci času relativní k vyhodnocení prostředku počítače. Pokud není zadáno, používá služba DateTime.UtcNow.

Odpovědi

Name Type Description
200 OK

Operace se úspěšně dokončila.

Other Status Codes

Při zpracování požadavku došlo k chybě. Pokud chcete identifikovat konkrétní chybu, podívejte se na parametr error.code.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

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

Definice

Accuracy

Určuje přesnost výpočtu.

AgentConfiguration

Popisuje konfiguraci závislého agenta nainstalovaného na počítači.

AzureCloudServiceConfiguration

Popisuje cloudovou službu Azure.

AzureCloudServiceRoleType

Slouží k určení typu role cloudové služby Azure.

AzureHostingConfiguration

Poskytuje informace o tom, jak je počítač hostovaný v Azure.

AzureServiceFabricClusterConfiguration

Popisuje cluster Azure Service Fabric.

AzureVmScaleSetConfiguration

Popisuje škálovací sadu virtuálních počítačů Azure.

Bitness

Určuje bitovou verzi počítače nebo procesu.

Error

Podrobnosti o chybě

ErrorResponse

Chybová odpověď z rozhraní API.

HypervisorConfiguration

Popisuje konfiguraci hypervisoru počítače.

HypervisorType

Určuje typ hypervisoru počítače.

ImageConfiguration

Popisuje image virtuálního počítače.

Ipv4NetworkInterface

Popisuje síťové rozhraní IPv4.

Ipv6NetworkInterface

Popisuje síťové rozhraní IPv6.

Machine

Prostředek počítače představuje zjištěný počítačový systém. Může být monitorován, tj. agent závislostí na něm běží nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového streamu z monitorovaných počítačů. Při změně počítačů se předchozí verze prostředku počítače zachovají a jsou dostupné pro přístup. Počítač je aktivní během časového intervalu, pokud jeho agent závislostí nahlásil data během (částí) tohoto intervalu nebo agent závislostí spuštěný na jiných počítačích oznámil aktivitu přidruženou k počítači.

MachineRebootStatus

Určuje, jestli se počítač od instalace agenta závislostí restartoval.

MachineResourcesConfiguration

Popisuje prostředky počítače.

MonitoringState

Slouží k určení, jestli jsou prostředky monitorovány nebo zjištěny.

NetworkConfiguration

Popisuje konfiguraci sítě počítače.

OperatingSystemConfiguration

Popisuje konfiguraci operačního systému počítače.

OperatingSystemFamily

Určuje řadu operačních systémů, například Linux, Windows atd.

Timezone

Popisuje časové pásmo.

VirtualizationState

Určuje, jestli je počítač fyzický, virtuální, hypervisor nebo neznámý.

VirtualMachineConfiguration

Popisuje konfiguraci související s virtualizací počítače.

VirtualMachineType

Určuje typ virtualizace počítače.

Accuracy

Určuje přesnost výpočtu.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

Popisuje konfiguraci závislého agenta nainstalovaného na počítači.

Name Type Description
agentId
  • string

jedinečný identifikátor agenta Health Service.

clockGranularity
  • integer

Členitost hodin stroje v milisekundách

dependencyAgentId
  • string

Jedinečný identifikátor agenta závislostí

dependencyAgentRevision
  • string

Číslo revize agenta závislostí

dependencyAgentVersion
  • string

Číslo verze agenta závislostí

rebootStatus

Určuje, jestli se počítač od instalace závislého agenta restartoval.

AzureCloudServiceConfiguration

Popisuje cloudovou službu Azure.

Name Type Description
deployment
  • string

Identifikátor nasazení cloudové služby

instanceId
  • string

Identifikátor instance cloudové služby

name
  • string

Název cloudové služby

roleName
  • string

Název role cloudové služby

roleType

Slouží k určení typu role cloudové služby Azure.

AzureCloudServiceRoleType

Slouží k určení typu role cloudové služby Azure.

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

AzureHostingConfiguration

Poskytuje informace o tom, jak je počítač hostovaný v Azure.

Name Type Description
cloudService

Obsahuje informace o počítačích hostovaných jako cloudová služba Azure

faultDomain
  • string

Doména selhání virtuálního počítače

image

Obrázek počítače

kind string:
  • provider:azure

Další kvalifikátor typu konfigurace hostování

location
  • string

Zeměpisné umístění virtuálního počítače

name
  • string

Název počítače podle poskytovatele hostingu.

provider enum:
  • azure

Poskytovatel hostingu virtuálního počítače.

resourceGroup
  • string

Název skupiny prostředků v rámci zadaného předplatného

resourceId
  • string

Jedinečný identifikátor prostředku.

serviceFabricCluster

Obsahuje informace o počítačích, které patří cluster Azure Service Fabric

size
  • string

Velikost virtuálního počítače

subscriptionId
  • string

ID předplatného

updateDomain
  • string

Aktualizujte doménu virtuálního počítače.

vmId
  • string

ID virtuálního počítače (jedinečný identifikátor).

vmScaleSet

Obsahuje informace o počítačích hostovaných jako škálovací sada virtuálních počítačů Azure.

AzureServiceFabricClusterConfiguration

Popisuje cluster Azure Service Fabric.

Name Type Description
clusterId
  • string

identifikátor clusteru Service Fabric.

name
  • string

Service Fabric název clusteru.

AzureVmScaleSetConfiguration

Popisuje škálovací sadu virtuálních počítačů Azure.

Name Type Description
deployment
  • string

Identifikátor nasazení škálovací sady virtuálních počítačů

instanceId
  • string

Identifikátor instance škálovací sady virtuálních počítačů

name
  • string

Název škálovací sady virtuálních počítačů

resourceId
  • string

Jedinečný identifikátor prostředku

Bitness

Určuje bitovou verzi počítače nebo procesu.

Name Type Description
32bit
  • string
64bit
  • string

Error

Podrobnosti o chybě

Name Type Description
code
  • string

Kód chyby identifikující konkrétní chybu

message
  • string

Chybová zpráva v národním prostředí volajícího

ErrorResponse

Chybová odpověď z rozhraní API.

Name Type Description
error

Informace o chybě

HypervisorConfiguration

Popisuje konfiguraci hypervisoru počítače.

Name Type Description
hypervisorType

Určuje virtualizační technologii používanou hypervisorem (hyperv, vmware atd.).

nativeHostMachineId
  • string

Jedinečný identifikátor počítače hypervisoru, jak hlásí základní virtualizační systém.

HypervisorType

Určuje typ hypervisoru počítače.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Popisuje image virtuálního počítače.

Name Type Description
offering
  • string

Nabídka image virtuálního počítače

publisher
  • string

Publisher image virtuálního počítače.

sku
  • string

Skladová položka image virtuálního počítače.

version
  • string

Verze image virtuálního počítače

Ipv4NetworkInterface

Popisuje síťové rozhraní IPv4.

Name Type Default Value Description
ipAddress
  • string

Adresa IPv4.

subnetMask
  • string
255.255.255.255

Maska podsítě IPv4

Ipv6NetworkInterface

Popisuje síťové rozhraní IPv6.

Name Type Description
ipAddress
  • string

Adresa IPv6.

Machine

Prostředek počítače představuje zjištěný počítačový systém. Může být monitorován, tj. agent závislostí na něm běží nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového streamu z monitorovaných počítačů. Při změně počítačů se předchozí verze prostředku počítače zachovají a jsou dostupné pro přístup. Počítač je aktivní během časového intervalu, pokud jeho agent závislostí nahlásil data během (částí) tohoto intervalu nebo agent závislostí spuštěný na jiných počítačích oznámil aktivitu přidruženou k počítači.

Name Type Description
etag
  • string

Značky ETAG prostředku

id
  • string

Identifikátor prostředku.

kind string:
  • machine

Kvalifikátor dalšího typu prostředku.

name
  • string

Název prostředku.

properties.agent

Konfigurace agenta závislostí

properties.bootTime
  • string

Datum a čas UTC při posledním spuštění počítače

properties.computerName
  • string

Název počítače, například server

properties.displayName
  • string

Název, který se má použít pro účely zobrazení

properties.fullyQualifiedDomainName
  • string

Plně kvalifikovaný název počítače, např. server.company.com

properties.hosting HostingConfiguration:

Konfigurace související s hostování Pokud se pro virtuální počítač zjistí informace o hostování

properties.hypervisor

Konfigurace související s hypervisorem Prezentovat pouze v případě, že je hypervisorvirtualizační stav .

properties.monitoringState

Určuje, jestli je počítač aktivně monitorován nebo zjištěn.

properties.networking

Konfigurace sítě (ips, brány, dns atd.)

properties.operatingSystem

Informace o operačním systému

properties.resources

Prostředky počítače (paměť, procesor atd.).

properties.timestamp
  • string

Datum a čas UTC, kdy byl tento prostředek v systému aktualizován.

properties.timezone

Časové pásmo stroje.

properties.virtualMachine

Konfigurace související s virtualizací Prezentovat pouze tehdy, když virtualizationState je virtual.

properties.virtualizationState

Určuje, jestli je počítač virtualizovaný.

type
  • string

Typ prostředku.

MachineRebootStatus

Určuje, jestli se počítač od instalace agenta závislostí restartoval.

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

MachineResourcesConfiguration

Popisuje prostředky počítače.

Name Type Description
cpuSpeed
  • integer

Rychlost procesoru v megahertzu (Mhz).

cpuSpeedAccuracy

Popisuje přesnost pole cpuSpeed.

cpus
  • integer

Počet procesorů.

physicalMemory
  • integer

Fyzická paměť v megabajtech (MB).

MonitoringState

Slouží k určení, jestli jsou prostředky monitorovány nebo zjištěny.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Popisuje konfiguraci sítě počítače.

Name Type Description
defaultIpv4Gateways
  • string[]

Výchozí brány IPv4

dnsNames
  • string[]

Názvy DNS přidružené k počítači

ipv4Interfaces

Rozhraní IPv4.

ipv6Interfaces

Rozhraní IPv6.

macAddresses
  • string[]

Adresy MAC všech aktivních síťových rozhraní.

OperatingSystemConfiguration

Popisuje konfiguraci operačního systému počítače.

Name Type Description
bitness

Bitová verze operačního systému (32bitová nebo 64bitová verze)

family

Windows, Linux atd.

fullName
  • string

Úplný název operačního systému.

OperatingSystemFamily

Určuje řadu operačních systémů, například Linux, Windows atd.

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

Timezone

Popisuje časové pásmo.

Name Type Description
fullName
  • string

Celé jméno časového pásma.

VirtualizationState

Určuje, jestli je počítač fyzický, virtuální, hypervisor nebo neznámý.

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

VirtualMachineConfiguration

Popisuje konfiguraci související s virtualizací počítače.

Name Type Description
nativeHostMachineId
  • string

Jedinečný identifikátor hostitele tohoto virtuálního počítače, jak hlásí základní virtualizační systém.

nativeMachineId
  • string

Jedinečný identifikátor virtuálního počítače, jak hlásí základní virtualizační systém.

virtualMachineName
  • string

Název virtuálního počítače.

virtualMachineType

Určuje virtualizační technologii používanou počítačem (hyperv, vmware atd.)

VirtualMachineType

Určuje typ virtualizace počítače.

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