feat(cloud): use PATCH /v2/lbpools

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 447
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/gcore%2Fgcore-21dade7f2034ff31578d98a7d0e769aa271906ace022862be072adc14176a108.yml
 openapi_spec_hash: a6b097bcb1ea27498a93ef4d26a35f90
-config_hash: 2f0d48b4e32c9c906836a67e06a1d72b
+config_hash: 0eef23ac91befdd529503f40af5ea9b1

api.md

@@ -258,7 +258,7 @@ Methods:
 Methods:
 
 - <code title="post /cloud/v1/lbpools/{project_id}/{region_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">create</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/load_balancers/pool_create_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
-- <code title="patch /cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">update</a>(pool_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/load_balancers/pool_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
+- <code title="patch /cloud/v2/lbpools/{project_id}/{region_id}/{pool_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">update</a>(pool_id, \*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/load_balancers/pool_update_params.py">params</a>) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
 - <code title="get /cloud/v1/lbpools/{project_id}/{region_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">list</a>(\*, project_id, region_id, \*\*<a href="src/gcore/types/cloud/load_balancers/pool_list_params.py">params</a>) -> <a href="./src/gcore/types/cloud/load_balancer_pool_list.py">LoadBalancerPoolList</a></code>
 - <code title="delete /cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">delete</a>(pool_id, \*, project_id, region_id) -> <a href="./src/gcore/types/cloud/task_id_list.py">TaskIDList</a></code>
 - <code title="get /cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}">client.cloud.load_balancers.pools.<a href="./src/gcore/resources/cloud/load_balancers/pools/pools.py">get</a>(pool_id, \*, project_id, region_id) -> <a href="./src/gcore/types/cloud/load_balancer_pool.py">LoadBalancerPool</a></code>

src/gcore/resources/cloud/load_balancers/pools/pools.py

@@ -199,9 +199,21 @@ def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Changes provided here will overwrite existing load balancer pool settings.
-        Undefined fields will be kept as is. Complex objects need to be specified fully,
-        they will be overwritten.
+        Updates the specified load balancer pool with the provided changes.
+        **Behavior:**
+
+        - Simple fields (strings, numbers, booleans) will be updated if provided
+        - Complex objects (nested structures like members, health monitors, etc.) must
+          be specified completely - partial updates are not supported for these objects
+        - Undefined fields will remain unchanged
+        - If no change is detected for a specific field compared to the current pool
+          state, that field will be skipped
+        - If no changes are detected at all across all fields, no task will be created
+          and an empty task list will be returned **Examples of complex objects that
+          require full specification:**
+        - Pool members: All member properties must be provided when updating members
+        - Health monitors: Complete health monitor configuration must be specified
+        - Session persistence: Full session persistence settings must be included
 
         Args:
           project_id: Project ID
@@ -250,7 +262,7 @@ def update(
         if not pool_id:
             raise ValueError(f"Expected a non-empty value for `pool_id` but received {pool_id!r}")
         return self._patch(
-            f"/cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}",
+            f"/cloud/v2/lbpools/{project_id}/{region_id}/{pool_id}",
             body=maybe_transform(
                 {
                     "ca_secret_id": ca_secret_id,
@@ -745,9 +757,21 @@ async def update(
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Changes provided here will overwrite existing load balancer pool settings.
-        Undefined fields will be kept as is. Complex objects need to be specified fully,
-        they will be overwritten.
+        Updates the specified load balancer pool with the provided changes.
+        **Behavior:**
+
+        - Simple fields (strings, numbers, booleans) will be updated if provided
+        - Complex objects (nested structures like members, health monitors, etc.) must
+          be specified completely - partial updates are not supported for these objects
+        - Undefined fields will remain unchanged
+        - If no change is detected for a specific field compared to the current pool
+          state, that field will be skipped
+        - If no changes are detected at all across all fields, no task will be created
+          and an empty task list will be returned **Examples of complex objects that
+          require full specification:**
+        - Pool members: All member properties must be provided when updating members
+        - Health monitors: Complete health monitor configuration must be specified
+        - Session persistence: Full session persistence settings must be included
 
         Args:
           project_id: Project ID
@@ -796,7 +820,7 @@ async def update(
         if not pool_id:
             raise ValueError(f"Expected a non-empty value for `pool_id` but received {pool_id!r}")
         return await self._patch(
-            f"/cloud/v1/lbpools/{project_id}/{region_id}/{pool_id}",
+            f"/cloud/v2/lbpools/{project_id}/{region_id}/{pool_id}",
             body=await async_maybe_transform(
                 {
                     "ca_secret_id": ca_secret_id,