名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
セキュリティ検出アラートで報告された AI エージェントを表します。
alertEvidence から継承します。
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| agentId | 文字列 | AI エージェントの一意識別子。 |
| agentName | 文字列 | AI エージェントの表示名。 |
| createdDateTime | DateTimeOffset | 証拠が作成され、アラートに追加された日時。 Timestamp 型は、ISO 8601 形式を使用して日付と時刻の情報を表し、常に UTC 時間です。 たとえば、2014 年 1 月 1 日午前 0 時 (UTC) は、2014-01-01T00:00:00Z です。
alertEvidence から継承されます。 |
| detailedRoles | String collection | アラート内のエンティティ ロールの詳細な説明。 値は自由形式です。 alertEvidence から継承されます。 |
| hostingPlatformType | microsoft.graph.security.aiAgentPlatform | エージェントが実行されるプラットフォームの種類。 使用可能な値: unknown、azureAIFoundry、copilotStudio、copilot、unknownFutureValue。 |
| 手順 | 文字列 | エージェントの指示。 |
| remediationStatus | microsoft.graph.security.evidenceRemediationStatus | 実行された修復アクションの状態。 有効な値は、 none、 remediated、 prevented、 blocked、 notFound、 unknownFutureValue、 active、 pendingApproval、 declined、 unremediated、 running、 partiallyRemediated です。
Prefer: include-unknown-enum-members 要求ヘッダーを使用して、この進化可能な列挙型から active、pendingApproval、declined、unremediated、running、partiallyRemediated の値を取得します。
alertEvidence から継承されます。 |
| remediationStatusDetails | 文字列 | 修復状態に関する詳細。 alertEvidence から継承されます。 |
| roles | microsoft.graph.security.evidenceRole コレクション | 証拠エンティティがアラートで表す 1 つ以上のロール。たとえば、攻撃者に関連付けられている IP アドレスには証拠ロール Attackerがあります。
alertEvidence から継承されます。 |
| tags | String collection | 証拠インスタンスに関連付けられているカスタム タグの配列。たとえば、デバイスのグループや価値の高い資産を示す場合などです。 alertEvidence から継承されます。 |
| 評決 | microsoft.graph.security.evidenceVerdict | 自動調査によって到達した決定。 使用可能な値: unknown、suspicious、malicious、noThreatsFound、unknownFutureValue。
alertEvidence から継承されます。 |
aiAgentPlatform の値
| メンバー | 説明 |
|---|---|
| 不明 | プラットフォームの値が不明であるか、指定されていません。 |
| azureAIFoundry | プラットフォーム値は Azure AI Foundry です。 |
| copilotStudio | プラットフォーム値は Copilot Studio です。 |
| Copilot | プラットフォーム値は Copilot です。 |
| unknownFutureValue | 進化可能な列挙値。 使用しないでください。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.aiAgentEvidence",
"agentId": "String",
"agentName": "String",
"createdDateTime": "String (timestamp)",
"detailedRoles": ["String"],
"hostingPlatformType": "String",
"instructions": "String",
"remediationStatus": "String",
"remediationStatusDetails": "String",
"roles": ["String"],
"tags": ["String"],
"verdict": "String"
}