Machines - Get

Service:

Service Map

API Version:

2015-11-01-preview

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

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}

URI-parametrar

Name	I	Obligatorisk	Typ	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	Typ	Description
200 OK	Machine	Åtgärden slutfördes.
Other Status Codes	ErrorResponse	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

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

Definitioner

Name	Description
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	Typ	Description
actual	string
estimated	string

AgentConfiguration

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

Name	Typ	Description
agentId	string	Unik identifierare för hälsotjänstagenten.
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	MachineRebootStatus	Anger om datorn har startats om sedan dependency agent-installationen.

AzureCloudServiceConfiguration

Beskriver en Azure-molntjänst

Name	Typ	Description
deployment	string	Molntjänstdistributionsidentifierare
instanceId	string	Cloud Service-instansidentifierare
name	string	Molntjänstnamn
roleName	string	Namn på molntjänstroll
roleType	AzureCloudServiceRoleType	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	Typ	Description
unknown	string
web	string
worker	string

AzureHostingConfiguration

Innehåller information om hur en dator finns i Azure

Name	Typ	Description
cloudService	AzureCloudServiceConfiguration	Innehåller information om datorer som hanteras som en Azure-molntjänst
faultDomain	string	Den virtuella datorns feldomän.
image	ImageConfiguration	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	AzureServiceFabricClusterConfiguration	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	AzureVmScaleSetConfiguration	Innehåller information om datorer som hanteras som en Skalningsuppsättning för virtuella Azure-datorer

AzureServiceFabricClusterConfiguration

Beskriver ett Azure Service Fabric-kluster

Name	Typ	Description
clusterId	string	Service Fabric-klusteridentifierare.
name	string	Service Fabric-klusternamn.

AzureVmScaleSetConfiguration

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

Name	Typ	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	Typ	Description
32bit	string
64bit	string

Error

Felinformation.

Name	Typ	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	Typ	Description
error	Error	Felinformation.

HypervisorConfiguration

Beskriver hypervisor-konfigurationen för en dator.

Name	Typ	Description
hypervisorType	HypervisorType	Anger den virtualiseringsteknik som används av hypervisor-programmet (hyperv, vmware osv.)
nativeHostMachineId	string	Den unika identifieraren för hypervisor-datorn enligt det underliggande virtualiseringssystemet.

HypervisorType

Anger hypervisor-typen för en dator.

Name	Typ	Description
hyperv	string
unknown	string

ImageConfiguration

Beskriver VM-avbildningen av en dator.

Name	Typ	Description
offering	string	Erbjudande för VM-avbildningen.
publisher	string	Utgivare av VM-avbildningen.
sku	string	SKU för VM-avbildningen.
version	string	Version av VM-avbildningen.

Ipv4NetworkInterface

Beskriver ett IPv4-nätverksgränssnitt.

Name	Typ	Standardvärde	Description
ipAddress	string		IPv4-adress.
subnetMask	string	255.255.255.255	IPv4-nätmask.

Ipv6NetworkInterface

Beskriver ett IPv6-nätverksgränssnitt.

Name	Typ	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	Typ	Description
etag	string	Resurs-ETAG.
id	string	Resursidentifierare.
kind	string: machine	Ytterligare resurstypskvalificerare.
name	string	Resursnamn.
properties.agent	AgentConfiguration	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: AzureHostingConfiguration	Värdrelaterad konfiguration. Presentera om värdinformation identifieras för den virtuella datorn.
properties.hypervisor	HypervisorConfiguration	Hypervisor-relaterad konfiguration. Presentera endast när "virtualizationState" är hypervisor.
properties.monitoringState	MonitoringState	Anger om datorn övervakas aktivt eller identifieras.
properties.networking	NetworkConfiguration	Nätverkskonfiguration (ip-adresser, gatewayer, dns osv.)
properties.operatingSystem	OperatingSystemConfiguration	Information om operativsystemet.
properties.resources	MachineResourcesConfiguration	Datorresurser (minne, cpu osv.).
properties.timestamp	string	UTC-datum och tid då den här resursen uppdaterades i systemet.
properties.timezone	Timezone	Datorns tidszon.
properties.virtualMachine	VirtualMachineConfiguration	Virtualiseringsrelaterad konfiguration. Presentera endast när virtualizationState är virtual.
properties.virtualizationState	VirtualizationState	Anger om datorn är virtualiserad.
type	string	Resurstyp.

MachineRebootStatus

Anger om datorn har startats om sedan beroendeagenten installeras.

Name	Typ	Description
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Beskriver en dators resurser.

Name	Typ	Description
cpuSpeed	integer	CPU-hastighet i megahertz (Mhz).
cpuSpeedAccuracy	Accuracy	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	Typ	Description
discovered	string
monitored	string

NetworkConfiguration

Beskriver nätverkskonfigurationen för en dator.

Name	Typ	Description
defaultIpv4Gateways	string[]	Standard-IPv4-gatewayer.
dnsNames	string[]	DNS-namn som är associerade med datorn.
ipv4Interfaces	Ipv4NetworkInterface[]	IPv4-gränssnitt.
ipv6Interfaces	Ipv6NetworkInterface[]	IPv6-gränssnitt.
macAddresses	string[]	MAC-adresser för alla aktiva nätverksgränssnitt.

OperatingSystemConfiguration

Beskriver konfigurationen av operativsystemet på en dator.

Name	Typ	Description
bitness	Bitness	Operativsystemets bit (32-bitars eller 64-bitars).
family	OperatingSystemFamily	Windows, Linux osv.
fullName	string	Fullständigt namn på operativsystemet.

OperatingSystemFamily

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

Name	Typ	Description
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Beskriver en tidszon.

Name	Typ	Description
fullName	string	Fullständigt namn på tidszon.

VirtualizationState

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

Name	Typ	Description
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

Beskriver den virtualiseringsrelaterade konfigurationen för en dator.

Name	Typ	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	VirtualMachineType	Anger den virtualiseringsteknik som används av datorn (hyperv, vmware osv.)

VirtualMachineType

Anger virtualiseringstypen för en dator.

Name	Typ	Description
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string