名前空間: 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) をサポートします。 |
| blueprintId | 文字列 | エージェントに関連付けられている ブループリント の識別子。 Null 許容型。 |
| id | 文字列 |
riskyAgentIdentity、riskyAgentIdentityBlueprintPrincipal、または riskyAgentUser のオブジェクト ID。
エンティティから継承 されます。 $filter (eq、startsWith) をサポートします。 |
| identityType | agentIdentityType | エージェント ID の種類。 使用可能な値: agentIdentity、agentUser、unknownFutureValue、agentIdentityBlueprintPrincipal。 この進化可能な列挙値を取得するには、 Prefer: include-unknown-enum-members 要求ヘッダーを使用する必要があります: agentIdentityBlueprintPrincipal。 必須です。 $filter (eq)をサポートしています。 |
| 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",
"blueprintId": "String",
"identityType": "String",
"isDeleted": "Boolean",
"isEnabled": "Boolean",
"isProcessing": "Boolean",
"riskLastModifiedDateTime": "String (timestamp)",
"riskState": "String",
"riskLevel": "String",
"riskDetail": "String"
}