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
Microsoft API 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 redirect
s’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 hostPair | microsoft.graph.security.hostPair | Lisez les propriétés et les relations d’un objet hostPair . |
Répertorier les hostPairs pour 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 . |
Répertorier parentHostPairs pour 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. |
Répertorier childHostPairs pour 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 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 des dernières Microsoft Defender Threat Intelligence observées sur 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. |
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
Voici une représentation JSON de la 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)"
}
}
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour