Regenerate client from commit 4ec899ff of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-02-10 19:09:34.070491",
-            "spec_repo_commit": "824f78a1"
+            "regenerated": "2025-02-11 15:13:45.958243",
+            "spec_repo_commit": "4ec899ff"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-02-10 19:09:34.086424",
-            "spec_repo_commit": "824f78a1"
+            "regenerated": "2025-02-11 15:13:45.973640",
+            "spec_repo_commit": "4ec899ff"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -12683,6 +12683,30 @@ components:
             $ref: '#/components/schemas/GetInterfacesData'
           type: array
       type: object
+    GetRuleVersionHistoryData:
+      description: Data for the rule version history.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/RuleVersionHistory'
+        id:
+          description: ID of the rule.
+          type: string
+        type:
+          $ref: '#/components/schemas/GetRuleVersionHistoryDataType'
+      type: object
+    GetRuleVersionHistoryDataType:
+      description: Type of data.
+      enum:
+      - GetRuleVersionHistoryResponse
+      type: string
+      x-enum-varnames:
+      - GETRULEVERSIONHISTORYRESPONSE
+    GetRuleVersionHistoryResponse:
+      description: Response for getting the rule version history.
+      properties:
+        data:
+          $ref: '#/components/schemas/GetRuleVersionHistoryData'
+      type: object
     GetSBOMResponse:
       description: The expected response schema when getting an SBOM.
       properties:
@@ -23245,6 +23269,57 @@ components:
           example: John Doe
           type: string
       type: object
+    RuleVersionHistory:
+      description: Response object containing the version history of a rule.
+      properties:
+        count:
+          description: The number of rule versions.
+          format: int32
+          maximum: 2147483647
+          type: integer
+        data:
+          additionalProperties:
+            $ref: '#/components/schemas/RuleVersions'
+            description: A rule version with a list of updates.
+          description: The `RuleVersionHistory` `data`.
+          type: object
+      type: object
+    RuleVersionUpdate:
+      description: A change in a rule version.
+      properties:
+        change:
+          description: The new value of the field.
+          example: cloud_provider:aws
+          type: string
+        field:
+          description: The field that was changed.
+          example: Tags
+          type: string
+        type:
+          $ref: '#/components/schemas/RuleVersionUpdateType'
+      type: object
+    RuleVersionUpdateType:
+      description: The type of change.
+      enum:
+      - create
+      - update
+      - delete
+      type: string
+      x-enum-varnames:
+      - CREATE
+      - UPDATE
+      - DELETE
+    RuleVersions:
+      description: A rule version with a list of updates.
+      properties:
+        changes:
+          description: A list of changes.
+          items:
+            $ref: '#/components/schemas/RuleVersionUpdate'
+          type: array
+        rule:
+          $ref: '#/components/schemas/SecurityMonitoringRuleResponse'
+      type: object
     RumMetricCompute:
       description: The compute rule to compute the rum-based metric.
       properties:
@@ -45631,6 +45706,42 @@ paths:
         operator: OR
         permissions:
         - security_monitoring_rules_write
+  /api/v2/security_monitoring/rules/{rule_id}/version_history:
+    get:
+      description: Get a rule's version history.
+      operationId: GetRuleVersionHistory
+      parameters:
+      - $ref: '#/components/parameters/SecurityMonitoringRuleID'
+      - $ref: '#/components/parameters/PageSize'
+      - $ref: '#/components/parameters/PageNumber'
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/GetRuleVersionHistoryResponse'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '404':
+          $ref: '#/components/responses/NotFoundResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - security_monitoring_rules_read
+      summary: Get a rule's version history
+      tags:
+      - Security Monitoring
+      x-permission:
+        operator: OR
+        permissions:
+        - security_monitoring_rules_read
+      x-unstable: '**Note**: This endpoint is in beta and may be subject to changes.'
   /api/v2/security_monitoring/signals:
     get:
       description: 'The list endpoint returns security signals that match a search

cassettes/features/v2/security_monitoring/Get-rule-version-history-returns-OK-response.frozen

@@ -0,0 +1 @@
+2025-02-04T22:39:17.325Z

cassettes/features/v2/security_monitoring/Get-rule-version-history-returns-OK-response.yml

@@ -0,0 +1,8 @@
+# Get a rule's version history returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.get_rule_version_history".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+p api_instance.get_rule_version_history("rule_id")

examples/v2/security-monitoring/GetRuleVersionHistory.rb

@@ -0,0 +1,11 @@
+# Get rule version history returns "OK" response
+
+require "datadog_api_client"
+DatadogAPIClient.configure do |config|
+  config.unstable_operations["v2.get_rule_version_history".to_sym] = true
+end
+api_instance = DatadogAPIClient::V2::SecurityMonitoringAPI.new
+
+# there is a valid "security_rule" in the system
+SECURITY_RULE_ID = ENV["SECURITY_RULE_ID"]
+p api_instance.get_rule_version_history(SECURITY_RULE_ID)

examples/v2/security-monitoring/GetRuleVersionHistory_2467565841.rb

@@ -1978,6 +1978,11 @@
             "rule_id" => "String",
             "body" => "SecurityMonitoringRuleTestRequest",
     },
+    "v2.GetRuleVersionHistory" => {
+            "rule_id" => "String",
+            "page_size" => "Integer",
+            "page_number" => "Integer",
+    },
     "v2.ListSecurityMonitoringSignals" => {
             "filter_query" => "String",
             "filter_from" => "Time",

features/scenarios_model_mapping.rb

@@ -589,6 +589,30 @@ Feature: Security Monitoring
     And the response "name" is equal to "{{ unique }}"
     And the response "id" has the same value as "security_rule.id"
 
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a rule's version history returns "Bad Request" response
+    Given operation "GetRuleVersionHistory" enabled
+    And new "GetRuleVersionHistory" request
+    And request contains "rule_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a rule's version history returns "Not Found" response
+    Given operation "GetRuleVersionHistory" enabled
+    And new "GetRuleVersionHistory" request
+    And request contains "rule_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/k9-cloud-security-platform
+  Scenario: Get a rule's version history returns "OK" response
+    Given operation "GetRuleVersionHistory" enabled
+    And new "GetRuleVersionHistory" request
+    And request contains "rule_id" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/k9-cloud-security-platform
   Scenario: Get a security filter returns "Not Found" response
     Given new "GetSecurityFilter" request
@@ -698,6 +722,19 @@ Feature: Security Monitoring
     When the request is sent
     Then the response status is 200 Notification rule details.
 
+  @skip-go @skip-java @skip-ruby @team:DataDog/k9-cloud-security-platform
+  Scenario: Get rule version history returns "OK" response
+    Given operation "GetRuleVersionHistory" enabled
+    And new "GetRuleVersionHistory" request
+    And there is a valid "security_rule" in the system
+    And request contains "rule_id" parameter from "security_rule.id"
+    When the request is sent
+    Then the response status is 200 OK
+    And the response "data.id" has the same value as "security_rule.id"
+    And the response "data.type" is equal to "GetRuleVersionHistoryResponse"
+    And the response "data.attributes.count" is equal to 1
+    And the response "data.attributes.data[1].rule.name" has the same value as "security_rule.name"
+
   @team:DataDog/cloud-security-posture-management
   Scenario: Get the list of signal-based notification rules returns "The list of notification rules." response
     Given there is a valid "valid_signal_notification_rule" in the system

features/v2/security_monitoring.feature

@@ -2362,6 +2362,12 @@
       "type": "idempotent"
     }
   },
+  "GetRuleVersionHistory": {
+    "tag": "Security Monitoring",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "ListSecurityMonitoringSignals": {
     "tag": "Security Monitoring",
     "undo": {

features/v2/undo.json

@@ -243,6 +243,7 @@ def initialize
             "v2.delete_historical_job": false,
             "v2.get_finding": false,
             "v2.get_historical_job": false,
+            "v2.get_rule_version_history": false,
             "v2.list_findings": false,
             "v2.list_historical_jobs": false,
             "v2.mute_findings": false,