Regenerate client from commit 23cdfee of spec repo

Author: ci.datadog-api-spec

.generated-info

@@ -1,4 +1,4 @@
 {
-  "spec_repo_commit": "4413e63",
-  "generated": "2025-08-19 20:28:35.046"
+  "spec_repo_commit": "23cdfee",
+  "generated": "2025-08-22 13:44:15.082"
 }

.generator/schemas/v2/openapi.yaml

@@ -9284,6 +9284,15 @@ components:
           that evaluates to a boolean.
         example: ${true}
         type: string
+    ComponentRecommendation:
+      description: Resource recommendation for a single Spark component (driver or
+        executor). Contains estimation data used to patch Spark job specs.
+      properties:
+        estimation:
+          $ref: '#/components/schemas/Estimation'
+      required:
+      - estimation
+      type: object
     ComponentType:
       description: The UI component type.
       enum:
@@ -10480,6 +10489,28 @@ components:
       type: string
       x-enum-varnames:
       - COST_BY_ORG
+    Cpu:
+      description: CPU usage statistics derived from historical Spark job metrics.
+        Provides multiple estimates so users can choose between conservative and cost-saving
+        risk profiles.
+      properties:
+        max:
+          description: Maximum CPU usage observed for the job, expressed in millicores.
+            This represents the upper bound of usage.
+          format: int64
+          type: integer
+        p75:
+          description: 75th percentile of CPU usage (millicores). Represents a cost-saving
+            configuration while covering most workloads.
+          format: int64
+          type: integer
+        p95:
+          description: 95th percentile of CPU usage (millicores). Balances performance
+            and cost, providing a safer margin than p75.
+          format: int64
+          type: integer
+      type: object
+      x-model-simple-name: SpaCpu
     CreateActionConnectionRequest:
       description: Request used to create an action connection.
       properties:
@@ -15937,6 +15968,33 @@ components:
       type: string
       x-enum-varnames:
       - ESCALATION_POLICY_STEPS
+    Estimation:
+      description: Recommended resource values for a Spark driver or executor, derived
+        from recent real usage metrics. Used by SPA to propose more efficient pod
+        sizing.
+      properties:
+        cpu:
+          $ref: '#/components/schemas/Cpu'
+        ephemeral_storage:
+          description: Recommended ephemeral storage allocation (in MiB). Derived
+            from job temporary storage patterns.
+          format: int64
+          type: integer
+        heap:
+          description: Recommended JVM heap size (in MiB).
+          format: int64
+          type: integer
+        memory:
+          description: Recommended total memory allocation (in MiB). Includes both
+            heap and overhead.
+          format: int64
+          type: integer
+        overhead:
+          description: Recommended JVM overhead (in MiB). Computed as total memory
+            - heap.
+          format: int64
+          type: integer
+      type: object
     Event:
       description: The metadata associated with a request.
       properties:
@@ -32835,6 +32893,52 @@ components:
       x-enum-varnames:
       - ANY
       - ALL
+    RecommendationAttributes:
+      description: Attributes of the SPA Recommendation resource. Contains recommendations
+        for both driver and executor components.
+      properties:
+        driver:
+          $ref: '#/components/schemas/ComponentRecommendation'
+        executor:
+          $ref: '#/components/schemas/ComponentRecommendation'
+      required:
+      - driver
+      - executor
+      type: object
+    RecommendationData:
+      description: JSON:API resource object for SPA Recommendation. Includes type,
+        optional ID, and resource attributes with structured recommendations.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/RecommendationAttributes'
+        id:
+          description: Resource identifier for the recommendation. Optional in responses.
+          type: string
+        type:
+          $ref: '#/components/schemas/RecommendationType'
+      required:
+      - type
+      - attributes
+      type: object
+    RecommendationDocument:
+      description: JSON:API document containing a single Recommendation resource.
+        Returned by SPA when the Spark Gateway requests recommendations.
+      properties:
+        data:
+          $ref: '#/components/schemas/RecommendationData'
+      required:
+      - data
+      type: object
+    RecommendationType:
+      default: recommendation
+      description: JSON:API resource type for Spark Pod Autosizing recommendations.
+        Identifies the Recommendation resource returned by SPA.
+      enum:
+      - recommendation
+      example: recommendation
+      type: string
+      x-enum-varnames:
+      - RECOMMENDATION
     RegisterAppKeyResponse:
       description: The response object after creating an app key registration.
       properties:
@@ -65710,6 +65814,69 @@ paths:
       x-unstable: '**Note**: This feature is in private beta. To request access, use
         the request access form in the [Service Level Objectives](https://docs.datadoghq.com/service_management/service_level_objectives/#slo-csv-export)
         docs.'
+  /api/v2/spa/recommendations/{service}/{shard}:
+    get:
+      description: Retrieve resource recommendations for a Spark job. The caller (Spark
+        Gateway or DJM UI) provides a service name and shard identifier, and SPA returns
+        structured recommendations for driver and executor resources.
+      operationId: GetSPARecommendations
+      parameters:
+      - description: The shard tag for a spark job, which differentiates jobs within
+          the same service that have different resource needs
+        in: path
+        name: shard
+        required: true
+        schema:
+          type: string
+      - description: The service name for a spark job
+        in: path
+        name: service
+        required: true
+        schema:
+          type: string
+      responses:
+        '200':
+          content:
+            application/json:
+              example:
+                data:
+                  attributes:
+                    driver:
+                      estimation:
+                        cpu:
+                          max: 1500
+                          p75: 1000
+                          p95: 1200
+                        ephemeral_storage: 896
+                        heap: 6144
+                        memory: 7168
+                        overhead: 1024
+                    executor:
+                      estimation:
+                        cpu:
+                          max: 2000
+                          p75: 1200
+                          p95: 1500
+                        ephemeral_storage: 512
+                        heap: 3072
+                        memory: 4096
+                        overhead: 1024
+                  id: dedupeactivecontexts:adp_dedupeactivecontexts_org2
+                  type: recommendation
+              schema:
+                $ref: '#/components/schemas/RecommendationDocument'
+          description: OK
+        '400':
+          $ref: '#/components/responses/BadRequestResponse'
+        '403':
+          $ref: '#/components/responses/NotAuthorizedResponse'
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get SPA Recommendations
+      tags:
+      - Spa
+      x-unstable: '**Note**: This endpoint is in public beta and may change in the
+        future. It is not yet recommended for production use.'
   /api/v2/spans/analytics/aggregate:
     post:
       description: 'The API endpoint to aggregate spans into buckets and compute metrics
@@ -69127,6 +69294,9 @@ tags:
   externalDocs:
     url: https://docs.datadoghq.com/service_catalog/service_definitions#metadata-schema-v30-beta
   name: Software Catalog
+- description: SPA (Spark Pod Autosizing) API. Provides resource recommendations and
+    cost insights to help optimize Spark job configurations.
+  name: Spa
 - description: Search and aggregate your spans from your Datadog platform over HTTP.
   name: Spans
 - description: Manage configuration of [span-based metrics](https://app.datadoghq.com/apm/traces/generate-metrics)

features/v2/spa.feature

@@ -0,0 +1,54 @@
+@endpoint(spa) @endpoint(spa-v2)
+Feature: Spa
+  SPA (Spark Pod Autosizing) API. Provides resource recommendations and cost
+  insights to help optimize Spark job configurations.
+
+  Background:
+    Given a valid "apiKeyAuth" key in the system
+    And a valid "appKeyAuth" key in the system
+    And an instance of "Spa" API
+    And operation "GetSPARecommendations" enabled
+    And new "GetSPARecommendations" request
+
+  @generated @skip @team:DataDog/data-and-analytics-processing
+  Scenario: Get SPA Recommendations returns "Bad Request" response
+    Given request contains "shard" parameter from "REPLACE.ME"
+    And request contains "service" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/data-and-analytics-processing
+  Scenario: Get SPA Recommendations returns "OK" response
+    Given request contains "shard" parameter from "REPLACE.ME"
+    And request contains "service" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
+  @skip @team:DataDog/data-and-analytics-processing
+  Scenario: GetSPARecommendations returns a JSON:API Recommendation with driver and executor estimations
+    Given request contains "service" parameter with value "dedupeactivecontexts"
+    And request contains "shard" parameter with value "adp_dedupeactivecontexts_org2"
+    When the request is sent
+    Then the response status is 404 Not Found
+    And the response "data.type" is equal to "recommendation"
+    And the response "data" has field "attributes"
+    And the response "data.attributes" has field "driver"
+    And the response "data.attributes" has field "executor"
+    And the response "data.attributes.driver" has field "estimation"
+    And the response "data.attributes.driver.estimation" has field "cpu"
+    And the response "data.attributes.driver.estimation" has field "memory"
+    And the response "data.attributes.driver.estimation" has field "ephemeral_storage"
+    And the response "data.attributes.driver.estimation" has field "heap"
+    And the response "data.attributes.driver.estimation" has field "overhead"
+    And the response "data.attributes.driver.estimation.cpu" has field "max"
+    And the response "data.attributes.driver.estimation.cpu" has field "p95"
+    And the response "data.attributes.driver.estimation.cpu" has field "p75"
+    And the response "data.attributes.executor" has field "estimation"
+    And the response "data.attributes.executor.estimation" has field "cpu"
+    And the response "data.attributes.executor.estimation" has field "memory"
+    And the response "data.attributes.executor.estimation" has field "ephemeral_storage"
+    And the response "data.attributes.executor.estimation" has field "heap"
+    And the response "data.attributes.executor.estimation" has field "overhead"
+    And the response "data.attributes.executor.estimation.cpu" has field "max"
+    And the response "data.attributes.executor.estimation.cpu" has field "p95"
+    And the response "data.attributes.executor.estimation.cpu" has field "p75"

features/v2/undo.json

@@ -3362,6 +3362,12 @@
       "type": "safe"
     }
   },
+  "GetSPARecommendations": {
+    "tag": "Spa",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "AggregateSpans": {
     "tag": "Spans",
     "undo": {

packages/datadog-api-client/README.md

@@ -423,6 +423,7 @@ apiInstance
 | Slack Integration | @datadog/datadog-api-client-slack-integration | [README.md](../../services/slack-integration/README.md) |
 | Snapshots | @datadog/datadog-api-client-snapshots | [README.md](../../services/snapshots/README.md) |
 | Software Catalog | @datadog/datadog-api-client-software-catalog | [README.md](../../services/software-catalog/README.md) |
+| Spa | @datadog/datadog-api-client-spa | [README.md](../../services/spa/README.md) |
 | Spans | @datadog/datadog-api-client-spans | [README.md](../../services/spans/README.md) |
 | Spans Metrics | @datadog/datadog-api-client-spans-metrics | [README.md](../../services/spans-metrics/README.md) |
 | Synthetics | @datadog/datadog-api-client-synthetics | [README.md](../../services/synthetics/README.md) |

private/bdd_runner/src/support/scenarios_model_mapping.ts

@@ -7476,6 +7476,17 @@ export const ScenariosModelMappings: { [key: string]: OperationMapping } = {
     },
     operationResponseType: "SLOReportStatusGetResponse",
   },
+  "SpaApi.V2.GetSPARecommendations": {
+    shard: {
+      type: "string",
+      format: "",
+    },
+    service: {
+      type: "string",
+      format: "",
+    },
+    operationResponseType: "RecommendationDocument",
+  },
   "SpansApi.V2.AggregateSpans": {
     body: {
       type: "SpansAggregateRequest",

services/spa/.yarnrc.yml

@@ -0,0 +1 @@
+nodeLinker: node-modules

services/spa/README.md

@@ -0,0 +1,44 @@
+# @datadog/datadog-api-client-spa
+
+## Description
+
+SPA (Spark Pod Autosizing) API. Provides resource recommendations and cost insights to help optimize Spark job configurations.
+
+## Navigation
+
+- [Installation](#installation)
+- [Getting Started](#getting-started)
+
+## Installation
+
+```sh
+# NPM
+npm install @datadog/datadog-api-client-spa
+# Yarn
+yarn add @datadog/datadog-api-client-spa
+```
+
+## Getting Started
+```ts
+import { createConfiguration } from "@datadog/datadog-api-client";
+import { SpaApiV2 } from "@datadog/datadog-api-client-spa";
+import { v2 } from "@datadog/datadog-api-client-spa";
+
+const configuration = createConfiguration();
+// Enable unstable operations
+const configurationOpts = {
+    unstableOperations: {
+        "SpaApi.v2.getSPARecommendations": true
+    }
+}
+
+const configuration = createConfiguration(configurationOpts);
+const apiInstance = new SpaApiV2(configuration);
+const params = {/* parameters */};
+
+apiInstance.getSPARecommendations(params).then((data) => {
+    console.log("API called successfully. Returned data: " + JSON.stringify(data));
+}).catch((error) => {
+    console.error("Error calling API: " + error);
+});
+```