Machines - Get

Služba:: Service Map

Verze rozhraní API:: 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

S volitelnými parametry:

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 minLength: 3 maxLength: 64	Název prostředku počítače.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Název skupiny prostředků v zadaném ID předplatného
subscriptionId	path	True	string	Identifikátor předplatného Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Pracovní prostor OMS obsahující prostředky, které jsou zajímavé.
api-version	query	True	string	Verze rozhraní API.
timestamp	query		string (date-time)	Datum a čas UTC určující instanci času vzhledem k tomu, ke které se má prostředek počítače vyhodnotit. Pokud není zadáno, služba používá 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 identifikujte pomocí parametru error.code.

Zabezpečení

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

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

Příklady

SMMachinesGetGet

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:: 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 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	Odpověď na chybu 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 se monitorovat, tj. agent závislostí na něm běží nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového proudu 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 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 počítače související s virtualizací.
VirtualMachineType	Určuje typ virtualizace počítače.

Accuracy

Výčet

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

Hodnota	Description
actual
estimated

AgentConfiguration

Objekt

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 (int32)	Č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	MachineRebootStatus	Určuje, jestli se počítač od instalace závislého agenta restartoval.

AzureCloudServiceConfiguration

Objekt

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 určení typu role cloudové služby Azure.

AzureCloudServiceRoleType

Výčet

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

Hodnota	Description
unknown
worker
web

AzureHostingConfiguration

Objekt

Poskytuje informace o tom, jak je počítač hostovaný 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é 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	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

Objekt

Popisuje cluster Azure Service Fabric.

Name	Typ	Description
clusterId	string	Identifikátor clusteru Service Fabric.
name	string	Název clusteru Service Fabric

AzureVmScaleSetConfiguration

Objekt

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

Výčet

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

Hodnota	Description
32bit
64bit

Error

Objekt

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

Objekt

Odpověď na chybu z rozhraní API

Name	Typ	Description
error	Error	Informace o chybě

HypervisorConfiguration

Objekt

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, jak hlásí základní virtualizační systém.

HypervisorType

Výčet

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

Hodnota	Description
unknown
hyperv

ImageConfiguration

Objekt

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	Skladová položka image virtuálního počítače
version	string	Verze image virtuálního počítače

Ipv4NetworkInterface

Objekt

Popisuje síťové rozhraní IPv4.

Name	Typ	Default value	Description
ipAddress	string		Adresa IPv4.
subnetMask	string	255.255.255.255	Maska podsítě IPv4

Ipv6NetworkInterface

Objekt

Popisuje síťové rozhraní IPv6.

Name	Typ	Description
ipAddress	string	Adresa IPv6.

Machine

Objekt

Prostředek počítače představuje zjištěný počítačový systém. Může se monitorovat, tj. agent závislostí na něm běží nebo zjištěn, tj. jeho existence byla odvozena pozorováním datového proudu 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 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	Typ	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	AgentConfiguration	Konfigurace závislého agenta.
properties.bootTime	string (date-time)	Datum a čas UTC při posledním 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ím Je k dispozici, pokud jsou pro virtuální počítač zjištěny informace o hostování.
properties.hypervisor	HypervisorConfiguration	Konfigurace související s hypervisorem K dispozici pouze v případech, kdy je virtualizační stav `hypervisor`.
properties.monitoringState	MonitoringState	Určuje, jestli je počítač aktivně monitorovaný nebo zjištěný.
properties.networking	NetworkConfiguration	Konfigurace sítě (ips, 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 (date-time)	Datum a čas UTC, kdy byl tento prostředek v systému aktualizován.
properties.timezone	Timezone	Časové pásmo stroje.
properties.virtualMachine	VirtualMachineConfiguration	Konfigurace související s virtualizací Prezentovat pouze v `virtualizationState` je `virtual`.
properties.virtualizationState	VirtualizationState	Určuje, jestli je počítač virtualizovaný.
type	string	Typ zdroje.

MachineRebootStatus

Výčet

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

Hodnota	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Objekt

Popisuje prostředky počítače.

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

MonitoringState

Výčet

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

Hodnota	Description
monitored
discovered

NetworkConfiguration

Objekt

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

Objekt

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

Výčet

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

Hodnota	Description
unknown
windows
linux
solaris
aix

Timezone

Objekt

Popisuje časové pásmo.

Name	Typ	Description
fullName	string	Celé jméno časového pásma.

VirtualizationState

Výčet

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

Hodnota	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Objekt

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, jak hlásí základní virtualizační systém.
nativeMachineId	string	Jedinečný identifikátor virtuálního počítače hlášený základní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

Výčet

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

Hodnota	Description
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen

Sdílet prostřednictvím

Machines - Get

Parametry identifikátoru URI

Odpovědi

Zabezpečení

azure_auth

Rozsahy

Příklady

SMMachinesGetGet

Ukázkový požadavek

Ukázková odpověď

Definice

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