latitudesh-python-sdk 3.0.1__tar.gz → 3.0.3__tar.gz

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: latitudesh-python-sdk
-Version: 3.0.1
+Version: 3.0.3
 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 Workers
+* [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 18 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.1 → latitudesh_python_sdk-3.0.3}/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 Workers
+* [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 18 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.1 → latitudesh_python_sdk-3.0.3}/pyproject.toml

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

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/_version.py

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

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/basesdk.py

@@ -66,6 +66,7 @@ class BaseSDK:
         url_override: Optional[str] = None,
         http_headers: Optional[Mapping[str, str]] = None,
         allow_empty_value: Optional[List[str]] = None,
+        allowed_fields: Optional[List[str]] = None,
     ) -> httpx.Request:
         client = self.sdk_configuration.async_client
         return self._build_request_with_client(
@@ -87,6 +88,7 @@ class BaseSDK:
             url_override,
             http_headers,
             allow_empty_value,
+            allowed_fields,
         )
 
     def _build_request(
@@ -110,6 +112,7 @@ class BaseSDK:
         url_override: Optional[str] = None,
         http_headers: Optional[Mapping[str, str]] = None,
         allow_empty_value: Optional[List[str]] = None,
+        allowed_fields: Optional[List[str]] = None,
     ) -> httpx.Request:
         client = self.sdk_configuration.client
         return self._build_request_with_client(
@@ -131,6 +134,7 @@ class BaseSDK:
             url_override,
             http_headers,
             allow_empty_value,
+            allowed_fields,
         )
 
     def _build_request_with_client(
@@ -155,6 +159,7 @@ class BaseSDK:
         url_override: Optional[str] = None,
         http_headers: Optional[Mapping[str, str]] = None,
         allow_empty_value: Optional[List[str]] = None,
+        allowed_fields: Optional[List[str]] = None,
     ) -> httpx.Request:
         query_params = {}
 
@@ -188,7 +193,9 @@ class BaseSDK:
                 security = security()
         security = utils.get_security_from_env(security, models.Security)
         if security is not None:
-            security_headers, security_query_params = utils.get_security(security)
+            security_headers, security_query_params = utils.get_security(
+                security, allowed_fields
+            )
             headers = {**headers, **security_headers}
             query_params = {**query_params, **security_query_params}
 

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/elastic_ips_sdk.py

@@ -120,6 +120,9 @@ class ElasticIpsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -245,6 +248,9 @@ class ElasticIpsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/events_sdk.py

@@ -138,6 +138,9 @@ class EventsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -281,6 +284,9 @@ class EventsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/firewalls_sdk.py

@@ -109,6 +109,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -223,6 +226,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -517,6 +523,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -631,6 +640,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -1477,6 +1489,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -1591,6 +1606,9 @@ class FirewallsSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/src/latitudesh_python_sdk/ipaddresses_sdk.py

@@ -141,6 +141,9 @@ class IPAddressesSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):
@@ -287,6 +290,9 @@ class IPAddressesSDK(BaseSDK):
                 page_size=page_size,
                 page_number=next_page,
                 retries=retries,
+                server_url=server_url,
+                timeout_ms=timeout_ms,
+                http_headers=http_headers,
             )
 
         if utils.match_response(http_res, "200", "application/vnd.api+json"):

{latitudesh_python_sdk-3.0.1 → latitudesh_python_sdk-3.0.3}/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:
+        - `version`: 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:
+        - `version`: 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,15 +953,30 @@ class KubernetesClustersSDK(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.KubernetesClusterUpdateResponse:
-        r"""Scale Kubernetes Cluster Workers
+        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.
+
+        ## Scaling Operations
 
-        Scales the worker nodes of a Kubernetes cluster. The cluster must be in `Provisioned` phase to accept updates.
+        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.
 
         When scaling up, the API validates that sufficient server stock is available for the requested delta (e.g., scaling from 2 to 5 workers checks for 3 available servers).
 
         When scaling from 0 workers, you must provide a `worker_plan` since there is no existing configuration to inherit the plan from.
 
-        Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested worker count matches the current count (no-op).
+        Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
+
+        ## 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.
@@ -894,15 +1085,30 @@ class KubernetesClustersSDK(BaseSDK):
         timeout_ms: Optional[int] = None,
         http_headers: Optional[Mapping[str, str]] = None,
     ) -> models.KubernetesClusterUpdateResponse:
-        r"""Scale Kubernetes Cluster Workers
+        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 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.
 
         When scaling up, the API validates that sufficient server stock is available for the requested delta (e.g., scaling from 2 to 5 workers checks for 3 available servers).
 
         When scaling from 0 workers, you must provide a `worker_plan` since there is no existing configuration to inherit the plan from.
 
-        Returns 202 Accepted when a scaling operation is triggered. Poll the GET endpoint to monitor progress. Returns 200 OK if the requested worker count matches the current count (no-op).
+        Control plane scaling has a minimum of 1 node. You cannot scale control plane nodes to zero.
+
+        ## 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.1 → latitudesh_python_sdk-3.0.3}/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,
@@ -668,6 +674,7 @@ if TYPE_CHECKING:
     )
     from .kubernetes_cluster_data import (
         ControlPlane,
+        ControlPlaneStatus,
         ControlPlaneTypedDict,
         KubernetesClusterData,
         KubernetesClusterDataAttributes,
@@ -684,6 +691,7 @@ if TYPE_CHECKING:
         KubernetesClusterDataTypedDict,
         Nodes,
         NodesTypedDict,
+        VersionStatus,
         WorkerStatus,
         Workers,
         WorkersTypedDict,
@@ -1632,6 +1640,7 @@ __all__ = [
     "CPU",
     "CPUTypedDict",
     "ControlPlane",
+    "ControlPlaneStatus",
     "ControlPlaneTypedDict",
     "Country",
     "CountryTypedDict",
@@ -2079,6 +2088,10 @@ __all__ = [
     "IpmiSessionType",
     "IpmiSessionTypedDict",
     "IpmiStatus",
+    "KubernetesAvailableVersions",
+    "KubernetesAvailableVersionsData",
+    "KubernetesAvailableVersionsDataTypedDict",
+    "KubernetesAvailableVersionsTypedDict",
     "KubernetesCluster",
     "KubernetesClusterCreateResponse",
     "KubernetesClusterCreateResponseAttributes",
@@ -2726,6 +2739,7 @@ __all__ = [
     "UserUpdateTypedDict",
     "Vcpu",
     "VcpuTypedDict",
+    "VersionStatus",
     "VirtualMachine",
     "VirtualMachineAttributes",
     "VirtualMachineAttributesAttributes",
@@ -3340,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",
@@ -3349,6 +3367,7 @@ _dynamic_imports: dict[str, str] = {
     "KubernetesClusterCreateResponseDataTypedDict": ".kubernetes_cluster_create_response",
     "KubernetesClusterCreateResponseTypedDict": ".kubernetes_cluster_create_response",
     "ControlPlane": ".kubernetes_cluster_data",
+    "ControlPlaneStatus": ".kubernetes_cluster_data",
     "ControlPlaneTypedDict": ".kubernetes_cluster_data",
     "KubernetesClusterData": ".kubernetes_cluster_data",
     "KubernetesClusterDataAttributes": ".kubernetes_cluster_data",
@@ -3365,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.3/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):
+    version: NotRequired[str]
+    r"""The full Kubernetes version string (e.g., v1.35.3+rke2r1)"""
+    minor: NotRequired[str]
+    r"""The minor version number (e.g., 1.35)"""
+
+
+class KubernetesAvailableVersionsData(BaseModel):
+    version: Optional[str] = None
+    r"""The full Kubernetes version string (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(["version", "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