Machines - Get

Service:: Service Map

API-versie:: 2015-11-01-preview

Retourneert de opgegeven machine.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/features/serviceMap/machines/{machineName}?api-version=2015-11-01-preview

Met optionele 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-parameters

Name	In	Vereist	Type	Description
machineName	path	True	string minLength: 3 maxLength: 64	Naam van computerresource.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	De naam van de resourcegroep binnen de opgegeven subscriptionId.
subscriptionId	path	True	string	Azure-abonnements-id.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	OMS-werkruimte met de resources die van belang zijn.
api-version	query	True	string	API-versie.
timestamp	query		string (date-time)	UTC-datum en -tijd die een tijdexemplaren aangeeft ten opzichte waarvan de machineresource moet worden geëvalueerd. Wanneer deze niet is opgegeven, gebruikt de service DateTime.UtcNow.

Antwoorden

Name	Type	Description
200 OK	Machine	De bewerking is voltooid.
Other Status Codes	ErrorResponse	Er is een fout opgetreden tijdens het verwerken van de aanvraag. Zie de parameter error.code om de specifieke fout te identificeren.

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

SMMachinesGetGet

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name	Description
Accuracy	Hiermee geeft u de nauwkeurigheid van een berekening.
AgentConfiguration	Beschrijft de configuratie van de afhankelijkheidsagent die op een computer is geïnstalleerd.
AzureCloudServiceConfiguration	Beschrijft een Azure-cloudservice
AzureCloudServiceRoleType	Wordt gebruikt om het type azure-cloudservicerol op te geven
AzureHostingConfiguration	Biedt informatie over hoe een machine wordt gehost in Azure
AzureServiceFabricClusterConfiguration	Beschrijft een Azure Service Fabric-cluster
AzureVmScaleSetConfiguration	Beschrijft een virtuele-machineschaalset van Azure
Bitness	Hiermee geeft u de bitness van een machine of proces.
Error	Foutdetails.
ErrorResponse	Een foutreactie van de API.
HypervisorConfiguration	Beschrijft de hypervisorconfiguratie van een machine.
HypervisorType	Hiermee geeft u het type hypervisor van een machine.
ImageConfiguration	Beschrijft de VM-installatiekopieën van een machine.
Ipv4NetworkInterface	Beschrijft een IPv4-netwerkinterface.
Ipv6NetworkInterface	Beschrijft een IPv6-netwerkinterface.
Machine	Een computerresource vertegenwoordigt een gedetecteerd computersysteem. Het kan worden bewaakt, dat wil bijvoorbeeld dat er een afhankelijkheidsagent op wordt uitgevoerd, of gedetecteerd, dat wil stellen dat het bestaan ervan is afgeleid door de gegevensstroom van bewaakte machines te observeren. Wanneer machines veranderen, blijven eerdere versies van de machineresource behouden en beschikbaar voor toegang. Een machine is live gedurende een tijdsinterval, als de afhankelijkheidsagent gegevens heeft gerapporteerd tijdens (onderdelen) van dat interval, of als een afhankelijkheidsagent die wordt uitgevoerd op andere computers activiteit heeft gerapporteerd die aan de machine is gekoppeld.
MachineRebootStatus	Hiermee geeft u op of de machine opnieuw is opgestart sinds de installatie van de afhankelijkheidsagent.
MachineResourcesConfiguration	Beschrijft de resources van een machine.
MonitoringState	Wordt gebruikt om op te geven of een resource wordt bewaakt of gedetecteerd.
NetworkConfiguration	Beschrijft de netwerkconfiguratie van een computer.
OperatingSystemConfiguration	Beschrijft de configuratie van het besturingssysteem van een computer.
OperatingSystemFamily	Hiermee geeft u de besturingssysteemfamilie, bijvoorbeeld Linux, Windows, enzovoort.
Timezone	Beschrijft een tijdzone.
VirtualizationState	Hiermee geeft u op of de machine fysiek, virtueel, hypervisor of onbekend is.
VirtualMachineConfiguration	Beschrijft de configuratie van virtualisatie van een machine.
VirtualMachineType	Hiermee geeft u het type virtualisatie van een machine.

Accuracy

Inventarisatie

Hiermee geeft u de nauwkeurigheid van een berekening.

Waarde	Description
actual
estimated

AgentConfiguration

Object

Beschrijft de configuratie van de afhankelijkheidsagent die op een computer is geïnstalleerd.

Name	Type	Description
agentId	string	Unieke id van Health Service Agent.
clockGranularity	integer (int32)	Machine klok granulariteit in milliseconden.
dependencyAgentId	string	Unieke id van afhankelijkheidsagent.
dependencyAgentRevision	string	Revisienummer van afhankelijkheidsagent.
dependencyAgentVersion	string	Versienummer van Dependency Agent.
rebootStatus	MachineRebootStatus	Hiermee geeft u op of de computer opnieuw is opgestart sinds de installatie van de Dependency Agent.

AzureCloudServiceConfiguration

Object

Beschrijft een Azure-cloudservice

Name	Type	Description
deployment	string	Id voor cloudservice-implementatie
instanceId	string	Id van cloudservice-exemplaar
name	string	Naam van cloudservice
roleName	string	Naam van cloudservicerol
roleType	AzureCloudServiceRoleType	Wordt gebruikt om het type azure-cloudservicerol op te geven

AzureCloudServiceRoleType

Inventarisatie

Wordt gebruikt om het type azure-cloudservicerol op te geven

Waarde	Description
unknown
worker
web

AzureHostingConfiguration

Object

Biedt informatie over hoe een machine wordt gehost in Azure

Name	Type	Description
cloudService	AzureCloudServiceConfiguration	Bevat informatie over machines die worden gehost als een Azure-cloudservice
faultDomain	string	Foutdomein van de VM.
image	ImageConfiguration	Afbeelding van de machine.
kind	string: provider:azure	Aanvullende kwalificatie voor hostingconfiguratietypen.
location	string	Geografische locatie van de virtuele machine.
name	string	Computernaam volgens de hostingprovider.
provider	enum: azure	De hostingprovider van de VIRTUELE machine.
resourceGroup	string	De naam van de resourcegroep binnen het opgegeven abonnement.
resourceId	string	Unieke id van de resource.
serviceFabricCluster	AzureServiceFabricClusterConfiguration	Bevat informatie over machines die deel uitmaken van een Azure Service Fabric-cluster
size	string	Grootte van de VIRTUELE machine.
subscriptionId	string	Abonnements-id.
updateDomain	string	Domein van de virtuele machine bijwerken.
vmId	string	Id van virtuele machine (unieke id).
vmScaleSet	AzureVmScaleSetConfiguration	Bevat informatie over machines die worden gehost als een virtuele-machineschaalset van Azure

AzureServiceFabricClusterConfiguration

Object

Beschrijft een Azure Service Fabric-cluster

Name	Type	Description
clusterId	string	Service Fabric-cluster-id.
name	string	Service Fabric-clusternaam.

AzureVmScaleSetConfiguration

Object

Beschrijft een virtuele-machineschaalset van Azure

Name	Type	Description
deployment	string	Implementatie-id van virtuele-machineschaalset
instanceId	string	Exemplaar-id van virtuele-machineschaalset
name	string	Naam van virtuele-machineschaalset
resourceId	string	Unieke id van de resource.

Bitness

Inventarisatie

Hiermee geeft u de bitness van een machine of proces.

Waarde	Description
32bit
64bit

Error

Object

Foutdetails.

Name	Type	Description
code	string	Foutcode waarmee de specifieke fout wordt geïdentificeerd.
message	string	Foutbericht in de landinstelling van de beller.

ErrorResponse

Object

Een foutreactie van de API.

Name	Type	Description
error	Error	Foutinformatie.

HypervisorConfiguration

Object

Beschrijft de hypervisorconfiguratie van een machine.

Name	Type	Description
hypervisorType	HypervisorType	Hiermee geeft u de virtualisatietechnologie op die wordt gebruikt door de hypervisor (hyperv, vmware, enzovoort)
nativeHostMachineId	string	De unieke id van de hypervisormachine zoals gerapporteerd door het onderliggende virtualisatiesysteem.

HypervisorType

Inventarisatie

Hiermee geeft u het type hypervisor van een machine.

Waarde	Description
unknown
hyperv

ImageConfiguration

Object

Beschrijft de VM-installatiekopieën van een machine.

Name	Type	Description
offering	string	Aanbieding van de VM-installatiekopieën.
publisher	string	Uitgever van de VM-installatiekopieën.
sku	string	SKU van de VM-installatiekopieën.
version	string	Versie van de VM-installatiekopieën.

Ipv4NetworkInterface

Object

Beschrijft een IPv4-netwerkinterface.

Name	Type	Default value	Description
ipAddress	string		IPv4-adres.
subnetMask	string	255.255.255.255	IPv4-subnetmasker.

Ipv6NetworkInterface

Object

Beschrijft een IPv6-netwerkinterface.

Name	Type	Description
ipAddress	string	IPv6-adres.

Machine

Object

Een computerresource vertegenwoordigt een gedetecteerd computersysteem. Het kan worden bewaakt, dat wil bijvoorbeeld dat er een afhankelijkheidsagent op wordt uitgevoerd, of gedetecteerd, dat wil stellen dat het bestaan ervan is afgeleid door de gegevensstroom van bewaakte machines te observeren. Wanneer machines veranderen, blijven eerdere versies van de machineresource behouden en beschikbaar voor toegang. Een machine is live gedurende een tijdsinterval, als de afhankelijkheidsagent gegevens heeft gerapporteerd tijdens (onderdelen) van dat interval, of als een afhankelijkheidsagent die wordt uitgevoerd op andere computers activiteit heeft gerapporteerd die aan de machine is gekoppeld.

Name	Type	Description
etag	string	Resource-ETAG.
id	string	Resource-id.
kind	string: machine	Aanvullende kwalificatie voor resourcetypen.
name	string	Resourcenaam.
properties.agent	AgentConfiguration	Configuratie van afhankelijkheidsagent.
properties.bootTime	string (date-time)	UTC-datum en -tijd waarop de computer voor het laatst is opgestart
properties.computerName	string	Naam van de computer, bijvoorbeeld server
properties.displayName	string	Te gebruiken naam voor weergavedoeleinden
properties.fullyQualifiedDomainName	string	Volledig gekwalificeerde naam van de machine, bijvoorbeeld server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Hosting-gerelateerde configuratie. Aanwezig als hostinggegevens worden gedetecteerd voor de virtuele machine.
properties.hypervisor	HypervisorConfiguration	Configuratie met betrekking tot hypervisor. Alleen aanwezig als 'virtualizationState' is `hypervisor`.
properties.monitoringState	MonitoringState	Hiermee geeft u op of de machine actief wordt bewaakt of gedetecteerd.
properties.networking	NetworkConfiguration	Netwerkconfiguratie (ips, gateways, dns, enzovoort)
properties.operatingSystem	OperatingSystemConfiguration	Informatie over het besturingssysteem.
properties.resources	MachineResourcesConfiguration	Machinebronnen (geheugen, cpu, enzovoort).
properties.timestamp	string (date-time)	UTC-datum en -tijd waarop deze resource is bijgewerkt in het systeem.
properties.timezone	Timezone	Tijdzone van de machine.
properties.virtualMachine	VirtualMachineConfiguration	Configuratie met betrekking tot virtualisatie. Alleen aanwezig wanneer `virtualizationState` is `virtual`.
properties.virtualizationState	VirtualizationState	Hiermee geeft u op of de machine wordt gevirtualiseerd.
type	string	Resourcetype.

MachineRebootStatus

Inventarisatie

Hiermee geeft u op of de machine opnieuw is opgestart sinds de installatie van de afhankelijkheidsagent.

Waarde	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

Beschrijft de resources van een machine.

Name	Type	Description
cpuSpeed	integer (int32)	CPU-snelheid in megahertz (Mhz).
cpuSpeedAccuracy	Accuracy	Beschrijft de nauwkeurigheid van het veld cpuSpeed.
cpus	integer (int32)	Aantal CPU's.
physicalMemory	integer (int32)	Fysiek geheugen in megabytes (MB).

MonitoringState

Inventarisatie

Wordt gebruikt om op te geven of een resource wordt bewaakt of gedetecteerd.

Waarde	Description
monitored
discovered

NetworkConfiguration

Object

Beschrijft de netwerkconfiguratie van een computer.

Name	Type	Description
defaultIpv4Gateways	string[]	Standaard-IPv4-gateways.
dnsNames	string[]	DNS-namen die zijn gekoppeld aan de computer.
ipv4Interfaces	Ipv4NetworkInterface[]	IPv4-interfaces.
ipv6Interfaces	Ipv6NetworkInterface[]	IPv6-interfaces.
macAddresses	string[]	MAC-adressen van alle actieve netwerkinterfaces.

OperatingSystemConfiguration

Object

Beschrijft de configuratie van het besturingssysteem van een computer.

Name	Type	Description
bitness	Bitness	Bitness van het besturingssysteem (32-bits of 64-bits).
family	OperatingSystemFamily	Windows, Linux, enzovoort.
fullName	string	Volledige naam van besturingssysteem.

OperatingSystemFamily

Inventarisatie

Hiermee geeft u de besturingssysteemfamilie, bijvoorbeeld Linux, Windows, enzovoort.

Waarde	Description
unknown
windows
linux
solaris
aix

Timezone

Object

Beschrijft een tijdzone.

Name	Type	Description
fullName	string	Volledige naam van tijdzone.

VirtualizationState

Inventarisatie

Hiermee geeft u op of de machine fysiek, virtueel, hypervisor of onbekend is.

Waarde	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

Beschrijft de configuratie van virtualisatie van een machine.

Name	Type	Description
nativeHostMachineId	string	De unieke id van de host van deze virtuele machine, zoals gerapporteerd door het onderliggende virtualisatiesysteem.
nativeMachineId	string	De unieke id van de virtuele machine zoals gerapporteerd door het onderliggende virtualisatiesysteem.
virtualMachineName	string	De naam van de virtuele machine.
virtualMachineType	VirtualMachineType	Hiermee geeft u de virtualisatietechnologie op die wordt gebruikt door de machine (hyperv, vmware, enzovoort)

VirtualMachineType

Inventarisatie

Hiermee geeft u het type virtualisatie van een machine.

Waarde	Description
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen

Delen via

Machines - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

SMMachinesGetGet

Voorbeeldaanvraag

Voorbeeldrespons

Definities

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