hostPair-Ressourcentyp

Namespace: microsoft.graph.security

Wichtig

Die APIs unter der /beta Version in Microsoft Graph können sich ändern. Die Verwendung dieser APIs in Produktionsanwendungen wird nicht unterstützt. Um festzustellen, ob eine API in v1.0 verfügbar ist, verwenden Sie die Version Selektor.

Hinweis

Die Microsoft Graph-API für Microsoft Defender Threat Intelligence erfordert eine aktive Defender Threat Intelligence Portal-Lizenz und eine API-Add-On-Lizenz für den Mandanten.

Stellt ein Paar von über- und untergeordneten Hosts dar, bei dem der untergeordnete Host über den übergeordneten Host erreicht werden kann. Wenn contoso.com beispielsweise an microsoft.com umleitet, ist contoso.com der übergeordnete Host und microsoft.com der untergeordnete Host.

Hostpaarbeziehungen, die zu einem früheren Zeitpunkt freigegeben wurden, oder derzeit gemeinsam eine Verbindung, die von einer Microsoft-Durchforstung beobachtet wurde. Ein übergeordneter Host führt zum untergeordneten Host möglicherweise über eine einfache Umleitung auf oberster Ebene (HTTP 302) oder etwas komplexeres wie einen iframe- oder Skriptquellenverweis. In anderen Fällen kann eine Webdurchforstung ungewöhnliche Verhaltensweisen aufdecken, z. B. Hostpaarbeziehungen zwischen IP-Adressen und Domänen/Hosts, die den DNS-Standards entsprechen.

Die linkKind-Eigenschaft stellt den Grund für die Identifizierung der Hosts als Über-/Unterordnungspaar fest. Ein Beispiel hierfür ist redirect.

Weitere Informationen zu Hostpaaren finden Sie in der Microsoft Defender Threat Intelligence-Dokumentation für Datasets.

Methoden

Methode	Rückgabetyp	Beschreibung
Get	microsoft.graph.security.hostPair	Liest die Eigenschaften und Beziehungen eines hostPair-Objekts .
Liste für einen Host	microsoft.graph.security.hostPair-Sammlung	Ruft eine Liste der hostPair-Objekte ab, die einem angegebenen Host zugeordnet sind, wobei der Host entweder das übergeordnete oder untergeordnete Element ist.
Liste für einen Host als untergeordnetes Element	microsoft.graph.security.hostPair-Sammlung	Ruft eine Liste der hostPair-Objekte ab, die einem Host zugeordnet sind, wobei dieser Host das untergeordnete Element ist und eine eingehende Kopplung mit einem übergeordneten Element aufweist.
Liste für einen Host als übergeordnetes Element	microsoft.graph.security.hostPair-Sammlung	Ruft eine Liste der hostPair-Objekte ab, die einem Host zugeordnet sind, wobei dieser Host das übergeordnete Element ist und eine ausgehende Kopplung mit einem untergeordneten Element aufweist.

Eigenschaften

Eigenschaft	Typ	Beschreibung
firstSeenDateTime	DateTimeOffset	Das erste Datum und die Uhrzeit, zu dem Microsoft Defender Threat Intelligence hostPair beobachtet haben. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
id	Zeichenfolge	Eine vom System generierte ID für hostPair.
lastSeenDateTime	DateTimeOffset	Das Datum und die Uhrzeit der letzten Beobachtung Microsoft Defender Threat Intelligence hostPair. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2014 ist beispielsweise 2014-01-01T00:00:00Z.
linkKind	Zeichenfolge	Der Grund, warum zwei Hosts als hostPair identifiziert werden.

Beziehungen

Beziehung	Typ	Beschreibung
childHost	microsoft.graph.security.host	Der Host wird über parentHost erreicht.
parentHost	microsoft.graph.security.host	Host, der verwendet wird, um den childHost zu erreichen.

JSON-Darstellung

Es folgt eine JSON-Darstellung der 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)"
  }
}