Regenerate client from commit b7d1caa of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v2/openapi.yaml

@@ -0,0 +1,22 @@
+/**
+ * Get detailed information about an agent returns "OK" response
+ */
+
+import { client, v2 } from "@datadog/datadog-api-client";
+
+const configuration = client.createConfiguration();
+configuration.unstableOperations["v2.getFleetAgentInfo"] = true;
+const apiInstance = new v2.FleetAutomationApi(configuration);
+
+const params: v2.FleetAutomationApiGetFleetAgentInfoRequest = {
+  agentKey: "agent_key",
+};
+
+apiInstance
+  .getFleetAgentInfo(params)
+  .then((data: v2.FleetAgentInfoResponse) => {
+    console.log(
+      "API called successfully. Returned data: " + JSON.stringify(data)
+    );
+  })
+  .catch((error: any) => console.error(error));

examples/v2/fleet-automation/GetFleetAgentInfo.ts

@@ -2343,6 +2343,13 @@ export const ScenariosModelMappings: {[key: string]: {[key: string]: any}} = {
     "v2.ListFleetAgentVersions": {
         "operationResponseType": "FleetAgentVersionsResponse",
     },
+    "v2.GetFleetAgentInfo": {
+        "agentKey": {
+            "type": "string",
+            "format": "",
+            },
+        "operationResponseType": "FleetAgentInfoResponse",
+    },
     "v2.ListFleetDeployments": {
         "pageSize": {
             "type": "number",

features/support/scenarios_model_mapping.ts

@@ -152,6 +152,30 @@ Feature: Fleet Automation
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip @team:DataDog/fleet-automation
+  Scenario: Get detailed information about an agent returns "Bad Request" response
+    Given operation "GetFleetAgentInfo" enabled
+    And new "GetFleetAgentInfo" request
+    And request contains "agent_key" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip @team:DataDog/fleet-automation
+  Scenario: Get detailed information about an agent returns "Not Found" response
+    Given operation "GetFleetAgentInfo" enabled
+    And new "GetFleetAgentInfo" request
+    And request contains "agent_key" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @generated @skip @team:DataDog/fleet-automation
+  Scenario: Get detailed information about an agent returns "OK" response
+    Given operation "GetFleetAgentInfo" enabled
+    And new "GetFleetAgentInfo" request
+    And request contains "agent_key" parameter from "REPLACE.ME"
+    When the request is sent
+    Then the response status is 200 OK
+
   @generated @skip @team:DataDog/fleet-automation
   Scenario: List all available Agent versions returns "Bad Request" response
     Given operation "ListFleetAgentVersions" enabled

features/v2/fleet_automation.feature

@@ -5,6 +5,12 @@
       "type": "safe"
     }
   },
+  "GetFleetAgentInfo": {
+    "tag": "Fleet Automation",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "ListFleetDeployments": {
     "tag": "Fleet Automation",
     "undo": {

features/v2/undo.json

@@ -227,6 +227,7 @@ export function createConfiguration(
       "v2.createFleetDeploymentUpgrade": false,
       "v2.createFleetSchedule": false,
       "v2.deleteFleetSchedule": false,
+      "v2.getFleetAgentInfo": false,
       "v2.getFleetDeployment": false,
       "v2.getFleetSchedule": false,
       "v2.listFleetAgentVersions": false,

packages/datadog-api-client-common/configuration.ts

@@ -17,6 +17,7 @@ import { ObjectSerializer } from "../models/ObjectSerializer";
 import { ApiException } from "../../datadog-api-client-common/exception";
 
 import { APIErrorResponse } from "../models/APIErrorResponse";
+import { FleetAgentInfoResponse } from "../models/FleetAgentInfoResponse";
 import { FleetAgentVersionsResponse } from "../models/FleetAgentVersionsResponse";
 import { FleetDeploymentConfigureCreateRequest } from "../models/FleetDeploymentConfigureCreateRequest";
 import { FleetDeploymentPackageUpgradeCreateRequest } from "../models/FleetDeploymentPackageUpgradeCreateRequest";
@@ -255,6 +256,44 @@ export class FleetAutomationApiRequestFactory extends BaseAPIRequestFactory {
     return requestContext;
   }
 
+  public async getFleetAgentInfo(
+    agentKey: string,
+    _options?: Configuration
+  ): Promise<RequestContext> {
+    const _config = _options || this.configuration;
+
+    logger.warn("Using unstable operation 'getFleetAgentInfo'");
+    if (!_config.unstableOperations["v2.getFleetAgentInfo"]) {
+      throw new Error("Unstable operation 'getFleetAgentInfo' is disabled");
+    }
+
+    // verify required parameter 'agentKey' is not null or undefined
+    if (agentKey === null || agentKey === undefined) {
+      throw new RequiredError("agentKey", "getFleetAgentInfo");
+    }
+
+    // Path Params
+    const localVarPath = "/api/unstable/fleet/agents/{agent_key}".replace(
+      "{agent_key}",
+      encodeURIComponent(String(agentKey))
+    );
+
+    // Make Request Context
+    const requestContext = _config
+      .getServer("v2.FleetAutomationApi.getFleetAgentInfo")
+      .makeRequestContext(localVarPath, HttpMethod.GET);
+    requestContext.setHeaderParam("Accept", "application/json");
+    requestContext.setHttpConfig(_config.httpConfig);
+
+    // Apply auth methods
+    applySecurityAuthentication(_config, requestContext, [
+      "apiKeyAuth",
+      "appKeyAuth",
+    ]);
+
+    return requestContext;
+  }
+
   public async getFleetDeployment(
     deploymentId: string,
     limit?: number,
@@ -848,6 +887,70 @@ export class FleetAutomationApiResponseProcessor {
     );
   }
 
+  /**
+   * Unwraps the actual response sent by the server from the response context and deserializes the response content
+   * to the expected objects
+   *
+   * @params response Response returned by the server for a request to getFleetAgentInfo
+   * @throws ApiException if the response code was not in [200, 299]
+   */
+  public async getFleetAgentInfo(
+    response: ResponseContext
+  ): Promise<FleetAgentInfoResponse> {
+    const contentType = ObjectSerializer.normalizeMediaType(
+      response.headers["content-type"]
+    );
+    if (response.httpStatusCode === 200) {
+      const body: FleetAgentInfoResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "FleetAgentInfoResponse"
+      ) as FleetAgentInfoResponse;
+      return body;
+    }
+    if (
+      response.httpStatusCode === 400 ||
+      response.httpStatusCode === 401 ||
+      response.httpStatusCode === 403 ||
+      response.httpStatusCode === 404 ||
+      response.httpStatusCode === 429
+    ) {
+      const bodyText = ObjectSerializer.parse(
+        await response.body.text(),
+        contentType
+      );
+      let body: APIErrorResponse;
+      try {
+        body = ObjectSerializer.deserialize(
+          bodyText,
+          "APIErrorResponse"
+        ) as APIErrorResponse;
+      } catch (error) {
+        logger.debug(`Got error deserializing error: ${error}`);
+        throw new ApiException<APIErrorResponse>(
+          response.httpStatusCode,
+          bodyText
+        );
+      }
+      throw new ApiException<APIErrorResponse>(response.httpStatusCode, body);
+    }
+
+    // Work around for missing responses in specification, e.g. for petstore.yaml
+    if (response.httpStatusCode >= 200 && response.httpStatusCode <= 299) {
+      const body: FleetAgentInfoResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "FleetAgentInfoResponse",
+        ""
+      ) as FleetAgentInfoResponse;
+      return body;
+    }
+
+    const body = (await response.body.text()) || "";
+    throw new ApiException<string>(
+      response.httpStatusCode,
+      'Unknown API Status Code!\nBody: "' + body + '"'
+    );
+  }
+
   /**
    * Unwraps the actual response sent by the server from the response context and deserializes the response content
    * to the expected objects
@@ -1335,6 +1438,14 @@ export interface FleetAutomationApiDeleteFleetScheduleRequest {
   id: string;
 }
 
+export interface FleetAutomationApiGetFleetAgentInfoRequest {
+  /**
+   * The unique identifier (agent key) for the Datadog Agent.
+   * @type string
+   */
+  agentKey: string;
+}
+
 export interface FleetAutomationApiGetFleetDeploymentRequest {
   /**
    * The unique identifier of the deployment to retrieve.
@@ -1560,6 +1671,33 @@ export class FleetAutomationApi {
     });
   }
 
+  /**
+   * Retrieve detailed information about a specific Datadog Agent.
+   *
+   * This endpoint returns comprehensive information about an agent including:
+   * - Agent details and metadata
+   * - Configured integrations organized by status (working, warning, error, missing)
+   * - Detected integrations
+   * - Configuration files and layers
+   * @param param The request object
+   */
+  public getFleetAgentInfo(
+    param: FleetAutomationApiGetFleetAgentInfoRequest,
+    options?: Configuration
+  ): Promise<FleetAgentInfoResponse> {
+    const requestContextPromise = this.requestFactory.getFleetAgentInfo(
+      param.agentKey,
+      options
+    );
+    return requestContextPromise.then((requestContext) => {
+      return this.configuration.httpApi
+        .send(requestContext)
+        .then((responseContext) => {
+          return this.responseProcessor.getFleetAgentInfo(responseContext);
+        });
+    });
+  }
+
   /**
    * Retrieve detailed information about a specific deployment using its unique identifier.
    * This endpoint returns comprehensive information about a deployment, including:

packages/datadog-api-client-v2/apis/FleetAutomationApi.ts

@@ -357,6 +357,7 @@ export {
   FleetAutomationApiCreateFleetDeploymentUpgradeRequest,
   FleetAutomationApiCreateFleetScheduleRequest,
   FleetAutomationApiDeleteFleetScheduleRequest,
+  FleetAutomationApiGetFleetAgentInfoRequest,
   FleetAutomationApiGetFleetDeploymentRequest,
   FleetAutomationApiGetFleetScheduleRequest,
   FleetAutomationApiListFleetDeploymentsRequest,
@@ -2197,10 +2198,17 @@ export { FlakyTestsSearchResponseMeta } from "./models/FlakyTestsSearchResponseM
 export { FlakyTestsSearchSort } from "./models/FlakyTestsSearchSort";
 export { FlakyTestStats } from "./models/FlakyTestStats";
 export { FlakyTestType } from "./models/FlakyTestType";
+export { FleetAgentInfo } from "./models/FleetAgentInfo";
+export { FleetAgentInfoAttributes } from "./models/FleetAgentInfoAttributes";
+export { FleetAgentInfoDetails } from "./models/FleetAgentInfoDetails";
+export { FleetAgentInfoResourceType } from "./models/FleetAgentInfoResourceType";
+export { FleetAgentInfoResponse } from "./models/FleetAgentInfoResponse";
 export { FleetAgentVersion } from "./models/FleetAgentVersion";
 export { FleetAgentVersionAttributes } from "./models/FleetAgentVersionAttributes";
 export { FleetAgentVersionResourceType } from "./models/FleetAgentVersionResourceType";
 export { FleetAgentVersionsResponse } from "./models/FleetAgentVersionsResponse";
+export { FleetConfigurationFile } from "./models/FleetConfigurationFile";
+export { FleetConfigurationLayer } from "./models/FleetConfigurationLayer";
 export { FleetDeployment } from "./models/FleetDeployment";
 export { FleetDeploymentAttributes } from "./models/FleetDeploymentAttributes";
 export { FleetDeploymentConfigureAttributes } from "./models/FleetDeploymentConfigureAttributes";
@@ -2221,6 +2229,9 @@ export { FleetDeploymentResponseMeta } from "./models/FleetDeploymentResponseMet
 export { FleetDeploymentsPage } from "./models/FleetDeploymentsPage";
 export { FleetDeploymentsResponse } from "./models/FleetDeploymentsResponse";
 export { FleetDeploymentsResponseMeta } from "./models/FleetDeploymentsResponseMeta";
+export { FleetDetectedIntegration } from "./models/FleetDetectedIntegration";
+export { FleetIntegrationDetails } from "./models/FleetIntegrationDetails";
+export { FleetIntegrationsByStatus } from "./models/FleetIntegrationsByStatus";
 export { FleetSchedule } from "./models/FleetSchedule";
 export { FleetScheduleAttributes } from "./models/FleetScheduleAttributes";
 export { FleetScheduleCreate } from "./models/FleetScheduleCreate";

packages/datadog-api-client-v2/index.ts

@@ -0,0 +1,73 @@
+/**
+ * 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 2020-Present Datadog, Inc.
+ */
+import { FleetAgentInfoAttributes } from "./FleetAgentInfoAttributes";
+import { FleetAgentInfoResourceType } from "./FleetAgentInfoResourceType";
+
+import { AttributeTypeMap } from "../../datadog-api-client-common/util";
+
+/**
+ * Represents detailed information about a specific Datadog Agent.
+ */
+export class FleetAgentInfo {
+  /**
+   * Attributes for agent information.
+   */
+  "attributes": FleetAgentInfoAttributes;
+  /**
+   * The unique agent key identifier.
+   */
+  "id": string;
+  /**
+   * The type of Agent info resource.
+   */
+  "type": FleetAgentInfoResourceType;
+
+  /**
+   * A container for additional, undeclared properties.
+   * This is a holder for any undeclared properties as specified with
+   * the 'additionalProperties' keyword in the OAS document.
+   */
+  "additionalProperties"?: { [key: string]: any };
+
+  /**
+   * @ignore
+   */
+  "_unparsed"?: boolean;
+
+  /**
+   * @ignore
+   */
+  static readonly attributeTypeMap: AttributeTypeMap = {
+    attributes: {
+      baseName: "attributes",
+      type: "FleetAgentInfoAttributes",
+      required: true,
+    },
+    id: {
+      baseName: "id",
+      type: "string",
+      required: true,
+    },
+    type: {
+      baseName: "type",
+      type: "FleetAgentInfoResourceType",
+      required: true,
+    },
+    additionalProperties: {
+      baseName: "additionalProperties",
+      type: "{ [key: string]: any; }",
+    },
+  };
+
+  /**
+   * @ignore
+   */
+  static getAttributeTypeMap(): AttributeTypeMap {
+    return FleetAgentInfo.attributeTypeMap;
+  }
+
+  public constructor() {}
+}