名前空間: microsoft.graph.security
重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
セキュリティ イベントの発生時にセキュリティ イベントを自動的に認識し、アラートと対応アクションをトリガーするために、 高度な捜索 で記述されたカスタム検出ルールを表します。
カスタム検出ルールを使用すると、 高度な捜索 クエリ (疑わしい侵害アクティビティや誤って構成されたエンドポイントなど) を使用して、さまざまなイベントやシステム状態を事前に監視できます。 カスタム検出ルールを使用すると、セキュリティ イベントが発生したときに自動的に認識され、アラートと応答アクションがトリガーされます。 一定の間隔で実行するようにルールを設定し、一致するたびにアラートを生成し、対応アクションを実行できます。
エンティティ から継承します。
メソッド
| メソッド | 戻り値の種類 | 説明 |
|---|---|---|
| List | microsoft.graph.security.detectionRule コレクション | detectionRule オブジェクトとそのプロパティのリストを取得します。 |
| Create | microsoft.graph.security.detectionRule | 新しい detectionRule オブジェクトを作成します。 |
| Get | microsoft.graph.security.detectionRule | detectionRule オブジェクトのプロパティと関係を読み取ります。 |
| Update | microsoft.graph.security.detectionRule | detectionRule オブジェクトのプロパティを更新します。 |
| Delete | なし | detectionRule オブジェクトを削除します。 |
プロパティ
| プロパティ | 型 | 説明 |
|---|---|---|
| createdBy | String | ルールを作成したユーザーまたはアプリケーションの名前。 読み取り専用です。
$filter (eq、ne、not、in、startsWith、endsWith、contains) をサポートします。 |
| createdDateTime | DateTimeOffset | ルール作成のタイムスタンプ。 読み取り専用です。
$filter (eq、ne、not、le、ge、lt、gt) と $orderby をサポートします。 |
| 説明 | String | ユーザーが指定した検出ルールの説明。
$filter (eq、ne、not、in、startsWith、endsWith、contains) をサポートします。 |
| displayName | String | ルールの表示名。
$filter (eq、ne、not、in、startsWith、endsWith、contains) と $orderby をサポートします。 |
| id | 文字列 | ルールの一意識別子。
エンティティから継承 されます。
$filter (eq、ne、not、in) と$orderbyをサポートします。 |
| lastModifiedBy | 文字列 | ルールを最後に更新したユーザーまたはアプリケーションの名前。 読み取り専用です。
$filter (eq、ne、not、in、startsWith、endsWith、contains) をサポートします。 |
| lastModifiedDateTime | DateTimeOffset | ルールが最後に更新されたときのタイムスタンプ。 読み取り専用です。
$filter (eq、ne、not、le、ge、lt、gt) と $orderby をサポートします。 |
| queryCondition | microsoft.graph.security.queryCondition | このルールの検出ロジックを定義する高度な捜索クエリ。
eq、ne、not、in、startsWith、endsWith、contains を使用して queryCondition/queryText (文字列) の$filterをサポートします。 |
| schedule | microsoft.graph.security.ruleSchedule | このルールのトリガー スケジュール。
eq、ne、not、le、ge、lt、gt を使用してスケジュール/頻度 (Duration) で$filterをサポートします。
schedule/frequency および schedule/nextRunDateTime の$orderbyをサポートします。 |
| status | microsoft.graph.security.detectionRuleStatus | ルールの現在の実行状態。 使用可能な値: enabled、disabled、autoDisabled、unknownFutureValue。
$filter (eq、ne、not、in) と$orderbyをサポートします。 |
| detectorId (非推奨) | 文字列 | 内部検出器識別子。 非推奨。 このプロパティは、2026-10-01 にこのリソースから削除されます。 |
| isEnabled (非推奨) | ブール型 | テナントに対してルールが有効になっているかどうかを示します。
$filter (eq、ne、not) をサポートします。 非推奨。 代わりに ステータス を使用してください。 このプロパティは、2026-10-01 にこのリソースから削除されます。 |
| detectionAction | microsoft.graph.security.detectionAction | このルールによって検出が行われたときに実行されるアクション (作成されたアラートと自動応答アクションなど)。 次の入れ子になった alertTemplate プロパティの$filterをサポートします。eq、 ne、 not、 in、 startsWith、 endsWith、 contains をサポートしています。eq、 ne、 not、 in をサポートします。 |
| lastRunDetails (非推奨) | microsoft.graph.security.runDetails | 最新のルール実行のランタイム実行の詳細。 次の入れ子になったプロパティの $filter をサポートします。eq、 ne、 not、 in、 startsWith、 endsWith、 contains をサポートします。eq、 ne、 not、 le、 ge、 lt、 gt をサポートします。eq、 ne、 not、 in をサポートしています。 |
リレーションシップ
なし。
JSON 表記
次の JSON 表現は、リソースの種類を示しています。
{
"@odata.type": "#microsoft.graph.security.detectionRule",
"id": "String (identifier)",
"displayName": "String",
"description": "String",
"status": "String",
"createdBy": "String",
"createdDateTime": "String (timestamp)",
"lastModifiedBy": "String",
"lastModifiedDateTime": "String (timestamp)",
"queryCondition": {
"@odata.type": "microsoft.graph.security.queryCondition"
},
"schedule": {
"@odata.type": "microsoft.graph.security.ruleSchedule"
},
"detectionAction": {
"@odata.type": "microsoft.graph.security.detectionAction"
},
"detectorId": "String",
"isEnabled": "Boolean",
"lastRunDetails": {
"@odata.type": "microsoft.graph.security.runDetails"
}
}