hostPair リソースの種類
名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
注:
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",
"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)"
}
}