Тип ресурса hostPair

Статья
10/04/2023

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

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Примечание.

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

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

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

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

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

Методы

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

Свойства

Свойство	Тип	Описание
firstSeenDateTime	DateTimeOffset	Первая дата и время, когда Аналитика угроз Microsoft Defender наблюдал hostPair. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. — 2014-01-01T00:00:00Z.
id	String	Идентификатор, созданный системой для hostPair.
lastSeenDateTime	DateTimeOffset	Последняя дата и время, когда Аналитика угроз Microsoft Defender наблюдал hostPair. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2014 г. — 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",
  "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)"
  }
}

Поделиться через