Machines - Get

Returnerar den angivna datorn.

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}

URI-parametrar

Name In Required Type Description
machineName
path True
  • string

Datorresursnamn.

resourceGroupName
path True
  • string

Resursgruppsnamn inom angivet subscriptionId.

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

subscriptionId
path True
  • string

Azure-prenumerationsidentifierare.

workspaceName
path True
  • string

OMS-arbetsyta som innehåller resurser av intresse.

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

api-version
query True
  • string

API-version.

timestamp
query
  • string
date-time

UTC-datum och tid som anger en tidsinstans i förhållande till vilken datorresursen ska utvärderas. När tjänsten inte har angetts använder den DateTime.UtcNow.

Svar

Name Type Description
200 OK

Åtgärden slutfördes.

Other Status Codes

Ett fel uppstod när begäran bearbetades. Se parametern error.code för att identifiera det specifika felet.

Säkerhet

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 personifiera ditt användarkonto

Exempel

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

Definitioner

Accuracy

Anger noggrannheten för en beräkning.

AgentConfiguration

Beskriver konfigurationen av beroendeagenten som är installerad på en dator.

AzureCloudServiceConfiguration

Beskriver en Azure-molntjänst

AzureCloudServiceRoleType

Används för att ange typ av en Azure Cloud Service-roll

AzureHostingConfiguration

Innehåller information om hur en dator finns i Azure

AzureServiceFabricClusterConfiguration

Beskriver ett Azure Service Fabric-kluster

AzureVmScaleSetConfiguration

Beskriver en Skalningsuppsättning för virtuella Azure-datorer

Bitness

Anger bitness för en dator eller process.

Error

Felinformation.

ErrorResponse

Ett felsvar från API:et.

HypervisorConfiguration

Beskriver hypervisor-konfigurationen för en dator.

HypervisorType

Anger hypervisor-typen för en dator.

ImageConfiguration

Beskriver VM-avbildningen av en dator.

Ipv4NetworkInterface

Beskriver ett IPv4-nätverksgränssnitt.

Ipv6NetworkInterface

Beskriver ett IPv6-nätverksgränssnitt.

Machine

En datorresurs representerar ett identifierat datorsystem. Den kan övervakas, d.v.s. att en beroendeagent körs på den, eller identifieras, d.v.s. att dess existens härleddes genom att dataströmmen observerades från övervakade datorer. När datorerna ändras bevaras tidigare versioner av datorresursen och är tillgängliga för åtkomst. En dator är aktiv under ett tidsintervall, om beroendeagenten har rapporterat data under (delar) av det intervallet, eller om en beroendeagent som körs på andra datorer har rapporterat aktivitet som är associerad med datorn.

MachineRebootStatus

Anger om datorn har startats om sedan beroendeagenten installeras.

MachineResourcesConfiguration

Beskriver en dators resurser.

MonitoringState

Används för att ange om en resurs övervakas eller identifieras.

NetworkConfiguration

Beskriver nätverkskonfigurationen för en dator.

OperatingSystemConfiguration

Beskriver konfigurationen av operativsystemet på en dator.

OperatingSystemFamily

Anger operativsystemfamiljen, t.ex. Linux, Windows osv.

Timezone

Beskriver en tidszon.

VirtualizationState

Anger om datorn är fysisk, virtuell, hypervisor eller okänd.

VirtualMachineConfiguration

Beskriver den virtualiseringsrelaterade konfigurationen för en dator.

VirtualMachineType

Anger virtualiseringstypen för en dator.

Accuracy

Anger noggrannheten för en beräkning.

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

Beskriver konfigurationen av beroendeagenten som är installerad på en dator.

Name Type Description
agentId
  • string

Hälsotjänst Unikt ID för agent.

clockGranularity
  • integer

Maskinklockans kornighet i millisekunder.

dependencyAgentId
  • string

Unik identifierare för beroendeagent.

dependencyAgentRevision
  • string

Revisionsnummer för beroendeagenten.

dependencyAgentVersion
  • string

Versionsnummer för beroendeagenten.

rebootStatus

Anger om datorn har startats om sedan dependency agent-installationen.

AzureCloudServiceConfiguration

Beskriver en Azure-molntjänst

Name Type Description
deployment
  • string

Molntjänstdistributionsidentifierare

instanceId
  • string

Cloud Service-instansidentifierare

name
  • string

Molntjänstnamn

roleName
  • string

Namn på molntjänstroll

roleType

Används för att ange typ av en Azure Cloud Service-roll

AzureCloudServiceRoleType

Används för att ange typ av en Azure Cloud Service-roll

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

AzureHostingConfiguration

Innehåller information om hur en dator finns i Azure

Name Type Description
cloudService

Innehåller information om datorer som hanteras som en Azure-molntjänst

faultDomain
  • string

Den virtuella datorns feldomän.

image

Bild av datorn.

kind string:
  • provider:azure

Ytterligare värdkonfigurationstypskvalificerare.

location
  • string

Den virtuella datorns geografiska plats.

name
  • string

Datornamn enligt värdleverantören.

provider enum:
  • azure

Värdprovidern för den virtuella datorn.

resourceGroup
  • string

Resursgruppens namn i den angivna prenumerationen.

resourceId
  • string

Unik identifierare för resursen.

serviceFabricCluster

Innehåller information om datorer som tillhör ett Azure Service Fabric-kluster

size
  • string

Storleken på den virtuella datorn.

subscriptionId
  • string

Prenumerations-ID.

updateDomain
  • string

Uppdatera domänen för den virtuella datorn.

vmId
  • string

ID för virtuell dator (unik identifierare).

vmScaleSet

Innehåller information om datorer som hanteras som en Skalningsuppsättning för virtuella Azure-datorer

AzureServiceFabricClusterConfiguration

Beskriver ett Azure Service Fabric-kluster

Name Type Description
clusterId
  • string

Service Fabric klusteridentifierare.

name
  • string

Service Fabric klusternamn.

AzureVmScaleSetConfiguration

Beskriver en Skalningsuppsättning för virtuella Azure-datorer

Name Type Description
deployment
  • string

Distributionsidentifierare för vm-skalningsuppsättning

instanceId
  • string

Instansidentifierare för vm-skalningsuppsättning

name
  • string

Namn på vm-skalningsuppsättning

resourceId
  • string

Unik identifierare för resursen.

Bitness

Anger bitness för en dator eller process.

Name Type Description
32bit
  • string
64bit
  • string

Error

Felinformation.

Name Type Description
code
  • string

Felkod som identifierar det specifika felet.

message
  • string

Felmeddelande i anroparens nationella inställningar.

ErrorResponse

Ett felsvar från API:et.

Name Type Description
error

Felinformation.

HypervisorConfiguration

Beskriver hypervisor-konfigurationen för en dator.

Name Type Description
hypervisorType

Anger den virtualiseringsteknik som används av hypervisor-programmet (hyperv, vmware osv.)

nativeHostMachineId
  • string

Den unika identifieraren för hypervisor-datorn som rapporteras av det underliggande virtualiseringssystemet.

HypervisorType

Anger hypervisor-typen för en dator.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

Beskriver VM-avbildningen av en dator.

Name Type Description
offering
  • string

Erbjudande för VM-avbildningen.

publisher
  • string

Publisher av VM-avbildningen.

sku
  • string

SKU för VM-avbildningen.

version
  • string

Version av VM-avbildningen.

Ipv4NetworkInterface

Beskriver ett IPv4-nätverksgränssnitt.

Name Type Default Value Description
ipAddress
  • string

IPv4-adress.

subnetMask
  • string
255.255.255.255

IPv4-nätmask.

Ipv6NetworkInterface

Beskriver ett IPv6-nätverksgränssnitt.

Name Type Description
ipAddress
  • string

IPv6-adress.

Machine

En datorresurs representerar ett identifierat datorsystem. Den kan övervakas, d.v.s. att en beroendeagent körs på den, eller identifieras, d.v.s. att dess existens härleddes genom att dataströmmen observerades från övervakade datorer. När datorerna ändras bevaras tidigare versioner av datorresursen och är tillgängliga för åtkomst. En dator är aktiv under ett tidsintervall, om beroendeagenten har rapporterat data under (delar) av det intervallet, eller om en beroendeagent som körs på andra datorer har rapporterat aktivitet som är associerad med datorn.

Name Type Description
etag
  • string

Resurs-ETAG.

id
  • string

Resursidentifierare.

kind string:
  • machine

Ytterligare resurstypskvalificerare.

name
  • string

Resursnamn.

properties.agent

Konfiguration av beroendeagent.

properties.bootTime
  • string

UTC-datum och tid när datorn senast startades

properties.computerName
  • string

Datorns namn, t.ex. server

properties.displayName
  • string

Namn som ska användas i visningssyfte

properties.fullyQualifiedDomainName
  • string

Fullständigt kvalificerat namn på datorn, t.ex. server.company.com

properties.hosting HostingConfiguration:

Värdrelaterad konfiguration. Presentera om värdinformation identifieras för den virtuella datorn.

properties.hypervisor

Hypervisor-relaterad konfiguration. Presentera endast när "virtualizationState" är hypervisor.

properties.monitoringState

Anger om datorn övervakas eller identifieras aktivt.

properties.networking

Nätverkskonfiguration (ip-adresser, gatewayer, dns osv.)

properties.operatingSystem

Information om operativsystemet.

properties.resources

Datorresurser (minne, cpu osv.).

properties.timestamp
  • string

UTC-datum och tid då den här resursen uppdaterades i systemet.

properties.timezone

Datorns tidszon.

properties.virtualMachine

Virtualiseringsrelaterad konfiguration. Presentera endast när virtualizationState är virtual.

properties.virtualizationState

Anger om datorn är virtualiserad.

type
  • string

Resurstyp.

MachineRebootStatus

Anger om datorn har startats om sedan beroendeagenten installeras.

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

MachineResourcesConfiguration

Beskriver en dators resurser.

Name Type Description
cpuSpeed
  • integer

CPU-hastighet i megahertz (Mhz).

cpuSpeedAccuracy

Beskriver noggrannheten i fältet cpuSpeed.

cpus
  • integer

Antal processorer.

physicalMemory
  • integer

Fysiskt minne i MEGABYTE (MB).

MonitoringState

Används för att ange om en resurs övervakas eller identifieras.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

Beskriver nätverkskonfigurationen för en dator.

Name Type Description
defaultIpv4Gateways
  • string[]

Standard-IPv4-gatewayer.

dnsNames
  • string[]

DNS-namn som är associerade med datorn.

ipv4Interfaces

IPv4-gränssnitt.

ipv6Interfaces

IPv6-gränssnitt.

macAddresses
  • string[]

MAC-adresser för alla aktiva nätverksgränssnitt.

OperatingSystemConfiguration

Beskriver konfigurationen av operativsystemet på en dator.

Name Type Description
bitness

Operativsystemets bit (32-bitars eller 64-bitars).

family

Windows, Linux osv.

fullName
  • string

Fullständigt namn på operativsystemet.

OperatingSystemFamily

Anger operativsystemfamiljen, t.ex. Linux, Windows osv.

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

Timezone

Beskriver en tidszon.

Name Type Description
fullName
  • string

Fullständigt namn på tidszon.

VirtualizationState

Anger om datorn är fysisk, virtuell, hypervisor eller okänd.

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

VirtualMachineConfiguration

Beskriver den virtualiseringsrelaterade konfigurationen för en dator.

Name Type Description
nativeHostMachineId
  • string

Den unika identifieraren för värden för den här virtuella datorn som rapporteras av det underliggande virtualiseringssystemet.

nativeMachineId
  • string

Den unika identifieraren för den virtuella datorn som rapporterats av det underliggande virtualiseringssystemet.

virtualMachineName
  • string

Namnet på den virtuella datorn.

virtualMachineType

Anger den virtualiseringsteknik som används av datorn (hyperv, vmware osv.)

VirtualMachineType

Anger virtualiseringstypen för en dator.

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