hostPair リソースの種類

  • [アーティクル]

名前空間: microsoft.graph.security

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

注:

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

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

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

linkKind プロパティは、ホストを親子ペアとして識別する理由を示します。 この例としては、 を指定できます redirect。

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

メソッド

メソッド 戻り値の種類 説明
hostPair を取得する microsoft.graph.security.hostPair hostPair オブジェクトのプロパティとリレーションシップを読み取ります。
ホストの hostPairs を一覧表示する microsoft.graph.security.hostPair コレクション ホストが親または子である、指定されたホストに関連付けられている hostPair オブジェクトの一覧を取得します。
ホストの parentHostPairs を子として一覧表示する microsoft.graph.security.hostPair コレクション ホストに関連付けられている hostPair オブジェクトの一覧を取得します。ここで、そのホストは 子 であり、 親との着信ペアリングがあります。
ホストの childHostPairs を親として一覧表示する microsoft.graph.security.hostPair コレクション ホストに関連付けられている hostPair オブジェクトの一覧を取得します。ここで、そのホストは 親 であり、 子への発信ペアリングがあります。

プロパティ

プロパティ 型 説明
firstSeenDateTime DateTimeOffset hostPair を観察Microsoft Defender 脅威インテリジェンス最初の日付と時刻。 タイムスタンプの種類は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC です。 たとえば、2014 年 1 月 1 日の午前 0 時 UTC は 2014-01-01T00:00:00Z です。
id String hostPair のシステム生成 ID。
lastSeenDateTime DateTimeOffset hostPair を観察Microsoft Defender 脅威インテリジェンス最後の日時。 タイムスタンプの種類は、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",
  "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)"
  }
}