名前空間: microsoft.graph
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
さまざまなシグナルと機械学習に基づいてMicrosoft Entra ID Protection によって評価される、危険にさらされているMicrosoft Entra エージェントを表します。 この API は、Microsoft Entra テナント内のすべての危険なエージェントへのプログラムによるアクセスを提供します。@odata.type は、このエージェントの正確な種類を示します。 サポートされる型は riskyAgentIdentity、 riskyAgentIdentityBlueprintPrincipal、 riskyAgentUser です。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | riskyAgent コレクション | riskyAgent オブジェクトとそのプロパティの一覧を取得します。 |
| Get | riskyAgent | riskyAgent オブジェクトのプロパティとリレーションシップを読み取ります。 |
| Dismiss | なし | 1 つ以上の riskyAgent オブジェクトのリスクを無視します。 |
| 侵害ありと確認する | なし | 1 つ以上の riskyAgent オブジェクトが侵害されていることを確認します。 |
| 安全を確認する | なし | 1 つ以上の riskyAgent オブジェクトを安全であることを確認します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| agentDisplayName | 文字列 | エージェントの名前。 $filter (eq、startsWith) をサポートします。 |
| id | 文字列 |
riskyAgentIdentity、riskyAgentIdentityBlueprintPrincipal、または riskyAgentUser のオブジェクト ID。
エンティティから継承 されます。 $filter (eq、startsWith) をサポートします。 |
| isDeleted | ブール型 | エージェントが削除されるかどうかを示します。 |
| isEnabled | ブール値 | エージェントが有効かどうかを示します。 |
| isProcessing | ブール型 | エージェントの危険な状態がバックエンドで処理されているかどうかを示します。 |
| riskDetail | riskDetail | エージェントの検出されたリスクの詳細。 $filter (eq)をサポートしています。 |
| riskLastModifiedDateTime | DateTimeOffset | 危険なエージェントが最後に更新された日時。 DateTimeOffset 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日の午前 0 時 UTC は 2014-01-01T00:00:00Z です。 $filter (eq、le、ge) をサポートします。 |
| riskLevel | riskLevel | 検出された危険なエージェントのレベル。 使用可能な値: low、medium、high、hidden、none、unknownFutureValue。 $filter (eq)をサポートしています。 |
| riskState | riskState | エージェントのリスクの状態。 使用可能な値: none、confirmedSafe、dismissed、atRisk、confirmedCompromised、unknownFutureValue。 $filter (eq)をサポートしています。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.riskyAgent",
"id": "String (identifier)",
"agentDisplayName": "String",
"isDeleted": "Boolean",
"isEnabled": "Boolean",
"isProcessing": "Boolean",
"riskLastModifiedDateTime": "String (timestamp)",
"riskState": "String",
"riskLevel": "String",
"riskDetail": "String"
}