Regenerate client from commit 9777e49 of spec repo (#205)

Co-authored-by: ci.datadog-api-spec <[email protected]>
Co-authored-by: api-clients-generation-pipeline[bot] <54105614+api-clients-generation-pipeline[bot]@users.noreply.github.com>

Author: api-clients-generation-pipeline[bot]

.apigentools-info

@@ -3,14 +3,14 @@
     "info_version": "2",
     "spec_versions": {
         "v1": {
-            "apigentools_version": "1.4.1.dev8",
-            "regenerated": "2021-07-01 19:07:51.346514",
-            "spec_repo_commit": "1847a67"
+            "apigentools_version": "1.4.1.dev11",
+            "regenerated": "2021-07-05 14:12:17.319690",
+            "spec_repo_commit": "9777e49"
         },
         "v2": {
-            "apigentools_version": "1.4.1.dev8",
-            "regenerated": "2021-07-01 19:09:10.959829",
-            "spec_repo_commit": "1847a67"
+            "apigentools_version": "1.4.1.dev11",
+            "regenerated": "2021-07-05 14:13:47.942174",
+            "spec_repo_commit": "9777e49"
         }
     }
 }

docs/v2/KeyManagementApi.md

@@ -10,6 +10,7 @@ Method | HTTP request | Description
 [**deleteApplicationKey**](KeyManagementApi.md#deleteApplicationKey) | **DELETE** /api/v2/application_keys/{app_key_id} | Delete an application key
 [**deleteCurrentUserApplicationKey**](KeyManagementApi.md#deleteCurrentUserApplicationKey) | **DELETE** /api/v2/current_user/application_keys/{app_key_id} | Delete an application key owned by current user
 [**getAPIKey**](KeyManagementApi.md#getAPIKey) | **GET** /api/v2/api_keys/{api_key_id} | Get API key
+[**getApplicationKey**](KeyManagementApi.md#getApplicationKey) | **GET** /api/v2/application_keys/{app_key_id} | Get an application key
 [**getCurrentUserApplicationKey**](KeyManagementApi.md#getCurrentUserApplicationKey) | **GET** /api/v2/current_user/application_keys/{app_key_id} | Get one application key owned by current user
 [**listAPIKeys**](KeyManagementApi.md#listAPIKeys) | **GET** /api/v2/api_keys | Get all API keys
 [**listApplicationKeys**](KeyManagementApi.md#listApplicationKeys) | **GET** /api/v2/application_keys | Get all application keys
@@ -372,6 +373,66 @@ Name | Type | Description  | Notes
 
 [[Back to top]](#) [[Back to API list]](README.md#documentation-for-api-endpoints) [[Back to Model list]](README.md#documentation-for-models) [[Back to README]](README.md)
 
+## **getApplicationKey**
+> ApplicationKeyResponse getApplicationKey()
+
+Get an application key for your org.
+
+### Example
+
+
+```typescript
+import { v2 } from '@datadog/datadog-api-client';
+import * as fs from 'fs';
+
+const configuration = v2.createConfiguration();
+const apiInstance = new v2.KeyManagementApi(configuration);
+
+let params:v2.KeyManagementApiGetApplicationKeyRequest = {
+  // string | The ID of the application key.
+  appKeyId: "app_key_id_example",
+  // string | Resource path for related resources to include in the response. Only `owned_by` is supported. (optional)
+  include: "owned_by",
+};
+
+apiInstance.getApplicationKey(params).then((data:any) => {
+  console.log('API called successfully. Returned data: ' + JSON.stringify(data));
+}).catch((error:any) => console.error(error));
+```
+
+
+### Parameters
+
+Name | Type | Description  | Notes
+------------- | ------------- | ------------- | -------------
+ **appKeyId** | [**string**] | The ID of the application key. | defaults to undefined
+ **include** | [**string**] | Resource path for related resources to include in the response. Only `owned_by` is supported. | (optional) defaults to undefined
+
+
+### Return type
+
+**ApplicationKeyResponse**
+
+### Authorization
+
+[apiKeyAuth](README.md#apiKeyAuth), [appKeyAuth](README.md#appKeyAuth)
+
+### HTTP request headers
+
+ - **Content-Type**: Not defined
+ - **Accept**: application/json
+
+
+### HTTP response details
+| Status code | Description | Response headers |
+|-------------|-------------|------------------|
+**200** | OK |  -  |
+**400** | Bad Request |  -  |
+**403** | Forbidden |  -  |
+**404** | Not Found |  -  |
+
+[[Back to top]](#) [[Back to API list]](README.md#documentation-for-api-endpoints) [[Back to Model list]](README.md#documentation-for-models) [[Back to README]](README.md)
+
 ## **getCurrentUserApplicationKey**
 > ApplicationKeyResponse getCurrentUserApplicationKey()
 

features/v2/key_management.feature

@@ -260,6 +260,28 @@ Feature: Key Management
     When the request is sent
     Then the response status is 200 OK
 
+  @generated @skip
+  Scenario: Get an application key returns "Bad Request" response
+    Given new "GetApplicationKey" request
+    And request contains "app_key_id" parameter from "<PATH>"
+    When the request is sent
+    Then the response status is 400 Bad Request
+
+  @generated @skip
+  Scenario: Get an application key returns "Not Found" response
+    Given new "GetApplicationKey" request
+    And request contains "app_key_id" parameter from "<PATH>"
+    When the request is sent
+    Then the response status is 404 Not Found
+
+  @integration-only
+  Scenario: Get an application key returns "OK" response
+    Given there is a valid "application_key" in the system
+    And new "GetApplicationKey" request
+    And request contains "app_key_id" parameter from "application_key.data.id"
+    When the request is sent
+    Then the response status is 200 OK
+
   @integration-only
   Scenario: Get one Application key owned by current user returns "OK" response
     Given there is a valid "application_key" in the system

features/v2/undo.json

@@ -48,6 +48,12 @@
       "type": "idempotent"
     }
   },
+  "GetApplicationKey": {
+    "tag": "Key Management",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "UpdateApplicationKey": {
     "tag": "Key Management",
     "undo": {

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

@@ -366,6 +366,68 @@ export class KeyManagementApiRequestFactory extends BaseAPIRequestFactory {
     return requestContext;
   }
 
+  /**
+   * Get an application key for your org.
+   * Get an application key
+   * @param appKeyId The ID of the application key.
+   * @param include Resource path for related resources to include in the response. Only `owned_by` is supported.
+   */
+  public async getApplicationKey(
+    appKeyId: string,
+    include?: string,
+    options?: Configuration
+  ): Promise<RequestContext> {
+    const config = options || this.configuration;
+
+    // verify required parameter 'appKeyId' is not null or undefined
+    if (appKeyId === null || appKeyId === undefined) {
+      throw new RequiredError(
+        "Required parameter appKeyId was null or undefined when calling getApplicationKey."
+      );
+    }
+
+    // Path Params
+    const localVarPath = "/api/v2/application_keys/{app_key_id}".replace(
+      "{" + "app_key_id" + "}",
+      encodeURIComponent(String(appKeyId))
+    );
+
+    // Make Request Context
+    const requestContext = getServer(
+      config,
+      "KeyManagementApi.getApplicationKey"
+    ).makeRequestContext(localVarPath, HttpMethod.GET);
+    requestContext.setHeaderParam("Accept", "application/json, */*;q=0.8");
+    requestContext.setHttpConfig(config.httpConfig);
+
+    // Query Params
+    if (include !== undefined) {
+      requestContext.setQueryParam(
+        "include",
+        ObjectSerializer.serialize(include, "string", "")
+      );
+    }
+
+    // Header Params
+
+    // Form Params
+
+    // Body Params
+
+    let authMethod = null;
+    // Apply auth methods
+    authMethod = config.authMethods["apiKeyAuth"];
+    if (authMethod) {
+      await authMethod.applySecurityAuthentication(requestContext);
+    }
+    authMethod = config.authMethods["appKeyAuth"];
+    if (authMethod) {
+      await authMethod.applySecurityAuthentication(requestContext);
+    }
+
+    return requestContext;
+  }
+
   /**
    * Get an application key owned by current user
    * Get one application key owned by current user
@@ -1241,6 +1303,69 @@ export class KeyManagementApiResponseProcessor {
     );
   }
 
+  /**
+   * 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 getApplicationKey
+   * @throws ApiException if the response code was not in [200, 299]
+   */
+  public async getApplicationKey(
+    response: ResponseContext
+  ): Promise<ApplicationKeyResponse> {
+    const contentType = ObjectSerializer.normalizeMediaType(
+      response.headers["content-type"]
+    );
+    if (isCodeInRange("200", response.httpStatusCode)) {
+      const body: ApplicationKeyResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "ApplicationKeyResponse",
+        ""
+      ) as ApplicationKeyResponse;
+      return body;
+    }
+    if (isCodeInRange("400", response.httpStatusCode)) {
+      const body: APIErrorResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "APIErrorResponse",
+        ""
+      ) as APIErrorResponse;
+      throw new ApiException<APIErrorResponse>(400, body);
+    }
+    if (isCodeInRange("403", response.httpStatusCode)) {
+      const body: APIErrorResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "APIErrorResponse",
+        ""
+      ) as APIErrorResponse;
+      throw new ApiException<APIErrorResponse>(403, body);
+    }
+    if (isCodeInRange("404", response.httpStatusCode)) {
+      const body: APIErrorResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "APIErrorResponse",
+        ""
+      ) as APIErrorResponse;
+      throw new ApiException<APIErrorResponse>(404, body);
+    }
+
+    // Work around for missing responses in specification, e.g. for petstore.yaml
+    if (response.httpStatusCode >= 200 && response.httpStatusCode <= 299) {
+      const body: ApplicationKeyResponse = ObjectSerializer.deserialize(
+        ObjectSerializer.parse(await response.body.text(), contentType),
+        "ApplicationKeyResponse",
+        ""
+      ) as ApplicationKeyResponse;
+      return body;
+    }
+
+    const body = response.body || "";
+    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

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

@@ -36,6 +36,7 @@ export {
   KeyManagementApiDeleteApplicationKeyRequest,
   KeyManagementApiDeleteCurrentUserApplicationKeyRequest,
   KeyManagementApiGetAPIKeyRequest,
+  KeyManagementApiGetApplicationKeyRequest,
   KeyManagementApiGetCurrentUserApplicationKeyRequest,
   KeyManagementApiListAPIKeysRequest,
   KeyManagementApiListApplicationKeysRequest,

packages/datadog-api-client-v2/types/ObjectParamAPI.ts

@@ -775,6 +775,21 @@ export interface KeyManagementApiGetAPIKeyRequest {
   include?: string;
 }
 
+export interface KeyManagementApiGetApplicationKeyRequest {
+  /**
+   * The ID of the application key.
+   * @type string
+   * @memberof KeyManagementApigetApplicationKey
+   */
+  appKeyId: string;
+  /**
+   * Resource path for related resources to include in the response. Only `owned_by` is supported.
+   * @type string
+   * @memberof KeyManagementApigetApplicationKey
+   */
+  include?: string;
+}
+
 export interface KeyManagementApiGetCurrentUserApplicationKeyRequest {
   /**
    * The ID of the application key.
@@ -1057,6 +1072,20 @@ export class ObjectKeyManagementApi {
       .toPromise();
   }
 
+  /**
+   * Get an application key for your org.
+   * Get an application key
+   * @param param the request object
+   */
+  public getApplicationKey(
+    param: KeyManagementApiGetApplicationKeyRequest,
+    options?: Configuration
+  ): Promise<ApplicationKeyResponse> {
+    return this.api
+      .getApplicationKey(param.appKeyId, param.include, options)
+      .toPromise();
+  }
+
   /**
    * Get an application key owned by current user
    * Get one application key owned by current user

packages/datadog-api-client-v2/types/ObservableAPI.ts

@@ -1320,6 +1320,52 @@ export class ObservableKeyManagementApi {
       );
   }
 
+  /**
+   * Get an application key for your org.
+   * Get an application key
+   * @param appKeyId The ID of the application key.
+   * @param include Resource path for related resources to include in the response. Only `owned_by` is supported.
+   */
+  public getApplicationKey(
+    appKeyId: string,
+    include?: string,
+    options?: Configuration
+  ): Observable<ApplicationKeyResponse> {
+    const requestContextPromise = this.requestFactory.getApplicationKey(
+      appKeyId,
+      include,
+      options
+    );
+
+    // build promise chain
+    let middlewarePreObservable = from_<RequestContext>(requestContextPromise);
+    for (const middleware of this.configuration.middleware) {
+      middlewarePreObservable = middlewarePreObservable.pipe(
+        mergeMap((ctx: RequestContext) => middleware.pre(ctx))
+      );
+    }
+
+    return middlewarePreObservable
+      .pipe(
+        mergeMap((ctx: RequestContext) => this.configuration.httpApi.send(ctx))
+      )
+      .pipe(
+        mergeMap((response: ResponseContext) => {
+          let middlewarePostObservable = of(response);
+          for (const middleware of this.configuration.middleware) {
+            middlewarePostObservable = middlewarePostObservable.pipe(
+              mergeMap((rsp: ResponseContext) => middleware.post(rsp))
+            );
+          }
+          return middlewarePostObservable.pipe(
+            map((rsp: ResponseContext) =>
+              this.responseProcessor.getApplicationKey(rsp)
+            )
+          );
+        })
+      );
+  }
+
   /**
    * Get an application key owned by current user
    * Get one application key owned by current user