@scaleway/sdk 1.10.1 → 1.11.0

package/dist/index.d.ts

@@ -910,7 +910,11 @@ interface TokenAccessor {
  */
 declare const authenticateWithSessionToken: (getToken: TokenAccessor) => RequestInterceptor;
 
-/** Unmarshals {@link Money} */
+/**
+ * Unmarshals {@link Money}
+ *
+ * @internal
+ */
 declare const unmarshalMoney: (data: unknown) => Money;
 /**
  * Unmarshals {@link ServiceInfo}.
@@ -1040,6 +1044,8 @@ type PaginatedContent<K extends string, T = unknown> = PaginatedResponse & {
  * @param fetcher - The method to retrieve paginated resources
  * @param request - A request with pagination options
  * @returns A resource Promise with the pagination helpers
+ *
+ * @internal
  */
 declare const enrichForPagination: <K extends string, T extends PaginatedContent<K, unknown>, R extends PaginationOptions>(key: K, fetcher: PaginatedFetcher<T, R>, request: R) => Promise<T> & {
     all: () => Promise<(Awaited<T[K]> extends infer T_1 ? T_1 extends Awaited<T[K]> ? T_1 extends readonly (infer InnerArr)[] ? InnerArr : T_1 : never : never)[]>;
@@ -5783,9 +5789,9 @@ declare class API$j extends API$q {
     deleteDNSZoneTsigKey: (request: Readonly<DeleteDNSZoneTsigKeyRequest>) => Promise<void>;
 }
 /**
- * Domains registrar API.
+ * Domains and DNS - Registrar API.
  *
- * Domains registrar API. Manage your domains and contacts.
+ * Domains and DNS - Registrar API. Manage your domains and contacts.
  */
 declare class RegistrarAPI extends API$q {
     protected pageOfListTasks: (request?: Readonly<RegistrarApiListTasksRequest>) => Promise<ListTasksResponse>;
@@ -13926,11 +13932,11 @@ type PoolVolumeType = 'default_volume_type' | 'l_ssd' | 'b_ssd';
 type Runtime = 'unknown_runtime' | 'docker' | 'containerd' | 'crio';
 /** Cluster. */
 interface Cluster$1 {
-    /** ID of the cluster. */
+    /** Cluster ID. */
     id: string;
-    /** Type of the cluster. */
+    /** Cluster type. */
     type: string;
-    /** Name of the cluster. */
+    /** Cluster name. */
     name: string;
     /** Status of the cluster. */
     status: ClusterStatus$1;
@@ -13938,23 +13944,23 @@ interface Cluster$1 {
     version: string;
     /** Region in which the cluster is deployed. */
     region: Region;
-    /** ID of the organization owning the cluster. */
+    /** ID of the Organization owning the cluster. */
     organizationId: string;
-    /** ID of the project owning the cluster. */
+    /** ID of the Project owning the cluster. */
     projectId: string;
     /** Tags associated with the cluster. */
     tags: string[];
     /** Container Network Interface (CNI) plugin running in the cluster. */
     cni: CNI;
-    /** Description of the cluster. */
+    /** Cluster description. */
     description: string;
     /** Kubernetes API server URL of the cluster. */
     clusterUrl: string;
-    /** DNS wildcard resovling all the ready nodes of the cluster. */
+    /** Wildcard DNS resolving all the ready cluster nodes. */
     dnsWildcard: string;
-    /** Date at which the cluster was created. */
+    /** Date on which the cluster was created. */
     createdAt?: Date;
-    /** Date at which the cluster was last updated. */
+    /** Date on which the cluster was last updated. */
     updatedAt?: Date;
     /** Autoscaler config for the cluster. */
     autoscalerConfig?: ClusterAutoscalerConfig;
@@ -13963,7 +13969,10 @@ interface Cluster$1 {
      *   cluster.
      */
     dashboardEnabled?: boolean;
-    /** @deprecated Ingress controller used in the cluster. */
+    /**
+     * @deprecated Managed Ingress controller used in the cluster (deprecated
+     *   feature).
+     */
     ingress?: Ingress;
     /** Auto upgrade configuration of the cluster. */
     autoUpgrade?: ClusterAutoUpgrade;
@@ -13974,8 +13983,8 @@ interface Cluster$1 {
     /** List of enabled admission plugins. */
     admissionPlugins: string[];
     /**
-     * OpenID Connect configuration of the cluster. This configuration enables to
-     * update the OpenID Connect configuration of the Kubernetes API server.
+     * This configuration enables to update the OpenID Connect configuration of
+     * the Kubernetes API server.
      */
     openIdConnectConfig?: ClusterOpenIDConnectConfig;
     /**
@@ -13988,7 +13997,7 @@ interface Cluster$1 {
 }
 /** Cluster. auto upgrade. */
 interface ClusterAutoUpgrade {
-    /** Whether or not auto upgrade is enabled for the cluster. */
+    /** Defines whether auto upgrade is enabled for the cluster. */
     enabled: boolean;
     /** Maintenance window of the cluster auto upgrades. */
     maintenanceWindow?: MaintenanceWindow$1;
@@ -14011,16 +14020,15 @@ interface ClusterAutoscalerConfig {
     /** Detect similar node groups and balance the number of nodes between them. */
     balanceSimilarNodeGroups: boolean;
     /**
-     * Pods with priority below cutoff will be expendable. Pods with priority
-     * below cutoff will be expendable. They can be killed without any
-     * consideration during scale down and they don't cause scale up. Pods with
-     * null priority (PodPriority disabled) are non expendable.
+     * Pods with priority below cutoff will be expendable. They can be killed
+     * without any consideration during scale down and they won't cause scale up.
+     * Pods with null priority (PodPriority disabled) are non expendable.
      */
     expendablePodsPriorityCutoff: number;
-    /** How long a node should be unneeded before it is eligible for scale down. */
+    /** How long a node should be unneeded before it is eligible to be scaled down. */
     scaleDownUnneededTime: string;
     /**
-     * Node utilization level, defined as sum of requested resources divided by
+     * Node utilization level, defined as a sum of requested resources divided by
      * capacity, below which a node can be considered for scale down.
      */
     scaleDownUtilizationThreshold: number;
@@ -14034,52 +14042,48 @@ interface ClusterAutoscalerConfig {
 interface ClusterOpenIDConnectConfig {
     /**
      * URL of the provider which allows the API server to discover public signing
-     * keys. URL of the provider which allows the API server to discover public
-     * signing keys. Only URLs which use the `https://` scheme are accepted. This
-     * is typically the provider's discovery URL without a path, for example
-     * "https://accounts.google.com" or "https://login.salesforce.com". This URL
-     * should point to the level below .well-known/openid-configuration.
+     * keys. Only URLs using the `https://` scheme are accepted. This is typically
+     * the provider's discovery URL without a path, for example
+     * "https://accounts.google.com" or "https://login.salesforce.com".
      */
     issuerUrl: string;
-    /** A client id that all tokens must be issued for. */
+    /** A client ID that all tokens must be issued for. */
     clientId: string;
     /**
-     * JWT claim to use as the user name. JWT claim to use as the user name. By
-     * default `sub`, which is expected to be a unique identifier of the end user.
-     * Admins can choose other claims, such as `email` or `name`, depending on
-     * their provider. However, claims other than `email` will be prefixed with
-     * the issuer URL to prevent naming clashes with other plugins.
+     * JWT claim to use as the user name. The default is `sub`, which is expected
+     * to be the end user's unique identifier. Admins can choose other claims,
+     * such as `email` or `name`, depending on their provider. However, claims
+     * other than `email` will be prefixed with the issuer URL to prevent name
+     * collision.
      */
     usernameClaim: string;
     /**
-     * Prefix prepended to username. Prefix prepended to username claims to
-     * prevent clashes with existing names (such as `system:` users). For example,
-     * the value `oidc:` will create usernames like `oidc:jane.doe`. If this flag
-     * isn't provided and `username_claim` is a value other than `email` the
-     * prefix defaults to `( Issuer URL )#` where `( Issuer URL )` is the value of
-     * `issuer_url`. The value `-` can be used to disable all prefixing.
+     * Prefix prepended to username claims to prevent name collision (such as
+     * `system:` users). For example, the value `oidc:` will create usernames like
+     * `oidc:jane.doe`. If this flag is not provided and `username_claim` is a
+     * value other than `email`, the prefix defaults to `( Issuer URL )#` where `(
+     * Issuer URL )` is the value of `issuer_url`. The value `-` can be used to
+     * disable all prefixing.
      */
     usernamePrefix: string;
     /** JWT claim to use as the user's group. */
     groupsClaim: string[];
     /**
-     * Prefix prepended to group claims. Prefix prepended to group claims to
-     * prevent clashes with existing names (such as `system:` groups). For
-     * example, the value `oidc:` will create group names like `oidc:engineering`
-     * and `oidc:infra`.
+     * Prefix prepended to group claims to prevent name collision (such as
+     * `system:` groups). For example, the value `oidc:` will create group names
+     * like `oidc:engineering` and `oidc:infra`.
      */
     groupsPrefix: string;
     /**
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * If set, the claims are verified to be present in the ID token with a
-     * matching value.
+     * Multiple key=value pairs describing a required claim in the ID token. If
+     * set, the claims are verified to be present in the ID token with a matching
+     * value.
      */
     requiredClaim: string[];
 }
 /** Create cluster request. auto upgrade. */
 interface CreateClusterRequestAutoUpgrade {
-    /** Whether or not auto upgrade is enabled for the cluster. */
+    /** Defines whether auto upgrade is enabled for the cluster. */
     enable: boolean;
     /** Maintenance window of the cluster auto upgrades. */
     maintenanceWindow?: MaintenanceWindow$1;
@@ -14102,16 +14106,15 @@ interface CreateClusterRequestAutoscalerConfig$1 {
     /** Detect similar node groups and balance the number of nodes between them. */
     balanceSimilarNodeGroups?: boolean;
     /**
-     * Pods with priority below cutoff will be expendable. Pods with priority
-     * below cutoff will be expendable. They can be killed without any
-     * consideration during scale down and they don't cause scale up. Pods with
-     * null priority (PodPriority disabled) are non expendable.
+     * Pods with priority below cutoff will be expendable. They can be killed
+     * without any consideration during scale down and they won't cause scale up.
+     * Pods with null priority (PodPriority disabled) are non expendable.
      */
     expendablePodsPriorityCutoff?: number;
-    /** How long a node should be unneeded before it is eligible for scale down. */
+    /** How long a node should be unneeded before it is eligible to be scaled down. */
     scaleDownUnneededTime?: string;
     /**
-     * Node utilization level, defined as sum of requested resources divided by
+     * Node utilization level, defined as a sum of requested resources divided by
      * capacity, below which a node can be considered for scale down.
      */
     scaleDownUtilizationThreshold?: number;
@@ -14125,46 +14128,42 @@ interface CreateClusterRequestAutoscalerConfig$1 {
 interface CreateClusterRequestOpenIDConnectConfig$1 {
     /**
      * URL of the provider which allows the API server to discover public signing
-     * keys. URL of the provider which allows the API server to discover public
-     * signing keys. Only URLs which use the `https://` scheme are accepted. This
-     * is typically the provider's discovery URL without a path, for example
-     * "https://accounts.google.com" or "https://login.salesforce.com". This URL
-     * should point to the level below .well-known/openid-configuration.
+     * keys. Only URLs using the `https://` scheme are accepted. This is typically
+     * the provider's discovery URL without a path, for example
+     * "https://accounts.google.com" or "https://login.salesforce.com".
      */
     issuerUrl: string;
-    /** A client id that all tokens must be issued for. */
+    /** A client ID that all tokens must be issued for. */
     clientId: string;
     /**
-     * JWT claim to use as the user name. JWT claim to use as the user name. By
-     * default `sub`, which is expected to be a unique identifier of the end user.
-     * Admins can choose other claims, such as `email` or `name`, depending on
-     * their provider. However, claims other than `email` will be prefixed with
-     * the issuer URL to prevent naming clashes with other plugins.
+     * JWT claim to use as the user name. The default is `sub`, which is expected
+     * to be the end user's unique identifier. Admins can choose other claims,
+     * such as `email` or `name`, depending on their provider. However, claims
+     * other than `email` will be prefixed with the issuer URL to prevent name
+     * collision.
      */
     usernameClaim?: string;
     /**
-     * Prefix prepended to username. Prefix prepended to username claims to
-     * prevent clashes with existing names (such as `system:` users). For example,
-     * the value `oidc:` will create usernames like `oidc:jane.doe`. If this flag
-     * isn't provided and `username_claim` is a value other than `email` the
-     * prefix defaults to `( Issuer URL )#` where `( Issuer URL )` is the value of
-     * `issuer_url`. The value `-` can be used to disable all prefixing.
+     * Prefix prepended to username claims to prevent name collision (such as
+     * `system:` users). For example, the value `oidc:` will create usernames like
+     * `oidc:jane.doe`. If this flag is not provided and `username_claim` is a
+     * value other than `email`, the prefix defaults to `( Issuer URL )#` where `(
+     * Issuer URL )` is the value of `issuer_url`. The value `-` can be used to
+     * disable all prefixing.
      */
     usernamePrefix?: string;
     /** JWT claim to use as the user's group. */
     groupsClaim?: string[];
     /**
-     * Prefix prepended to group claims. Prefix prepended to group claims to
-     * prevent clashes with existing names (such as `system:` groups). For
-     * example, the value `oidc:` will create group names like `oidc:engineering`
-     * and `oidc:infra`.
+     * Prefix prepended to group claims to prevent name collision (such as
+     * `system:` groups). For example, the value `oidc:` will create group names
+     * like `oidc:engineering` and `oidc:infra`.
      */
     groupsPrefix?: string;
     /**
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * If set, the claims are verified to be present in the ID token with a
-     * matching value.
+     * Multiple key=value pairs describing a required claim in the ID token. If
+     * set, the claims are verified to be present in the ID token with a matching
+     * value.
      */
     requiredClaim?: string[];
 }
@@ -14173,11 +14172,10 @@ interface CreateClusterRequestPoolConfig$1 {
     /** Name of the pool. */
     name: string;
     /**
-     * Node type is the type of Scaleway Instance wanted for the pool. Node type
-     * is the type of Scaleway Instance wanted for the pool. Nodes with
+     * Node type is the type of Scaleway Instance wanted for the pool. Nodes with
      * insufficient memory are not eligible (DEV1-S, PLAY2-PICO, STARDUST).
      * 'external' is a special node type used to provision instances from other
-     * cloud providers.
+     * cloud providers in a Kosmos Cluster.
      */
     nodeType: string;
     /** Placement group ID in which all the nodes of the pool will be created. */
@@ -14187,19 +14185,19 @@ interface CreateClusterRequestPoolConfig$1 {
     /** Size (number of nodes) of the pool. */
     size: number;
     /**
-     * Minimum size of the pool. Defines the minimum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     minSize?: number;
     /**
-     * Maximum size of the pool. Defines the maximum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     maxSize?: number;
     /**
-     * Container runtime for the nodes of the pool. Customization of the container
-     * runtime is available for each pool. Note that `docker` is deprecated since
-     * 1.20 and will be removed in 1.24.
+     * Customization of the container runtime is available for each pool. Note
+     * that `docker` has been deprecated since version 1.20 and will be removed by
+     * version 1.24.
      */
     containerRuntime: Runtime;
     /** Defines whether the autohealing feature is enabled for the pool. */
@@ -14207,8 +14205,8 @@ interface CreateClusterRequestPoolConfig$1 {
     /** Tags associated with the pool. */
     tags: string[];
     /**
-     * Kubelet arguments to be used by this pool. Note that this feature is to be
-     * considered as experimental.
+     * Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
      */
     kubeletArgs: Record<string, string>;
     /** Pool upgrade policy. */
@@ -14216,11 +14214,11 @@ interface CreateClusterRequestPoolConfig$1 {
     /** Zone in which the pool's nodes will be spawned. */
     zone: Zone;
     /**
-     * System volume disk type. Defines the system volume disk type, we provide
-     * two different types of volume (`volume_type`): `l_ssd` is a local block
-     * storage: your system is stored locally on the hypervisor of your node.
-     * `b_ssd` is a remote block storage: your system is stored on a centralised
-     * and resilient cluster.
+     * Defines the system volume disk type. Two different types of volume
+     * (`volume_type`) are provided: `l_ssd` is a local block storage which means
+     * your system is stored locally on your node's hypervisor. `b_ssd` is a
+     * remote block storage which means your system is stored on a centralized and
+     * resilient cluster.
      */
     rootVolumeType: PoolVolumeType;
     /** System volume disk size. */
@@ -14248,7 +14246,7 @@ interface ExternalNode {
 }
 /** List cluster available versions response. */
 interface ListClusterAvailableVersionsResponse {
-    /** Available Kubernetes version for the cluster. */
+    /** Available Kubernetes versions for the cluster. */
     versions: Version$2[];
 }
 /** List clusters response. */
@@ -14286,7 +14284,7 @@ interface MaintenanceWindow$1 {
 }
 /** Node. */
 interface Node {
-    /** ID of the node. */
+    /** Node ID. */
     id: string;
     /** Pool ID of the node. */
     poolId: string;
@@ -14307,41 +14305,40 @@ interface Node {
     /** @deprecated Public IPv6 address of the node. */
     publicIpV6?: string;
     /**
-     * @deprecated Conditions of the node. These conditions contains the Node
+     * @deprecated Conditions of the node. These conditions contain the Node
      *   Problem Detector conditions, as well as some in house conditions.
      */
     conditions?: Record<string, string>;
     /** Status of the node. */
     status: NodeStatus;
-    /** Details of the error, if any occured when managing the node. */
+    /** Details of the error, if any occurred when managing the node. */
     errorMessage?: string;
     /** Date on which the node was created. */
     createdAt?: Date;
-    /** Date at which the node was last updated. */
+    /** Date on which the node was last updated. */
     updatedAt?: Date;
 }
 /** Pool. */
 interface Pool {
-    /** ID of the pool. */
+    /** Pool ID. */
     id: string;
     /** Cluster ID of the pool. */
     clusterId: string;
-    /** Date at which the pool was created. */
+    /** Date on which the pool was created. */
     createdAt?: Date;
-    /** Date at which the pool was last updated. */
+    /** Date on which the pool was last updated. */
     updatedAt?: Date;
-    /** Name of the pool. */
+    /** Pool name. */
     name: string;
-    /** Status of the pool. */
+    /** Pool status. */
     status: PoolStatus;
-    /** Version of the pool. */
+    /** Pool version. */
     version: string;
     /**
-     * Node type is the type of Scaleway Instance wanted for the pool. Node type
-     * is the type of Scaleway Instance wanted for the pool. Nodes with
+     * Node type is the type of Scaleway Instance wanted for the pool. Nodes with
      * insufficient memory are not eligible (DEV1-S, PLAY2-PICO, STARDUST).
      * 'external' is a special node type used to provision instances from other
-     * cloud providers.
+     * cloud providers in a Kosmos Cluster.
      */
     nodeType: string;
     /** Defines whether the autoscaling feature is enabled for the pool. */
@@ -14349,19 +14346,19 @@ interface Pool {
     /** Size (number of nodes) of the pool. */
     size: number;
     /**
-     * Minimum size of the pool. Defines the minimum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     minSize: number;
     /**
-     * Maximum size of the pool. Defines the maximum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     maxSize: number;
     /**
-     * Container runtime for the nodes of the pool. Customization of the container
-     * runtime is available for each pool. Note that `docker` is deprecated since
-     * 1.20 and will be removed in 1.24.
+     * Customization of the container runtime is available for each pool. Note
+     * that `docker` has been deprecated since version 1.20 and will be removed by
+     * version 1.24.
      */
     containerRuntime: Runtime;
     /** Defines whether the autohealing feature is enabled for the pool. */
@@ -14371,8 +14368,8 @@ interface Pool {
     /** Placement group ID in which all the nodes of the pool will be created. */
     placementGroupId?: string;
     /**
-     * Kubelet arguments to be used by this pool. Note that this feature is to be
-     * considered as experimental.
+     * Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
      */
     kubeletArgs: Record<string, string>;
     /** Pool upgrade policy. */
@@ -14380,11 +14377,11 @@ interface Pool {
     /** Zone in which the pool's nodes will be spawned. */
     zone: Zone;
     /**
-     * System volume disk type. Defines the system volume disk type, we provide
-     * two different types of volume (`volume_type`): `l_ssd` is a local block
-     * storage: your system is stored locally on the hypervisor of your node.
-     * `b_ssd` is a remote block storage: your system is stored on a centralised
-     * and resilient cluster.
+     * Defines the system volume disk type. Two different types of volume
+     * (`volume_type`) are provided: `l_ssd` is a local block storage which means
+     * your system is stored locally on your node's hypervisor. `b_ssd` is a
+     * remote block storage which means your system is stored on a centralized and
+     * resilient cluster.
      */
     rootVolumeType: PoolVolumeType;
     /** System volume disk size. */
@@ -14398,7 +14395,7 @@ interface PoolUpgradePolicy {
 }
 /** Update cluster request. auto upgrade. */
 interface UpdateClusterRequestAutoUpgrade {
-    /** Whether or not auto upgrade is enabled for the cluster. */
+    /** Defines whether auto upgrade is enabled for the cluster. */
     enable?: boolean;
     /** Maintenance window of the cluster auto upgrades. */
     maintenanceWindow?: MaintenanceWindow$1;
@@ -14421,16 +14418,15 @@ interface UpdateClusterRequestAutoscalerConfig$1 {
     /** Detect similar node groups and balance the number of nodes between them. */
     balanceSimilarNodeGroups?: boolean;
     /**
-     * Pods with priority below cutoff will be expendable. Pods with priority
-     * below cutoff will be expendable. They can be killed without any
-     * consideration during scale down and they don't cause scale up. Pods with
-     * null priority (PodPriority disabled) are non expendable.
+     * Pods with priority below cutoff will be expendable. They can be killed
+     * without any consideration during scale down and they won't cause scale up.
+     * Pods with null priority (PodPriority disabled) are non expendable.
      */
     expendablePodsPriorityCutoff?: number;
-    /** How long a node should be unneeded before it is eligible for scale down. */
+    /** How long a node should be unneeded before it is eligible to be scaled down. */
     scaleDownUnneededTime?: string;
     /**
-     * Node utilization level, defined as sum of requested resources divided by
+     * Node utilization level, defined as a sum of requested resources divided by
      * capacity, below which a node can be considered for scale down.
      */
     scaleDownUtilizationThreshold?: number;
@@ -14444,46 +14440,42 @@ interface UpdateClusterRequestAutoscalerConfig$1 {
 interface UpdateClusterRequestOpenIDConnectConfig {
     /**
      * URL of the provider which allows the API server to discover public signing
-     * keys. URL of the provider which allows the API server to discover public
-     * signing keys. Only URLs which use the `https://` scheme are accepted. This
-     * is typically the provider's discovery URL without a path, for example
-     * "https://accounts.google.com" or "https://login.salesforce.com". This URL
-     * should point to the level below .well-known/openid-configuration.
+     * keys. Only URLs using the `https://` scheme are accepted. This is typically
+     * the provider's discovery URL without a path, for example
+     * "https://accounts.google.com" or "https://login.salesforce.com".
      */
     issuerUrl?: string;
-    /** A client id that all tokens must be issued for. */
+    /** A client ID that all tokens must be issued for. */
     clientId?: string;
     /**
-     * JWT claim to use as the user name. JWT claim to use as the user name. By
-     * default `sub`, which is expected to be a unique identifier of the end user.
-     * Admins can choose other claims, such as `email` or `name`, depending on
-     * their provider. However, claims other than `email` will be prefixed with
-     * the issuer URL to prevent naming clashes with other plugins.
+     * JWT claim to use as the user name. The default is `sub`, which is expected
+     * to be the end user's unique identifier. Admins can choose other claims,
+     * such as `email` or `name`, depending on their provider. However, claims
+     * other than `email` will be prefixed with the issuer URL to prevent name
+     * collision.
      */
     usernameClaim?: string;
     /**
-     * Prefix prepended to username. Prefix prepended to username claims to
-     * prevent clashes with existing names (such as `system:` users). For example,
-     * the value `oidc:` will create usernames like `oidc:jane.doe`. If this flag
-     * isn't provided and `username_claim` is a value other than `email` the
-     * prefix defaults to `( Issuer URL )#` where `( Issuer URL )` is the value of
-     * `issuer_url`. The value `-` can be used to disable all prefixing.
+     * Prefix prepended to username claims to prevent name collision (such as
+     * `system:` users). For example, the value `oidc:` will create usernames like
+     * `oidc:jane.doe`. If this flag is not provided and `username_claim` is a
+     * value other than `email`, the prefix defaults to `( Issuer URL )#` where `(
+     * Issuer URL )` is the value of `issuer_url`. The value `-` can be used to
+     * disable all prefixing.
      */
     usernamePrefix?: string;
     /** JWT claim to use as the user's group. */
     groupsClaim?: string[];
     /**
-     * Prefix prepended to group claims. Prefix prepended to group claims to
-     * prevent clashes with existing names (such as `system:` groups). For
-     * example, the value `oidc:` will create group names like `oidc:engineering`
-     * and `oidc:infra`.
+     * Prefix prepended to group claims to prevent name collision (such as
+     * `system:` groups). For example, the value `oidc:` will create group names
+     * like `oidc:engineering` and `oidc:infra`.
      */
     groupsPrefix?: string;
     /**
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * Multiple key=value pairs that describes a required claim in the ID token.
-     * If set, the claims are verified to be present in the ID token with a
-     * matching value.
+     * Multiple key=value pairs describing a required claim in the ID token. If
+     * set, the claims are verified to be present in the ID token with a matching
+     * value.
      */
     requiredClaim?: string[];
 }
@@ -14522,17 +14514,20 @@ type ListClustersRequest$2 = {
     organizationId?: string;
     /** Project ID on which to filter the returned clusters. */
     projectId?: string;
-    /** Sort order of the returned clusters. */
+    /** Sort order of returned clusters. */
     orderBy?: ListClustersRequestOrderBy$1;
-    /** Page number for the returned clusters. */
+    /** Page number to return for clusters, from the paginated results. */
     page?: number;
     /** Maximum number of clusters per page. */
     pageSize?: number;
-    /** Name on which to filter the returned clusters. */
+    /**
+     * Name to filter on, only clusters containing this substring in their name
+     * will be returned.
+     */
     name?: string;
-    /** Status on which to filter the returned clusters. */
+    /** Status to filter on, only clusters with this status will be returned. */
     status?: ClusterStatus$1;
-    /** Type on which to filter the returned clusters. */
+    /** Type to filter on, only clusters with this type will be returned. */
     type?: string;
 };
 type CreateClusterRequest$2 = {
@@ -14555,35 +14550,41 @@ type CreateClusterRequest$2 = {
      * could be set.
      */
     projectId?: string;
-    /** Type of the cluster (possible values are kapsule, multicloud). */
+    /**
+     * Type of the cluster (possible values are kapsule, multicloud,
+     * kapsule-dedicated-8, kapsule-dedicated-16).
+     */
     type: string;
-    /** Name of the cluster. */
+    /** Cluster name. */
     name?: string;
-    /** Description of the cluster. */
+    /** Cluster description. */
     description: string;
     /** Tags associated with the cluster. */
     tags?: string[];
     /** Kubernetes version of the cluster. */
     version: string;
-    /** Container Network Interface (CNI) plugin that will run in the cluster. */
+    /** Container Network Interface (CNI) plugin running in the cluster. */
     cni: CNI;
-    /** @deprecated Defines if the Kubernetes Dashboard is enabled in the cluster. */
+    /**
+     * @deprecated Defines whether the Kubernetes Dashboard is enabled in the
+     *   cluster.
+     */
     enableDashboard?: boolean;
-    /** @deprecated Ingress Controller that will run in the cluster. */
+    /** @deprecated Ingress Controller running in the cluster (deprecated feature). */
     ingress?: Ingress;
-    /** Pools to be created along with the cluster. */
+    /** Pools created along with the cluster. */
     pools?: CreateClusterRequestPoolConfig$1[];
     /**
-     * Autoscaler config for the cluster. This field allows to specify some
-     * configuration for the autoscaler, which is an implementation of the
-     * cluster-autoscaler
+     * Autoscaler configuration for the cluster. It allows you to set (to an
+     * extent) your preferred autoscaler configuration, which is an implementation
+     * of the cluster-autoscaler
      * (https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler/).
      */
     autoscalerConfig?: CreateClusterRequestAutoscalerConfig$1;
     /**
      * Auto upgrade configuration of the cluster. This configuration enables to
      * set a specific 2-hour time window in which the cluster can be automatically
-     * updated to the latest patch version in the current minor one.
+     * updated to the latest patch version.
      */
     autoUpgrade?: CreateClusterRequestAutoUpgrade;
     /** List of feature gates to enable. */
@@ -14612,7 +14613,7 @@ type GetClusterRequest$1 = {
      * config.
      */
     region?: Region;
-    /** The ID of the requested cluster. */
+    /** ID of the requested cluster. */
     clusterId: string;
 };
 type UpdateClusterRequest$2 = {
@@ -14623,25 +14624,21 @@ type UpdateClusterRequest$2 = {
     region?: Region;
     /** ID of the cluster to update. */
     clusterId: string;
-    /** New external name of the cluster. */
+    /** New external name for the cluster. */
     name?: string;
-    /** New description of the cluster. */
+    /** New description for the cluster. */
     description?: string;
     /** New tags associated with the cluster. */
     tags?: string[];
-    /**
-     * New autoscaler config for the cluster. Object defining the configuration
-     * for the autoscaler, which is an implementation of the
-     * [cluster-autoscaler](https://github.com/kubernetes/autoscaler/tree/master/cluster-autoscaler/).
-     */
+    /** New autoscaler config for the cluster. */
     autoscalerConfig?: UpdateClusterRequestAutoscalerConfig$1;
-    /** @deprecated New value of the Kubernetes Dashboard enablement. */
+    /** @deprecated New value for the Kubernetes Dashboard enablement. */
     enableDashboard?: boolean;
-    /** @deprecated New Ingress Controller for the cluster. */
+    /** @deprecated New Ingress Controller for the cluster (deprecated feature). */
     ingress?: Ingress;
     /**
-     * New auto upgrade configuration of the cluster. New auto upgrade
-     * configuration of the cluster. Note that all fields need to be set.
+     * New auto upgrade configuration for the cluster. Note that all fields need
+     * to be set.
      */
     autoUpgrade?: UpdateClusterRequestAutoUpgrade;
     /** List of feature gates to enable. */
@@ -14668,8 +14665,8 @@ type DeleteClusterRequest$1 = {
     /** ID of the cluster to delete. */
     clusterId: string;
     /**
-     * Set true if you want to delete all volumes (including retain volume type)
-     * and loadbalancers whose name start with cluster ID.
+     * Defines whether all volumes (including retain volume type) and Load
+     * Balancers with a name starting with the cluster ID will also be deleted.
      */
     withAdditionalResources: boolean;
 };
@@ -14682,14 +14679,14 @@ type UpgradeClusterRequest = {
     /** ID of the cluster to upgrade. */
     clusterId: string;
     /**
-     * New Kubernetes version of the cluster. New Kubernetes version of the
-     * cluster. Note that the version shoud either be a higher patch version of
-     * the same minor version or the direct minor version after the current one.
+     * New Kubernetes version of the cluster. Note that the version should either
+     * be a higher patch version of the same minor version or the direct minor
+     * version after the current one.
      */
     version: string;
     /**
-     * Enablement of the pools upgrade. This field also trigger pools upgrade once
-     * the control plane is upgraded.
+     * Defines whether pools will also be upgraded once the control plane is
+     * upgraded.
      */
     upgradePools: boolean;
 };
@@ -14713,10 +14710,7 @@ type ListClusterAvailableVersionsRequest = {
      * config.
      */
     region?: Region;
-    /**
-     * ID of the cluster which the available Kuberentes versions will be listed
-     * from.
-     */
+    /** Cluster ID for which the available Kubernetes versions will be listed. */
     clusterId: string;
 };
 type ResetClusterAdminTokenRequest = {
@@ -14725,7 +14719,7 @@ type ResetClusterAdminTokenRequest = {
      * config.
      */
     region?: Region;
-    /** ID of the cluster on which the admin token will be renewed. */
+    /** Cluster ID on which the admin token will be renewed. */
     clusterId: string;
 };
 type ListPoolsRequest$1 = {
@@ -14734,17 +14728,20 @@ type ListPoolsRequest$1 = {
      * config.
      */
     region?: Region;
-    /** ID of the cluster from which the pools will be listed from. */
+    /** ID of the cluster whose pools will be listed. */
     clusterId: string;
-    /** Sort order of the returned pools. */
+    /** Sort order of returned pools. */
     orderBy?: ListPoolsRequestOrderBy;
     /** Page number for the returned pools. */
     page?: number;
     /** Maximum number of pools per page. */
     pageSize?: number;
-    /** Name on which to filter the returned pools. */
+    /**
+     * Name to filter on, only pools containing this substring in their name will
+     * be returned.
+     */
     name?: string;
-    /** Status on which to filter the returned pools. */
+    /** Status to filter on, only pools with this status will be returned. */
     status?: PoolStatus;
 };
 type CreatePoolRequest$1 = {
@@ -14753,16 +14750,15 @@ type CreatePoolRequest$1 = {
      * config.
      */
     region?: Region;
-    /** ID of the cluster in which the pool will be created. */
+    /** Cluster ID to which the pool will be attached. */
     clusterId: string;
-    /** Name of the pool. */
+    /** Pool name. */
     name?: string;
     /**
-     * Node type is the type of Scaleway Instance wanted for the pool. Node type
-     * is the type of Scaleway Instance wanted for the pool. Nodes with
+     * Node type is the type of Scaleway Instance wanted for the pool. Nodes with
      * insufficient memory are not eligible (DEV1-S, PLAY2-PICO, STARDUST).
      * 'external' is a special node type used to provision instances from other
-     * cloud providers.
+     * cloud providers in a Kosmos Cluster.
      */
     nodeType: string;
     /** Placement group ID in which all the nodes of the pool will be created. */
@@ -14772,19 +14768,19 @@ type CreatePoolRequest$1 = {
     /** Size (number of nodes) of the pool. */
     size: number;
     /**
-     * Minimum size of the pool. Defines the minimum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     minSize?: number;
     /**
-     * Maximum size of the pool. Defines the maximum size of the pool. Note that
-     * this field will be used only when autoscaling is enabled.
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
      */
     maxSize?: number;
     /**
-     * Container runtime for the nodes of the pool. Customization of the container
-     * runtime is available for each pool. Note that `docker` is deprecated since
-     * 1.20 and will be removed in 1.24.
+     * Customization of the container runtime is available for each pool. Note
+     * that `docker` has been deprecated since version 1.20 and will be removed by
+     * version 1.24.
      */
     containerRuntime?: Runtime;
     /** Defines whether the autohealing feature is enabled for the pool. */
@@ -14792,8 +14788,8 @@ type CreatePoolRequest$1 = {
     /** Tags associated with the pool. */
     tags?: string[];
     /**
-     * Kubelet arguments to be used by this pool. Note that this feature is to be
-     * considered as experimental.
+     * Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
      */
     kubeletArgs?: Record<string, string>;
     /** Pool upgrade policy. */
@@ -14801,11 +14797,11 @@ type CreatePoolRequest$1 = {
     /** Zone in which the pool's nodes will be spawned. */
     zone?: Zone;
     /**
-     * System volume disk type. Defines the system volume disk type, we provide
-     * two different types of volume (`volume_type`): `l_ssd` is a local block
-     * storage: your system is stored locally on the hypervisor of your node.
-     * `b_ssd` is a remote block storage: your system is stored on a centralised
-     * and resilient cluster.
+     * Defines the system volume disk type. Two different types of volume
+     * (`volume_type`) are provided: `l_ssd` is a local block storage which means
+     * your system is stored locally on your node's hypervisor. `b_ssd` is a
+     * remote block storage which means your system is stored on a centralized and
+     * resilient cluster.
      */
     rootVolumeType?: PoolVolumeType;
     /** System volume disk size. */
@@ -14839,24 +14835,24 @@ type UpdatePoolRequest = {
     region?: Region;
     /** ID of the pool to update. */
     poolId: string;
-    /** New value for the enablement of autoscaling for the pool. */
+    /** New value for the pool autoscaling enablement. */
     autoscaling?: boolean;
-    /** New size for the pool. */
+    /** New desired pool size. */
     size?: number;
-    /** New minimun size for the pool. */
+    /** New minimum size for the pool. */
     minSize?: number;
     /** New maximum size for the pool. */
     maxSize?: number;
-    /** New value for the enablement of autohealing for the pool. */
+    /** New value for the pool autohealing enablement. */
     autohealing?: boolean;
     /** New tags associated with the pool. */
     tags?: string[];
     /**
-     * New Kubelet arguments to be used by this pool. Note that this feature is to
-     * be considered as experimental.
+     * New Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
      */
     kubeletArgs?: Record<string, string>;
-    /** Upgrade policy for the pool. */
+    /** New upgrade policy for the pool. */
     upgradePolicy?: UpdatePoolRequestUpgradePolicy;
 };
 type DeletePoolRequest = {
@@ -14892,9 +14888,12 @@ type ListNodesRequest$1 = {
     page?: number;
     /** Maximum number of nodes per page. */
     pageSize?: number;
-    /** Name on which to filter the returned nodes. */
+    /**
+     * Name to filter on, only nodes containing this substring in their name will
+     * be returned.
+     */
     name?: string;
-    /** Status on which to filter the returned nodes. */
+    /** Status to filter on, only nodes with this status will be returned. */
     status?: NodeStatus;
 };
 type GetNodeRequest = {
@@ -14960,7 +14959,7 @@ type GetClusterKubeConfigRequest = {
      * config.
      */
     region?: Region;
-    /** ID of the cluster to download the kubeconfig from. */
+    /** Cluster ID for which to download the kubeconfig. */
     clusterId: string;
 };
 
@@ -14970,8 +14969,7 @@ declare class API$d extends API$q {
     static readonly LOCALITIES: Region[];
     protected pageOfListClusters: (request?: Readonly<ListClustersRequest$2>) => Promise<ListClustersResponse$1>;
     /**
-     * List all clusters. List all the existing Kubernetes clusters in a specific
-     * Region.
+     * List Clusters. List all existing Kubernetes clusters in a specific region.
      *
      * @param request - The request {@link ListClustersRequest}
      * @returns A Promise of ListClustersResponse
@@ -14981,16 +14979,14 @@ declare class API$d extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Cluster$1[], void, void>;
     };
     /**
-     * Create a new cluster. Create a new Kubernetes cluster on a Scaleway
-     * account.
+     * Create a new Cluster. Create a new Kubernetes cluster in a Scaleway region.
      *
      * @param request - The request {@link CreateClusterRequest}
      * @returns A Promise of Cluster
      */
     createCluster: (request: Readonly<CreateClusterRequest$2>) => Promise<Cluster$1>;
     /**
-     * Get specific cluster information. Get details about a specific Kubernetes
-     * cluster.
+     * Get a Cluster. Retrieve information about a specific Kubernetes cluster.
      *
      * @param request - The request {@link GetClusterRequest}
      * @returns A Promise of Cluster
@@ -15005,26 +15001,25 @@ declare class API$d extends API$q {
      */
     waitForCluster: (request: Readonly<GetClusterRequest$1>, options?: Readonly<WaitForOptions<Cluster$1>>) => Promise<Cluster$1>;
     /**
-     * Update a cluster. Update a specific Kubernetes cluster. Note that this
-     * method is designed to update details such as name, description, tags and
-     * configuration. However, you cannot upgrade a cluster with this method. To
-     * do so, use the dedicated endpoint.
+     * Update a Cluster. Update information on a specific Kubernetes cluster. You
+     * can update details such as its name, description, tags and configuration.
+     * To upgrade a cluster, you will need to use the dedicated endpoint.
      *
      * @param request - The request {@link UpdateClusterRequest}
      * @returns A Promise of Cluster
      */
     updateCluster: (request: Readonly<UpdateClusterRequest$2>) => Promise<Cluster$1>;
     /**
-     * Delete a cluster. Delete a specific cluster and all its associated pools
-     * and nodes. Note that this method will not delete any Load Balancers or
-     * Block Volumes that are associated with the cluster.
+     * Delete a Cluster. Delete a specific Kubernetes cluster and all its
+     * associated pools and nodes. Note that this method will not delete any Load
+     * Balancer or Block Volume that are associated with the cluster.
      *
      * @param request - The request {@link DeleteClusterRequest}
      * @returns A Promise of Cluster
      */
     deleteCluster: (request: Readonly<DeleteClusterRequest$1>) => Promise<Cluster$1>;
     /**
-     * Upgrade a cluster. Upgrade a specific Kubernetes cluster and/or its
+     * Upgrade a Cluster. Upgrade a specific Kubernetes cluster and possibly its
      * associated pools to a specific and supported Kubernetes version.
      *
      * @param request - The request {@link UpgradeClusterRequest}
@@ -15032,15 +15027,15 @@ declare class API$d extends API$q {
      */
     upgradeCluster: (request: Readonly<UpgradeClusterRequest>) => Promise<Cluster$1>;
     /**
-     * Change type of a cluster. Change type of a specific Kubernetes cluster.
+     * Change the Cluster type. Change the type of a specific Kubernetes cluster.
      *
      * @param request - The request {@link SetClusterTypeRequest}
      * @returns A Promise of Cluster
      */
     setClusterType: (request: Readonly<SetClusterTypeRequest>) => Promise<Cluster$1>;
     /**
-     * List available versions for a cluster. List the versions that a specific
-     * Kubernetes cluster is allowed to upgrade to. Results will comprise every
+     * List available versions for a Cluster. List the versions that a specific
+     * Kubernetes cluster is allowed to upgrade to. Results will include every
      * patch version greater than the current patch, as well as one minor version
      * ahead of the current version. Any upgrade skipping a minor version will not
      * work.
@@ -15051,17 +15046,17 @@ declare class API$d extends API$q {
     listClusterAvailableVersions: (request: Readonly<ListClusterAvailableVersionsRequest>) => Promise<ListClusterAvailableVersionsResponse>;
     protected _getClusterKubeConfig: (request: Readonly<GetClusterKubeConfigRequest>) => Promise<Blob>;
     /**
-     * Reset the admin token of a cluster. Reset the admin token for a specific
-     * Kubernetes cluster. This will invalidate the old admin token (which will
-     * not be usable afterwards) and create a new one. Note that you will need to
-     * redownload kubeconfig in order to keep interacting with the cluster.
+     * Reset the admin token of a Cluster. Reset the admin token for a specific
+     * Kubernetes cluster. This will revoke the old admin token (which will not be
+     * usable afterwards) and create a new one. Note that you will need to
+     * download kubeconfig again to keep interacting with the cluster.
      *
      * @param request - The request {@link ResetClusterAdminTokenRequest}
      */
     resetClusterAdminToken: (request: Readonly<ResetClusterAdminTokenRequest>) => Promise<void>;
     protected pageOfListPools: (request: Readonly<ListPoolsRequest$1>) => Promise<ListPoolsResponse>;
     /**
-     * List all the pools in a cluster. List all the existing pools for a specific
+     * List Pools in a Cluster. List all the existing pools for a specific
      * Kubernetes cluster.
      *
      * @param request - The request {@link ListPoolsRequest}
@@ -15072,7 +15067,7 @@ declare class API$d extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Pool[], void, void>;
     };
     /**
-     * Create a new pool in a cluster. Create a new pool in a specific Kubernetes
+     * Create a new Pool in a Cluster. Create a new pool in a specific Kubernetes
      * cluster.
      *
      * @param request - The request {@link CreatePoolRequest}
@@ -15080,8 +15075,8 @@ declare class API$d extends API$q {
      */
     createPool: (request: Readonly<CreatePoolRequest$1>) => Promise<Pool>;
     /**
-     * Get a pool in a cluster. Get details about a specific pool in a Kubernetes
-     * cluster.
+     * Get a Pool in a Cluster. Retrieve details about a specific pool in a
+     * Kubernetes cluster.
      *
      * @param request - The request {@link GetPoolRequest}
      * @returns A Promise of Pool
@@ -15096,33 +15091,33 @@ declare class API$d extends API$q {
      */
     waitForPool: (request: Readonly<GetPoolRequest>, options?: Readonly<WaitForOptions<Pool>>) => Promise<Pool>;
     /**
-     * Upgrade a pool in a cluster. Upgrade the Kubernetes version of a specific
-     * pool. Note that this will work when the targeted version is the same than
-     * the version of the cluster.
+     * Upgrade a Pool in a Cluster. Upgrade the Kubernetes version of a specific
+     * pool. Note that it only works if the targeted version matches the cluster's
+     * version.
      *
      * @param request - The request {@link UpgradePoolRequest}
      * @returns A Promise of Pool
      */
     upgradePool: (request: Readonly<UpgradePoolRequest>) => Promise<Pool>;
     /**
-     * Update a pool in a cluster. Update attributes of a specific pool, such as
-     * size, autoscaling settings, and tags.
+     * Update a Pool in a Cluster. Update the attributes of a specific pool, such
+     * as its desired size, autoscaling settings, and tags.
      *
      * @param request - The request {@link UpdatePoolRequest}
      * @returns A Promise of Pool
      */
     updatePool: (request: Readonly<UpdatePoolRequest>) => Promise<Pool>;
     /**
-     * Delete a pool in a cluster. Delete a specific pool from a cluster. All of
-     * the pool's nodes will also be deleted.
+     * Delete a Pool in a Cluster. Delete a specific pool from a cluster. Note
+     * that all the pool's nodes will also be deleted.
      *
      * @param request - The request {@link DeletePoolRequest}
      * @returns A Promise of Pool
      */
     deletePool: (request: Readonly<DeletePoolRequest>) => Promise<Pool>;
     /**
-     * Create a Kosmos node. Get metadata about a Kosmos node. This method is not
-     * intended to be directly called by end users, only by the
+     * Create a Kosmos node. Retrieve metadata for a Kosmos node. This method is
+     * not intended to be called by end users but rather programmatically by the
      * kapsule-node-agent.
      *
      * @param request - The request {@link CreateExternalNodeRequest}
@@ -15131,7 +15126,7 @@ declare class API$d extends API$q {
     createExternalNode: (request: Readonly<CreateExternalNodeRequest>) => Promise<ExternalNode>;
     protected pageOfListNodes: (request: Readonly<ListNodesRequest$1>) => Promise<ListNodesResponse>;
     /**
-     * List all the nodes in a cluster. List all the existing nodes for a specific
+     * List Nodes in a Cluster. List all the existing nodes for a specific
      * Kubernetes cluster.
      *
      * @param request - The request {@link ListNodesRequest}
@@ -15142,7 +15137,7 @@ declare class API$d extends API$q {
         [Symbol.asyncIterator]: () => AsyncGenerator<Node[], void, void>;
     };
     /**
-     * Get a node in a cluster. Get details about a specific Kubernetes node.
+     * Get a Node in a Cluster. Retrieve details about a specific Kubernetes Node.
      *
      * @param request - The request {@link GetNodeRequest}
      * @returns A Promise of Node
@@ -15157,13 +15152,12 @@ declare class API$d extends API$q {
      */
     waitForNode: (request: Readonly<GetNodeRequest>, options?: Readonly<WaitForOptions<Node>>) => Promise<Node>;
     /**
-     * Replace a node in a cluster. Replace a specific node. The node will be set
-     * cordoned, meaning that scheduling will be disabled. Then the existing pods
-     * on the node will be drained and reschedule onto another schedulable node.
-     * Then the node will be deleted, and a new one will be created after the
-     * deletion. Note that when there is not enough space to reschedule all the
-     * pods (in a one node cluster for instance), you may experience some
-     * disruption of your applications.
+     * Replace a Node in a Cluster. Replace a specific Node. The node will first
+     * be cordoned (scheduling will be disabled on it). The existing pods on the
+     * node will then be drained and rescheduled onto another schedulable node.
+     * Note that when there is not enough space to reschedule all the pods (such
+     * as in a one-node cluster), disruption of your applications can be
+     * expected.
      *
      * @deprecated
      * @param request - The request {@link ReplaceNodeRequest}
@@ -15171,28 +15165,27 @@ declare class API$d extends API$q {
      */
     replaceNode: (request: Readonly<ReplaceNodeRequest>) => Promise<Node>;
     /**
-     * Reboot a node in a cluster. Reboot a specific node. This node will first be
-     * cordoned, meaning that scheduling will be disabled. Then the existing pods
-     * on the node will be drained and rescheduled onto another schedulable node.
-     * Note that when there is not enough space to reschedule all the pods (in a
-     * one-node cluster, for instance), you may experience some disruption of your
-     * applications.
+     * Reboot a Node in a Cluster. Reboot a specific Node. The node will first be
+     * cordoned (scheduling will be disabled on it). The existing pods on the node
+     * will then be drained and rescheduled onto another schedulable node. Note
+     * that when there is not enough space to reschedule all the pods (such as in
+     * a one-node cluster), disruption of your applications can be expected.
      *
      * @param request - The request {@link RebootNodeRequest}
      * @returns A Promise of Node
      */
     rebootNode: (request: Readonly<RebootNodeRequest>) => Promise<Node>;
     /**
-     * Delete a node in a cluster. Delete a specific node. Note that when there is
-     * not enough space to reschedule all the pods (in a one-node cluster for
-     * instance), you may experience some disruption of your applications.
+     * Delete a Node in a Cluster. Delete a specific Node. Note that when there is
+     * not enough space to reschedule all the pods (such as in a one-node
+     * cluster), disruption of your applications can be expected.
      *
      * @param request - The request {@link DeleteNodeRequest}
      * @returns A Promise of Node
      */
     deleteNode: (request: Readonly<DeleteNodeRequest>) => Promise<Node>;
     /**
-     * List all available versions. List all available versions for the creation
+     * List all available Versions. List all available versions for the creation
      * of a new Kubernetes cluster.
      *
      * @param request - The request {@link ListVersionsRequest}
@@ -15200,8 +15193,7 @@ declare class API$d extends API$q {
      */
     listVersions: (request?: Readonly<ListVersionsRequest$2>) => Promise<ListVersionsResponse$2>;
     /**
-     * Get details about a specific version. Get a specific Kubernetes version and
-     * the details about the version.
+     * Get a Version. Retrieve a specific Kubernetes version and its details.
      *
      * @param request - The request {@link GetVersionRequest}
      * @returns A Promise of Version
@@ -15661,6 +15653,13 @@ interface Backend {
     redispatchAttemptCount?: number;
     /** Number of retries when a backend server connection failed. */
     maxRetries?: number;
+    /** Maximum number of connections allowed per backend server. */
+    maxConnections?: number;
+    /**
+     * Maximum time for a request to be left pending in queue when
+     * `max_connections` is reached.
+     */
+    timeoutQueue?: string;
 }
 /** Backend server stats. */
 interface BackendServerStats {
@@ -16504,6 +16503,13 @@ type CreateBackendRequest = {
     redispatchAttemptCount?: number;
     /** Number of retries when a backend server connection failed. */
     maxRetries?: number;
+    /** Maximum number of connections allowed per backend server. */
+    maxConnections?: number;
+    /**
+     * Maximum time for a request to be left pending in queue when
+     * `max_connections` is reached.
+     */
+    timeoutQueue?: string;
 };
 type GetBackendRequest = {
     /**
@@ -16581,6 +16587,13 @@ type UpdateBackendRequest = {
     redispatchAttemptCount?: number;
     /** Number of retries when a backend server connection failed. */
     maxRetries?: number;
+    /** Maximum number of connections allowed per backend server. */
+    maxConnections?: number;
+    /**
+     * Maximum time for a request to be left pending in queue when
+     * `max_connections` is reached.
+     */
+    timeoutQueue?: string;
 };
 type DeleteBackendRequest = {
     /**
@@ -17497,6 +17510,13 @@ type ZonedApiCreateBackendRequest = {
     redispatchAttemptCount?: number;
     /** Number of retries when a backend server connection failed. */
     maxRetries?: number;
+    /** Maximum number of connections allowed per backend server. */
+    maxConnections?: number;
+    /**
+     * Maximum time for a request to be left pending in queue when
+     * `max_connections` is reached.
+     */
+    timeoutQueue?: string;
 };
 type ZonedApiGetBackendRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */
@@ -17568,6 +17588,13 @@ type ZonedApiUpdateBackendRequest = {
     redispatchAttemptCount?: number;
     /** Number of retries when a backend server connection failed. */
     maxRetries?: number;
+    /** Maximum number of connections allowed per backend server. */
+    maxConnections?: number;
+    /**
+     * Maximum time for a request to be left pending in queue when
+     * `max_connections` is reached.
+     */
+    timeoutQueue?: string;
 };
 type ZonedApiDeleteBackendRequest = {
     /** Zone to target. If none is passed will use default zone from the config. */