Regenerate client from commit 11ca4e2 of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -12570,6 +12570,20 @@ components:
     BudgetAttributes:
       description: The attributes of a budget.
       properties:
+        costs:
+          $ref: "#/components/schemas/BudgetAttributesCosts"
+          description: Aggregated cost data for the budget. Present only when `actual=true` or `forecast=true` is requested.
+        costs_period_end:
+          description: The end of the period used to compute cost data, in milliseconds since epoch.
+          format: int64
+          type: integer
+        costs_period_start:
+          description: The start of the period used to compute cost data, in milliseconds since epoch.
+          format: int64
+          type: integer
+        costs_unit:
+          $ref: "#/components/schemas/BudgetAttributesCostsUnit"
+          description: The unit used for all cost values in the response.
         created_at:
           description: The timestamp when the budget was created.
           example: 1738258683590
@@ -12622,6 +12636,53 @@ components:
           example: 00000000-0a0a-0a0a-aaa0-00000000000a
           type: string
       type: object
+    BudgetAttributesCosts:
+      description: Aggregated cost data for the budget over the requested period.
+      properties:
+        actual:
+          description: The total actual cost. Present only when `actual=true` is requested.
+          format: double
+          nullable: true
+          type: number
+        amount:
+          description: The total budgeted amount over the requested period.
+          format: double
+          nullable: true
+          type: number
+        forecast:
+          description: The total forecast cost, with any custom forecast overrides applied. Present only when `forecast=true` is requested.
+          format: double
+          nullable: true
+          type: number
+        ootb_forecast:
+          description: The out-of-the-box ML forecast before custom overrides. Present only when `forecast=true` is requested.
+          format: double
+          nullable: true
+          type: number
+      type: object
+    BudgetAttributesCostsUnit:
+      description: The unit used for all cost values in the response.
+      properties:
+        family:
+          description: The unit family (for example, `currency`).
+          type: string
+        id:
+          description: The unique identifier for the unit.
+          type: string
+        name:
+          description: The full name of the unit.
+          type: string
+        plural:
+          description: The plural form of the unit name.
+          type: string
+        scale_factor:
+          description: The scale factor applied to raw cost values.
+          format: double
+          type: number
+        short_name:
+          description: The abbreviated unit name.
+          type: string
+      type: object
     BudgetValidationRequest:
       description: The request object for validating a budget configuration before creating or updating it.
       example:
@@ -12787,6 +12848,9 @@ components:
           description: The budgeted amount for this entry.
           format: double
           type: number
+        costs:
+          $ref: "#/components/schemas/BudgetWithEntriesDataAttributesEntriesItemsCosts"
+          description: Cost data for this entry. Present only when `actual=true` or `forecast=true` is requested.
         month:
           description: The month this budget entry applies to, in YYYYMM format.
           format: int64
@@ -12797,6 +12861,36 @@ components:
             $ref: "#/components/schemas/BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems"
           type: array
       type: object
+    BudgetWithEntriesDataAttributesEntriesItemsCosts:
+      description: Cost data for a single budget entry.
+      properties:
+        actual:
+          description: The actual cost for this entry. Present only when `actual=true` is requested.
+          format: double
+          nullable: true
+          type: number
+        amount:
+          description: The budgeted amount for this entry.
+          format: double
+          nullable: true
+          type: number
+        custom_forecast:
+          description: |-
+            The custom forecast override for this entry. `null` when `forecast=true` is requested but no custom forecast has been set for this entry's month. A numeric value, including `0`, indicates an explicit custom forecast override. Omitted when `forecast=false` or the feature is not available for the organization.
+          format: double
+          nullable: true
+          type: number
+        forecast:
+          description: The final forecast for this entry, with any custom forecast override applied. Present only when `forecast=true` is requested.
+          format: double
+          nullable: true
+          type: number
+        ootb_forecast:
+          description: The out-of-the-box ML forecast for this entry, before custom overrides. Present only when `forecast=true` is requested.
+          format: double
+          nullable: true
+          type: number
+      type: object
     BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems:
       description: A tag filter used to scope a budget entry to specific resource tags.
       properties:
@@ -116220,10 +116314,36 @@ paths:
       tags:
         - Cloud Cost Management
     get:
-      description: Get a budget
+      description: Get a budget by ID. Pass `actual=true` or `forecast=true` to include cost data in the response. Use `start` and `end` (millisecond epochs, both required) to set the cost window. When `forecast=true`, each entry also includes `ootb_forecast` (the ML forecast before overrides) and `custom_forecast` (`null` if no override is set, a number if one is).
       operationId: GetBudget
       parameters:
         - $ref: "#/components/parameters/BudgetID"
+        - description: When `true`, includes actual cost data in the response.
+          in: query
+          name: actual
+          required: false
+          schema:
+            type: boolean
+        - description: When `true`, includes forecast cost data in the response, including `ootb_forecast` and `custom_forecast` per entry.
+          in: query
+          name: forecast
+          required: false
+          schema:
+            type: boolean
+        - description: Start of the cost window in milliseconds since epoch. Must be used together with `end`.
+          in: query
+          name: start
+          required: false
+          schema:
+            format: int64
+            type: integer
+        - description: End of the cost window in milliseconds since epoch. Must be used together with `start`.
+          in: query
+          name: end
+          required: false
+          schema:
+            format: int64
+            type: integer
       responses:
         "200":
           content:
@@ -116233,11 +116353,31 @@ paths:
                   value:
                     data:
                       attributes:
+                        costs:
+                          actual: 850.25
+                          amount: 1000.0
+                          forecast: 1100.5
+                          ootb_forecast: 1100.5
+                        costs_period_end: 1740873600000
+                        costs_period_start: 1738281600000
+                        costs_unit:
+                          family: currency
+                          id: "1"
+                          name: dollar
+                          plural: dollars
+                          scale_factor: 1.0
+                          short_name: $
                         created_at: 1738258683590
                         created_by: 00000000-0a0a-0a0a-aaa0-00000000000a
                         end_month: 202502
                         entries:
                           - amount: 500
+                            costs:
+                              actual: 425.5
+                              amount: 500.0
+                              custom_forecast:
+                              forecast: 550.25
+                              ootb_forecast: 550.25
                             month: 202501
                             tag_filters:
                               - tag_key: service
@@ -116254,6 +116394,10 @@ paths:
               schema:
                 $ref: "#/components/schemas/BudgetWithEntries"
           description: OK
+        "400":
+          $ref: "#/components/responses/BadRequestResponse"
+        "404":
+          $ref: "#/components/responses/NotFoundResponse"
         "429":
           $ref: "#/components/responses/TooManyRequestsResponse"
       security:

docs/datadog_api_client.v2.model.rst

@@ -4358,6 +4358,20 @@ datadog\_api\_client.v2.model.budget\_attributes module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.budget\_attributes\_costs module
+--------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.budget_attributes_costs
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.budget\_attributes\_costs\_unit module
+--------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.budget_attributes_costs_unit
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.budget\_validation\_request module
 ----------------------------------------------------------------
 
@@ -4428,6 +4442,13 @@ datadog\_api\_client.v2.model.budget\_with\_entries\_data\_attributes\_entries\_
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.budget\_with\_entries\_data\_attributes\_entries\_items\_costs module
+---------------------------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.budget_with_entries_data_attributes_entries_items_costs
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.budget\_with\_entries\_data\_attributes\_entries\_items\_tag\_filters\_items module
 -----------------------------------------------------------------------------------------------------------------
 

examples/v2/cloud-cost-management/UpsertBudget.py

@@ -5,23 +5,42 @@
 from datadog_api_client import ApiClient, Configuration
 from datadog_api_client.v2.api.cloud_cost_management_api import CloudCostManagementApi
 from datadog_api_client.v2.model.budget_attributes import BudgetAttributes
+from datadog_api_client.v2.model.budget_attributes_costs import BudgetAttributesCosts
+from datadog_api_client.v2.model.budget_attributes_costs_unit import BudgetAttributesCostsUnit
 from datadog_api_client.v2.model.budget_with_entries import BudgetWithEntries
 from datadog_api_client.v2.model.budget_with_entries_data import BudgetWithEntriesData
 from datadog_api_client.v2.model.budget_with_entries_data_attributes_entries_items import (
     BudgetWithEntriesDataAttributesEntriesItems,
 )
+from datadog_api_client.v2.model.budget_with_entries_data_attributes_entries_items_costs import (
+    BudgetWithEntriesDataAttributesEntriesItemsCosts,
+)
 from datadog_api_client.v2.model.budget_with_entries_data_attributes_entries_items_tag_filters_items import (
     BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems,
 )
 
 body = BudgetWithEntries(
     data=BudgetWithEntriesData(
         attributes=BudgetAttributes(
+            costs=BudgetAttributesCosts(
+                actual=None,
+                amount=None,
+                forecast=None,
+                ootb_forecast=None,
+            ),
+            costs_unit=BudgetAttributesCostsUnit(),
             created_at=1738258683590,
             created_by="00000000-0a0a-0a0a-aaa0-00000000000a",
             end_month=202502,
             entries=[
                 BudgetWithEntriesDataAttributesEntriesItems(
+                    costs=BudgetWithEntriesDataAttributesEntriesItemsCosts(
+                        actual=None,
+                        amount=None,
+                        custom_forecast=None,
+                        forecast=None,
+                        ootb_forecast=None,
+                    ),
                     tag_filters=[
                         BudgetWithEntriesDataAttributesEntriesItemsTagFiltersItems(),
                     ],

src/datadog_api_client/v2/api/cloud_cost_management_api.py

@@ -420,6 +420,26 @@ def __init__(self, api_client=None):
                     "attribute": "budget_id",
                     "location": "path",
                 },
+                "actual": {
+                    "openapi_types": (bool,),
+                    "attribute": "actual",
+                    "location": "query",
+                },
+                "forecast": {
+                    "openapi_types": (bool,),
+                    "attribute": "forecast",
+                    "location": "query",
+                },
+                "start": {
+                    "openapi_types": (int,),
+                    "attribute": "start",
+                    "location": "query",
+                },
+                "end": {
+                    "openapi_types": (int,),
+                    "attribute": "end",
+                    "location": "query",
+                },
             },
             headers_map={
                 "accept": ["application/json"],
@@ -2155,18 +2175,43 @@ def generate_cost_tag_description_by_key(
     def get_budget(
         self,
         budget_id: str,
+        *,
+        actual: Union[bool, UnsetType] = unset,
+        forecast: Union[bool, UnsetType] = unset,
+        start: Union[int, UnsetType] = unset,
+        end: Union[int, UnsetType] = unset,
     ) -> BudgetWithEntries:
         """Get budget.
 
-        Get a budget
+        Get a budget by ID. Pass ``actual=true`` or ``forecast=true`` to include cost data in the response. Use ``start`` and ``end`` (millisecond epochs, both required) to set the cost window. When ``forecast=true`` , each entry also includes ``ootb_forecast`` (the ML forecast before overrides) and ``custom_forecast`` ( ``null`` if no override is set, a number if one is).
 
         :param budget_id: Budget id.
         :type budget_id: str
+        :param actual: When ``true`` , includes actual cost data in the response.
+        :type actual: bool, optional
+        :param forecast: When ``true`` , includes forecast cost data in the response, including ``ootb_forecast`` and ``custom_forecast`` per entry.
+        :type forecast: bool, optional
+        :param start: Start of the cost window in milliseconds since epoch. Must be used together with ``end``.
+        :type start: int, optional
+        :param end: End of the cost window in milliseconds since epoch. Must be used together with ``start``.
+        :type end: int, optional
         :rtype: BudgetWithEntries
         """
         kwargs: Dict[str, Any] = {}
         kwargs["budget_id"] = budget_id
 
+        if actual is not unset:
+            kwargs["actual"] = actual
+
+        if forecast is not unset:
+            kwargs["forecast"] = forecast
+
+        if start is not unset:
+            kwargs["start"] = start
+
+        if end is not unset:
+            kwargs["end"] = end
+
         return self._get_budget_endpoint.call_with_http_info(**kwargs)
 
     def get_commitments_commitment_list(