Machines - Get

Service:: Service Map

Version d'API:: 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

Avec des paramètres facultatifs:

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 minLength: 3 maxLength: 64	Nom de la ressource de l’ordinateur.
resourceGroupName	path	True	string minLength: 1 maxLength: 64 pattern: [a-zA-Z0-9_-]+	Nom du groupe de ressources dans l’id d’abonnement spécifié.
subscriptionId	path	True	string	Identificateur d’abonnement Azure.
workspaceName	path	True	string minLength: 3 maxLength: 63 pattern: [a-zA-Z0-9_][a-zA-Z0-9_-]+[a-zA-Z0-9_]	Espace de travail OMS contenant les ressources intéressantes.
api-version	query	True	string	Version de l’API.
timestamp	query		string (date-time)	Date et heure UTC spécifiant une instance d’heure par rapport à laquelle évaluer la ressource de l’ordinateur. 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
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

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

Exemples

SMMachinesGetGet

Exemple de requête

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

Exemple de réponse

Code d’état:: 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 Dependency Agent installée sur un ordinateur.
AzureCloudServiceConfiguration	Décrit un service cloud Azure
AzureCloudServiceRoleType	Utilisé pour spécifier le type d’un rôle de service cloud Azure
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 de machine représente un système informatique découvert. Il peut être supervisé, c’est-à-dire qu’un Agent de dépendances s’exécute dessus, ou découvert, c’est-à-dire que son existence a été déduite en observant le flux de données à partir de 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épendance a signalé des données pendant (parties) de cet intervalle, ou qu’un agent de dépendance s’exécutant sur d’autres ordinateurs a signalé une activité associée à l’ordinateur.
MachineRebootStatus	Spécifie si la machine 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’un ordinateur.
OperatingSystemConfiguration	Décrit la configuration du système d’exploitation d’un ordinateur.
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

Énumération

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

Valeur	Description
actual
estimated

AgentConfiguration

Object

Décrit la configuration de Dependency Agent installée sur un ordinateur.

Nom	Type	Description
agentId	string	Identificateur unique de l’Agent de service d’intégrité.
clockGranularity	integer (int32)	Granularité de l’horloge 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 Dependency Agent.

AzureCloudServiceConfiguration

Object

Décrit un service cloud Azure

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

AzureCloudServiceRoleType

Énumération

Utilisé pour spécifier le type d’un rôle de service cloud Azure

Valeur	Description
unknown
worker
web

AzureHostingConfiguration

Object

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 type 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 appartenant à 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

Object

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

Object

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 d’instance du groupe de machines virtuelles identiques
name	string	Nom du groupe de machines virtuelles identiques
resourceId	string	Identificateur unique de la ressource.

Bitness

Énumération

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

Valeur	Description
32bit
64bit

Error

Object

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

Object

Réponse d’erreur de l’API.

Nom	Type	Description
error	Error	Informations sur l’erreur.

HypervisorConfiguration

Object

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 la machine hyperviseur, tel qu’indiqué par le système de virtualisation sous-jacent.

HypervisorType

Énumération

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

Valeur	Description
unknown
hyperv

ImageConfiguration

Object

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

Object

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

Object

Décrit une interface réseau IPv6.

Nom	Type	Description
ipAddress	string	Adresse IPv6.

Machine

Object

Une ressource de machine représente un système informatique découvert. Il peut être supervisé, c’est-à-dire qu’un Agent de dépendances s’exécute dessus, ou découvert, c’est-à-dire que son existence a été déduite en observant le flux de données à partir de 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épendance a signalé des données pendant (parties) de cet intervalle, ou qu’un agent de dépendance s’exécutant sur d’autres ordinateurs a signalé une activité associée à l’ordinateur.

Nom	Type	Description
etag	string	RESSOURCE ETAG.
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-time)	Date et heure UTC de la dernière démarrage de l’ordinateur
properties.computerName	string	Nom de l’ordinateur, par exemple, serveur
properties.displayName	string	Nom à utiliser à des fins d’affichage
properties.fullyQualifiedDomainName	string	Nom complet de l’ordinateur, par exemple, server.company.com
properties.hosting	HostingConfiguration: AzureHostingConfiguration	Configuration liée à l’hébergement. Présentez 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-time)	Date et heure UTC de la mise à jour de cette ressource 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

Énumération

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

Valeur	Description
unknown
rebooted
notRebooted

MachineResourcesConfiguration

Object

Décrit les ressources d’un ordinateur.

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

MonitoringState

Énumération

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

Valeur	Description
monitored
discovered

NetworkConfiguration

Object

Décrit la configuration réseau d’un ordinateur.

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

OperatingSystemConfiguration

Object

Décrit la configuration du système d’exploitation d’un ordinateur.

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

Énumération

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

Valeur	Description
unknown
windows
linux
solaris
aix

Timezone

Object

Décrit un fuseau horaire.

Nom	Type	Description
fullName	string	Nom complet du fuseau horaire.

VirtualizationState

Énumération

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

Valeur	Description
unknown
physical
virtual
hypervisor

VirtualMachineConfiguration

Object

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, tel qu’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

Énumération

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

Valeur	Description
unknown
hyperv
ldom
lpar
vmware
virtualPc
xen

Partager via

Machines - Get

Paramètres URI

Réponses

Sécurité

azure_auth

Étendues

Exemples

SMMachinesGetGet

Exemple de requête

Exemple de réponse

Définitions

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