[SEC-2514]add documentation to keepAlive and evaluationWindow (#1725)

Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-07-26 19:06:12.505492",
-            "spec_repo_commit": "44cf4afe"
+            "regenerated": "2024-07-30 17:01:11.256926",
+            "spec_repo_commit": "4380003d"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-07-26 19:06:12.524483",
-            "spec_repo_commit": "44cf4afe"
+            "regenerated": "2024-07-30 17:01:11.275395",
+            "spec_repo_commit": "4380003d"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -18006,7 +18006,8 @@ components:
       description: 'A time window is specified to match when at least one of the cases
         matches true. This is a sliding window
 
-        and evaluates in real time.'
+        and evaluates in real time. For third party rules, it should equal max signal
+        duration.'
       enum:
       - 0
       - 60
@@ -18050,7 +18051,8 @@ components:
       type: boolean
     SecurityMonitoringRuleKeepAlive:
       description: "Once a signal is generated, the signal will remain \u201Copen\u201D
-        if a case is matched at least once within\nthis keep alive window."
+        if a case is matched at least once within\nthis keep alive window. For third
+        party rules, it should equal max signal duration."
       enum:
       - 0
       - 60

packages/datadog-api-client-v2/models/SecurityMonitoringRuleEvaluationWindow.ts

@@ -8,7 +8,7 @@ import { UnparsedObject } from "../../datadog-api-client-common/util";
 
 /**
  * A time window is specified to match when at least one of the cases matches true. This is a sliding window
- * and evaluates in real time.
+ * and evaluates in real time. For third party rules, it should equal max signal duration.
  */
 
 export type SecurityMonitoringRuleEvaluationWindow =

packages/datadog-api-client-v2/models/SecurityMonitoringRuleKeepAlive.ts

@@ -8,7 +8,7 @@ import { UnparsedObject } from "../../datadog-api-client-common/util";
 
 /**
  * Once a signal is generated, the signal will remain “open” if a case is matched at least once within
- * this keep alive window.
+ * this keep alive window. For third party rules, it should equal max signal duration.
  */
 
 export type SecurityMonitoringRuleKeepAlive =

packages/datadog-api-client-v2/models/SecurityMonitoringRuleOptions.ts

@@ -36,7 +36,7 @@ export class SecurityMonitoringRuleOptions {
   "detectionMethod"?: SecurityMonitoringRuleDetectionMethod;
   /**
    * A time window is specified to match when at least one of the cases matches true. This is a sliding window
-   * and evaluates in real time.
+   * and evaluates in real time. For third party rules, it should equal max signal duration.
    */
   "evaluationWindow"?: SecurityMonitoringRuleEvaluationWindow;
   /**
@@ -49,7 +49,7 @@ export class SecurityMonitoringRuleOptions {
   "impossibleTravelOptions"?: SecurityMonitoringRuleImpossibleTravelOptions;
   /**
    * Once a signal is generated, the signal will remain “open” if a case is matched at least once within
-   * this keep alive window.
+   * this keep alive window. For third party rules, it should equal max signal duration.
    */
   "keepAlive"?: SecurityMonitoringRuleKeepAlive;
   /**