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

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 oms zawierający zasoby zainteresowania.

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

api-version
query True
  • string

wersji interfejsu API.

timestamp
query
  • string
date-time

Data i godzina UTC określająca wystąpienie czasu względem którego ma być oceniana zasób komputera. Gdy nie określono, usługa używa 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ć określony błąd.

Zabezpieczenia

azure_auth

Przepływ usługi Azure Active Directory OAuth2

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

Scopes

Name Description
user_impersonation podszywanie się pod konto 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 komputerze.

AzureCloudServiceConfiguration

W tym artykule opisano usługę chmury Azure

AzureCloudServiceRoleType

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

AzureHostingConfiguration

Zawiera informacje o sposobie hosta komputera na platformie Azure

AzureServiceFabricClusterConfiguration

W tym artykule opisano klaster sieci szkieletowej usług Azure

AzureVmScaleSetConfiguration

W tym artykule opisano zestaw skalowania maszyny wirtualnej platformy Azure

Bitness

Określa bityść maszyny lub procesu.

Error

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd z interfejsu API.

HypervisorConfiguration

Opisuje konfigurację funkcji hypervisor komputera.

HypervisorType

Określa typ funkcji hypervisor komputera.

ImageConfiguration

Opisuje obraz maszyny Wirtualnej komputera.

Ipv4NetworkInterface

W tym artykule opisano interfejs sieciowy IPv4.

Ipv6NetworkInterface

W tym artykule opisano interfejs sieciowy IPv6.

Machine

Zasób komputera reprezentuje odnaleziony system komputerowy. Można go monitorować, czyli agent zależności działa na nim, lub odkryto, to znaczy, jego istnienie zostało wywnioskowane przez obserwowanie strumienia danych z monitorowanych maszyn. W miarę zmiany maszyn wcześniejsze wersje zasobu maszyny są zachowywane i dostępne dla dostępu. Komputer jest na żywo w przedziale czasu, jeśli jego agent zależności zgłosił dane podczas (części) tego interwału lub agent zależności uruchomiony na innych komputerach zgłosił aktywność skojarzoną z komputerem.

MachineRebootStatus

Określa, czy komputer został ponownie uruchomiony od czasu instalacji agenta zależności.

MachineResourcesConfiguration

Opisuje zasoby komputera.

MonitoringState

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

NetworkConfiguration

Opisuje konfigurację sieciową komputera.

OperatingSystemConfiguration

Opisuje konfigurację systemu operacyjnego komputera.

OperatingSystemFamily

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

Timezone

Opisuje strefę czasową.

VirtualizationState

Określa, czy maszyna jest fizyczna, wirtualna, hipernadzorcy lub nieznany.

VirtualMachineConfiguration

Zawiera opis konfiguracji maszyny związanej z wirtualizacji.

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

Name Type Description
agentId
  • string

Unikatowy identyfikator agenta usługi kondycji.

clockGranularity
  • integer

Ziarnistość 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 komputer został ponownie uruchomiony od czasu instalacji agenta zależności.

AzureCloudServiceConfiguration

W tym artykule opisano usługę chmury 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 azure

AzureCloudServiceRoleType

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

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

AzureHostingConfiguration

Zawiera informacje o sposobie hosta komputera na platformie Azure

Name Type Description
cloudService

Zawiera informacje o komputerach hostowanych jako usługa w chmurze Azure

faultDomain
  • string

Domena błędów maszyny Wirtualnej.

image

Obraz urządzenia.

kind string:
  • provider:azure

Dodatkowe kwalifikatory typu konfiguracji hostingu.

location
  • string

Położenie geograficzne maszyny Wirtualnej.

name
  • string

Nazwa komputera 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 komputerach należących do klastra sieci szkieletowej usług Azure

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 komputerach hostowanych jako zestaw skalowania maszyny wirtualnej platformy Azure

AzureServiceFabricClusterConfiguration

W tym artykule opisano klaster sieci szkieletowej usług Azure

Name Type Description
clusterId
  • string

Identyfikator klastra sieci szkieletowej usług.

name
  • string

Nazwa klastra sieci szkieletowej usług.

AzureVmScaleSetConfiguration

W tym artykule opisano zestaw skalowania maszyny wirtualnej platformy Azure

Name Type Description
deployment
  • string

Identyfikator wdrożenia zestawu skalowania maszyny wirtualnej

instanceId
  • string

Identyfikator wystąpienia zestawu skalowania maszyny wirtualnej

name
  • string

Nazwa zestawu skalowania maszyny wirtualnej

resourceId
  • string

Unikatowy identyfikator zasobu.

Bitness

Określa bityść 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 komputera.

Name Type Description
hypervisorType

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

nativeHostMachineId
  • string

Unikatowy identyfikator maszyny hypervisor zgłaszane przez podstawowy system wirtualizacji.

HypervisorType

Określa typ funkcji hypervisor komputera.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Opisuje obraz maszyny Wirtualnej komputera.

Name Type Description
offering
  • string

Oferowanie obrazu maszyny Wirtualnej.

publisher
  • string

Wydawca obrazu maszyny Wirtualnej.

sku
  • string

Jednostka SKU obrazu maszyny Wirtualnej.

version
  • string

Wersja obrazu maszyny Wirtualnej.

Ipv4NetworkInterface

W tym artykule opisano interfejs sieciowy IPv4.

Name Type Description
ipAddress
  • string

Adres IPv4.

subnetMask
  • string

Maska podsieci IPv4.

Ipv6NetworkInterface

W tym artykule opisano interfejs sieciowy IPv6.

Name Type Description
ipAddress
  • string

Adres IPv6.

Machine

Zasób komputera reprezentuje odnaleziony system komputerowy. Można go monitorować, czyli agent zależności działa na nim, lub odkryto, to znaczy, jego istnienie zostało wywnioskowane przez obserwowanie strumienia danych z monitorowanych maszyn. W miarę zmiany maszyn wcześniejsze wersje zasobu maszyny są zachowywane i dostępne dla dostępu. Komputer jest na żywo w przedziale czasu, jeśli jego agent zależności zgłosił dane podczas (części) tego interwału lub agent zależności uruchomiony na innych komputerach zgłosił aktywność skojarzoną z komputerem.

Name Type Description
etag
  • string

ETAG zasobu.

id
  • string

Identyfikator zasobu.

kind string:
  • machine

Dodatkowe kwalifikator typu zasobu.

name
  • string

Nazwa zasobu.

properties.agent

Konfiguracja agenta zależności.

properties.bootTime
  • string

Data i godzina UTC podczas ostatniego rozruchu maszyny

properties.computerName
  • string

Nazwa urządzenia, np.

properties.displayName
  • string

Nazwa do użycia do celów wyświetlania

properties.fullyQualifiedDomainName
  • string

W pełni kwalifikowana nazwa urządzenia, np server.company.com.

properties.hosting HostingConfiguration:

Konfiguracja związana z hostingiem. Obecny, jeśli informacje o hostingu zostanie wykryty dla maszyny Wirtualnej.

properties.hypervisor

Konfiguracja związana z hipernadzorcą. Obecny tylko wtedy, gdy hypervisor"virtualizationState" jest .

properties.monitoringState

Określa, czy urządzenie jest aktywnie monitorowane, czy odnalezione.

properties.networking

Konfiguracja sieci (ips, bramy, dns, itp.)

properties.operatingSystem

Informacje o systemie operacyjnym.

properties.resources

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

properties.timestamp
  • string

Data i godzina UTC, kiedy ten zasób został zaktualizowany w systemie.

properties.timezone

Strefa czasowa maszyny.

properties.virtualMachine

Konfiguracja związana z wirtualizacją. Obecny tylko virtualizationState virtualwtedy, gdy jest .

properties.virtualizationState

Określa, czy maszyna jest zwirtualizowana.

type
  • string

Typ zasobu.

MachineRebootStatus

Określa, czy komputer został ponownie uruchomiony od czasu instalacji agenta zależności.

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

MachineResourcesConfiguration

Opisuje zasoby komputera.

Name Type Description
cpuSpeed
  • integer

Prędkość procesora w megahercach (Mhz).

cpuSpeedAccuracy

Opisuje dokładność pola cpuSpeed.

cpus
  • integer

Liczba procesorów.

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ę sieciową komputera.

Name Type Description
defaultIpv4Gateways
  • string[]

Domyślne bramy IPv4.

dnsNames
  • string[]

Nazwy DNS skojarzone z urządzeniem.

ipv4Interfaces

interfejsów IPv4.

ipv6Interfaces

interfejsów IPv6.

macAddresses
  • string[]

adresy MAC wszystkich aktywnych interfejsów sieciowych.

OperatingSystemConfiguration

Opisuje konfigurację systemu operacyjnego komputera.

Name Type Description
bitness

Bitysy systemu operacyjnego (32-bitowe lub 64-bitowe).

family

Windows, Linux itp.

fullName
  • string

Pełna nazwa systemu operacyjnego.

OperatingSystemFamily

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

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, hipernadzorcy lub nieznany.

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

VirtualMachineConfiguration

Zawiera opis konfiguracji maszyny związanej z wirtualizacji.

Name Type Description
nativeHostMachineId
  • string

Unikatowy identyfikator hosta tej maszyny wirtualnej zgłoszony przez podstawowy system wirtualizacji.

nativeMachineId
  • string

Unikatowy identyfikator maszyny wirtualnej zgłoszony przez podstawowy 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