Machines - Get

Reference

Service:: Service Map

API Version:: 2015-11-01-preview

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

With optional parameters:

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	V	Vyžadováno	Typ	Description
machineName	path	True	string	Název prostředku počítače.
resourceGroupName	path	True	string	Název skupiny prostředků v rámci zadaného 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é vás zajímají. 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í čas instance relativní k vyhodnocení prostředku počítače. Pokud není zadaný, služba použije DateTime.UtcNow.

Odpovědi

Name	Typ	Description
200 OK	Machine	Operace byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Při zpracování požadavku došlo k chybě. Konkrétní chybu najdete v parametru error.code.

Zabezpečení

azure_auth

Tok Azure Active Directory OAuth2

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

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

Sample Response

Status code:: 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"
}

Definice

Name	Description
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 zadání typu role cloudové služby Azure.
AzureHostingConfiguration	Poskytuje informace o hostovaném počítači v Azure.
AzureServiceFabricClusterConfiguration	Popisuje cluster Azure Service Fabric.
AzureVmScaleSetConfiguration	Popisuje škálovací sadu virtuálních počítačů Azure.
Bitness	Určuje bitovou velikost 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 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. je na něm spuštěný závislý agent, nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového proudu z monitorovaných počítačů. S tím, jak se počítače mění, se předchozí verze prostředku počítače zachovají a jsou k dispozici 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 pokud agent závislostí spuštěný na jiných počítačích nahlásil 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 se prostředky monitorují nebo zjistí.
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 počítače související s virtualizací.
VirtualMachineType	Určuje typ virtualizace počítače.

Accuracy

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

Name	Typ	Description
actual	string
estimated	string

AgentConfiguration

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

Name	Typ	Description
agentId	string	Jedinečný identifikátor agenta služby Health Service.
clockGranularity	integer	Členitost strojového času 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	MachineRebootStatus	Určuje, jestli byl počítač restartován od instalace závislého agenta.

AzureCloudServiceConfiguration

Popisuje cloudovou službu Azure.

Name	Typ	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	AzureCloudServiceRoleType	Slouží k zadání typu role cloudové služby Azure.

AzureCloudServiceRoleType

Slouží k zadání typu role cloudové služby Azure.

Name	Typ	Description
unknown	string
web	string
worker	string

AzureHostingConfiguration

Poskytuje informace o hostovaném počítači v Azure.

Name	Typ	Description
cloudService	AzureCloudServiceConfiguration	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	ImageConfiguration	Obrázek počítače
kind	string: provider:azure	Další kvalifikátor typu konfigurace hostování
location	string	Zeměpisná poloha 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	AzureServiceFabricClusterConfiguration	Obsahuje informace o počítačích, které patří clusteru 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	AzureVmScaleSetConfiguration	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	Typ	Description
clusterId	string	Identifikátor clusteru Service Fabric.
name	string	Název clusteru Service Fabric.

AzureVmScaleSetConfiguration

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

Name	Typ	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 velikost počítače nebo procesu.

Name	Typ	Description
32bit	string
64bit	string

Error

Podrobnosti o chybě.

Name	Typ	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	Typ	Description
error	Error	Informace o chybě.

HypervisorConfiguration

Popisuje konfiguraci hypervisoru počítače.

Name	Typ	Description
hypervisorType	HypervisorType	Určuje virtualizační technologii používanou hypervisorem (hyperv, vmware atd.).
nativeHostMachineId	string	Jedinečný identifikátor počítače hypervisoru nahlášený podkladovým virtualizačním systémem.

HypervisorType

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

Name	Typ	Description
hyperv	string
unknown	string

ImageConfiguration

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

Name	Typ	Description
offering	string	Nabídka image virtuálního počítače.
publisher	string	Vydavatel image virtuálního počítače.
sku	string	SKU image virtuálního počítače.
version	string	Verze image virtuálního počítače.

Ipv4NetworkInterface

Popisuje síťové rozhraní IPv4.

Name	Typ	Výchozí hodnota	Description
ipAddress	string		IPv4 adresa.
subnetMask	string	255.255.255.255	Maska podsítě IPv4.

Ipv6NetworkInterface

Popisuje síťové rozhraní IPv6.

Name	Typ	Description
ipAddress	string	IPv6 adresa.

Machine

Prostředek počítače představuje zjištěný počítačový systém. Může být monitorován, tj. je na něm spuštěný závislý agent, nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového proudu z monitorovaných počítačů. S tím, jak se počítače mění, se předchozí verze prostředku počítače zachovají a jsou k dispozici 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 pokud agent závislostí spuštěný na jiných počítačích nahlásil aktivitu přidruženou k počítači.

Name	Typ	Description
etag	string	Značka ETAG prostředku.
id	string	Identifikátor prostředku.
kind	string: machine	Další kvalifikátor typu prostředku.
name	string	Název prostředku.
properties.agent	AgentConfiguration	Konfigurace agenta závislostí.
properties.bootTime	string	Datum a čas (UTC) posledního spuštění počítače
properties.computerName	string	Název počítače, např. 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: AzureHostingConfiguration	Konfigurace související s hostování. Je k dispozici, pokud se pro virtuální počítač zjistí informace o hostování.
properties.hypervisor	HypervisorConfiguration	Konfigurace související s hypervisorem. K dispozici pouze v případech, kdy je `hypervisor`virtualizationState .
properties.monitoringState	MonitoringState	Určuje, jestli je počítač aktivně monitorovaný nebo zjištěný.
properties.networking	NetworkConfiguration	Konfigurace sítě (IP adresy, brány, dns atd.)
properties.operatingSystem	OperatingSystemConfiguration	Informace o operačním systému.
properties.resources	MachineResourcesConfiguration	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	Timezone	Časové pásmo počítače.
properties.virtualMachine	VirtualMachineConfiguration	Konfigurace související s virtualizací. K dispozici pouze tehdy, když `virtualizationState` je `virtual`.
properties.virtualizationState	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	Typ	Description
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Popisuje prostředky počítače.

Name	Typ	Description
cpuSpeed	integer	Rychlost procesoru v megahertzech (MHz).
cpuSpeedAccuracy	Accuracy	Popisuje přesnost pole cpuSpeed.
cpus	integer	Počet procesorů.
physicalMemory	integer	Fyzická paměť v megabajtech (MB).

MonitoringState

Slouží k určení, jestli se prostředky monitorují nebo zjistí.

Name	Typ	Description
discovered	string
monitored	string

NetworkConfiguration

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

Name	Typ	Description
defaultIpv4Gateways	string[]	Výchozí brány IPv4.
dnsNames	string[]	Názvy DNS přidružené k počítači.
ipv4Interfaces	Ipv4NetworkInterface[]	Rozhraní IPv4.
ipv6Interfaces	Ipv6NetworkInterface[]	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	Typ	Description
bitness	Bitness	Bitová verze operačního systému (32bitová nebo 64bitová verze).
family	OperatingSystemFamily	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	Typ	Description
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Popisuje časové pásmo.

Name	Typ	Description
fullName	string	Celé jméno timezone.

VirtualizationState

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

Name	Typ	Description
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

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

Name	Typ	Description
nativeHostMachineId	string	Jedinečný identifikátor hostitele tohoto virtuálního počítače nahlášený podkladovým virtualizačním systémem.
nativeMachineId	string	Jedinečný identifikátor virtuálního počítače nahlášený podkladovým virtualizačním systémem.
virtualMachineName	string	Název virtuálního počítače.
virtualMachineType	VirtualMachineType	Určuje virtualizační technologii používanou počítačem (hyperv, vmware atd.).

VirtualMachineType

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

Name	Typ	Description
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string