Machines - Get

Service:

Service Map

API Version:

2015-11-01-preview

Zwraca określoną maszynę.

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

Nazwa	W	Wymagane	Typ	Opis
machineName	path	True	string	Nazwa zasobu maszyny.
resourceGroupName	path	True	string	Nazwa grupy zasobów w określonym identyfikatorze subskrypcji. Regex pattern: [a-zA-Z0-9_-]+
subscriptionId	path	True	string	Identyfikator subskrypcji platformy Azure.
workspaceName	path	True	string	Obszar roboczy pakietu OMS zawierający interesujące zasoby. Regex pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]
api-version	query	True	string	Wersja interfejsu API.
timestamp	query		string date-time	Data i godzina UTC określająca wystąpienie godziny względem którego ma być obliczany zasób maszyny. Jeśli nie zostanie określona, usługa używa wartości DateTime.UtcNow.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Machine	Operacja została ukończona pomyślnie.
Other Status Codes	ErrorResponse	Wystąpił błąd podczas przetwarzania żądania. Zobacz parametr error.code, aby zidentyfikować określony błąd.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa	Opis
Accuracy	Określa dokładność obliczeń.
AgentConfiguration	Opisuje konfigurację agenta zależności zainstalowanego na maszynie.
AzureCloudServiceConfiguration	Opisuje usługę w chmurze platformy Azure
AzureCloudServiceRoleType	Służy do określania typu roli usługi w chmurze platformy Azure
AzureHostingConfiguration	Zawiera informacje o tym, jak maszyna jest hostowana na platformie Azure
AzureServiceFabricClusterConfiguration	Opisuje klaster usługi Azure Service Fabric
AzureVmScaleSetConfiguration	Opisuje zestaw skalowania maszyn wirtualnych platformy Azure
Bitness	Określa bitowość maszyny lub procesu.
Error	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd z interfejsu API.
HypervisorConfiguration	Opisuje konfigurację funkcji hypervisor maszyny.
HypervisorType	Określa typ funkcji hypervisor maszyny.
ImageConfiguration	Opisuje obraz maszyny wirtualnej maszyny.
Ipv4NetworkInterface	Opisuje interfejs sieciowy IPv4.
Ipv6NetworkInterface	Opisuje interfejs sieciowy IPv6.
Machine	Zasób maszyny reprezentuje odnaleziony system komputerowy. Można go monitorować, tj. agent zależności jest na nim uruchomiony lub odnaleziony, tj. jego istnienie zostało wywnioskowane przez obserwowanie strumienia danych z monitorowanych maszyn. W miarę zmiany maszyny wcześniejsze wersje zasobu maszyny są zachowywane i dostępne do uzyskania dostępu. Maszyna jest aktywna w przedziale czasu, jeśli jego agent zależności zgłosił dane w tym interwale (części) lub agent zależności działający na innych maszynach zgłosił aktywność skojarzoną z maszyną.
MachineRebootStatus	Określa, czy maszyna została ponownie uruchomiona od czasu instalacji agenta zależności.
MachineResourcesConfiguration	Opisuje zasoby maszyny.
MonitoringState	Służy do określania, czy zasoby są monitorowane lub odnalezione.
NetworkConfiguration	Opisuje konfigurację sieci maszyny.
OperatingSystemConfiguration	Opisuje konfigurację systemu operacyjnego maszyny.
OperatingSystemFamily	Określa rodzinę systemów operacyjnych, np. Linux, Windows itp.
Timezone	Opisuje strefę czasową.
VirtualizationState	Określa, czy maszyna jest fizyczna, wirtualna, hypervisor lub nieznana.
VirtualMachineConfiguration	Opisuje konfigurację związaną z wirtualizacją maszyny.
VirtualMachineType	Określa typ wirtualizacji maszyny.

Accuracy

Określa dokładność obliczeń.

Nazwa	Typ	Opis
actual	string
estimated	string

AgentConfiguration

Opisuje konfigurację agenta zależności zainstalowanego na maszynie.

Nazwa	Typ	Opis
agentId	string	Unikatowy identyfikator agenta usługi kondycji.
clockGranularity	integer	Stopień szczegółowości zegara maszynowego w milisekundach.
dependencyAgentId	string	Unikatowy identyfikator agenta zależności.
dependencyAgentRevision	string	Numer poprawki agenta zależności.
dependencyAgentVersion	string	Numer wersji agenta zależności.
rebootStatus	MachineRebootStatus	Określa, czy maszyna została ponownie uruchomiona od czasu instalacji agenta zależności.

AzureCloudServiceConfiguration

Opisuje usługę w chmurze platformy Azure

Nazwa	Typ	Opis
deployment	string	Identyfikator wdrożenia usługi w chmurze
instanceId	string	Identyfikator wystąpienia usługi w chmurze
name	string	Nazwa usługi w chmurze
roleName	string	Nazwa roli usługi w chmurze
roleType	AzureCloudServiceRoleType	Służy do określania typu roli usługi w chmurze platformy Azure

AzureCloudServiceRoleType

Służy do określania typu roli usługi w chmurze platformy Azure

Nazwa	Typ	Opis
unknown	string
web	string
worker	string

AzureHostingConfiguration

Zawiera informacje o tym, jak maszyna jest hostowana na platformie Azure

Nazwa	Typ	Opis
cloudService	AzureCloudServiceConfiguration	Zawiera informacje o maszynach hostowanych jako usługa w chmurze platformy Azure
faultDomain	string	Domena błędów maszyny wirtualnej.
image	ImageConfiguration	Obraz maszyny.
kind	string: provider:azure	Dodatkowy kwalifikator typu konfiguracji hostingu.
location	string	Lokalizacja geograficzna maszyny wirtualnej.
name	string	Nazwa maszyny zgodnie z dostawcą hostingu.
provider	enum: azure	Dostawca hostingu maszyny wirtualnej.
resourceGroup	string	Nazwa grupy zasobów w ramach określonej subskrypcji.
resourceId	string	Unikatowy identyfikator zasobu.
serviceFabricCluster	AzureServiceFabricClusterConfiguration	Zawiera informacje o maszynach należących do klastra usługi Azure Service Fabric
size	string	Rozmiar maszyny wirtualnej.
subscriptionId	string	Identyfikator subskrypcji.
updateDomain	string	Zaktualizuj domenę maszyny wirtualnej.
vmId	string	Identyfikator maszyny wirtualnej (unikatowy identyfikator).
vmScaleSet	AzureVmScaleSetConfiguration	Zawiera informacje o maszynach hostowanych jako zestaw skalowania maszyn wirtualnych platformy Azure

AzureServiceFabricClusterConfiguration

Opisuje klaster usługi Azure Service Fabric

Nazwa	Typ	Opis
clusterId	string	Identyfikator klastra usługi Service Fabric.
name	string	Nazwa klastra usługi Service Fabric.

AzureVmScaleSetConfiguration

Opisuje zestaw skalowania maszyn wirtualnych platformy Azure

Nazwa	Typ	Opis
deployment	string	Identyfikator wdrożenia zestawu skalowania maszyn wirtualnych
instanceId	string	Identyfikator wystąpienia zestawu skalowania maszyn wirtualnych
name	string	Nazwa zestawu skalowania maszyn wirtualnych
resourceId	string	Unikatowy identyfikator zasobu.

Bitness

Określa bitowość maszyny lub procesu.

Nazwa	Typ	Opis
32bit	string
64bit	string

Error

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu identyfikujący określony błąd.
message	string	Komunikat o błędzie w ustawieniach regionalnych wywołującego.

ErrorResponse

Odpowiedź na błąd z interfejsu API.

Nazwa	Typ	Opis
error	Error	Informacje o błędzie.

HypervisorConfiguration

Opisuje konfigurację funkcji hypervisor maszyny.

Nazwa	Typ	Opis
hypervisorType	HypervisorType	Określa technologię wirtualizacji używaną przez funkcję hypervisor (hyperv, vmware itp.)
nativeHostMachineId	string	Unikatowy identyfikator maszyny hypervisor zgłoszonej przez bazowy system wirtualizacji.

HypervisorType

Określa typ funkcji hypervisor maszyny.

Nazwa	Typ	Opis
hyperv	string
unknown	string

ImageConfiguration

Opisuje obraz maszyny wirtualnej maszyny.

Nazwa	Typ	Opis
offering	string	Oferta obrazu maszyny wirtualnej.
publisher	string	Wydawca obrazu maszyny wirtualnej.
sku	string	Jednostka SKU obrazu maszyny wirtualnej.
version	string	Wersja obrazu maszyny wirtualnej.

Ipv4NetworkInterface

Opisuje interfejs sieciowy IPv4.

Nazwa	Typ	Wartość domyślna	Opis
ipAddress	string		Adres IPv4.
subnetMask	string	255.255.255.255	Maska podsieci IPv4.

Ipv6NetworkInterface

Opisuje interfejs sieciowy IPv6.

Nazwa	Typ	Opis
ipAddress	string	Adres IPv6.

Machine

Zasób maszyny reprezentuje odnaleziony system komputerowy. Można go monitorować, tj. agent zależności jest na nim uruchomiony lub odnaleziony, tj. jego istnienie zostało wywnioskowane przez obserwowanie strumienia danych z monitorowanych maszyn. W miarę zmiany maszyny wcześniejsze wersje zasobu maszyny są zachowywane i dostępne do uzyskania dostępu. Maszyna jest aktywna w przedziale czasu, jeśli jego agent zależności zgłosił dane w tym interwale (części) lub agent zależności działający na innych maszynach zgłosił aktywność skojarzoną z maszyną.

Nazwa	Typ	Opis
etag	string	Zasób ETAG.
id	string	Identyfikator zasobu.
kind	string: machine	Dodatkowy kwalifikator typu zasobu.
name	string	Nazwa zasobu.
properties.agent	AgentConfiguration	Konfiguracja agenta zależności.
properties.bootTime	string	Data i godzina UTC ostatniego rozruchu maszyny
properties.computerName	string	Nazwa maszyny, np. serwer
properties.displayName	string	Nazwa do użycia do celów wyświetlania
properties.fullyQualifiedDomainName	string	W pełni kwalifikowana nazwa maszyny, np. server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Konfiguracja związana z hostingem. Jeśli informacje o hostingu zostaną odnalezione dla maszyny wirtualnej.
properties.hypervisor	HypervisorConfiguration	Konfiguracja związana z funkcją Hypervisor. Występuje tylko wtedy, gdy parametr "virtualizationState" to hypervisor.
properties.monitoringState	MonitoringState	Określa, czy maszyna jest aktywnie monitorowana, czy odnaleziona.
properties.networking	NetworkConfiguration	Konfiguracja sieci (adresy IP, bramy, dns itp.)
properties.operatingSystem	OperatingSystemConfiguration	Informacje o systemie operacyjnym.
properties.resources	MachineResourcesConfiguration	Zasoby maszyny (pamięć, procesor itp.).
properties.timestamp	string	Data i godzina UTC aktualizacji tego zasobu w systemie.
properties.timezone	Timezone	Strefa czasowa maszyny.
properties.virtualMachine	VirtualMachineConfiguration	Konfiguracja związana z wirtualizacją. Prezentuj tylko wtedy, gdy virtualizationState ma wartość virtual.
properties.virtualizationState	VirtualizationState	Określa, czy maszyna jest zwirtualizowana.
type	string	Typ zasobu.

MachineRebootStatus

Określa, czy maszyna została ponownie uruchomiona od czasu instalacji agenta zależności.

Nazwa	Typ	Opis
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Opisuje zasoby maszyny.

Nazwa	Typ	Opis
cpuSpeed	integer	Szybkość procesora CPU w megahertz (Mhz).
cpuSpeedAccuracy	Accuracy	Opisuje dokładność pola cpuSpeed.
cpus	integer	Liczba procesorów CPU.
physicalMemory	integer	Pamięć fizyczna w megabajtach (MB).

MonitoringState

Służy do określania, czy zasoby są monitorowane lub odnalezione.

Nazwa	Typ	Opis
discovered	string
monitored	string

NetworkConfiguration

Opisuje konfigurację sieci maszyny.

Nazwa	Typ	Opis
defaultIpv4Gateways	string[]	Domyślne bramy IPv4.
dnsNames	string[]	Nazwy DNS skojarzone z maszyną.
ipv4Interfaces	Ipv4NetworkInterface[]	Interfejsy IPv4.
ipv6Interfaces	Ipv6NetworkInterface[]	Interfejsy IPv6.
macAddresses	string[]	Adresy MAC wszystkich aktywnych interfejsów sieciowych.

OperatingSystemConfiguration

Opisuje konfigurację systemu operacyjnego maszyny.

Nazwa	Typ	Opis
bitness	Bitness	Bitowość systemu operacyjnego (32-bitowa lub 64-bitowa).
family	OperatingSystemFamily	Windows, Linux itp.
fullName	string	Pełna nazwa systemu operacyjnego.

OperatingSystemFamily

Określa rodzinę systemów operacyjnych, np. Linux, Windows itp.

Nazwa	Typ	Opis
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Opisuje strefę czasową.

Nazwa	Typ	Opis
fullName	string	Pełna nazwa strefy czasowej.

VirtualizationState

Określa, czy maszyna jest fizyczna, wirtualna, hypervisor lub nieznana.

Nazwa	Typ	Opis
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

Opisuje konfigurację związaną z wirtualizacją maszyny.

Nazwa	Typ	Opis
nativeHostMachineId	string	Unikatowy identyfikator hosta tej maszyny wirtualnej zgłoszony przez bazowy system wirtualizacji.
nativeMachineId	string	Unikatowy identyfikator maszyny wirtualnej zgłoszony przez bazowy system wirtualizacji.
virtualMachineName	string	Nazwa maszyny wirtualnej.
virtualMachineType	VirtualMachineType	Określa technologię wirtualizacji używaną przez maszynę (hyperv, vmware itp.)

VirtualMachineType

Określa typ wirtualizacji maszyny.

Nazwa	Typ	Opis
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string