Regenerate client from commit 3d683e08 of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-22 15:54:08.561505",
-            "spec_repo_commit": "7a8ea4b1"
+            "regenerated": "2025-01-23 15:33:50.263552",
+            "spec_repo_commit": "3d683e08"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-22 15:54:08.576092",
-            "spec_repo_commit": "7a8ea4b1"
+            "regenerated": "2025-01-23 15:33:50.278037",
+            "spec_repo_commit": "3d683e08"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -12666,6 +12666,20 @@ components:
             $ref: '#/components/schemas/GetInterfacesData'
           type: array
       type: object
+    GetRuleVersionHistoryResponse:
+      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:
+          description: A list of rule versions.
+          items:
+            $ref: '#/components/schemas/RuleVersionHistory'
+          type: array
+      type: object
     GetSBOMResponse:
       description: The expected response schema when getting an SBOM.
       properties:
@@ -22930,6 +22944,42 @@ components:
       type: string
       x-enum-varnames:
       - RULE
+    RuleVersionHistory:
+      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
+    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
     RumMetricCompute:
       description: The compute rule to compute the rum-based metric.
       properties:
@@ -44751,6 +44801,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

docs/datadog_api_client.v2.model.rst

@@ -5233,6 +5233,13 @@ datadog\_api\_client.v2.model.get\_interfaces\_response module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.get\_rule\_version\_history\_response module
+--------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.get_rule_version_history_response
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.get\_sbom\_response module
 --------------------------------------------------------
 
@@ -9790,6 +9797,27 @@ datadog\_api\_client.v2.model.rule\_type module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.rule\_version\_history module
+-----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rule_version_history
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.rule\_version\_update module
+----------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rule_version_update
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.rule\_version\_update\_type module
+----------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.rule_version_update_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.rum\_aggregate\_bucket\_value module
 ------------------------------------------------------------------
 

examples/v2/security-monitoring/GetRuleVersionHistory.py

@@ -0,0 +1,16 @@
+"""
+Get a rule's version history returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.security_monitoring_api import SecurityMonitoringApi
+
+configuration = Configuration()
+configuration.unstable_operations["get_rule_version_history"] = True
+with ApiClient(configuration) as api_client:
+    api_instance = SecurityMonitoringApi(api_client)
+    response = api_instance.get_rule_version_history(
+        rule_id="rule_id",
+    )
+
+    print(response)

examples/v2/security-monitoring/GetRuleVersionHistory_2467565841.py

@@ -0,0 +1,19 @@
+"""
+Get rule version history returns "OK" response
+"""
+
+from os import environ
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.security_monitoring_api import SecurityMonitoringApi
+
+# there is a valid "security_rule" in the system
+SECURITY_RULE_ID = environ["SECURITY_RULE_ID"]
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = SecurityMonitoringApi(api_client)
+    response = api_instance.get_rule_version_history(
+        rule_id=SECURITY_RULE_ID,
+    )
+
+    print(response)

src/datadog_api_client/configuration.py

@@ -293,6 +293,7 @@ def __init__(
                 "v2.delete_historical_job": False,
                 "v2.get_finding": False,
                 "v2.get_historical_job": False,
+                "v2.get_rule_version_history": False,
                 "v2.get_sbom": False,
                 "v2.list_findings": False,
                 "v2.list_historical_jobs": False,

src/datadog_api_client/v2/api/security_monitoring_api.py

@@ -63,6 +63,7 @@
 from datadog_api_client.v2.model.security_monitoring_rule_validate_payload import SecurityMonitoringRuleValidatePayload
 from datadog_api_client.v2.model.cloud_configuration_rule_payload import CloudConfigurationRulePayload
 from datadog_api_client.v2.model.security_monitoring_rule_update_payload import SecurityMonitoringRuleUpdatePayload
+from datadog_api_client.v2.model.get_rule_version_history_response import GetRuleVersionHistoryResponse
 from datadog_api_client.v2.model.security_monitoring_signals_list_response import SecurityMonitoringSignalsListResponse
 from datadog_api_client.v2.model.security_monitoring_signals_sort import SecurityMonitoringSignalsSort
 from datadog_api_client.v2.model.security_monitoring_signal import SecurityMonitoringSignal
@@ -467,6 +468,39 @@ def __init__(self, api_client=None):
             api_client=api_client,
         )
 
+        self._get_rule_version_history_endpoint = _Endpoint(
+            settings={
+                "response_type": (GetRuleVersionHistoryResponse,),
+                "auth": ["apiKeyAuth", "appKeyAuth", "AuthZ"],
+                "endpoint_path": "/api/v2/security_monitoring/rules/{rule_id}/version_history",
+                "operation_id": "get_rule_version_history",
+                "http_method": "GET",
+                "version": "v2",
+            },
+            params_map={
+                "rule_id": {
+                    "required": True,
+                    "openapi_types": (str,),
+                    "attribute": "rule_id",
+                    "location": "path",
+                },
+                "page_size": {
+                    "openapi_types": (int,),
+                    "attribute": "page[size]",
+                    "location": "query",
+                },
+                "page_number": {
+                    "openapi_types": (int,),
+                    "attribute": "page[number]",
+                    "location": "query",
+                },
+            },
+            headers_map={
+                "accept": ["application/json"],
+            },
+            api_client=api_client,
+        )
+
         self._get_sbom_endpoint = _Endpoint(
             settings={
                 "response_type": (GetSBOMResponse,),
@@ -1669,6 +1703,36 @@ def get_historical_job(
 
         return self._get_historical_job_endpoint.call_with_http_info(**kwargs)
 
+    def get_rule_version_history(
+        self,
+        rule_id: str,
+        *,
+        page_size: Union[int, UnsetType] = unset,
+        page_number: Union[int, UnsetType] = unset,
+    ) -> GetRuleVersionHistoryResponse:
+        """Get a rule's version history.
+
+        Get a rule's version history.
+
+        :param rule_id: The ID of the rule.
+        :type rule_id: str
+        :param page_size: Size for a given page. The maximum allowed value is 100.
+        :type page_size: int, optional
+        :param page_number: Specific page number to return.
+        :type page_number: int, optional
+        :rtype: GetRuleVersionHistoryResponse
+        """
+        kwargs: Dict[str, Any] = {}
+        kwargs["rule_id"] = rule_id
+
+        if page_size is not unset:
+            kwargs["page_size"] = page_size
+
+        if page_number is not unset:
+            kwargs["page_number"] = page_number
+
+        return self._get_rule_version_history_endpoint.call_with_http_info(**kwargs)
+
     def get_sbom(
         self,
         asset_type: AssetType,

src/datadog_api_client/v2/model/get_rule_version_history_response.py

@@ -0,0 +1,57 @@
+# Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+# This product includes software developed at Datadog (https://www.datadoghq.com/).
+# Copyright 2019-Present Datadog, Inc.
+from __future__ import annotations
+
+from typing import List, Union, TYPE_CHECKING
+
+from datadog_api_client.model_utils import (
+    ModelNormal,
+    cached_property,
+    unset,
+    UnsetType,
+)
+
+
+if TYPE_CHECKING:
+    from datadog_api_client.v2.model.rule_version_history import RuleVersionHistory
+
+
+class GetRuleVersionHistoryResponse(ModelNormal):
+    validations = {
+        "count": {
+            "inclusive_maximum": 2147483647,
+        },
+    }
+
+    @cached_property
+    def openapi_types(_):
+        from datadog_api_client.v2.model.rule_version_history import RuleVersionHistory
+
+        return {
+            "count": (int,),
+            "data": ([RuleVersionHistory],),
+        }
+
+    attribute_map = {
+        "count": "count",
+        "data": "data",
+    }
+
+    def __init__(
+        self_, count: Union[int, UnsetType] = unset, data: Union[List[RuleVersionHistory], UnsetType] = unset, **kwargs
+    ):
+        """
+        Response object containing the version history of a rule.
+
+        :param count: The number of rule versions.
+        :type count: int, optional
+
+        :param data: A list of rule versions.
+        :type data: [RuleVersionHistory], optional
+        """
+        if count is not unset:
+            kwargs["count"] = count
+        if data is not unset:
+            kwargs["data"] = data
+        super().__init__(kwargs)