Machines - Get

Tjänst:: 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

Med valfria parametrar:

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 minLength: 3 maxLength: 64	Namnet på datorns resurs.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Resursgruppsnamn inom angivet subscriptionId.
subscriptionId	path	True	string	Azure-prenumerationsidentifierare.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	OMS-arbetsyta som innehåller resurser av intresse.
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 det inte anges använder tjänsten DateTime.UtcNow.

Svar

Name	Typ	Description
200 OK	Machine	Åtgärden har slutförts.
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-flöde

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name	Description
user_impersonation	personifiera ditt användarkonto

Exempel

SMMachinesGetGet

Exempelbegäran

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

Exempelsvar

Statuskod:: 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 Cloud Service
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. Det kan övervakas, dvs. en beroendeagent körs på den, eller identifierade, dvs. dess existens härleddes genom att observera dataströmmen 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 för 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

Uppräkning

Anger noggrannheten för en beräkning.

Värde	Description
actual
estimated

AgentConfiguration

Objekt

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

Name	Typ	Description
agentId	string	Unik identifierare för hälsotjänstagenten.
clockGranularity	integer (int32)	Maskinklockans kornighet i millisekunder.
dependencyAgentId	string	Unik identifierare för beroendeagent.
dependencyAgentRevision	string	Beroendeagentens revisionsnummer.
dependencyAgentVersion	string	Versionsnummer för beroendeagenten.
rebootStatus	MachineRebootStatus	Anger om datorn har startats om sedan installationen av beroendeagenten.

AzureCloudServiceConfiguration

Objekt

Beskriver en Azure Cloud Service

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

Uppräkning

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

Värde	Description
unknown
worker
web

AzureHostingConfiguration

Objekt

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 Cloud Service
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ärdleverantören för den virtuella datorn.
resourceGroup	string	Resursgruppsnamn 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

Objekt

Beskriver ett Azure Service Fabric-kluster

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

AzureVmScaleSetConfiguration

Objekt

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

Uppräkning

Anger bitness för en dator eller process.

Värde	Description
32bit
64bit

Error

Objekt

Felinformation.

Name	Typ	Description
code	string	Felkod som identifierar det specifika felet.
message	string	Felmeddelande i anroparens nationella inställningar.

ErrorResponse

Objekt

Ett felsvar från API:et.

Name	Typ	Description
error	Error	Felinformation.

HypervisorConfiguration

Objekt

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 som rapporterats av det underliggande virtualiseringssystemet.

HypervisorType

Uppräkning

Anger hypervisor-typen för en dator.

Värde	Description
unknown
hyperv

ImageConfiguration

Objekt

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

Objekt

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

Objekt

Beskriver ett IPv6-nätverksgränssnitt.

Name	Typ	Description
ipAddress	string	IPv6-adress.

Machine

Objekt

En datorresurs representerar ett identifierat datorsystem. Det kan övervakas, dvs. en beroendeagent körs på den, eller identifierade, dvs. dess existens härleddes genom att observera dataströmmen 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 (date-time)	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 eller identifieras aktivt.
properties.networking	NetworkConfiguration	Nätverkskonfiguration (ip-adresser, gatewayer, dns osv.)
properties.operatingSystem	OperatingSystemConfiguration	Information om operativsystemet.
properties.resources	MachineResourcesConfiguration	Datorresurser (minne, processor osv.).
properties.timestamp	string (date-time)	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

Uppräkning

Anger om datorn har startats om sedan beroendeagenten installeras.

Värde	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Objekt

Beskriver en dators resurser.

Name	Typ	Description
cpuSpeed	integer (int32)	CPU-hastighet i megahertz (Mhz).
cpuSpeedAccuracy	Accuracy	Beskriver noggrannheten i fältet cpuSpeed.
cpus	integer (int32)	Antal processorer.
physicalMemory	integer (int32)	Fysiskt minne i megabyte (MB).

MonitoringState

Uppräkning

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

Värde	Description
monitored
discovered

NetworkConfiguration

Objekt

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

Objekt

Beskriver konfigurationen av operativsystemet för en dator.

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

OperatingSystemFamily

Uppräkning

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

Värde	Description
unknown
windows
linux
solaris
aix

Timezone

Objekt

Beskriver en tidszon.

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

VirtualizationState

Uppräkning

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

Värde	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Objekt

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 enligt det underliggande virtualiseringssystemet.
nativeMachineId	string	Den unika identifieraren för den virtuella datorn enligt det underliggande virtualiseringssystemet.
virtualMachineName	string	Namnet på den virtuella datorn.
virtualMachineType	VirtualMachineType	Anger den virtualiseringsteknik som används av datorn (hyperv, vmware osv.)

VirtualMachineType

Uppräkning

Anger virtualiseringstypen för en dator.

Värde	Description
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen

Dela via

Machines - Get

URI-parametrar

Svar

Säkerhet

azure_auth

Omfattningar

Exempel

SMMachinesGetGet

Exempelbegäran

Exempelsvar

Definitioner

Accuracy

AgentConfiguration

AzureCloudServiceConfiguration

AzureCloudServiceRoleType

AzureHostingConfiguration

AzureServiceFabricClusterConfiguration

AzureVmScaleSetConfiguration

Bitness

Error

ErrorResponse

HypervisorConfiguration

HypervisorType

ImageConfiguration

Ipv4NetworkInterface

Ipv6NetworkInterface

Machine

MachineRebootStatus

MachineResourcesConfiguration

MonitoringState

NetworkConfiguration

OperatingSystemConfiguration

OperatingSystemFamily

Timezone

VirtualizationState

VirtualMachineConfiguration

VirtualMachineType