Machines - Get

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

Name In Required Type Description
machineName
path True
  • string

Nom de la ressource de l’ordinateur.

resourceGroupName
path True
  • string

Nom du groupe de ressources dans le subscriptionId 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 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

Name Type Description
200 OK

L’opération s’est terminée avec succès.

Other Status Codes

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

Azure Active Directory le Flow OAuth2

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

Scopes

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

Exemples

SMMachinesGetGet

Sample Request

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

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

Accuracy

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

AgentConfiguration

Décrit la configuration de l’Dependency Agent installé 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 un ordinateur est hébergé dans Azure

AzureServiceFabricClusterConfiguration

Décrit un cluster Azure Service Fabric

AzureVmScaleSetConfiguration

Décrit un groupe de machines virtuelles identiques Azure

Bitness

Spécifie le nombre de bits d’un ordinateur 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’un ordinateur.

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 surveillé, c.-à-d. qu’un Dependency agent s’exécute sur celui-ci ou découvert, c.-à-d. que son existence a été déduite en observant le flux de données des ordinateurs analysés. À mesure que les machines changent, les versions antérieures de la ressource de l’ordinateur sont conservées et disponibles pour l’accès. Une machine est active pendant un intervalle de temps, si son Dependency Agent a signalé des données pendant (parties) de cet intervalle, ou si un agent de dépendances s’exécutant sur d’autres ordinateurs a signalé une activité associée à la machine.

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

Utilisé pour spécifier si une ressource est analysé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 du système d’exploitation, par exemple, Linux, Windows, etc.

Timezone

Décrit un fuseau horaire.

VirtualizationState

Spécifie si l’ordinateur est physique, virtuel, hyperviseur ou inconnu.

VirtualMachineConfiguration

Décrit la configuration de la virtualisation d’un ordinateur.

VirtualMachineType

Spécifie le type de virtualisation d’un ordinateur.

Accuracy

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

Name Type Description
actual
  • string
estimated
  • string

AgentConfiguration

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

Name Type Description
agentId
  • string

Identificateur unique de l’agent de Service de contrôle d’intégrité.

clockGranularity
  • integer

Granularité de l’horloge de l’ordinateur en millisecondes.

dependencyAgentId
  • string

Dependency Agent identificateur unique.

dependencyAgentRevision
  • string

Numéro de révision Dependency Agent.

dependencyAgentVersion
  • string

Numéro de version du Dependency Agent.

rebootStatus

Spécifie si l’ordinateur a été redémarré depuis l’installation de Dependency Agent.

AzureCloudServiceConfiguration

Décrit un service Cloud Azure

Name Type Description
deployment
  • string

Identificateur de déploiement du service Cloud

instanceId
  • string

Identificateur de l’instance du service Cloud

name
  • string

Nom du service cloud

roleName
  • string

Nom de rôle Cloud Service

roleType

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

AzureCloudServiceRoleType

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

Name Type Description
unknown
  • string
web
  • string
worker
  • string

AzureHostingConfiguration

Fournit des informations sur la façon dont un ordinateur est hébergé dans Azure

Name Type Description
cloudService

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

Image de l’ordinateur.

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

Contient des informations sur les ordinateurs 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

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

Name 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

Name Type Description
deployment
  • string

Identificateur de déploiement du groupe de machines virtuelles identiques

instanceId
  • string

Identificateur d’instance de 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 nombre de bits d’un ordinateur ou d’un processus.

Name Type Description
32bit
  • string
64bit
  • string

Error

Détails de l’erreur.

Name 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.

Name Type Description
error

Informations sur l’erreur.

HypervisorConfiguration

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

Name Type Description
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’un ordinateur.

Name Type Description
hyperv
  • string
unknown
  • string

ImageConfiguration

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

Name 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.

Name Type Description
ipAddress
  • string

Adresse IPv4.

subnetMask
  • string

Masque de sous-réseau IPv4.

Ipv6NetworkInterface

Décrit une interface réseau IPv6.

Name Type Description
ipAddress
  • string

Adresse IPv6.

Machine

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

Name 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

Configuration de Dependency Agent.

properties.bootTime
  • string

Date et heure UTC auxquelles l’ordinateur a démarré pour la dernière fois

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:

Configuration liée à l’hébergement. Présent si les informations d’hébergement sont découvertes pour la machine virtuelle.

properties.hypervisor

Configuration liée à l’hyperviseur. Présent uniquement lorsque « virtualizationState » est hypervisor .

properties.monitoringState

Spécifie si l’ordinateur est activement surveillé ou découvert.

properties.networking

Configuration réseau (IPS, passerelles, DNS, etc.)

properties.operatingSystem

Informations sur le système d’exploitation.

properties.resources

Ressources de l’ordinateur (mémoire, UC, etc.).

properties.timestamp
  • string

Date et heure UTC auxquelles cette ressource a été mise à jour dans le système.

properties.timezone

Fuseau horaire de la machine.

properties.virtualMachine

Configuration liée à la virtualisation. Présent uniquement lorsque virtualizationState est virtual .

properties.virtualizationState

Spécifie si l’ordinateur est virtualisé.

type
  • string

Type de ressource.

MachineRebootStatus

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

Name Type Description
notRebooted
  • string
rebooted
  • string
unknown
  • string

MachineResourcesConfiguration

Décrit les ressources d’un ordinateur.

Name Type Description
cpuSpeed
  • integer

Vitesse du processeur en mégahertz (MHz).

cpuSpeedAccuracy

Décrit la précision du champ cpuSpeed.

cpus
  • integer

Nombre de processeurs.

physicalMemory
  • integer

Mémoire physique en mégaoctets (Mo).

MonitoringState

Utilisé pour spécifier si une ressource est analysée ou découverte.

Name Type Description
discovered
  • string
monitored
  • string

NetworkConfiguration

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

Name Type Description
defaultIpv4Gateways
  • string[]

Passerelles IPv4 par défaut.

dnsNames
  • string[]

Noms DNS associés à l’ordinateur.

ipv4Interfaces

Interfaces IPv4.

ipv6Interfaces

Interfaces IPv6.

macAddresses
  • string[]

Adresses MAC de toutes les interfaces réseau actives.

OperatingSystemConfiguration

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

Name Type Description
bitness

Nombre de bits du système d’exploitation (32 bits ou 64 bits).

family

Windows, Linux, etc.

fullName
  • string

Nom complet du système d’exploitation.

OperatingSystemFamily

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

Name Type Description
aix
  • string
linux
  • string
solaris
  • string
unknown
  • string
windows
  • string

Timezone

Décrit un fuseau horaire.

Name Type Description
fullName
  • string

Nom complet du fuseau horaire.

VirtualizationState

Spécifie si l’ordinateur est physique, virtuel, hyperviseur ou inconnu.

Name Type Description
hypervisor
  • string
physical
  • string
unknown
  • string
virtual
  • string

VirtualMachineConfiguration

Décrit la configuration de la virtualisation d’un ordinateur.

Name Type Description
nativeHostMachineId
  • string

Identificateur unique de l’hôte de cet ordinateur virtuel signalé par le système de virtualisation sous-jacent.

nativeMachineId
  • string

Identificateur unique de l’ordinateur virtuel signalé par le système de virtualisation sous-jacent.

virtualMachineName
  • string

Nom de la machine virtuelle.

virtualMachineType

Spécifie la technologie de virtualisation utilisée par l’ordinateur (HyperV, VMware, etc.)

VirtualMachineType

Spécifie le type de virtualisation d’un ordinateur.

Name Type Description
hyperv
  • string
ldom
  • string
lpar
  • string
unknown
  • string
virtualPc
  • string
vmware
  • string
xen
  • string