latitudesh-python-sdk 3.0.2__tar.gz → 3.0.4__tar.gz

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: latitudesh-python-sdk
-Version: 3.0.2
+Version: 3.0.4
 Summary: Python Client SDK Generated by Speakeasy.
 License-File: LICENSE
 Author: Speakeasy
@@ -315,9 +315,10 @@ with Latitudesh(
 
 * [list_kubernetes_clusters](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#list_kubernetes_clusters) - List Kubernetes Clusters
 * [create_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#create_kubernetes_cluster) - Create a Kubernetes Cluster
+* [list_kubernetes_available_versions](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#list_kubernetes_available_versions) - List Available Kubernetes Versions
 * [get_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#get_kubernetes_cluster) - Get a Kubernetes Cluster
 * [delete_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#delete_kubernetes_cluster) - Delete a Kubernetes Cluster
-* [update_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#update_kubernetes_cluster) - Scale Kubernetes Cluster
+* [update_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#update_kubernetes_cluster) - Update Kubernetes Cluster
 * [get_kubernetes_cluster_kubeconfig](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#get_kubernetes_cluster_kubeconfig) - Get Kubernetes Cluster Kubeconfig
 
 ### [OperatingSystems](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/operatingsystemssdk/README.md)
@@ -611,7 +612,7 @@ with Latitudesh(
 
 
 **Inherit from [`LatitudeshError`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/latitudesherror.py)**:
-* [`ErrorObject`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/errorobject.py): Applicable to 19 of 128 methods.*
+* [`ErrorObject`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/errorobject.py): Applicable to 20 of 129 methods.*
 * [`ResponseValidationError`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/README-PYPI.md

@@ -295,9 +295,10 @@ with Latitudesh(
 
 * [list_kubernetes_clusters](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#list_kubernetes_clusters) - List Kubernetes Clusters
 * [create_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#create_kubernetes_cluster) - Create a Kubernetes Cluster
+* [list_kubernetes_available_versions](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#list_kubernetes_available_versions) - List Available Kubernetes Versions
 * [get_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#get_kubernetes_cluster) - Get a Kubernetes Cluster
 * [delete_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#delete_kubernetes_cluster) - Delete a Kubernetes Cluster
-* [update_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#update_kubernetes_cluster) - Scale Kubernetes Cluster
+* [update_kubernetes_cluster](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#update_kubernetes_cluster) - Update Kubernetes Cluster
 * [get_kubernetes_cluster_kubeconfig](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/kubernetesclusterssdk/README.md#get_kubernetes_cluster_kubeconfig) - Get Kubernetes Cluster Kubeconfig
 
 ### [OperatingSystems](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/docs/sdks/operatingsystemssdk/README.md)
@@ -591,7 +592,7 @@ with Latitudesh(
 
 
 **Inherit from [`LatitudeshError`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/latitudesherror.py)**:
-* [`ErrorObject`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/errorobject.py): Applicable to 19 of 128 methods.*
+* [`ErrorObject`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/errorobject.py): Applicable to 20 of 129 methods.*
 * [`ResponseValidationError`](https://github.com/latitudesh/latitudesh-python-sdk/blob/master/./src/latitudesh_python_sdk/models/responsevalidationerror.py): Type mismatch between the response data and the expected Pydantic model. Provides access to the Pydantic validation error via the `cause` attribute.
 
 </details>

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/pyproject.toml

@@ -1,7 +1,7 @@
 
 [project]
 name = "latitudesh-python-sdk"
-version = "3.0.2"
+version = "3.0.4"
 description = "Python Client SDK Generated by Speakeasy."
 authors = [{ name = "Speakeasy" },]
 readme = "README-PYPI.md"

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/_version.py

@@ -3,11 +3,11 @@
 import importlib.metadata
 
 __title__: str = "latitudesh-python-sdk"
-__version__: str = "3.0.2"
+__version__: str = "3.0.4"
 __openapi_doc_version__: str = "2023-06-01"
-__gen_version__: str = "2.879.6"
+__gen_version__: str = "2.879.10"
 __user_agent__: str = (
-    "speakeasy-sdk/python 3.0.2 2.879.6 2023-06-01 latitudesh-python-sdk"
+    "speakeasy-sdk/python 3.0.4 2.879.10 2023-06-01 latitudesh-python-sdk"
 )
 
 try:

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/kubernetes_clusters_sdk.py

@@ -400,6 +400,182 @@ class KubernetesClustersSDK(BaseSDK):
 
         raise models.APIError("Unexpected response received", http_res)
 
+    def list_kubernetes_available_versions(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.KubernetesAvailableVersions:
+        r"""List Available Kubernetes Versions
+
+        Returns the list of available Kubernetes versions for cluster creation and upgrades. Versions are sourced from the RKE2 release channels and cached for 24 hours.
+
+        Each version object includes:
+        - `latest`: The full version string (e.g., `v1.35.3+rke2r1`)
+        - `minor`: The minor version number (e.g., `1.35`)
+
+        The API returns the latest 5 supported minor versions. When upgrading clusters, you can only upgrade one minor version at a time (e.g., from 1.34 to 1.35).
+
+
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+        req = self._build_request(
+            method="GET",
+            path="/kubernetes_clusters/available_versions",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/vnd.api+json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = self.do_request(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="list-kubernetes-available-versions",
+                oauth2_scopes=None,
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "403", "4XX", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/vnd.api+json"):
+            return unmarshal_json_response(models.KubernetesAvailableVersions, http_res)
+        if utils.match_response(http_res, ["401", "403"], "application/vnd.api+json"):
+            response_data = unmarshal_json_response(models.ErrorObjectData, http_res)
+            raise models.ErrorObject(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise models.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = utils.stream_to_text(http_res)
+            raise models.APIError("API error occurred", http_res, http_res_text)
+
+        raise models.APIError("Unexpected response received", http_res)
+
+    async def list_kubernetes_available_versions_async(
+        self,
+        *,
+        retries: OptionalNullable[utils.RetryConfig] = UNSET,
+        server_url: Optional[str] = None,
+        timeout_ms: Optional[int] = None,
+        http_headers: Optional[Mapping[str, str]] = None,
+    ) -> models.KubernetesAvailableVersions:
+        r"""List Available Kubernetes Versions
+
+        Returns the list of available Kubernetes versions for cluster creation and upgrades. Versions are sourced from the RKE2 release channels and cached for 24 hours.
+
+        Each version object includes:
+        - `latest`: The full version string (e.g., `v1.35.3+rke2r1`)
+        - `minor`: The minor version number (e.g., `1.35`)
+
+        The API returns the latest 5 supported minor versions. When upgrading clusters, you can only upgrade one minor version at a time (e.g., from 1.34 to 1.35).
+
+
+        :param retries: Override the default retry configuration for this method
+        :param server_url: Override the default server URL for this method
+        :param timeout_ms: Override the default request timeout configuration for this method in milliseconds
+        :param http_headers: Additional headers to set or replace on requests.
+        """
+        base_url = None
+        url_variables = None
+        if timeout_ms is None:
+            timeout_ms = self.sdk_configuration.timeout_ms
+
+        if server_url is not None:
+            base_url = server_url
+        else:
+            base_url = self._get_url(base_url, url_variables)
+        req = self._build_request_async(
+            method="GET",
+            path="/kubernetes_clusters/available_versions",
+            base_url=base_url,
+            url_variables=url_variables,
+            request=None,
+            request_body_required=False,
+            request_has_path_params=False,
+            request_has_query_params=True,
+            user_agent_header="user-agent",
+            accept_header_value="application/vnd.api+json",
+            http_headers=http_headers,
+            security=self.sdk_configuration.security,
+            allow_empty_value=None,
+            timeout_ms=timeout_ms,
+        )
+
+        if retries == UNSET:
+            if self.sdk_configuration.retry_config is not UNSET:
+                retries = self.sdk_configuration.retry_config
+
+        retry_config = None
+        if isinstance(retries, utils.RetryConfig):
+            retry_config = (retries, ["429", "500", "502", "503", "504"])
+
+        http_res = await self.do_request_async(
+            hook_ctx=HookContext(
+                config=self.sdk_configuration,
+                base_url=base_url or "",
+                operation_id="list-kubernetes-available-versions",
+                oauth2_scopes=None,
+                security_source=get_security_from_env(
+                    self.sdk_configuration.security, models.Security
+                ),
+            ),
+            request=req,
+            error_status_codes=["401", "403", "4XX", "5XX"],
+            retry_config=retry_config,
+        )
+
+        response_data: Any = None
+        if utils.match_response(http_res, "200", "application/vnd.api+json"):
+            return unmarshal_json_response(models.KubernetesAvailableVersions, http_res)
+        if utils.match_response(http_res, ["401", "403"], "application/vnd.api+json"):
+            response_data = unmarshal_json_response(models.ErrorObjectData, http_res)
+            raise models.ErrorObject(response_data, http_res)
+        if utils.match_response(http_res, "4XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise models.APIError("API error occurred", http_res, http_res_text)
+        if utils.match_response(http_res, "5XX", "*"):
+            http_res_text = await utils.stream_to_text_async(http_res)
+            raise models.APIError("API error occurred", http_res, http_res_text)
+
+        raise models.APIError("Unexpected response received", http_res)
+
     def get_kubernetes_cluster(
         self,
         *,
@@ -777,9 +953,11 @@ class KubernetesClustersSDK(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.KubernetesClusterUpdateResponse:
-        r"""Scale Kubernetes Cluster
+        r"""Update Kubernetes Cluster
+
+        Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in `Provisioned` phase to accept updates.
 
-        Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in `Provisioned` phase to accept updates.
+        ## Scaling Operations
 
         Exactly one of `worker_count` or `control_plane_count` must be provided per request. You cannot scale workers and control plane nodes in the same request.
 
@@ -789,7 +967,16 @@ class KubernetesClustersSDK(BaseSDK):
 
         Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
 
-        Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested count matches the current count (no-op).
+        ## Version Upgrades
+
+        Provide a `kubernetes_version` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:
+
+        - **No downgrades**: You cannot downgrade to a lower version than currently installed
+        - **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
+        - **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
+        - **Available versions only**: The target version must be in the list returned by `GET /kubernetes_clusters/available_versions`
+
+        Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).
 
 
         :param kubernetes_cluster_id: The cluster ID (format: kc_<hash>) or cluster name. Both formats are accepted for backward compatibility.
@@ -898,9 +1085,11 @@ class KubernetesClustersSDK(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.KubernetesClusterUpdateResponse:
-        r"""Scale Kubernetes Cluster
+        r"""Update Kubernetes Cluster
 
-        Scales the worker nodes or control plane nodes of a Kubernetes cluster. The cluster must be in `Provisioned` phase to accept updates.
+        Updates a Kubernetes cluster by scaling nodes or upgrading the Kubernetes version. The cluster must be in `Provisioned` phase to accept updates.
+
+        ## Scaling Operations
 
         Exactly one of `worker_count` or `control_plane_count` must be provided per request. You cannot scale workers and control plane nodes in the same request.
 
@@ -910,7 +1099,16 @@ class KubernetesClustersSDK(BaseSDK):
 
         Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
 
-        Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested count matches the current count (no-op).
+        ## Version Upgrades
+
+        Provide a `kubernetes_version` parameter to upgrade the cluster to a new Kubernetes version. Version upgrades follow these rules:
+
+        - **No downgrades**: You cannot downgrade to a lower version than currently installed
+        - **One minor version at a time**: You can only upgrade one minor version at a time (e.g., from 1.34 to 1.35, not from 1.34 to 1.36)
+        - **Mutually exclusive**: Version upgrades cannot be combined with scaling operations in the same request
+        - **Available versions only**: The target version must be in the list returned by `GET /kubernetes_clusters/available_versions`
+
+        Returns 202 Accepted when an update operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if no change is needed (no-op).
 
 
         :param kubernetes_cluster_id: The cluster ID (format: kc_<hash>) or cluster name. Both formats are accepted for backward compatibility.

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/models/__init__.py

@@ -657,6 +657,12 @@ if TYPE_CHECKING:
         IpmiSessionType,
         IpmiSessionTypedDict,
     )
+    from .kubernetes_available_versions import (
+        KubernetesAvailableVersions,
+        KubernetesAvailableVersionsData,
+        KubernetesAvailableVersionsDataTypedDict,
+        KubernetesAvailableVersionsTypedDict,
+    )
     from .kubernetes_cluster import KubernetesCluster, KubernetesClusterTypedDict
     from .kubernetes_cluster_create_response import (
         KubernetesClusterCreateResponse,
@@ -685,6 +691,7 @@ if TYPE_CHECKING:
         KubernetesClusterDataTypedDict,
         Nodes,
         NodesTypedDict,
+        VersionStatus,
         WorkerStatus,
         Workers,
         WorkersTypedDict,
@@ -2081,6 +2088,10 @@ __all__ = [
     "IpmiSessionType",
     "IpmiSessionTypedDict",
     "IpmiStatus",
+    "KubernetesAvailableVersions",
+    "KubernetesAvailableVersionsData",
+    "KubernetesAvailableVersionsDataTypedDict",
+    "KubernetesAvailableVersionsTypedDict",
     "KubernetesCluster",
     "KubernetesClusterCreateResponse",
     "KubernetesClusterCreateResponseAttributes",
@@ -2728,6 +2739,7 @@ __all__ = [
     "UserUpdateTypedDict",
     "Vcpu",
     "VcpuTypedDict",
+    "VersionStatus",
     "VirtualMachine",
     "VirtualMachineAttributes",
     "VirtualMachineAttributesAttributes",
@@ -3342,6 +3354,10 @@ _dynamic_imports: dict[str, str] = {
     "IpmiSessionDataTypedDict": ".ipmi_session",
     "IpmiSessionType": ".ipmi_session",
     "IpmiSessionTypedDict": ".ipmi_session",
+    "KubernetesAvailableVersions": ".kubernetes_available_versions",
+    "KubernetesAvailableVersionsData": ".kubernetes_available_versions",
+    "KubernetesAvailableVersionsDataTypedDict": ".kubernetes_available_versions",
+    "KubernetesAvailableVersionsTypedDict": ".kubernetes_available_versions",
     "KubernetesCluster": ".kubernetes_cluster",
     "KubernetesClusterTypedDict": ".kubernetes_cluster",
     "KubernetesClusterCreateResponse": ".kubernetes_cluster_create_response",
@@ -3368,6 +3384,7 @@ _dynamic_imports: dict[str, str] = {
     "KubernetesClusterDataTypedDict": ".kubernetes_cluster_data",
     "Nodes": ".kubernetes_cluster_data",
     "NodesTypedDict": ".kubernetes_cluster_data",
+    "VersionStatus": ".kubernetes_cluster_data",
     "WorkerStatus": ".kubernetes_cluster_data",
     "Workers": ".kubernetes_cluster_data",
     "WorkersTypedDict": ".kubernetes_cluster_data",

latitudesh_python_sdk-3.0.4/src/latitudesh_python_sdk/models/kubernetes_available_versions.py

@@ -0,0 +1,66 @@
+"""Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT."""
+
+from __future__ import annotations
+from latitudesh_python_sdk.types import BaseModel, UNSET_SENTINEL
+from pydantic import model_serializer
+from typing import List, Optional
+from typing_extensions import NotRequired, TypedDict
+
+
+class KubernetesAvailableVersionsDataTypedDict(TypedDict):
+    latest: NotRequired[str]
+    r"""The latest full Kubernetes version string for this minor version (e.g., v1.35.3+rke2r1)"""
+    minor: NotRequired[str]
+    r"""The minor version number (e.g., 1.35)"""
+
+
+class KubernetesAvailableVersionsData(BaseModel):
+    latest: Optional[str] = None
+    r"""The latest full Kubernetes version string for this minor version (e.g., v1.35.3+rke2r1)"""
+
+    minor: Optional[str] = None
+    r"""The minor version number (e.g., 1.35)"""
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["latest", "minor"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m
+
+
+class KubernetesAvailableVersionsTypedDict(TypedDict):
+    r"""Response schema for available Kubernetes versions"""
+
+    data: NotRequired[List[KubernetesAvailableVersionsDataTypedDict]]
+
+
+class KubernetesAvailableVersions(BaseModel):
+    r"""Response schema for available Kubernetes versions"""
+
+    data: Optional[List[KubernetesAvailableVersionsData]] = None
+
+    @model_serializer(mode="wrap")
+    def serialize_model(self, handler):
+        optional_fields = set(["data"])
+        serialized = handler(self)
+        m = {}
+
+        for n, f in type(self).model_fields.items():
+            k = f.alias or n
+            val = serialized.get(k, serialized.get(n))
+
+            if val != UNSET_SENTINEL:
+                if val is not None or k not in optional_fields:
+                    m[k] = val
+
+        return m

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/models/kubernetes_cluster_data.py

@@ -25,6 +25,15 @@ class KubernetesClusterDataPhase(str, Enum):
     FAILED = "Failed"
 
 
+class VersionStatus(str, Enum):
+    r"""The cluster's version status relative to available upgrades"""
+
+    UP_TO_DATE = "up_to_date"
+    UPGRADE_AVAILABLE = "upgrade_available"
+    UNSUPPORTED = "unsupported"
+    UNKNOWN = "unknown"
+
+
 class ControlPlaneTypedDict(TypedDict):
     r"""Control plane status information"""
 
@@ -319,6 +328,10 @@ class KubernetesClusterDataAttributesTypedDict(TypedDict):
     r"""IP addresses assigned to the cluster's load balancer"""
     kubernetes_version: NotRequired[str]
     r"""The Kubernetes version running on the cluster"""
+    version_status: NotRequired[VersionStatus]
+    r"""The cluster's version status relative to available upgrades"""
+    available_upgrade: NotRequired[Nullable[str]]
+    r"""The next available Kubernetes version for upgrade. Null if the cluster is already on the latest version, or if version status is unknown or unsupported."""
     created_at: NotRequired[datetime]
     r"""When the cluster was created"""
     plan: NotRequired[str]
@@ -382,6 +395,12 @@ class KubernetesClusterDataAttributes(BaseModel):
     kubernetes_version: Optional[str] = None
     r"""The Kubernetes version running on the cluster"""
 
+    version_status: Optional[VersionStatus] = None
+    r"""The cluster's version status relative to available upgrades"""
+
+    available_upgrade: OptionalNullable[str] = UNSET
+    r"""The next available Kubernetes version for upgrade. Null if the cluster is already on the latest version, or if version status is unknown or unsupported."""
+
     created_at: Optional[datetime] = None
     r"""When the cluster was created"""
 
@@ -448,6 +467,8 @@ class KubernetesClusterDataAttributes(BaseModel):
                 "location",
                 "load_balancer_ips",
                 "kubernetes_version",
+                "version_status",
+                "available_upgrade",
                 "created_at",
                 "plan",
                 "worker_plan",
@@ -472,6 +493,7 @@ class KubernetesClusterDataAttributes(BaseModel):
             [
                 "control_plane_endpoint",
                 "kubeconfig_url",
+                "available_upgrade",
                 "worker_plan",
                 "control_plane",
                 "workers",

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/models/kubernetes_cluster_update_response.py

@@ -19,9 +19,10 @@ class KubernetesClusterUpdateResponseType(str, Enum):
 
 
 class KubernetesClusterUpdateResponseStatus(str, Enum):
-    r"""The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count."""
+    r"""The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed."""
 
     SCALING = "scaling"
+    UPGRADING = "upgrading"
     UNCHANGED = "unchanged"
 
 
@@ -29,11 +30,13 @@ class KubernetesClusterUpdateResponseAttributesTypedDict(TypedDict):
     name: NotRequired[str]
     r"""The cluster name"""
     status: NotRequired[KubernetesClusterUpdateResponseStatus]
-    r"""The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count."""
+    r"""The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed."""
     worker_count: NotRequired[Nullable[int]]
     r"""The requested number of worker nodes. Present when scaling workers."""
     control_plane_count: NotRequired[Nullable[int]]
     r"""The requested number of control plane nodes. Present when scaling control plane."""
+    kubernetes_version: NotRequired[Nullable[str]]
+    r"""The target Kubernetes version. Present when upgrading version."""
 
 
 class KubernetesClusterUpdateResponseAttributes(BaseModel):
@@ -41,7 +44,7 @@ class KubernetesClusterUpdateResponseAttributes(BaseModel):
     r"""The cluster name"""
 
     status: Optional[KubernetesClusterUpdateResponseStatus] = None
-    r"""The update status. 'scaling' indicates nodes are being added or removed. 'unchanged' indicates the requested count matches the current count."""
+    r"""The update status. 'scaling' indicates nodes are being added or removed. 'upgrading' indicates a version upgrade is in progress. 'unchanged' indicates no change was needed."""
 
     worker_count: OptionalNullable[int] = UNSET
     r"""The requested number of worker nodes. Present when scaling workers."""
@@ -49,10 +52,23 @@ class KubernetesClusterUpdateResponseAttributes(BaseModel):
     control_plane_count: OptionalNullable[int] = UNSET
     r"""The requested number of control plane nodes. Present when scaling control plane."""
 
+    kubernetes_version: OptionalNullable[str] = UNSET
+    r"""The target Kubernetes version. Present when upgrading version."""
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = set(["name", "status", "worker_count", "control_plane_count"])
-        nullable_fields = set(["worker_count", "control_plane_count"])
+        optional_fields = set(
+            [
+                "name",
+                "status",
+                "worker_count",
+                "control_plane_count",
+                "kubernetes_version",
+            ]
+        )
+        nullable_fields = set(
+            ["worker_count", "control_plane_count", "kubernetes_version"]
+        )
         serialized = handler(self)
         m = {}
 

{latitudesh_python_sdk-3.0.2 → latitudesh_python_sdk-3.0.4}/src/latitudesh_python_sdk/models/update_kubernetes_cluster.py

@@ -19,31 +19,38 @@ class UpdateKubernetesClusterType(str, Enum):
 
 
 class UpdateKubernetesClusterAttributesTypedDict(TypedDict):
-    r"""Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive."""
+    r"""Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations."""
 
     worker_count: NotRequired[int]
-    r"""Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count."""
+    r"""Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count and kubernetes_version."""
     control_plane_count: NotRequired[int]
-    r"""Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count."""
+    r"""Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count and kubernetes_version."""
     worker_plan: NotRequired[Nullable[str]]
     r"""Plan slug for worker nodes. Required when scaling from 0 workers. Ignored when scaling an existing deployment."""
+    kubernetes_version: NotRequired[str]
+    r"""Target Kubernetes version for upgrade (e.g., v1.35.0+rke2r1). Mutually exclusive with scaling operations. Must be one minor version higher than current."""
 
 
 class UpdateKubernetesClusterAttributes(BaseModel):
-    r"""Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive."""
+    r"""Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations."""
 
     worker_count: Optional[int] = None
-    r"""Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count."""
+    r"""Desired number of worker nodes. Must be between 0 and 10. Mutually exclusive with control_plane_count and kubernetes_version."""
 
     control_plane_count: Optional[int] = None
-    r"""Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count."""
+    r"""Desired number of control plane nodes. Minimum 1. Mutually exclusive with worker_count and kubernetes_version."""
 
     worker_plan: OptionalNullable[str] = UNSET
     r"""Plan slug for worker nodes. Required when scaling from 0 workers. Ignored when scaling an existing deployment."""
 
+    kubernetes_version: Optional[str] = None
+    r"""Target Kubernetes version for upgrade (e.g., v1.35.0+rke2r1). Mutually exclusive with scaling operations. Must be one minor version higher than current."""
+
     @model_serializer(mode="wrap")
     def serialize_model(self, handler):
-        optional_fields = set(["worker_count", "control_plane_count", "worker_plan"])
+        optional_fields = set(
+            ["worker_count", "control_plane_count", "worker_plan", "kubernetes_version"]
+        )
         nullable_fields = set(["worker_plan"])
         serialized = handler(self)
         m = {}
@@ -70,14 +77,14 @@ class UpdateKubernetesClusterAttributes(BaseModel):
 class UpdateKubernetesClusterDataTypedDict(TypedDict):
     type: UpdateKubernetesClusterType
     attributes: UpdateKubernetesClusterAttributesTypedDict
-    r"""Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive."""
+    r"""Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations."""
 
 
 class UpdateKubernetesClusterData(BaseModel):
     type: UpdateKubernetesClusterType
 
     attributes: UpdateKubernetesClusterAttributes
-    r"""Exactly one of worker_count or control_plane_count must be provided. These parameters are mutually exclusive."""
+    r"""Provide one of: worker_count, control_plane_count (for scaling), or kubernetes_version (for upgrades). These are mutually exclusive operations."""
 
 
 class UpdateKubernetesClusterTypedDict(TypedDict):