hostPair リソースの種類

名前空間: microsoft.graph.security

注:

Microsoft Graph API for Microsoft Defender Threat Intelligence には、テナントの アクティブな Defender 脅威インテリジェンス ポータル ライセンスと API アドオン ライセンス が必要です。

親ホストを介して子ホストに到達できる親子ホストのペアを表します。 たとえば、contoso.com が microsoft.com にリダイレクトする場合、contoso.com は親ホストを表し、子ホストを microsoft.com します。

以前の時点で共有されているホスト ペアのリレーションシップ、または現在、Microsoft クロールから観察された接続を共有します。 親ホストは、おそらく、単純な最上位レベルのリダイレクト (HTTP 302)、または iframe やスクリプト ソース参照のようなより複雑なものによって、子ホストに導きます。 他の場合、Web クロールによって、IP アドレスと DNS 標準に反するドメイン/ホスト間のホスト ペア関係などの奇妙な動作が表示されることがあります。

linkKind プロパティは、ホストを親子ペアとして識別する理由を示します。 その例として、 redirectがあります。

ホスト ペアの詳細については、 データ セットの Microsoft Defender 脅威インテリジェンスに関するドキュメントを参照してください。

メソッド

メソッド	戻り値の種類	説明
Get	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 です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
id	String	hostPair のシステム生成 ID。
lastSeenDateTime	DateTimeOffset	Microsoft Defender 脅威インテリジェンスが最後に hostPair を観察した日時。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
linkKind	String	2 つのホストが hostPair として識別される理由。

リレーションシップ

リレーションシップ	型	説明
childHost	microsoft.graph.security.host	parentHost を介して到達したホスト。
parentHost	microsoft.graph.security.host	childHost に到達するために使用されるホスト。

JSON 表記

次の JSON 表現は、リソースの種類を示しています。

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