@scaleway/sdk 2.26.0 → 2.28.0

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

@@ -0,0 +1,1123 @@
+import type { Region, Zone } from '../../../bridge';
+export type AutoscalerEstimator = 'unknown_estimator' | 'binpacking';
+export type AutoscalerExpander = 'unknown_expander' | 'random' | 'most_pods' | 'least_waste' | 'priority' | 'price';
+export type CNI = 'unknown_cni' | 'cilium' | 'calico' | 'weave' | 'flannel' | 'kilo' | 'none';
+export type ClusterStatus = 'unknown' | 'creating' | 'ready' | 'deleting' | 'deleted' | 'updating' | 'locked' | 'pool_required';
+export type ClusterTypeAvailability = 'available' | 'scarce' | 'shortage';
+export type ClusterTypeResiliency = 'unknown_resiliency' | 'standard' | 'high_availability';
+export type ListClustersRequestOrderBy = 'created_at_asc' | 'created_at_desc' | 'updated_at_asc' | 'updated_at_desc' | 'name_asc' | 'name_desc' | 'status_asc' | 'status_desc' | 'version_asc' | 'version_desc';
+export type ListNodesRequestOrderBy = 'created_at_asc' | 'created_at_desc';
+export type ListPoolsRequestOrderBy = 'created_at_asc' | 'created_at_desc' | 'updated_at_asc' | 'updated_at_desc' | 'name_asc' | 'name_desc' | 'status_asc' | 'status_desc' | 'version_asc' | 'version_desc';
+export type MaintenanceWindowDayOfTheWeek = 'any' | 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+export type NodeStatus = 'unknown' | 'creating' | 'not_ready' | 'ready' | 'deleting' | 'deleted' | 'locked' | 'rebooting' | 'creation_error' | 'upgrading' | 'starting' | 'registering';
+export type PoolStatus = 'unknown' | 'ready' | 'deleting' | 'deleted' | 'scaling' | 'warning' | 'locked' | 'upgrading';
+export type PoolVolumeType = 'default_volume_type' | 'l_ssd' | 'b_ssd';
+export type Runtime = 'unknown_runtime' | 'docker' | 'containerd' | 'crio';
+export interface MaintenanceWindow {
+    /** Start time of the two-hour maintenance window. */
+    startHour: number;
+    /** Day of the week for the maintenance window. */
+    day: MaintenanceWindowDayOfTheWeek;
+}
+export interface PoolUpgradePolicy {
+    maxUnavailable: number;
+    maxSurge: number;
+}
+export interface CreateClusterRequestPoolConfigUpgradePolicy {
+    /** The maximum number of nodes that can be not ready at the same time. */
+    maxUnavailable?: number;
+    /** The maximum number of nodes to be created during the upgrade. */
+    maxSurge?: number;
+}
+export interface ClusterAutoUpgrade {
+    /** Defines whether auto upgrade is enabled for the cluster. */
+    enabled: boolean;
+    /** Maintenance window of the cluster auto upgrades. */
+    maintenanceWindow?: MaintenanceWindow;
+}
+export interface ClusterAutoscalerConfig {
+    /** Disable the cluster autoscaler. */
+    scaleDownDisabled: boolean;
+    /** How long after scale up that scale down evaluation resumes. */
+    scaleDownDelayAfterAdd: string;
+    /** Type of resource estimator to be used in scale up. */
+    estimator: AutoscalerEstimator;
+    /** Type of node group expander to be used in scale up. */
+    expander: AutoscalerExpander;
+    /**
+     * Ignore DaemonSet pods when calculating resource utilization for scaling
+     * down.
+     */
+    ignoreDaemonsetsUtilization: boolean;
+    /** Detect similar node groups and balance the number of nodes between them. */
+    balanceSimilarNodeGroups: boolean;
+    /**
+     * 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 to be scaled down. */
+    scaleDownUnneededTime: string;
+    /**
+     * 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;
+    /**
+     * Maximum number of seconds the cluster autoscaler waits for pod termination
+     * when trying to scale down a node.
+     */
+    maxGracefulTerminationSec: number;
+}
+export interface ClusterOpenIDConnectConfig {
+    /**
+     * URL of the provider which allows the API server to discover public signing
+     * 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. */
+    clientId: string;
+    /**
+     * 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 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 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 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[];
+}
+export interface Pool {
+    /** Pool ID. */
+    id: string;
+    /** Cluster ID of the pool. */
+    clusterId: string;
+    /** Date on which the pool was created. */
+    createdAt?: Date;
+    /** Date on which the pool was last updated. */
+    updatedAt?: Date;
+    /** Pool name. */
+    name: string;
+    /** Pool status. */
+    status: PoolStatus;
+    /** Pool version. */
+    version: string;
+    /**
+     * 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 in a Kosmos Cluster.
+     */
+    nodeType: string;
+    /** Defines whether the autoscaling feature is enabled for the pool. */
+    autoscaling: boolean;
+    /** Size (number of nodes) of the pool. */
+    size: number;
+    /**
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    minSize: number;
+    /**
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    maxSize: number;
+    /**
+     * 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. */
+    autohealing: boolean;
+    /** Tags associated with the pool. */
+    tags: string[];
+    /** 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
+     * experimental.
+     */
+    kubeletArgs: Record<string, string>;
+    /** Pool upgrade policy. */
+    upgradePolicy?: PoolUpgradePolicy;
+    /** Zone in which the pool's nodes will be spawned. */
+    zone: Zone;
+    /**
+     * 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. */
+    rootVolumeSize?: number;
+    /**
+     * Defines if the public IP should be removed from Nodes. To use this feature,
+     * your Cluster must have an attached Private Network set up with a Public
+     * Gateway.
+     */
+    publicIpDisabled: boolean;
+    /** Cluster region of the pool. */
+    region: Region;
+}
+export interface CreateClusterRequestAutoUpgrade {
+    /** Defines whether auto upgrade is enabled for the cluster. */
+    enable: boolean;
+    /** Maintenance window of the cluster auto upgrades. */
+    maintenanceWindow?: MaintenanceWindow;
+}
+export interface CreateClusterRequestAutoscalerConfig {
+    /** Disable the cluster autoscaler. */
+    scaleDownDisabled?: boolean;
+    /** How long after scale up that scale down evaluation resumes. */
+    scaleDownDelayAfterAdd?: string;
+    /** Type of resource estimator to be used in scale up. */
+    estimator: AutoscalerEstimator;
+    /** Type of node group expander to be used in scale up. */
+    expander: AutoscalerExpander;
+    /**
+     * Ignore DaemonSet pods when calculating resource utilization for scaling
+     * down.
+     */
+    ignoreDaemonsetsUtilization?: boolean;
+    /** Detect similar node groups and balance the number of nodes between them. */
+    balanceSimilarNodeGroups?: boolean;
+    /**
+     * 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 to be scaled down. */
+    scaleDownUnneededTime?: string;
+    /**
+     * 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;
+    /**
+     * Maximum number of seconds the cluster autoscaler waits for pod termination
+     * when trying to scale down a node.
+     */
+    maxGracefulTerminationSec?: number;
+}
+export interface CreateClusterRequestOpenIDConnectConfig {
+    /**
+     * URL of the provider which allows the API server to discover public signing
+     * 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. */
+    clientId: string;
+    /**
+     * 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 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 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 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[];
+}
+export interface CreateClusterRequestPoolConfig {
+    /** Name of the pool. */
+    name: string;
+    /**
+     * 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 in a Kosmos Cluster.
+     */
+    nodeType: string;
+    /** Placement group ID in which all the nodes of the pool will be created. */
+    placementGroupId?: string;
+    /** Defines whether the autoscaling feature is enabled for the pool. */
+    autoscaling: boolean;
+    /** Size (number of nodes) of the pool. */
+    size: number;
+    /**
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    minSize?: number;
+    /**
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    maxSize?: number;
+    /**
+     * 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. */
+    autohealing: boolean;
+    /** Tags associated with the pool. */
+    tags: string[];
+    /**
+     * Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
+     */
+    kubeletArgs: Record<string, string>;
+    /** Pool upgrade policy. */
+    upgradePolicy?: CreateClusterRequestPoolConfigUpgradePolicy;
+    /** Zone in which the pool's nodes will be spawned. */
+    zone: Zone;
+    /**
+     * 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. */
+    rootVolumeSize?: number;
+    /**
+     * Defines if the public IP should be removed from Nodes. To use this feature,
+     * your Cluster must have an attached Private Network set up with a Public
+     * Gateway.
+     */
+    publicIpDisabled: boolean;
+}
+export interface CreatePoolRequestUpgradePolicy {
+    maxUnavailable?: number;
+    maxSurge?: number;
+}
+export interface ExternalNodeCoreV1Taint {
+    key: string;
+    value: string;
+    effect: string;
+}
+export interface ClusterType {
+    /** Cluster type name. */
+    name: string;
+    /** Cluster type availability. */
+    availability: ClusterTypeAvailability;
+    /** Maximum number of nodes supported by the offer. */
+    maxNodes: number;
+    /** Time period during which you can no longer switch to a lower offer. */
+    commitmentDelay?: string;
+    /** Value of the Service Level Agreement of the offer. */
+    sla: number;
+    /** Resiliency offered by the offer. */
+    resiliency: ClusterTypeResiliency;
+    /** Max RAM allowed for the control plane. */
+    memory: number;
+    /** Returns information if this offer uses dedicated resources. */
+    dedicated: boolean;
+    /**
+     * True if the offer allows activation of the audit log functionality. Please
+     * note that audit logs are sent to Cockpit.
+     */
+    auditLogsSupported: boolean;
+}
+export interface Version {
+    /** Name of the Kubernetes version. */
+    name: string;
+    /** Label of the Kubernetes version. */
+    label: string;
+    /** Region in which this version is available. */
+    region: Region;
+    /** Supported Container Network Interface (CNI) plugins for this version. */
+    availableCnis: CNI[];
+    /** Supported container runtimes for this version. */
+    availableContainerRuntimes: Runtime[];
+    /** Supported feature gates for this version. */
+    availableFeatureGates: string[];
+    /** Supported admission plugins for this version. */
+    availableAdmissionPlugins: string[];
+    /** Supported kubelet arguments for this version. */
+    availableKubeletArgs: Record<string, string>;
+}
+export interface Cluster {
+    /** Cluster ID. */
+    id: string;
+    /** Cluster type. */
+    type: string;
+    /** Cluster name. */
+    name: string;
+    /** Status of the cluster. */
+    status: ClusterStatus;
+    /** Kubernetes version of the cluster. */
+    version: string;
+    /** Region in which the cluster is deployed. */
+    region: Region;
+    /** ID of the Organization owning the cluster. */
+    organizationId: string;
+    /** 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;
+    /** Cluster description. */
+    description: string;
+    /** Kubernetes API server URL of the cluster. */
+    clusterUrl: string;
+    /** Wildcard DNS resolving all the ready cluster nodes. */
+    dnsWildcard: string;
+    /** Date on which the cluster was created. */
+    createdAt?: Date;
+    /** Date on which the cluster was last updated. */
+    updatedAt?: Date;
+    /** Autoscaler config for the cluster. */
+    autoscalerConfig?: ClusterAutoscalerConfig;
+    /** Auto upgrade configuration of the cluster. */
+    autoUpgrade?: ClusterAutoUpgrade;
+    /** Defines whether a new Kubernetes version is available. */
+    upgradeAvailable: boolean;
+    /** List of enabled feature gates. */
+    featureGates: string[];
+    /** List of enabled admission plugins. */
+    admissionPlugins: string[];
+    /**
+     * This configuration enables to update the OpenID Connect configuration of
+     * the Kubernetes API server.
+     */
+    openIdConnectConfig?: ClusterOpenIDConnectConfig;
+    /**
+     * Additional Subject Alternative Names for the Kubernetes API server
+     * certificate.
+     */
+    apiserverCertSans: string[];
+    /** Private network ID for internal cluster communication. */
+    privateNetworkId?: string;
+    /** Date on which it will be possible to switch to a smaller offer. */
+    commitmentEndsAt?: Date;
+    /**
+     * @deprecated Defines whether routed IPs are enabled for nodes of this
+     *   cluster.
+     */
+    routedIpEnabled?: boolean;
+}
+export interface Node {
+    /** Node ID. */
+    id: string;
+    /** Pool ID of the node. */
+    poolId: string;
+    /** Cluster ID of the node. */
+    clusterId: string;
+    /**
+     * Underlying instance ID. It is prefixed by instance type and location
+     * information (see
+     * https://pkg.go.dev/k8s.io/api/core/v1#NodeSpec.ProviderID).
+     */
+    providerId: string;
+    /** Cluster region of the node. */
+    region: Region;
+    /** Name of the node. */
+    name: string;
+    /** @deprecated Public IPv4 address of the node. */
+    publicIpV4?: string;
+    /** @deprecated Public IPv6 address of the node. */
+    publicIpV6?: string;
+    /**
+     * @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 occurred when managing the node. */
+    errorMessage?: string;
+    /** Date on which the node was created. */
+    createdAt?: Date;
+    /** Date on which the node was last updated. */
+    updatedAt?: Date;
+}
+export interface UpdateClusterRequestAutoUpgrade {
+    /** Defines whether auto upgrade is enabled for the cluster. */
+    enable?: boolean;
+    /** Maintenance window of the cluster auto upgrades. */
+    maintenanceWindow?: MaintenanceWindow;
+}
+export interface UpdateClusterRequestAutoscalerConfig {
+    /** Disable the cluster autoscaler. */
+    scaleDownDisabled?: boolean;
+    /** How long after scale up that scale down evaluation resumes. */
+    scaleDownDelayAfterAdd?: string;
+    /** Type of resource estimator to be used in scale up. */
+    estimator: AutoscalerEstimator;
+    /** Type of node group expander to be used in scale up. */
+    expander: AutoscalerExpander;
+    /**
+     * Ignore DaemonSet pods when calculating resource utilization for scaling
+     * down.
+     */
+    ignoreDaemonsetsUtilization?: boolean;
+    /** Detect similar node groups and balance the number of nodes between them. */
+    balanceSimilarNodeGroups?: boolean;
+    /**
+     * 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 to be scaled down. */
+    scaleDownUnneededTime?: string;
+    /**
+     * 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;
+    /**
+     * Maximum number of seconds the cluster autoscaler waits for pod termination
+     * when trying to scale down a node.
+     */
+    maxGracefulTerminationSec?: number;
+}
+export interface UpdateClusterRequestOpenIDConnectConfig {
+    /**
+     * URL of the provider which allows the API server to discover public signing
+     * 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. */
+    clientId?: string;
+    /**
+     * 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 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 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 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[];
+}
+export interface UpdatePoolRequestUpgradePolicy {
+    maxUnavailable?: number;
+    maxSurge?: number;
+}
+export type CreateClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /**
+     * @deprecated Organization ID in which the cluster will be created.
+     *
+     *   One-of ('projectIdentifier'): at most one of 'projectId', 'organizationId'
+     *   could be set.
+     */
+    organizationId?: string;
+    /**
+     * Project ID in which the cluster will be created.
+     *
+     * One-of ('projectIdentifier'): at most one of 'projectId', 'organizationId'
+     * could be set.
+     */
+    projectId?: string;
+    /**
+     * Type of the cluster (possible values are kapsule, multicloud,
+     * kapsule-dedicated-8, kapsule-dedicated-16).
+     */
+    type: string;
+    /** Cluster name. */
+    name?: string;
+    /** Cluster description. */
+    description: string;
+    /** Tags associated with the cluster. */
+    tags?: string[];
+    /** Kubernetes version of the cluster. */
+    version: string;
+    /** Container Network Interface (CNI) plugin running in the cluster. */
+    cni: CNI;
+    /** Pools created along with the cluster. */
+    pools?: CreateClusterRequestPoolConfig[];
+    /**
+     * 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;
+    /**
+     * 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.
+     */
+    autoUpgrade?: CreateClusterRequestAutoUpgrade;
+    /** List of feature gates to enable. */
+    featureGates?: string[];
+    /** List of admission plugins to enable. */
+    admissionPlugins?: string[];
+    /**
+     * OpenID Connect configuration of the cluster. This configuration enables to
+     * update the OpenID Connect configuration of the Kubernetes API server.
+     */
+    openIdConnectConfig?: CreateClusterRequestOpenIDConnectConfig;
+    /**
+     * Additional Subject Alternative Names for the Kubernetes API server
+     * certificate.
+     */
+    apiserverCertSans?: string[];
+    /**
+     * Private network ID for internal cluster communication (cannot be changed
+     * later).
+     */
+    privateNetworkId?: string;
+};
+export type CreateExternalNodeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    poolId: string;
+};
+export type CreatePoolRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID to which the pool will be attached. */
+    clusterId: string;
+    /** Pool name. */
+    name?: string;
+    /**
+     * 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 in a Kosmos Cluster.
+     */
+    nodeType: string;
+    /** Placement group ID in which all the nodes of the pool will be created. */
+    placementGroupId?: string;
+    /** Defines whether the autoscaling feature is enabled for the pool. */
+    autoscaling: boolean;
+    /** Size (number of nodes) of the pool. */
+    size: number;
+    /**
+     * Defines the minimum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    minSize?: number;
+    /**
+     * Defines the maximum size of the pool. Note that this field is only used
+     * when autoscaling is enabled on the pool.
+     */
+    maxSize?: number;
+    /**
+     * 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. */
+    autohealing: boolean;
+    /** Tags associated with the pool. */
+    tags?: string[];
+    /**
+     * Kubelet arguments to be used by this pool. Note that this feature is
+     * experimental.
+     */
+    kubeletArgs?: Record<string, string>;
+    /** Pool upgrade policy. */
+    upgradePolicy?: CreatePoolRequestUpgradePolicy;
+    /** Zone in which the pool's nodes will be spawned. */
+    zone?: Zone;
+    /**
+     * 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. */
+    rootVolumeSize?: number;
+    /**
+     * Defines if the public IP should be removed from Nodes. To use this feature,
+     * your Cluster must have an attached Private Network set up with a Public
+     * Gateway.
+     */
+    publicIpDisabled: boolean;
+};
+export type DeleteClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster to delete. */
+    clusterId: string;
+    /**
+     * Defines whether all volumes (including retain volume type), empty Private
+     * Networks and Load Balancers with a name starting with the cluster ID will
+     * also be deleted.
+     */
+    withAdditionalResources: boolean;
+};
+export type DeleteNodeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the node to replace. */
+    nodeId: string;
+    /**
+     * Skip draining node from its workload (Note: this parameter is currently
+     * inactive).
+     */
+    skipDrain: boolean;
+    /** Add a new node after the deletion of this node. */
+    replace: boolean;
+};
+export type DeletePoolRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the pool to delete. */
+    poolId: string;
+};
+export interface ExternalNode {
+    id: string;
+    name: string;
+    clusterUrl: string;
+    poolVersion: string;
+    clusterCa: string;
+    kubeToken: string;
+    kubeletConfig: string;
+    externalIp: string;
+    containerdVersion: string;
+    runcVersion: string;
+    cniPluginsVersion: string;
+    nodeLabels: Record<string, string>;
+    nodeTaints: ExternalNodeCoreV1Taint[];
+}
+export type GetClusterKubeConfigRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID for which to download the kubeconfig. */
+    clusterId: string;
+    /** Hide the legacy token from the kubeconfig. */
+    redacted?: boolean;
+};
+export type GetClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the requested cluster. */
+    clusterId: string;
+};
+export type GetNodeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the requested node. */
+    nodeId: string;
+};
+export type GetPoolRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the requested pool. */
+    poolId: string;
+};
+export type GetVersionRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Requested version name. */
+    versionName: string;
+};
+export type ListClusterAvailableTypesRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID for which the available Kubernetes types will be listed. */
+    clusterId: string;
+};
+export interface ListClusterAvailableTypesResponse {
+    /** Available cluster types for the cluster. */
+    clusterTypes: ClusterType[];
+    /** Total number of types. */
+    totalCount: number;
+}
+export type ListClusterAvailableVersionsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID for which the available Kubernetes versions will be listed. */
+    clusterId: string;
+};
+export interface ListClusterAvailableVersionsResponse {
+    /** Available Kubernetes versions for the cluster. */
+    versions: Version[];
+}
+export type ListClusterTypesRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Page number, from the paginated results, to return for cluster-types. */
+    page?: number;
+    /** Maximum number of clusters per page. */
+    pageSize?: number;
+};
+export interface ListClusterTypesResponse {
+    /** Total number of cluster-types. */
+    totalCount: number;
+    /** Paginated returned cluster-types. */
+    clusterTypes: ClusterType[];
+}
+export type ListClustersRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Organization ID on which to filter the returned clusters. */
+    organizationId?: string;
+    /** Project ID on which to filter the returned clusters. */
+    projectId?: string;
+    /** Sort order of returned clusters. */
+    orderBy?: ListClustersRequestOrderBy;
+    /** Page number to return for clusters, from the paginated results. */
+    page?: number;
+    /** Maximum number of clusters per page. */
+    pageSize?: number;
+    /**
+     * Name to filter on, only clusters containing this substring in their name
+     * will be returned.
+     */
+    name?: string;
+    /** Status to filter on, only clusters with this status will be returned. */
+    status?: ClusterStatus;
+    /** Type to filter on, only clusters with this type will be returned. */
+    type?: string;
+    /**
+     * Private Network ID to filter on, only clusters within this Private Network
+     * will be returned.
+     */
+    privateNetworkId?: string;
+};
+export interface ListClustersResponse {
+    /** Total number of clusters. */
+    totalCount: number;
+    /** Paginated returned clusters. */
+    clusters: Cluster[];
+}
+export type ListNodesRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID from which the nodes will be listed from. */
+    clusterId: string;
+    /** Pool ID on which to filter the returned nodes. */
+    poolId?: string;
+    /** Sort order of the returned nodes. */
+    orderBy?: ListNodesRequestOrderBy;
+    /** Page number for the returned nodes. */
+    page?: number;
+    /** Maximum number of nodes per page. */
+    pageSize?: number;
+    /**
+     * Name to filter on, only nodes containing this substring in their name will
+     * be returned.
+     */
+    name?: string;
+    /** Status to filter on, only nodes with this status will be returned. */
+    status?: NodeStatus;
+};
+export interface ListNodesResponse {
+    /** Total number of nodes. */
+    totalCount: number;
+    /** Paginated returned nodes. */
+    nodes: Node[];
+}
+export type ListPoolsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster whose pools will be listed. */
+    clusterId: string;
+    /** Sort order of returned pools. */
+    orderBy?: ListPoolsRequestOrderBy;
+    /** Page number for the returned pools. */
+    page?: number;
+    /** Maximum number of pools per page. */
+    pageSize?: number;
+    /**
+     * Name to filter on, only pools containing this substring in their name will
+     * be returned.
+     */
+    name?: string;
+    /** Status to filter on, only pools with this status will be returned. */
+    status?: PoolStatus;
+};
+export interface ListPoolsResponse {
+    /** Total number of pools that exists for the cluster. */
+    totalCount: number;
+    /** Paginated returned pools. */
+    pools: Pool[];
+}
+export type ListVersionsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+};
+export interface ListVersionsResponse {
+    /** Available Kubernetes versions. */
+    versions: Version[];
+}
+export type MigrateClusterToRoutedIPsRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    clusterId: string;
+};
+export type MigrateToPrivateNetworkClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster to migrate. */
+    clusterId: string;
+    /** ID of the Private Network to link to the cluster. */
+    privateNetworkId: string;
+};
+export type RebootNodeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the node to reboot. */
+    nodeId: string;
+};
+export type ReplaceNodeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the node to replace. */
+    nodeId: string;
+};
+export type ResetClusterAdminTokenRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** Cluster ID on which the admin token will be renewed. */
+    clusterId: string;
+};
+export type SetClusterTypeRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster to migrate from one type to another. */
+    clusterId: string;
+    /**
+     * Type of the cluster. Note that some migrations are not possible (please
+     * refer to product documentation).
+     */
+    type: string;
+};
+export type UpdateClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster to update. */
+    clusterId: string;
+    /** New external name for the cluster. */
+    name?: string;
+    /** New description for the cluster. */
+    description?: string;
+    /** New tags associated with the cluster. */
+    tags?: string[];
+    /** New autoscaler config for the cluster. */
+    autoscalerConfig?: UpdateClusterRequestAutoscalerConfig;
+    /**
+     * New auto upgrade configuration for the cluster. Note that all fields need
+     * to be set.
+     */
+    autoUpgrade?: UpdateClusterRequestAutoUpgrade;
+    /** List of feature gates to enable. */
+    featureGates?: string[];
+    /** List of admission plugins to enable. */
+    admissionPlugins?: string[];
+    /**
+     * OpenID Connect configuration of the cluster. This configuration enables to
+     * update the OpenID Connect configuration of the Kubernetes API server.
+     */
+    openIdConnectConfig?: UpdateClusterRequestOpenIDConnectConfig;
+    /**
+     * Additional Subject Alternative Names for the Kubernetes API server
+     * certificate.
+     */
+    apiserverCertSans?: string[];
+};
+export type UpdatePoolRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the pool to update. */
+    poolId: string;
+    /** New value for the pool autoscaling enablement. */
+    autoscaling?: boolean;
+    /** New desired pool size. */
+    size?: number;
+    /** New minimum size for the pool. */
+    minSize?: number;
+    /** New maximum size for the pool. */
+    maxSize?: number;
+    /** 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
+     * experimental.
+     */
+    kubeletArgs?: Record<string, string>;
+    /** New upgrade policy for the pool. */
+    upgradePolicy?: UpdatePoolRequestUpgradePolicy;
+};
+export type UpgradeClusterRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the cluster to upgrade. */
+    clusterId: string;
+    /**
+     * 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;
+    /**
+     * Defines whether pools will also be upgraded once the control plane is
+     * upgraded.
+     */
+    upgradePools: boolean;
+};
+export type UpgradePoolRequest = {
+    /**
+     * Region to target. If none is passed will use default region from the
+     * config.
+     */
+    region?: Region;
+    /** ID of the pool to upgrade. */
+    poolId: string;
+    /** New Kubernetes version for the pool. */
+    version: string;
+};