@scaleway/sdk 2.72.0 → 2.74.0

package/dist/api/key_manager/v1alpha1/api.gen.cjs

@@ -17,10 +17,7 @@ class API extends api.API {
     "pl-waw"
   ];
   /**
-   * Create a key. Create a key in a given region specified by the `region`
-   * parameter. Keys only support symmetric encryption. You can use keys to
-   * encrypt or decrypt arbitrary payloads, or to generate data encryption keys.
-   * **Data encryption keys are not stored in Key Manager**.
+   * Create a key. Create a key in a given region specified by the `region` parameter. Keys only support symmetric encryption. You can use keys to encrypt or decrypt arbitrary payloads, or to generate data encryption keys. **Data encryption keys are not stored in Key Manager**.
    *
    * @param request - The request {@link CreateKeyRequest}
    * @returns A Promise of Key
@@ -37,8 +34,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Get key metadata. Retrieve metadata for a specified key using the `region`
-   * and `key_id` parameters.
+   * Get key metadata. Retrieve metadata for a specified key using the `region` and `key_id` parameters.
    *
    * @param request - The request {@link GetKeyRequest}
    * @returns A Promise of Key
@@ -51,8 +47,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Update a key. Modify a key's metadata including name, description and tags,
-   * specified by the `key_id` and `region` parameters.
+   * Update a key. Modify a key's metadata including name, description and tags, specified by the `key_id` and `region` parameters.
    *
    * @param request - The request {@link UpdateKeyRequest}
    * @returns A Promise of Key
@@ -69,9 +64,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Delete a key. Permanently delete a key specified by the `region` and
-   * `key_id` parameters. This action is irreversible. Any data encrypted with
-   * this key, including data encryption keys, will no longer be decipherable.
+   * Delete a key. Permanently delete a key specified by the `region` and `key_id` parameters. This action is irreversible. Any data encrypted with this key, including data encryption keys, will no longer be decipherable.
    *
    * @param request - The request {@link DeleteKeyRequest}
    */
@@ -80,10 +73,7 @@ class API extends api.API {
     path: `/key-manager/v1alpha1/regions/${marshalling.validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/keys/${marshalling.validatePathParam("keyId", request.keyId)}`
   });
   /**
-   * Rotate a key. Generate a new version of an existing key with new key
-   * material. Previous key versions remain usable to decrypt previously
-   * encrypted data, but the key's new version will be used for subsequent
-   * encryption operations and data key generation.
+   * Rotate a key. Generate a new version of an existing key with new key material. Previous key versions remain usable to decrypt previously encrypted data, but the key's new version will be used for subsequent encryption operations and data key generation.
    *
    * @param request - The request {@link RotateKeyRequest}
    * @returns A Promise of Key
@@ -98,9 +88,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Apply key protection. Apply protection to a given key specified by the
-   * `key_id` parameter. Applying key protection means that your key can be used
-   * and modified, but it cannot be deleted.
+   * Apply key protection. Apply protection to a given key specified by the `key_id` parameter. Applying key protection means that your key can be used and modified, but it cannot be deleted.
    *
    * @param request - The request {@link ProtectKeyRequest}
    * @returns A Promise of Key
@@ -115,9 +103,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Remove key protection. Remove key protection from a given key specified by
-   * the `key_id` parameter. Removing key protection means that your key can be
-   * deleted anytime.
+   * Remove key protection. Remove key protection from a given key specified by the `key_id` parameter. Removing key protection means that your key can be deleted anytime.
    *
    * @param request - The request {@link UnprotectKeyRequest}
    * @returns A Promise of Key
@@ -132,9 +118,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Enable key. Enable a given key to be used for cryptographic operations.
-   * Enabling a key allows you to make a disabled key usable again. You must
-   * specify the `region` and `key_id` parameters.
+   * Enable key. Enable a given key to be used for cryptographic operations. Enabling a key allows you to make a disabled key usable again. You must specify the `region` and `key_id` parameters.
    *
    * @param request - The request {@link EnableKeyRequest}
    * @returns A Promise of Key
@@ -149,9 +133,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Disable key. Disable a given key, preventing it to be used for
-   * cryptographic operations. Disabling a key renders it unusable. You must
-   * specify the `region` and `key_id` parameters.
+   * Disable key. Disable a given key, preventing it to be used for cryptographic operations. Disabling a key renders it unusable. You must specify the `region` and `key_id` parameters.
    *
    * @param request - The request {@link DisableKeyRequest}
    * @returns A Promise of Key
@@ -185,28 +167,20 @@ class API extends api.API {
     marshalling_gen.unmarshalListKeysResponse
   );
   /**
-   * List keys. Retrieve a list of keys across all Projects in an Organization
-   * or within a specific Project. You must specify the `region`, and either the
-   * `organization_id` or the `project_id`.
+   * List keys. Retrieve a list of keys across all Projects in an Organization or within a specific Project. You must specify the `region`, and either the `organization_id` or the `project_id`.
    *
    * @param request - The request {@link ListKeysRequest}
    * @returns A Promise of ListKeysResponse
    */
   listKeys = (request = {}) => resourcePaginator.enrichForPagination("keys", this.pageOfListKeys, request);
   /**
-   * Create a data encryption key. Create a new data encryption key for
-   * cryptographic operations outside of Key Manager. The data encryption key is
-   * encrypted and must be decrypted using the key you have created in Key
-   * Manager.
-   *
-   * The data encryption key is returned in plaintext and ciphertext but it
-   * should only be stored in its encrypted form (ciphertext). Key Manager does
-   * not store your data encryption key. To retrieve your key's plaintext, use
-   * the `Decrypt` method with your key's ID and ciphertext.
-   *
-   * @param request - The request {@link GenerateDataKeyRequest}
-   * @returns A Promise of DataKey
-   */
+     * Create a data encryption key. Create a new data encryption key for cryptographic operations outside of Key Manager. The data encryption key is encrypted and must be decrypted using the key you have created in Key Manager.
+  
+  The data encryption key is returned in plaintext and ciphertext but it should only be stored in its encrypted form (ciphertext). Key Manager does not store your data encryption key. To retrieve your key's plaintext, use the `Decrypt` method with your key's ID and ciphertext.
+     *
+     * @param request - The request {@link GenerateDataKeyRequest}
+     * @returns A Promise of DataKey
+     */
   generateDataKey = (request) => this.client.fetch(
     {
       body: JSON.stringify(
@@ -219,10 +193,7 @@ class API extends api.API {
     marshalling_gen.unmarshalDataKey
   );
   /**
-   * Encrypt a payload. Encrypt a payload using an existing key, specified by
-   * the `key_id` parameter. Only keys with a usage set to
-   * `symmetric_encryption` are supported by this method. The maximum payload
-   * size that can be encrypted is 64 KB of plaintext.
+   * Encrypt a payload. Encrypt a payload using an existing key, specified by the `key_id` parameter. Only keys with a usage set to `symmetric_encryption` are supported by this method. The maximum payload size that can be encrypted is 64 KB of plaintext.
    *
    * @param request - The request {@link EncryptRequest}
    * @returns A Promise of EncryptResponse
@@ -239,10 +210,7 @@ class API extends api.API {
     marshalling_gen.unmarshalEncryptResponse
   );
   /**
-   * Decrypt an encrypted payload. Decrypt an encrypted payload using an
-   * existing key, specified by the `key_id` parameter. The maximum payload size
-   * that can be decrypted is equivalent to the encrypted output of 64 KB of
-   * data (around 131 KB).
+   * Decrypt an encrypted payload. Decrypt an encrypted payload using an existing key, specified by the `key_id` parameter. The maximum payload size that can be decrypted is equivalent to the encrypted output of 64 KB of data (around 131 KB).
    *
    * @param request - The request {@link DecryptRequest}
    * @returns A Promise of DecryptResponse
@@ -259,9 +227,7 @@ class API extends api.API {
     marshalling_gen.unmarshalDecryptResponse
   );
   /**
-   * Import key material. Import externally generated key material into Key
-   * Manager to derive a new cryptographic key. The key's origin must be
-   * `external`.
+   * Import key material. Import externally generated key material into Key Manager to derive a new cryptographic key. The key's origin must be `external`.
    *
    * @param request - The request {@link ImportKeyMaterialRequest}
    * @returns A Promise of Key
@@ -278,9 +244,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Delete key material. Delete previously imported key material. This renders
-   * the associated cryptographic key unusable for any operation. The key's
-   * origin must be `external`.
+   * Delete key material. Delete previously imported key material. This renders the associated cryptographic key unusable for any operation. The key's origin must be `external`.
    *
    * @param request - The request {@link DeleteKeyMaterialRequest}
    */

package/dist/api/key_manager/v1alpha1/api.gen.d.ts

@@ -3,88 +3,69 @@ import type { Region as ScwRegion } from '@scaleway/sdk-client';
 import type { CreateKeyRequest, DataKey, DecryptRequest, DecryptResponse, DeleteKeyMaterialRequest, DeleteKeyRequest, DisableKeyRequest, EnableKeyRequest, EncryptRequest, EncryptResponse, GenerateDataKeyRequest, GetKeyRequest, ImportKeyMaterialRequest, Key, ListKeysRequest, ListKeysResponse, ProtectKeyRequest, RotateKeyRequest, UnprotectKeyRequest, UpdateKeyRequest } from './types.gen';
 /**
  * Key Manager API.
- *
- * This API allows you to create, manage and use cryptographic keys in a
- * centralized and secure service.
+
+This API allows you to create, manage and use cryptographic keys in a centralized and secure service.
  */
 export declare class API extends ParentAPI {
     /** Lists the available regions of the API. */
     static readonly LOCALITIES: ScwRegion[];
     /**
-     * Create a key. Create a key in a given region specified by the `region`
-     * parameter. Keys only support symmetric encryption. You can use keys to
-     * encrypt or decrypt arbitrary payloads, or to generate data encryption keys.
-     * **Data encryption keys are not stored in Key Manager**.
+     * Create a key. Create a key in a given region specified by the `region` parameter. Keys only support symmetric encryption. You can use keys to encrypt or decrypt arbitrary payloads, or to generate data encryption keys. **Data encryption keys are not stored in Key Manager**.
      *
      * @param request - The request {@link CreateKeyRequest}
      * @returns A Promise of Key
      */
     createKey: (request: Readonly<CreateKeyRequest>) => Promise<Key>;
     /**
-     * Get key metadata. Retrieve metadata for a specified key using the `region`
-     * and `key_id` parameters.
+     * Get key metadata. Retrieve metadata for a specified key using the `region` and `key_id` parameters.
      *
      * @param request - The request {@link GetKeyRequest}
      * @returns A Promise of Key
      */
     getKey: (request: Readonly<GetKeyRequest>) => Promise<Key>;
     /**
-     * Update a key. Modify a key's metadata including name, description and tags,
-     * specified by the `key_id` and `region` parameters.
+     * Update a key. Modify a key's metadata including name, description and tags, specified by the `key_id` and `region` parameters.
      *
      * @param request - The request {@link UpdateKeyRequest}
      * @returns A Promise of Key
      */
     updateKey: (request: Readonly<UpdateKeyRequest>) => Promise<Key>;
     /**
-     * Delete a key. Permanently delete a key specified by the `region` and
-     * `key_id` parameters. This action is irreversible. Any data encrypted with
-     * this key, including data encryption keys, will no longer be decipherable.
+     * Delete a key. Permanently delete a key specified by the `region` and `key_id` parameters. This action is irreversible. Any data encrypted with this key, including data encryption keys, will no longer be decipherable.
      *
      * @param request - The request {@link DeleteKeyRequest}
      */
     deleteKey: (request: Readonly<DeleteKeyRequest>) => Promise<void>;
     /**
-     * Rotate a key. Generate a new version of an existing key with new key
-     * material. Previous key versions remain usable to decrypt previously
-     * encrypted data, but the key's new version will be used for subsequent
-     * encryption operations and data key generation.
+     * Rotate a key. Generate a new version of an existing key with new key material. Previous key versions remain usable to decrypt previously encrypted data, but the key's new version will be used for subsequent encryption operations and data key generation.
      *
      * @param request - The request {@link RotateKeyRequest}
      * @returns A Promise of Key
      */
     rotateKey: (request: Readonly<RotateKeyRequest>) => Promise<Key>;
     /**
-     * Apply key protection. Apply protection to a given key specified by the
-     * `key_id` parameter. Applying key protection means that your key can be used
-     * and modified, but it cannot be deleted.
+     * Apply key protection. Apply protection to a given key specified by the `key_id` parameter. Applying key protection means that your key can be used and modified, but it cannot be deleted.
      *
      * @param request - The request {@link ProtectKeyRequest}
      * @returns A Promise of Key
      */
     protectKey: (request: Readonly<ProtectKeyRequest>) => Promise<Key>;
     /**
-     * Remove key protection. Remove key protection from a given key specified by
-     * the `key_id` parameter. Removing key protection means that your key can be
-     * deleted anytime.
+     * Remove key protection. Remove key protection from a given key specified by the `key_id` parameter. Removing key protection means that your key can be deleted anytime.
      *
      * @param request - The request {@link UnprotectKeyRequest}
      * @returns A Promise of Key
      */
     unprotectKey: (request: Readonly<UnprotectKeyRequest>) => Promise<Key>;
     /**
-     * Enable key. Enable a given key to be used for cryptographic operations.
-     * Enabling a key allows you to make a disabled key usable again. You must
-     * specify the `region` and `key_id` parameters.
+     * Enable key. Enable a given key to be used for cryptographic operations. Enabling a key allows you to make a disabled key usable again. You must specify the `region` and `key_id` parameters.
      *
      * @param request - The request {@link EnableKeyRequest}
      * @returns A Promise of Key
      */
     enableKey: (request: Readonly<EnableKeyRequest>) => Promise<Key>;
     /**
-     * Disable key. Disable a given key, preventing it to be used for
-     * cryptographic operations. Disabling a key renders it unusable. You must
-     * specify the `region` and `key_id` parameters.
+     * Disable key. Disable a given key, preventing it to be used for cryptographic operations. Disabling a key renders it unusable. You must specify the `region` and `key_id` parameters.
      *
      * @param request - The request {@link DisableKeyRequest}
      * @returns A Promise of Key
@@ -92,9 +73,7 @@ export declare class API extends ParentAPI {
     disableKey: (request: Readonly<DisableKeyRequest>) => Promise<Key>;
     protected pageOfListKeys: (request?: Readonly<ListKeysRequest>) => Promise<ListKeysResponse>;
     /**
-     * List keys. Retrieve a list of keys across all Projects in an Organization
-     * or within a specific Project. You must specify the `region`, and either the
-     * `organization_id` or the `project_id`.
+     * List keys. Retrieve a list of keys across all Projects in an Organization or within a specific Project. You must specify the `region`, and either the `organization_id` or the `project_id`.
      *
      * @param request - The request {@link ListKeysRequest}
      * @returns A Promise of ListKeysResponse
@@ -104,53 +83,37 @@ export declare class API extends ParentAPI {
         [Symbol.asyncIterator]: () => AsyncGenerator<Key[], void, void>;
     };
     /**
-     * Create a data encryption key. Create a new data encryption key for
-     * cryptographic operations outside of Key Manager. The data encryption key is
-     * encrypted and must be decrypted using the key you have created in Key
-     * Manager.
-     *
-     * The data encryption key is returned in plaintext and ciphertext but it
-     * should only be stored in its encrypted form (ciphertext). Key Manager does
-     * not store your data encryption key. To retrieve your key's plaintext, use
-     * the `Decrypt` method with your key's ID and ciphertext.
+     * Create a data encryption key. Create a new data encryption key for cryptographic operations outside of Key Manager. The data encryption key is encrypted and must be decrypted using the key you have created in Key Manager.
+  
+  The data encryption key is returned in plaintext and ciphertext but it should only be stored in its encrypted form (ciphertext). Key Manager does not store your data encryption key. To retrieve your key's plaintext, use the `Decrypt` method with your key's ID and ciphertext.
      *
      * @param request - The request {@link GenerateDataKeyRequest}
      * @returns A Promise of DataKey
      */
     generateDataKey: (request: Readonly<GenerateDataKeyRequest>) => Promise<DataKey>;
     /**
-     * Encrypt a payload. Encrypt a payload using an existing key, specified by
-     * the `key_id` parameter. Only keys with a usage set to
-     * `symmetric_encryption` are supported by this method. The maximum payload
-     * size that can be encrypted is 64 KB of plaintext.
+     * Encrypt a payload. Encrypt a payload using an existing key, specified by the `key_id` parameter. Only keys with a usage set to `symmetric_encryption` are supported by this method. The maximum payload size that can be encrypted is 64 KB of plaintext.
      *
      * @param request - The request {@link EncryptRequest}
      * @returns A Promise of EncryptResponse
      */
     encrypt: (request: Readonly<EncryptRequest>) => Promise<EncryptResponse>;
     /**
-     * Decrypt an encrypted payload. Decrypt an encrypted payload using an
-     * existing key, specified by the `key_id` parameter. The maximum payload size
-     * that can be decrypted is equivalent to the encrypted output of 64 KB of
-     * data (around 131 KB).
+     * Decrypt an encrypted payload. Decrypt an encrypted payload using an existing key, specified by the `key_id` parameter. The maximum payload size that can be decrypted is equivalent to the encrypted output of 64 KB of data (around 131 KB).
      *
      * @param request - The request {@link DecryptRequest}
      * @returns A Promise of DecryptResponse
      */
     decrypt: (request: Readonly<DecryptRequest>) => Promise<DecryptResponse>;
     /**
-     * Import key material. Import externally generated key material into Key
-     * Manager to derive a new cryptographic key. The key's origin must be
-     * `external`.
+     * Import key material. Import externally generated key material into Key Manager to derive a new cryptographic key. The key's origin must be `external`.
      *
      * @param request - The request {@link ImportKeyMaterialRequest}
      * @returns A Promise of Key
      */
     importKeyMaterial: (request: Readonly<ImportKeyMaterialRequest>) => Promise<Key>;
     /**
-     * Delete key material. Delete previously imported key material. This renders
-     * the associated cryptographic key unusable for any operation. The key's
-     * origin must be `external`.
+     * Delete key material. Delete previously imported key material. This renders the associated cryptographic key unusable for any operation. The key's origin must be `external`.
      *
      * @param request - The request {@link DeleteKeyMaterialRequest}
      */

package/dist/api/key_manager/v1alpha1/api.gen.js

@@ -15,10 +15,7 @@ class API extends API$1 {
     "pl-waw"
   ];
   /**
-   * Create a key. Create a key in a given region specified by the `region`
-   * parameter. Keys only support symmetric encryption. You can use keys to
-   * encrypt or decrypt arbitrary payloads, or to generate data encryption keys.
-   * **Data encryption keys are not stored in Key Manager**.
+   * Create a key. Create a key in a given region specified by the `region` parameter. Keys only support symmetric encryption. You can use keys to encrypt or decrypt arbitrary payloads, or to generate data encryption keys. **Data encryption keys are not stored in Key Manager**.
    *
    * @param request - The request {@link CreateKeyRequest}
    * @returns A Promise of Key
@@ -35,8 +32,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Get key metadata. Retrieve metadata for a specified key using the `region`
-   * and `key_id` parameters.
+   * Get key metadata. Retrieve metadata for a specified key using the `region` and `key_id` parameters.
    *
    * @param request - The request {@link GetKeyRequest}
    * @returns A Promise of Key
@@ -49,8 +45,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Update a key. Modify a key's metadata including name, description and tags,
-   * specified by the `key_id` and `region` parameters.
+   * Update a key. Modify a key's metadata including name, description and tags, specified by the `key_id` and `region` parameters.
    *
    * @param request - The request {@link UpdateKeyRequest}
    * @returns A Promise of Key
@@ -67,9 +62,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Delete a key. Permanently delete a key specified by the `region` and
-   * `key_id` parameters. This action is irreversible. Any data encrypted with
-   * this key, including data encryption keys, will no longer be decipherable.
+   * Delete a key. Permanently delete a key specified by the `region` and `key_id` parameters. This action is irreversible. Any data encrypted with this key, including data encryption keys, will no longer be decipherable.
    *
    * @param request - The request {@link DeleteKeyRequest}
    */
@@ -78,10 +71,7 @@ class API extends API$1 {
     path: `/key-manager/v1alpha1/regions/${validatePathParam("region", request.region ?? this.client.settings.defaultRegion)}/keys/${validatePathParam("keyId", request.keyId)}`
   });
   /**
-   * Rotate a key. Generate a new version of an existing key with new key
-   * material. Previous key versions remain usable to decrypt previously
-   * encrypted data, but the key's new version will be used for subsequent
-   * encryption operations and data key generation.
+   * Rotate a key. Generate a new version of an existing key with new key material. Previous key versions remain usable to decrypt previously encrypted data, but the key's new version will be used for subsequent encryption operations and data key generation.
    *
    * @param request - The request {@link RotateKeyRequest}
    * @returns A Promise of Key
@@ -96,9 +86,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Apply key protection. Apply protection to a given key specified by the
-   * `key_id` parameter. Applying key protection means that your key can be used
-   * and modified, but it cannot be deleted.
+   * Apply key protection. Apply protection to a given key specified by the `key_id` parameter. Applying key protection means that your key can be used and modified, but it cannot be deleted.
    *
    * @param request - The request {@link ProtectKeyRequest}
    * @returns A Promise of Key
@@ -113,9 +101,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Remove key protection. Remove key protection from a given key specified by
-   * the `key_id` parameter. Removing key protection means that your key can be
-   * deleted anytime.
+   * Remove key protection. Remove key protection from a given key specified by the `key_id` parameter. Removing key protection means that your key can be deleted anytime.
    *
    * @param request - The request {@link UnprotectKeyRequest}
    * @returns A Promise of Key
@@ -130,9 +116,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Enable key. Enable a given key to be used for cryptographic operations.
-   * Enabling a key allows you to make a disabled key usable again. You must
-   * specify the `region` and `key_id` parameters.
+   * Enable key. Enable a given key to be used for cryptographic operations. Enabling a key allows you to make a disabled key usable again. You must specify the `region` and `key_id` parameters.
    *
    * @param request - The request {@link EnableKeyRequest}
    * @returns A Promise of Key
@@ -147,9 +131,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Disable key. Disable a given key, preventing it to be used for
-   * cryptographic operations. Disabling a key renders it unusable. You must
-   * specify the `region` and `key_id` parameters.
+   * Disable key. Disable a given key, preventing it to be used for cryptographic operations. Disabling a key renders it unusable. You must specify the `region` and `key_id` parameters.
    *
    * @param request - The request {@link DisableKeyRequest}
    * @returns A Promise of Key
@@ -183,28 +165,20 @@ class API extends API$1 {
     unmarshalListKeysResponse
   );
   /**
-   * List keys. Retrieve a list of keys across all Projects in an Organization
-   * or within a specific Project. You must specify the `region`, and either the
-   * `organization_id` or the `project_id`.
+   * List keys. Retrieve a list of keys across all Projects in an Organization or within a specific Project. You must specify the `region`, and either the `organization_id` or the `project_id`.
    *
    * @param request - The request {@link ListKeysRequest}
    * @returns A Promise of ListKeysResponse
    */
   listKeys = (request = {}) => enrichForPagination("keys", this.pageOfListKeys, request);
   /**
-   * Create a data encryption key. Create a new data encryption key for
-   * cryptographic operations outside of Key Manager. The data encryption key is
-   * encrypted and must be decrypted using the key you have created in Key
-   * Manager.
-   *
-   * The data encryption key is returned in plaintext and ciphertext but it
-   * should only be stored in its encrypted form (ciphertext). Key Manager does
-   * not store your data encryption key. To retrieve your key's plaintext, use
-   * the `Decrypt` method with your key's ID and ciphertext.
-   *
-   * @param request - The request {@link GenerateDataKeyRequest}
-   * @returns A Promise of DataKey
-   */
+     * Create a data encryption key. Create a new data encryption key for cryptographic operations outside of Key Manager. The data encryption key is encrypted and must be decrypted using the key you have created in Key Manager.
+  
+  The data encryption key is returned in plaintext and ciphertext but it should only be stored in its encrypted form (ciphertext). Key Manager does not store your data encryption key. To retrieve your key's plaintext, use the `Decrypt` method with your key's ID and ciphertext.
+     *
+     * @param request - The request {@link GenerateDataKeyRequest}
+     * @returns A Promise of DataKey
+     */
   generateDataKey = (request) => this.client.fetch(
     {
       body: JSON.stringify(
@@ -217,10 +191,7 @@ class API extends API$1 {
     unmarshalDataKey
   );
   /**
-   * Encrypt a payload. Encrypt a payload using an existing key, specified by
-   * the `key_id` parameter. Only keys with a usage set to
-   * `symmetric_encryption` are supported by this method. The maximum payload
-   * size that can be encrypted is 64 KB of plaintext.
+   * Encrypt a payload. Encrypt a payload using an existing key, specified by the `key_id` parameter. Only keys with a usage set to `symmetric_encryption` are supported by this method. The maximum payload size that can be encrypted is 64 KB of plaintext.
    *
    * @param request - The request {@link EncryptRequest}
    * @returns A Promise of EncryptResponse
@@ -237,10 +208,7 @@ class API extends API$1 {
     unmarshalEncryptResponse
   );
   /**
-   * Decrypt an encrypted payload. Decrypt an encrypted payload using an
-   * existing key, specified by the `key_id` parameter. The maximum payload size
-   * that can be decrypted is equivalent to the encrypted output of 64 KB of
-   * data (around 131 KB).
+   * Decrypt an encrypted payload. Decrypt an encrypted payload using an existing key, specified by the `key_id` parameter. The maximum payload size that can be decrypted is equivalent to the encrypted output of 64 KB of data (around 131 KB).
    *
    * @param request - The request {@link DecryptRequest}
    * @returns A Promise of DecryptResponse
@@ -257,9 +225,7 @@ class API extends API$1 {
     unmarshalDecryptResponse
   );
   /**
-   * Import key material. Import externally generated key material into Key
-   * Manager to derive a new cryptographic key. The key's origin must be
-   * `external`.
+   * Import key material. Import externally generated key material into Key Manager to derive a new cryptographic key. The key's origin must be `external`.
    *
    * @param request - The request {@link ImportKeyMaterialRequest}
    * @returns A Promise of Key
@@ -276,9 +242,7 @@ class API extends API$1 {
     unmarshalKey
   );
   /**
-   * Delete key material. Delete previously imported key material. This renders
-   * the associated cryptographic key unusable for any operation. The key's
-   * origin must be `external`.
+   * Delete key material. Delete previously imported key material. This renders the associated cryptographic key unusable for any operation. The key's origin must be `external`.
    *
    * @param request - The request {@link DeleteKeyMaterialRequest}
    */