detectionRule リソースの種類

名前空間: microsoft.graph.security

セキュリティ イベントの発生時にセキュリティ イベントを自動的に認識し、アラートと対応アクションをトリガーするために、 高度な捜索 で記述されたカスタム検出ルールを表します。

カスタム検出ルールを使用すると、 高度な捜索 クエリ (疑わしい侵害アクティビティや誤って構成されたエンドポイントなど) を使用して、さまざまなイベントやシステム状態を事前に監視できます。 カスタム検出ルールを使用すると、セキュリティ イベントが発生したときに自動的に認識され、アラートと応答アクションがトリガーされます。 一定の間隔で実行するようにルールを設定し、一致するたびにアラートを生成し、対応アクションを実行できます。

エンティティ から継承します。

メソッド

メソッド 戻り値の種類 説明
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) をサポートします。
detectionAction microsoft.graph.security.detectionAction このルールによって検出が行われたときに実行されるアクション (作成されたアラートと自動応答アクションなど)。 次の入れ子になった alertTemplate プロパティの$filterをサポートします。
  • 文字列: detectionAction/alertTemplate/title、 detectionAction/alertTemplate/description、 detectionAction/alertTemplate/recommendedActions — それぞれ eq、 ne、 not、 in、 startsWith、 endsWith、 contains をサポートしています。
  • 列挙型: detectionAction/alertTemplate/severity — eq、 ne、 not、 in をサポートします。
  • 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をサポートします。 スケジュール/頻度で$orderbyをサポートします。
    status microsoft.graph.security.detectionRuleStatus ルールの現在の実行状態。 使用可能な値: enabled、disabled、autoDisabled、unknownFutureValue。 $filter (eq、ne、not、in) と$orderbyをサポートします。

    リレーションシップ

    なし。

    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"
      }
    }