add timeframe_type param for cost monitors (#2386)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-29 14:55:52.778358",
-            "spec_repo_commit": "14f5d952"
+            "regenerated": "2025-01-30 13:13:54.596747",
+            "spec_repo_commit": "833109b8"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2025-01-29 14:55:52.793962",
-            "spec_repo_commit": "14f5d952"
+            "regenerated": "2025-01-30 13:13:54.612098",
+            "spec_repo_commit": "833109b8"
         }
     }
 }

.generator/schemas/v1/openapi.yaml

@@ -29252,19 +29252,22 @@ paths:
         or the facet name you want to use.\n- `time_window` #m (between 1 and 2880),
         #h (between 1 and 48).\n- `operator` `<`, `<=`, `>`, `>=`, `==`, or `!=`.\n-
         `#` an integer or decimal number used to set the threshold.\n\n**Cost Alert
-        Query**\n\nExample: `formula(query).last(time_window).function(parameter)
+        Query**\n\nExample: `formula(query).timeframe_type(time_window).function(parameter)
         operator #`\n\n- `query` The search query - following the [Log search syntax](https://docs.datadoghq.com/logs/search_syntax/).\n-
-        `time_window` - supports daily roll-up e.g. `7d`\n- `function` - [optional,
-        defaults to `threshold` monitor if omitted] supports `change`, `anomaly`,
-        `forecast`\n- `parameter` Specify the parameter of the type\n    - for `change`:\n
-        \       - supports `relative`, `absolute`\n        - [optional] supports `#`,
-        where `#` is an integer or decimal number used to set the threshold\n    -
-        for `anomaly`:\n        - supports `direction=both`, `direction=above`, `direction=below`\n
-        \       - [optional] supports `threshold=#`, where `#` is an integer or decimal
-        number used to set the threshold\n- `operator`\n    - for `threshold` supports
-        `<`, `<=`, `>`, `>=`, `==`, or `!=`\n    - for `change` supports `>`, `<`\n
-        \   - for `anomaly` supports `>=`\n    - for `forecast` supports `>`\n- `#`
-        an integer or decimal number used to set the threshold."
+        `timeframe_type` The timeframe type to evaluate the cost\n        - for `forecast`
+        supports `current`\n        - for `change`, `anomaly`, `threshold` supports
+        `last`\n- `time_window` - supports daily roll-up e.g. `7d`\n- `function` -
+        [optional, defaults to `threshold` monitor if omitted] supports `change`,
+        `anomaly`, `forecast`\n- `parameter` Specify the parameter of the type\n    -
+        for `change`:\n        - supports `relative`, `absolute`\n        - [optional]
+        supports `#`, where `#` is an integer or decimal number used to set the threshold\n
+        \   - for `anomaly`:\n        - supports `direction=both`, `direction=above`,
+        `direction=below`\n        - [optional] supports `threshold=#`, where `#`
+        is an integer or decimal number used to set the threshold\n- `operator`\n
+        \   - for `threshold` supports `<`, `<=`, `>`, `>=`, `==`, or `!=`\n    -
+        for `change` supports `>`, `<`\n    - for `anomaly` supports `>=`\n    - for
+        `forecast` supports `>`\n- `#` an integer or decimal number used to set the
+        threshold."
       operationId: CreateMonitor
       requestBody:
         content:

src/datadog_api_client/v1/api/monitors_api.py

@@ -567,9 +567,15 @@ def create_monitor(
 
         **Cost Alert Query**
 
-        Example: ``formula(query).last(time_window).function(parameter) operator #``
+        Example: ``formula(query).timeframe_type(time_window).function(parameter) operator #``
 
         * ``query`` The search query - following the `Log search syntax <https://docs.datadoghq.com/logs/search_syntax/>`_.
+        * ``timeframe_type`` The timeframe type to evaluate the cost
+          .. code-block::
+
+               - for `forecast` supports `current`
+               - for `change`, `anomaly`, `threshold` supports `last`
+
         * ``time_window`` - supports daily roll-up e.g. ``7d``
         * ``function`` - [optional, defaults to ``threshold`` monitor if omitted] supports ``change`` , ``anomaly`` , ``forecast``
         * ``parameter`` Specify the parameter of the type