Type de ressource hostPair

Espace de noms : microsoft.graph.security

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Remarque

L’API Microsoft Graph pour Microsoft Defender Threat Intelligence nécessite une licence active du portail Defender Threat Intelligence et une licence de module complémentaire d’API pour le locataire.

Représente une paire d’hôtes parent-enfant dans lesquelles l’hôte enfant peut être atteint via l’hôte parent. Par exemple, si contoso.com redirige vers microsoft.com, contoso.com serait l’hôte parent et microsoft.com l’hôte enfant.

Les relations de paire d’hôtes partagées à un point antérieur ou partagent actuellement une connexion observée à partir d’une analyse Microsoft. Un hôte parent mène à l’hôte enfant par le biais d’une simple redirection de niveau supérieur (HTTP 302), ou quelque chose de plus complexe comme une référence de source d’iframe ou de script. Dans d’autres cas, une analyse web peut révéler des comportements étranges tels que des relations de paire d’hôtes entre des adresses IP et des domaines/hôtes qui vont à l’encontre des normes DNS.

La propriété linkKind indique la raison pour laquelle les hôtes sont identifiés comme une paire parent-enfant. Il peut redirects’agir, par exemple, de .

Pour plus d’informations sur les paires d’hôtes, consultez la documentation Microsoft Defender Threat Intelligence pour les jeux de données.

Méthodes

Méthode	Type de retour	Description
Obtenir	microsoft.graph.security.hostPair	Lisez les propriétés et les relations d’un objet hostPair .
Liste d’un hôte	collection microsoft.graph.security.hostPair	Obtenez la liste des objets hostPair associés à un hôte spécifié, où l’hôte est le parent ou l’enfant .
Liste d’un hôte en tant qu’enfant	collection microsoft.graph.security.hostPair	Obtenez la liste des objets hostPair associés à un hôte, où cet hôte est l’enfant et a un appairage entrant avec un parent.
Liste d’un hôte en tant que parent	collection microsoft.graph.security.hostPair	Obtenez la liste des objets hostPair associés à un hôte, où cet hôte est le parent et a un appairage sortant avec un enfant.

Propriétés

Propriété	Type	Description
firstSeenDateTime	DateTimeOffset	Première date et heure auxquelles Microsoft Defender Threat Intelligence a observé le hostPair. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z.
id	Chaîne	ID généré par le système pour hostPair.
lastSeenDateTime	DateTimeOffset	Date et heure de la dernière observation de HostPair par Microsoft Defender Threat Intelligence. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2014 est 2014-01-01T00:00:00Z.
linkKind	Chaîne	Raison pour laquelle deux hôtes sont identifiés comme hostPair.

Relations

Relation	Type	Description
childHost	microsoft.graph.security.host	Hôte atteint via parentHost.
parentHost	microsoft.graph.security.host	Hôte utilisé pour atteindre l’enfantHost.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.security.hostPair",
  "id": "String (identifier)",
  "firstSeenDateTime": "String (timestamp)",
  "lastSeenDateTime": "String (timestamp)",
  "linkKind": "String",
  "parentHost": {
    "@odata.type": "#microsoft.graph.security.host",
    "id": "String (identifier)"
  },
  "childHost": {
    "@odata.type": "#microsoft.graph.security.host",
    "id": "String (identifier)"
  }
}