@scaleway/sdk 2.63.0 → 2.65.0

package/dist/api/instance/v1/types.private.gen.d.ts

@@ -1,11 +1,11 @@
-import type { Zone } from '../../../bridge';
+import type { Zone as ScwZone } from '../../../bridge';
 import type { Arch, BootType, Image, PlacementGroup, PrivateNIC, SecurityGroup, SecurityGroupPolicy, SecurityGroupRule, SecurityGroupRuleAction, SecurityGroupRuleDirection, SecurityGroupRuleProtocol, SecurityGroupSummary, Server, ServerAction, ServerIp, ServerIpv6, ServerLocation, ServerMaintenance, ServerState, ServerSummary, Snapshot, SnapshotBaseVolume, SnapshotState, Volume, VolumeVolumeType } from './types.gen';
 export interface SetImageResponse {
     image?: Image;
 }
 export type SetSecurityGroupRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
-    zone?: Zone;
+    zone?: ScwZone;
     /** UUID of the security group. */
     id: string;
     /** Name of the security group. */
@@ -45,7 +45,7 @@ export interface SetSecurityGroupResponse {
 }
 export type SetSecurityGroupRuleRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
-    zone?: Zone;
+    zone?: ScwZone;
     securityGroupId: string;
     securityGroupRuleId: string;
     id: string;
@@ -63,7 +63,7 @@ export interface SetSecurityGroupRuleResponse {
 }
 export type SetServerRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
-    zone?: Zone;
+    zone?: ScwZone;
     /** Instance unique ID. */
     id: string;
     /** Instance name. */
@@ -153,7 +153,7 @@ export interface SetServerResponse {
 }
 export type SetSnapshotRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
-    zone?: Zone;
+    zone?: ScwZone;
     snapshotId: string;
     id: string;
     name: string;

package/dist/api/interlink/v1beta1/api.gen.cjs

@@ -10,7 +10,11 @@ const jsonContentHeaders = {
 };
 class API extends api.API {
   /** Lists the available regions of the API. */
-  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  static LOCALITIES = [
+    "fr-par",
+    "nl-ams",
+    "pl-waw"
+  ];
   pageOfListPartners = (request = {}) => this.client.fetch(
     {
       method: "GET",

package/dist/api/interlink/v1beta1/api.gen.d.ts

@@ -1,5 +1,5 @@
 import { API as ParentAPI } from '../../../bridge';
-import type { Region } from '../../../bridge';
+import type { Region as ScwRegion } from '../../../bridge';
 import type { AttachRoutingPolicyRequest, AttachVpcRequest, CreateLinkRequest, CreateRoutingPolicyRequest, DeleteLinkRequest, DeleteRoutingPolicyRequest, DetachRoutingPolicyRequest, DetachVpcRequest, DisableRoutePropagationRequest, EnableRoutePropagationRequest, GetLinkRequest, GetPartnerRequest, GetPopRequest, GetRoutingPolicyRequest, Link, ListLinksRequest, ListLinksResponse, ListPartnersRequest, ListPartnersResponse, ListPopsRequest, ListPopsResponse, ListRoutingPoliciesRequest, ListRoutingPoliciesResponse, Partner, Pop, RoutingPolicy, UpdateLinkRequest, UpdateRoutingPolicyRequest } from './types.gen';
 /**
  * InterLink API.
@@ -9,7 +9,7 @@ import type { AttachRoutingPolicyRequest, AttachVpcRequest, CreateLinkRequest, C
  */
 export declare class API extends ParentAPI {
     /** Lists the available regions of the API. */
-    static readonly LOCALITIES: Region[];
+    static readonly LOCALITIES: ScwRegion[];
     protected pageOfListPartners: (request?: Readonly<ListPartnersRequest>) => Promise<ListPartnersResponse>;
     /**
      * List available partners. List all available partners. By default, the

package/dist/api/interlink/v1beta1/api.gen.js

@@ -8,7 +8,11 @@ const jsonContentHeaders = {
 };
 class API extends API$1 {
   /** Lists the available regions of the API. */
-  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  static LOCALITIES = [
+    "fr-par",
+    "nl-ams",
+    "pl-waw"
+  ];
   pageOfListPartners = (request = {}) => this.client.fetch(
     {
       method: "GET",

package/dist/api/interlink/v1beta1/marshalling.gen.cjs

@@ -14,6 +14,7 @@ const unmarshalLink = (data) => {
     bgpV4Status: data.bgp_v4_status,
     bgpV6Status: data.bgp_v6_status,
     createdAt: marshalling.unmarshalDate(data.created_at),
+    disapprovedReason: data.disapproved_reason,
     enableRoutePropagation: data.enable_route_propagation,
     id: data.id,
     name: data.name,

package/dist/api/interlink/v1beta1/marshalling.gen.js

@@ -12,6 +12,7 @@ const unmarshalLink = (data) => {
     bgpV4Status: data.bgp_v4_status,
     bgpV6Status: data.bgp_v6_status,
     createdAt: unmarshalDate(data.created_at),
+    disapprovedReason: data.disapproved_reason,
     enableRoutePropagation: data.enable_route_propagation,
     id: data.id,
     name: data.name,

package/dist/api/interlink/v1beta1/types.gen.d.ts

@@ -1,4 +1,4 @@
-import type { Region } from '../../../bridge';
+import type { Region as ScwRegion } from '../../../bridge';
 export type BgpStatus = 'unknown_bgp_status' | 'up' | 'down';
 export type LinkStatus = 'unknown_link_status' | 'configuring' | 'failed' | 'requested' | 'refused' | 'expired' | 'provisioning' | 'active' | 'limited_connectivity' | 'all_down' | 'deprovisioning' | 'deleted' | 'locked';
 export type ListLinksRequestOrderBy = 'created_at_asc' | 'created_at_desc' | 'name_asc' | 'name_desc' | 'status_asc' | 'status_desc';
@@ -43,8 +43,13 @@ export interface Link {
     updatedAt?: Date;
     /** Used to identify a link from a user or partner's point of view. */
     pairingKey: string;
+    /**
+     * Reason given by partner to explain why they did not approve the request for
+     * a hosted link.
+     */
+    disapprovedReason?: string;
     /** Region of the link. */
-    region: Region;
+    region: ScwRegion;
 }
 export interface Partner {
     /** Unique identifier of the partner. */
@@ -84,7 +89,7 @@ export interface Pop {
      */
     availableLinkBandwidthsMbps: number[];
     /** Region of the PoP. */
-    region: Region;
+    region: ScwRegion;
 }
 export interface RoutingPolicy {
     /** Unique identifier of the routing policy. */
@@ -109,14 +114,14 @@ export interface RoutingPolicy {
     /** Last modification date of the routing policy. */
     updatedAt?: Date;
     /** Region of the routing policy. */
-    region: Region;
+    region: ScwRegion;
 }
 export type AttachRoutingPolicyRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to attach a routing policy to. */
     linkId: string;
     /** ID of the routing policy to be attached. */
@@ -127,7 +132,7 @@ export type AttachVpcRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to attach VPC to. */
     linkId: string;
     /** ID of the VPC to attach. */
@@ -138,7 +143,7 @@ export type CreateLinkRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the Project to create the link in. */
     projectId?: string;
     /** Name of the link. */
@@ -191,7 +196,7 @@ export type CreateRoutingPolicyRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the Project to create the routing policy in. */
     projectId?: string;
     /** Name of the routing policy. */
@@ -211,7 +216,7 @@ export type DeleteLinkRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to delete. */
     linkId: string;
 };
@@ -220,7 +225,7 @@ export type DeleteRoutingPolicyRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the routing policy to delete. */
     routingPolicyId: string;
 };
@@ -229,7 +234,7 @@ export type DetachRoutingPolicyRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to detach a routing policy from. */
     linkId: string;
 };
@@ -238,7 +243,7 @@ export type DetachVpcRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to detach the VPC from. */
     linkId: string;
 };
@@ -247,7 +252,7 @@ export type DisableRoutePropagationRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link on which to disable route propagation. */
     linkId: string;
 };
@@ -256,7 +261,7 @@ export type EnableRoutePropagationRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link on which to enable route propagation. */
     linkId: string;
 };
@@ -265,7 +270,7 @@ export type GetLinkRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to get. */
     linkId: string;
 };
@@ -274,7 +279,7 @@ export type GetPartnerRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of partner to get. */
     partnerId: string;
 };
@@ -283,7 +288,7 @@ export type GetPopRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of PoP to get. */
     popId: string;
 };
@@ -292,7 +297,7 @@ export type GetRoutingPolicyRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the routing policy to get. */
     routingPolicyId: string;
 };
@@ -301,7 +306,7 @@ export type ListLinksRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** Order in which to return results. */
     orderBy?: ListLinksRequestOrderBy;
     /** Page number to return. */
@@ -346,7 +351,7 @@ export type ListPartnersRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** Order in which to return results. */
     orderBy?: ListPartnersRequestOrderBy;
     /** Page number to return. */
@@ -367,7 +372,7 @@ export type ListPopsRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** Order in which to return results. */
     orderBy?: ListPopsRequestOrderBy;
     /** Page number to return. */
@@ -397,7 +402,7 @@ export type ListRoutingPoliciesRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** Order in which to return results. */
     orderBy?: ListRoutingPoliciesRequestOrderBy;
     /** Page number to return. */
@@ -422,7 +427,7 @@ export type UpdateLinkRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the link to update. */
     linkId: string;
     /** Name of the link. */
@@ -435,7 +440,7 @@ export type UpdateRoutingPolicyRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** ID of the routing policy to update. */
     routingPolicyId: string;
     /** Name of the routing policy. */

package/dist/api/ipam/v1/api.gen.cjs

@@ -10,7 +10,11 @@ const jsonContentHeaders = {
 };
 class API extends api.API {
   /** Lists the available regions of the API. */
-  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  static LOCALITIES = [
+    "fr-par",
+    "nl-ams",
+    "pl-waw"
+  ];
   /**
    * Reserve a new IP. Reserve a new IP from the specified source. Currently IPs
    * can only be reserved from a Private Network.

package/dist/api/ipam/v1/api.gen.d.ts

@@ -1,5 +1,5 @@
 import { API as ParentAPI } from '../../../bridge';
-import type { Region } from '../../../bridge';
+import type { Region as ScwRegion } from '../../../bridge';
 import type { AttachIPRequest, BookIPRequest, DetachIPRequest, GetIPRequest, IP, ListIPsRequest, ListIPsResponse, MoveIPRequest, ReleaseIPRequest, ReleaseIPSetRequest, UpdateIPRequest } from './types.gen';
 /**
  * IPAM API.
@@ -9,7 +9,7 @@ import type { AttachIPRequest, BookIPRequest, DetachIPRequest, GetIPRequest, IP,
  */
 export declare class API extends ParentAPI {
     /** Lists the available regions of the API. */
-    static readonly LOCALITIES: Region[];
+    static readonly LOCALITIES: ScwRegion[];
     /**
      * Reserve a new IP. Reserve a new IP from the specified source. Currently IPs
      * can only be reserved from a Private Network.

package/dist/api/ipam/v1/api.gen.js

@@ -8,7 +8,11 @@ const jsonContentHeaders = {
 };
 class API extends API$1 {
   /** Lists the available regions of the API. */
-  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  static LOCALITIES = [
+    "fr-par",
+    "nl-ams",
+    "pl-waw"
+  ];
   /**
    * Reserve a new IP. Reserve a new IP from the specified source. Currently IPs
    * can only be reserved from a Private Network.

package/dist/api/ipam/v1/types.gen.d.ts

@@ -1,6 +1,6 @@
-import type { Region, Zone } from '../../../bridge';
+import type { Region as ScwRegion, Zone as ScwZone } from '../../../bridge';
 export type ListIPsRequestOrderBy = 'created_at_desc' | 'created_at_asc' | 'updated_at_desc' | 'updated_at_asc' | 'attached_at_desc' | 'attached_at_asc';
-export type ResourceType = 'unknown_type' | 'custom' | 'instance_server' | 'instance_ip' | 'instance_private_nic' | 'lb_server' | 'fip_ip' | 'vpc_gateway' | 'vpc_gateway_network' | 'k8s_node' | 'k8s_cluster' | 'rdb_instance' | 'redis_cluster' | 'baremetal_server' | 'baremetal_private_nic' | 'llm_deployment' | 'mgdb_instance' | 'apple_silicon_server' | 'apple_silicon_private_nic';
+export type ResourceType = 'unknown_type' | 'custom' | 'instance_server' | 'instance_ip' | 'instance_private_nic' | 'lb_server' | 'fip_ip' | 'vpc_gateway' | 'vpc_gateway_network' | 'k8s_node' | 'k8s_cluster' | 'rdb_instance' | 'redis_cluster' | 'baremetal_server' | 'baremetal_private_nic' | 'llm_deployment' | 'mgdb_instance' | 'apple_silicon_server' | 'apple_silicon_private_nic' | 'serverless_container' | 'serverless_function';
 export interface Resource {
     /** Type of resource the IP is attached to. */
     type: ResourceType;
@@ -74,16 +74,16 @@ export interface IP {
     /** Array of reverses associated with the IP. */
     reverses: Reverse[];
     /** Region of the IP. */
-    region: Region;
+    region: ScwRegion;
     /** Zone of the IP, if zonal. */
-    zone?: Zone;
+    zone?: ScwZone;
 }
 export type AttachIPRequest = {
     /**
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
     /** Custom resource to be attached to the IP. */
@@ -94,7 +94,7 @@ export type BookIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /**
      * When creating an IP in a Private Network, the Project must match the
      * Private Network's Project.
@@ -128,7 +128,7 @@ export type DetachIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
     /** Custom resource currently attached to the IP. */
@@ -139,7 +139,7 @@ export type GetIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
 };
@@ -148,7 +148,7 @@ export type ListIPsRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** Sort order of the returned IPs. */
     orderBy?: ListIPsRequestOrderBy;
     /** Page number to return, from the paginated results. */
@@ -240,7 +240,7 @@ export type MoveIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
     /** Custom resource currently attached to the IP. */
@@ -253,7 +253,7 @@ export type ReleaseIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
 };
@@ -262,7 +262,7 @@ export type ReleaseIPSetRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     ipIds?: string[];
 };
 export type UpdateIPRequest = {
@@ -270,7 +270,7 @@ export type UpdateIPRequest = {
      * Region to target. If none is passed will use default region from the
      * config.
      */
-    region?: Region;
+    region?: ScwRegion;
     /** IP ID. */
     ipId: string;
     /** Tags for the IP. */

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

@@ -10,12 +10,16 @@ const jsonContentHeaders = {
 };
 class API extends api.API {
   /** Lists the available regions of the API. */
-  static LOCALITIES = ["fr-par", "nl-ams", "pl-waw"];
+  static LOCALITIES = [
+    "fr-par",
+    "nl-ams",
+    "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
-   * that can be used without being stored in Key Manager.
+   * 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
@@ -32,7 +36,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Get key metadata. Retrieve the metadata of a key specified by the `region`
+   * Get key metadata. Retrieve metadata for a specified key using the `region`
    * and `key_id` parameters.
    *
    * @param request - The request {@link GetKeyRequest}
@@ -46,7 +50,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Update a key. Update a key's metadata (name, description and tags),
+   * 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}
@@ -64,10 +68,9 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Delete a key. Delete an existing key specified by the `region` and `key_id`
-   * parameters. Deleting a key is permanent and cannot be undone. All data
-   * encrypted using this key, including data encryption keys, will become
-   * unusable.
+   * 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}
    */
@@ -76,10 +79,10 @@ 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 randomly
-   * generated key material. Rotated keys can still be used to decrypt
-   * previously encrypted data. The key's new material 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
@@ -94,7 +97,7 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Apply key protection. Apply key protection to a given key specified by the
+   * 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.
    *
@@ -145,9 +148,9 @@ class API extends api.API {
     marshalling_gen.unmarshalKey
   );
   /**
-   * Disable key. Disable a given key 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
@@ -181,25 +184,24 @@ class API extends api.API {
     marshalling_gen.unmarshalListKeysResponse
   );
   /**
-   * List keys. Retrieve the list of keys created within all Projects of an
-   * Organization or in a given 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);
   /**
-   * Generate a data encryption key. Generate a new data encryption key to use
-   * for cryptographic operations outside of Key Manager. Note that Key Manager
-   * does not store your data encryption key. The data encryption key is
+   * 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's plaintext is returned in the response
-   * object, for immediate usage.
+   * Manager.
    *
-   * Always store the data encryption key's ciphertext, rather than its
-   * plaintext, which must not be stored. To retrieve your key's plaintext, call
-   * the Decrypt endpoint with your key's ID and ciphertext.
+   * 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
@@ -216,10 +218,10 @@ class API extends api.API {
     marshalling_gen.unmarshalDataKey
   );
   /**
-   * Encrypt data. Encrypt data 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
-   * 64KB 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
@@ -236,9 +238,10 @@ class API extends api.API {
     marshalling_gen.unmarshalEncryptResponse
   );
   /**
-   * Decrypt data. Decrypt data using an existing key, specified by the `key_id`
-   * parameter. The maximum payload size that can be decrypted is the result of
-   * the encryption of 64KB of data (around 131KB).
+   * 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
@@ -255,8 +258,9 @@ class API extends api.API {
     marshalling_gen.unmarshalDecryptResponse
   );
   /**
-   * Import key material. Import key material to use 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