Machines - Get

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

Name In Required Type Description
machineName
path True
  • string

Nazwa zasobu maszyny.

resourceGroupName
path True
  • string

Nazwa grupy zasobów w ramach określonego identyfikatora 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 wystąpienia, które ma być obliczane przez zasób maszyny. Jeśli nie zostanie określony, usługa używa elementu DateTime.UtcNow.

Odpowiedzi

Name Type Description
200 OK

Operacja została ukończona pomyślnie.

Other Status Codes

Wystąpił błąd podczas przetwarzania żądania. Zobacz parametr error.code, aby zidentyfikować konkretny błąd.

Zabezpieczenia

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 personifikacja konta użytkownika

Przykłady

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

Definicje

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

Opis klastra usługi Azure Service Fabric

AzureVmScaleSetConfiguration

Opis zestawu 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 ciągu (części) tego interwału lub agent zależności uruchomiony 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ń.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

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

Name Type Description
agentId
  • string

Usługa kondycji unikatowy identyfikator agenta.

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

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

AzureCloudServiceConfiguration

Opisuje usługę w chmurze platformy Azure

Name Type Description
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

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

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

AzureHostingConfiguration

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

Name Type Description
cloudService

Zawiera informacje o maszynach hostowanych jako usługa w chmurze platformy Azure

faultDomain
  • string

Domena błędów maszyny wirtualnej.

image

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

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

Zawiera informacje o maszynach hostowanych jako zestaw skalowania maszyn wirtualnych platformy Azure

AzureServiceFabricClusterConfiguration

Opis klastra usługi Azure Service Fabric

Name Type Description
clusterId
  • string

Service Fabric identyfikator klastra.

name
  • string

Service Fabric nazwę klastra.

AzureVmScaleSetConfiguration

Opis zestawu skalowania maszyn wirtualnych platformy Azure

Name Type Description
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.

Name Type Description
32bit
  • string
64bit
  • string

Error

Szczegóły błędu.

Name Type Description
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.

Name Type Description
error

Informacje o błędzie.

HypervisorConfiguration

Opisuje konfigurację funkcji hypervisor maszyny.

Name Type Description
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.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Opisuje obraz maszyny wirtualnej maszyny.

Name Type Description
offering
  • string

Oferta obrazu maszyny wirtualnej.

publisher
  • string

Publisher obrazu maszyny wirtualnej.

sku
  • string

Jednostka SKU obrazu maszyny wirtualnej.

version
  • string

Wersja obrazu maszyny wirtualnej.

Ipv4NetworkInterface

Opisuje interfejs sieciowy IPv4.

Name Type Default Value Description
ipAddress
  • string

Adres IPv4.

subnetMask
  • string
255.255.255.255

Maska podsieci IPv4.

Ipv6NetworkInterface

Opisuje interfejs sieciowy IPv6.

Name Type Description
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 ciągu (części) tego interwału lub agent zależności uruchomiony na innych maszynach zgłosił aktywność skojarzoną z maszyną.

Name Type Description
etag
  • string

Zasób ETAG.

id
  • string

Identyfikator zasobu.

kind string:
  • machine

Dodatkowy kwalifikator typu zasobu.

name
  • string

Nazwa zasobu.

properties.agent

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:

Konfiguracja związana z hostingem. Jeśli informacje o hostingu zostaną odnalezione dla maszyny wirtualnej.

properties.hypervisor

Konfiguracja związana z funkcją Hypervisor. Występuje tylko wtedy, gdy parametr "virtualizationState" to hypervisor.

properties.monitoringState

Określa, czy maszyna jest aktywnie monitorowana, czy odnaleziona.

properties.networking

Konfiguracja sieci (adresy IP, bramy, dns itp.)

properties.operatingSystem

Informacje o systemie operacyjnym.

properties.resources

Zasoby maszyny (pamięć, procesor itp.).

properties.timestamp
  • string

Data i godzina UTC aktualizacji tego zasobu w systemie.

properties.timezone

Strefa czasowa maszyny.

properties.virtualMachine

Konfiguracja związana z wirtualizacją. Prezentuj tylko wtedy, gdy virtualizationState ma wartość virtual.

properties.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.

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

MachineResourcesConfiguration

Opisuje zasoby maszyny.

Name Type Description
cpuSpeed
  • integer

Szybkość procesora CPU w megahertz (Mhz).

cpuSpeedAccuracy

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.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Opisuje konfigurację sieci maszyny.

Name Type Description
defaultIpv4Gateways
  • string[]

Domyślne bramy IPv4.

dnsNames
  • string[]

Nazwy DNS skojarzone z maszyną.

ipv4Interfaces

Interfejsy IPv4.

ipv6Interfaces

Interfejsy IPv6.

macAddresses
  • string[]

Adresy MAC wszystkich aktywnych interfejsów sieciowych.

OperatingSystemConfiguration

Opisuje konfigurację systemu operacyjnego maszyny.

Name Type Description
bitness

Bitowość systemu operacyjnego (32-bitowa lub 64-bitowa).

family

Windows, Linux itp.

fullName
  • string

Pełna nazwa systemu operacyjnego.

OperatingSystemFamily

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

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

Timezone

Opisuje strefę czasową.

Name Type Description
fullName
  • string

Pełna nazwa strefy czasowej.

VirtualizationState

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

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

VirtualMachineConfiguration

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

Name Type Description
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

Określa technologię wirtualizacji używaną przez maszynę (hyperv, vmware itp.)

VirtualMachineType

Określa typ wirtualizacji maszyny.

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