feat(cloud): add update method to GPU Baremetal clusters

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
-configured_endpoints: 646
+configured_endpoints: 647
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-2482396a183d8700e3679fec5090d194f9d67113e907e6504934c08cc52f2f91.yml
 openapi_spec_hash: 587bdc6b89167a5a1305332ec9d4565c
-config_hash: 679c55ab9eac10ef2e9c4974f904978e
+config_hash: a4c3f3f2864f6fd064ca57b691e73958

src/gcore/resources/cloud/api.md

@@ -786,6 +786,7 @@ from gcore.types.cloud.gpu_baremetal import GPUBaremetalCluster
 Methods:
 
 - <code title="post /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters">client.cloud.gpu_baremetal.clusters.<a href="./src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py">create</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/gpu_baremetal/cluster_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
+- <code title="patch /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}">client.cloud.gpu_baremetal.clusters.<a href="./src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py">update</a>(cluster_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/gpu_baremetal/cluster_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/gpu_baremetal/gpu_baremetal_cluster.py">GPUBaremetalCluster</a></code>
 - <code title="get /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters">client.cloud.gpu_baremetal.clusters.<a href="./src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py">list</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/gpu_baremetal/cluster_list_params.py">params</a>) -> <a href="./src/gcore/types/cloud/gpu_baremetal/gpu_baremetal_cluster.py">SyncOffsetPage[GPUBaremetalCluster]</a></code>
 - <code title="delete /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}">client.cloud.gpu_baremetal.clusters.<a href="./src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py">delete</a>(cluster_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/gpu_baremetal/cluster_delete_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
 - <code title="get /cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}">client.cloud.gpu_baremetal.clusters.<a href="./src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py">get</a>(cluster_id, \*, project_id, region_id) -> <a href="./src/gcore/types/cloud/gpu_baremetal/gpu_baremetal_cluster.py">GPUBaremetalCluster</a></code>

src/gcore/resources/cloud/gpu_baremetal/clusters/clusters.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List
+from typing import Dict, List, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -57,8 +57,10 @@
     cluster_create_params,
     cluster_delete_params,
     cluster_resize_params,
+    cluster_update_params,
     cluster_update_servers_settings_params,
 )
+from .....types.cloud.tag_update_map_param import TagUpdateMapParam
 from .....types.cloud.gpu_baremetal.gpu_baremetal_cluster import GPUBaremetalCluster
 from .....types.cloud.gpu_baremetal.clusters.gpu_baremetal_cluster_server_v1_list import GPUBaremetalClusterServerV1List
 
@@ -176,6 +178,88 @@ def create(
             cast_to=TaskIDList,
         )
 
+    def update(
+        self,
+        cluster_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str | Omit = omit,
+        tags: Optional[TagUpdateMapParam] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> GPUBaremetalCluster:
+        """
+        Update the name of an existing bare metal GPU cluster.
+
+        Update tags for a bare metal GPU cluster (and apply to all its nodes) using JSON
+        Merge Patch semantics (RFC 7386). To add or update tags, provide key-value
+        pairs. To remove a tag, set its value to null.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          name: Cluster name
+
+          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
+              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
+              Unspecified tags remain unchanged. Read-only tags are always preserved and
+              cannot be modified.
+
+              **Examples:**
+
+              - **Add/update tags:**
+                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+                updates existing ones.
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+              - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
+                tags are preserved).
+              - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
+                specified tags.
+              - **Mixed operations:**
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
+                adds/updates 'environment' and 'cost_center' while removing 'deprecated_tag',
+                preserving other existing tags.
+              - **Replace all:** first delete existing tags with null values, then add new
+                ones in the same request.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        if region_id is None:
+            region_id = self._client._get_cloud_region_id_path_param()
+        if not cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return self._patch(
+            f"/cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}",
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "tags": tags,
+                },
+                cluster_update_params.ClusterUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GPUBaremetalCluster,
+        )
+
     def list(
         self,
         *,
@@ -862,6 +946,88 @@ async def create(
             cast_to=TaskIDList,
         )
 
+    async def update(
+        self,
+        cluster_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str | Omit = omit,
+        tags: Optional[TagUpdateMapParam] | Omit = omit,
+        # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
+        # The extra values given here take precedence over values defined on the client or passed to this method.
+        extra_headers: Headers | None = None,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = not_given,
+    ) -> GPUBaremetalCluster:
+        """
+        Update the name of an existing bare metal GPU cluster.
+
+        Update tags for a bare metal GPU cluster (and apply to all its nodes) using JSON
+        Merge Patch semantics (RFC 7386). To add or update tags, provide key-value
+        pairs. To remove a tag, set its value to null.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          name: Cluster name
+
+          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
+              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
+              Unspecified tags remain unchanged. Read-only tags are always preserved and
+              cannot be modified.
+
+              **Examples:**
+
+              - **Add/update tags:**
+                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+                updates existing ones.
+              - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+              - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
+                tags are preserved).
+              - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
+                specified tags.
+              - **Mixed operations:**
+                `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
+                adds/updates 'environment' and 'cost_center' while removing 'deprecated_tag',
+                preserving other existing tags.
+              - **Replace all:** first delete existing tags with null values, then add new
+                ones in the same request.
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        if region_id is None:
+            region_id = self._client._get_cloud_region_id_path_param()
+        if not cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return await self._patch(
+            f"/cloud/v3/gpu/baremetal/{project_id}/{region_id}/clusters/{cluster_id}",
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "tags": tags,
+                },
+                cluster_update_params.ClusterUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GPUBaremetalCluster,
+        )
+
     def list(
         self,
         *,
@@ -1446,6 +1612,9 @@ def __init__(self, clusters: ClustersResource) -> None:
         self.create = to_raw_response_wrapper(
             clusters.create,
         )
+        self.update = to_raw_response_wrapper(
+            clusters.update,
+        )
         self.list = to_raw_response_wrapper(
             clusters.list,
         )
@@ -1505,6 +1674,9 @@ def __init__(self, clusters: AsyncClustersResource) -> None:
         self.create = async_to_raw_response_wrapper(
             clusters.create,
         )
+        self.update = async_to_raw_response_wrapper(
+            clusters.update,
+        )
         self.list = async_to_raw_response_wrapper(
             clusters.list,
         )
@@ -1564,6 +1736,9 @@ def __init__(self, clusters: ClustersResource) -> None:
         self.create = to_streamed_response_wrapper(
             clusters.create,
         )
+        self.update = to_streamed_response_wrapper(
+            clusters.update,
+        )
         self.list = to_streamed_response_wrapper(
             clusters.list,
         )
@@ -1623,6 +1798,9 @@ def __init__(self, clusters: AsyncClustersResource) -> None:
         self.create = async_to_streamed_response_wrapper(
             clusters.create,
         )
+        self.update = async_to_streamed_response_wrapper(
+            clusters.update,
+        )
         self.list = async_to_streamed_response_wrapper(
             clusters.list,
         )

src/gcore/types/cloud/gpu_baremetal/__init__.py

@@ -6,6 +6,7 @@
 from .cluster_create_params import ClusterCreateParams as ClusterCreateParams
 from .cluster_delete_params import ClusterDeleteParams as ClusterDeleteParams
 from .cluster_resize_params import ClusterResizeParams as ClusterResizeParams
+from .cluster_update_params import ClusterUpdateParams as ClusterUpdateParams
 from .gpu_baremetal_cluster import GPUBaremetalCluster as GPUBaremetalCluster
 from .cluster_update_servers_settings_params import (
     ClusterUpdateServersSettingsParams as ClusterUpdateServersSettingsParams,

src/gcore/types/cloud/gpu_baremetal/cluster_update_params.py

@@ -0,0 +1,46 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Optional
+from typing_extensions import TypedDict
+
+from ..tag_update_map_param import TagUpdateMapParam
+
+__all__ = ["ClusterUpdateParams"]
+
+
+class ClusterUpdateParams(TypedDict, total=False):
+    project_id: int
+    """Project ID"""
+
+    region_id: int
+    """Region ID"""
+
+    name: str
+    """Cluster name"""
+
+    tags: Optional[TagUpdateMapParam]
+    """Update key-value tags using JSON Merge Patch semantics (RFC 7386).
+
+    Provide key-value pairs to add or update tags. Set tag values to `null` to
+    remove tags. Unspecified tags remain unchanged. Read-only tags are always
+    preserved and cannot be modified.
+
+    **Examples:**
+
+    - **Add/update tags:**
+      `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+      updates existing ones.
+    - **Delete tags:** `{'tags': {'old_tag': null}}` removes specific tags.
+    - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
+      tags are preserved).
+    - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
+      specified tags.
+    - **Mixed operations:**
+      `{'tags': {'environment': 'production', 'cost_center': 'engineering', 'deprecated_tag': null}}`
+      adds/updates 'environment' and 'cost_center' while removing 'deprecated_tag',
+      preserving other existing tags.
+    - **Replace all:** first delete existing tags with null values, then add new
+      ones in the same request.
+    """