Machines - Get

Référence

Service:: Service Map

API Version:: 2015-11-01-preview

Retourne l’ordinateur spécifié.

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}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
machineName	path	True	string	Nom de la ressource d’ordinateur.
resourceGroupName	path	True	string	Nom du groupe de ressources dans l’id d’abonnement spécifié. Regex pattern: `[a-zA-Z0-9_-]+`
subscriptionId	path	True	string	Identificateur de l’abonnement Azure.
workspaceName	path	True	string	Espace de travail OMS contenant les ressources qui vous intéressent. Regex pattern: `[a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]`
api-version	query	True	string	Version de l’API.
timestamp	query		string date-time	Date et heure UTC spécifiant une heure instance relative à laquelle évaluer la ressource machine. Lorsqu’il n’est pas spécifié, le service utilise DateTime.UtcNow.

Réponses

Nom	Type	Description
200 OK	Machine	L’opération s’est terminée avec succès.
Other Status Codes	ErrorResponse	Une erreur s’est produite lors du traitement de la demande. Consultez le paramètre error.code pour identifier l’erreur spécifique.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

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

Scopes

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Exemples

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

Définitions

Nom	Description
Accuracy	Spécifie la précision d’un calcul.
AgentConfiguration	Décrit la configuration de l’agent de dépendances installé sur un ordinateur.
AzureCloudServiceConfiguration	Décrit un service cloud Azure
AzureCloudServiceRoleType	Utilisé pour spécifier le type d’un rôle Azure Cloud Service
AzureHostingConfiguration	Fournit des informations sur la façon dont une machine est hébergée dans Azure
AzureServiceFabricClusterConfiguration	Décrit un cluster Azure Service Fabric
AzureVmScaleSetConfiguration	Décrit un groupe de machines virtuelles identiques Azure
Bitness	Spécifie le bit d’une machine ou d’un processus.
Error	Détails de l’erreur.
ErrorResponse	Réponse d’erreur de l’API.
HypervisorConfiguration	Décrit la configuration de l’hyperviseur d’un ordinateur.
HypervisorType	Spécifie le type d’hyperviseur d’une machine.
ImageConfiguration	Décrit l’image de machine virtuelle d’un ordinateur.
Ipv4NetworkInterface	Décrit une interface réseau IPv4.
Ipv6NetworkInterface	Décrit une interface réseau IPv6.
Machine	Une ressource d’ordinateur représente un système informatique découvert. Il peut être surveillé, c’est-à-dire qu’un agent de dépendances s’exécute sur celui-ci, ou découvert, c’est-à-dire que son existence a été déduite en observant le flux de données des machines surveillées. À mesure que les machines changent, les versions antérieures de la ressource d’ordinateur sont conservées et disponibles pour l’accès. Une machine est active pendant un intervalle de temps, si son Agent de dépendances a signalé des données pendant (parties) de cet intervalle, ou si un agent de dépendances s’exécutant sur d’autres machines a signalé une activité associée à l’ordinateur.
MachineRebootStatus	Spécifie si l’ordinateur a été redémarré depuis l’installation de l’agent de dépendances.
MachineResourcesConfiguration	Décrit les ressources d’un ordinateur.
MonitoringState	Permet de spécifier si une ressource est surveillée ou découverte.
NetworkConfiguration	Décrit la configuration réseau d’une machine.
OperatingSystemConfiguration	Décrit la configuration du système d’exploitation d’une machine.
OperatingSystemFamily	Spécifie la famille de systèmes d’exploitation, par exemple Linux, Windows, etc.
Timezone	Décrit un fuseau horaire.
VirtualizationState	Spécifie si la machine est physique, virtuelle, hyperviseur ou inconnue.
VirtualMachineConfiguration	Décrit la configuration liée à la virtualisation d’une machine.
VirtualMachineType	Spécifie le type de virtualisation d’une machine.

Accuracy

Spécifie la précision d’un calcul.

Nom	Type	Description
actual	string
estimated	string

AgentConfiguration

Décrit la configuration de l’agent de dépendances installé sur un ordinateur.

Nom	Type	Description
agentId	string	Identificateur unique de l’agent Health Service.
clockGranularity	integer	Granularité de l’horloge de la machine en millisecondes.
dependencyAgentId	string	Identificateur unique de l’Agent de dépendances.
dependencyAgentRevision	string	Numéro de révision de l’Agent de dépendances.
dependencyAgentVersion	string	Numéro de version de l’Agent de dépendances.
rebootStatus	MachineRebootStatus	Spécifie si l’ordinateur a été redémarré depuis l’installation de l’Agent de dépendances.

AzureCloudServiceConfiguration

Décrit un service cloud Azure

Nom	Type	Description
deployment	string	Identificateur de déploiement cloud Service
instanceId	string	Identificateur de instance cloud Service
name	string	Nom du service cloud
roleName	string	Nom de rôle Cloud Service
roleType	AzureCloudServiceRoleType	Utilisé pour spécifier le type d’un rôle Azure Cloud Service

AzureCloudServiceRoleType

Utilisé pour spécifier le type d’un rôle Azure Cloud Service

Nom	Type	Description
unknown	string
web	string
worker	string

AzureHostingConfiguration

Fournit des informations sur la façon dont une machine est hébergée dans Azure

Nom	Type	Description
cloudService	AzureCloudServiceConfiguration	Contient des informations sur les machines hébergées en tant que service cloud Azure
faultDomain	string	Domaine d’erreur de la machine virtuelle.
image	ImageConfiguration	Image de la machine.
kind	string: provider:azure	Qualificateur de configuration de configuration d’hébergement supplémentaire.
location	string	Emplacement géographique de la machine virtuelle.
name	string	Nom de l’ordinateur en fonction du fournisseur d’hébergement.
provider	enum: azure	Fournisseur d’hébergement de la machine virtuelle.
resourceGroup	string	Nom du groupe de ressources dans l’abonnement spécifié.
resourceId	string	Identificateur unique de la ressource.
serviceFabricCluster	AzureServiceFabricClusterConfiguration	Contient des informations sur les machines qui appartiennent à un cluster Azure Service Fabric
size	string	Taille de la machine virtuelle.
subscriptionId	string	l'ID d'abonnement.
updateDomain	string	Mettez à jour le domaine de la machine virtuelle.
vmId	string	ID de machine virtuelle (identificateur unique).
vmScaleSet	AzureVmScaleSetConfiguration	Contient des informations sur les machines hébergées en tant que groupe de machines virtuelles identiques Azure

AzureServiceFabricClusterConfiguration

Décrit un cluster Azure Service Fabric

Nom	Type	Description
clusterId	string	Identificateur de cluster Service Fabric.
name	string	Nom du cluster Service Fabric.

AzureVmScaleSetConfiguration

Décrit un groupe de machines virtuelles identiques Azure

Nom	Type	Description
deployment	string	Identificateur de déploiement du groupe de machines virtuelles identiques
instanceId	string	Identificateur instance groupe de machines virtuelles identiques
name	string	Nom du groupe de machines virtuelles identiques
resourceId	string	Identificateur unique de la ressource.

Bitness

Spécifie le bit d’une machine ou d’un processus.

Nom	Type	Description
32bit	string
64bit	string

Error

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur identifiant l’erreur spécifique.
message	string	Message d’erreur dans les paramètres régionaux de l’appelant.

ErrorResponse

Réponse d’erreur de l’API.

Nom	Type	Description
error	Error	Informations sur l’erreur.

HypervisorConfiguration

Décrit la configuration de l’hyperviseur d’un ordinateur.

Nom	Type	Description
hypervisorType	HypervisorType	Spécifie la technologie de virtualisation utilisée par l’hyperviseur (hyperv, vmware, etc.)
nativeHostMachineId	string	Identificateur unique de l’ordinateur hyperviseur comme indiqué par le système de virtualisation sous-jacent.

HypervisorType

Spécifie le type d’hyperviseur d’une machine.

Nom	Type	Description
hyperv	string
unknown	string

ImageConfiguration

Décrit l’image de machine virtuelle d’un ordinateur.

Nom	Type	Description
offering	string	Offre de l’image de machine virtuelle.
publisher	string	Éditeur de l’image de machine virtuelle.
sku	string	Référence SKU de l’image de machine virtuelle.
version	string	Version de l’image de machine virtuelle.

Ipv4NetworkInterface

Décrit une interface réseau IPv4.

Nom	Type	Valeur par défaut	Description
ipAddress	string		Adresse IPv4.
subnetMask	string	255.255.255.255	Masque de sous-réseau IPv4.

Ipv6NetworkInterface

Décrit une interface réseau IPv6.

Nom	Type	Description
ipAddress	string	Adresse IPv6.

Machine

Une ressource d’ordinateur représente un système informatique découvert. Il peut être surveillé, c’est-à-dire qu’un agent de dépendances s’exécute sur celui-ci, ou découvert, c’est-à-dire que son existence a été déduite en observant le flux de données des machines surveillées. À mesure que les machines changent, les versions antérieures de la ressource d’ordinateur sont conservées et disponibles pour l’accès. Une machine est active pendant un intervalle de temps, si son Agent de dépendances a signalé des données pendant (parties) de cet intervalle, ou si un agent de dépendances s’exécutant sur d’autres machines a signalé une activité associée à l’ordinateur.

Nom	Type	Description
etag	string	ETAG de ressource.
id	string	Identificateur de ressource.
kind	string: machine	Qualificateur de type de ressource supplémentaire.
name	string	Nom de la ressource.
properties.agent	AgentConfiguration	Configuration de l’Agent de dépendances.
properties.bootTime	string	Date et heure UTC auxquelles la machine a démarré pour la dernière fois
properties.computerName	string	Nom de la machine, par exemple, serveur
properties.displayName	string	Nom à utiliser à des fins d’affichage
properties.fullyQualifiedDomainName	string	Nom complet de la machine, par exemple, server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Configuration liée à l’hébergement. Présente si les informations d’hébergement sont découvertes pour la machine virtuelle.
properties.hypervisor	HypervisorConfiguration	Configuration liée à l’hyperviseur. Présente uniquement lorsque « virtualizationState » est `hypervisor`.
properties.monitoringState	MonitoringState	Spécifie si la machine est activement surveillée ou découverte.
properties.networking	NetworkConfiguration	Configuration réseau (ips, passerelles, dns, etc.)
properties.operatingSystem	OperatingSystemConfiguration	Informations sur le système d’exploitation.
properties.resources	MachineResourcesConfiguration	Ressources de machine (mémoire, processeur, etc.).
properties.timestamp	string	Date et heure UTC auxquelles cette ressource a été mise à jour dans le système.
properties.timezone	Timezone	Fuseau horaire de la machine.
properties.virtualMachine	VirtualMachineConfiguration	Configuration liée à la virtualisation. Présente uniquement lorsque `virtualizationState` est `virtual`.
properties.virtualizationState	VirtualizationState	Spécifie si la machine est virtualisée.
type	string	Type de ressource.

MachineRebootStatus

Spécifie si l’ordinateur a été redémarré depuis l’installation de l’agent de dépendances.

Nom	Type	Description
notRebooted	string
rebooted	string
unknown	string

MachineResourcesConfiguration

Décrit les ressources d’un ordinateur.

Nom	Type	Description
cpuSpeed	integer	Vitesse du processeur en mégahertz (Mhz).
cpuSpeedAccuracy	Accuracy	Décrit la précision du champ cpuSpeed.
cpus	integer	Nombre de processeurs.
physicalMemory	integer	Mémoire physique en mégaoctets (Mo).

MonitoringState

Permet de spécifier si une ressource est surveillée ou découverte.

Nom	Type	Description
discovered	string
monitored	string

NetworkConfiguration

Décrit la configuration réseau d’une machine.

Nom	Type	Description
defaultIpv4Gateways	string[]	Passerelles IPv4 par défaut.
dnsNames	string[]	Noms DNS associés à l’ordinateur.
ipv4Interfaces	Ipv4NetworkInterface[]	Interfaces IPv4.
ipv6Interfaces	Ipv6NetworkInterface[]	Interfaces IPv6.
macAddresses	string[]	Adresses MAC de toutes les interfaces réseau actives.

OperatingSystemConfiguration

Décrit la configuration du système d’exploitation d’une machine.

Nom	Type	Description
bitness	Bitness	Bitness du système d’exploitation (32 bits ou 64 bits).
family	OperatingSystemFamily	Windows, Linux, etc.
fullName	string	Nom complet du système d’exploitation.

OperatingSystemFamily

Spécifie la famille de systèmes d’exploitation, par exemple Linux, Windows, etc.

Nom	Type	Description
aix	string
linux	string
solaris	string
unknown	string
windows	string

Timezone

Décrit un fuseau horaire.

Nom	Type	Description
fullName	string	Nom complet du fuseau horaire.

VirtualizationState

Spécifie si la machine est physique, virtuelle, hyperviseur ou inconnue.

Nom	Type	Description
hypervisor	string
physical	string
unknown	string
virtual	string

VirtualMachineConfiguration

Décrit la configuration liée à la virtualisation d’une machine.

Nom	Type	Description
nativeHostMachineId	string	Identificateur unique de l’hôte de cette machine virtuelle, comme indiqué par le système de virtualisation sous-jacent.
nativeMachineId	string	Identificateur unique de la machine virtuelle comme indiqué par le système de virtualisation sous-jacent.
virtualMachineName	string	Nom de la machine virtuelle.
virtualMachineType	VirtualMachineType	Spécifie la technologie de virtualisation utilisée par la machine (hyperv, vmware, etc.)

VirtualMachineType

Spécifie le type de virtualisation d’une machine.

Nom	Type	Description
hyperv	string
ldom	string
lpar	string
unknown	string
virtualPc	string
vmware	string
xen	string