Тип ресурса hostPair

  • Статья

Пространство имен: microsoft.graph.security

Примечание.

Для microsoft API Graph для Аналитика угроз Microsoft Defender требуется активная лицензия на портал аналитики угроз в Defender и лицензия на надстройку API для клиента.

Представляет пару родительских и дочерних узлов, к которым к дочернему узлу можно связаться через родительский узел. Например, если contoso.com перенаправляет на microsoft.com, то contoso.com представляет родительский узел и microsoft.com дочерний узел.

Связи пар узлов, совместно используемые в более ранней точке, или в настоящее время совместно используют подключение, наблюдаемое из обхода контента Майкрософт. Родительский узел ведет к дочернему узлу, возможно, через простое перенаправление верхнего уровня (HTTP 302) или что-то более сложное, например iframe или исходная ссылка на скрипт. В других случаях при обходе веб-страниц может быть выявлено нечетное поведение, например связи пар узлов между IP-адресами и доменами или узлами, которые соответствуют стандартам DNS.

Свойство linkKind указывает причину определения узлов в качестве пары "родители-потомки". Примером может быть redirect.

Дополнительные сведения о парах узлов см. в документации по Аналитика угроз Microsoft Defender для наборов данных.

Методы

Метод Тип возвращаемых данных Описание
Получение hostPair microsoft.graph.security.hostPair Чтение свойств и связей объекта hostPair .
Перечисление hostPairs для узла Коллекция microsoft.graph.security.hostPair Получите список объектов hostPair , связанных с указанным узлом, где узел является родительским или дочерним.
Вывод списка parentHostPairs для узла в качестве дочернего Коллекция microsoft.graph.security.hostPair Получите список объектов hostPair , связанных с узлом, где этот узел является дочерним и имеет входящее связывание с родительским элементом.
Вывод списка дочернихHostPairs для узла в качестве родительского элемента Коллекция microsoft.graph.security.hostPair Получите список объектов hostPair , связанных с узлом, где этот узел является родительским и имеет исходящее связывание с дочерним.

Свойства

Свойство Тип Описание
firstSeenDateTime DateTimeOffset Дата и время, когда Аналитика угроз Microsoft Defender впервые заметил hostPair. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
id String Идентификатор, созданный системой для hostPair.
lastSeenDateTime DateTimeOffset Дата и время последнего наблюдения Аналитика угроз Microsoft Defender hostPair. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, значение полуночи 1 января 2014 г. в формате UTC: 2014-01-01T00:00:00Z.
linkKind String Причина, по которой два узла определены как hostPair.

Связи

Связь Тип Описание
childHost microsoft.graph.security.host Узел достигнут через parentHost.
parentHost microsoft.graph.security.host Узел, используемый для доступа к дочернему Узлу.

Представление JSON

Ниже указано представление ресурса в формате JSON.

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