gcore 0.9.0__py3-none-any.whl → 0.11.0__py3-none-any.whl

gcore/resources/cloud/load_balancers/listeners.py

@@ -2,11 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Iterable, Optional
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -61,11 +61,11 @@ class ListenersResource(SyncAPIResource):
         name: str,
         protocol: LbListenerProtocol,
         protocol_port: int,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
         secret_id: str | NotGiven = NOT_GIVEN,
-        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -158,11 +158,11 @@ class ListenersResource(SyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         secret_id: Optional[str] | NotGiven = NOT_GIVEN,
-        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -402,11 +402,11 @@ class ListenersResource(SyncAPIResource):
         name: str,
         protocol: LbListenerProtocol,
         protocol_port: int,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
         secret_id: str | NotGiven = NOT_GIVEN,
-        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -501,11 +501,11 @@ class ListenersResource(SyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         secret_id: Optional[str] | NotGiven = NOT_GIVEN,
-        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -584,11 +584,11 @@ class AsyncListenersResource(AsyncAPIResource):
         name: str,
         protocol: LbListenerProtocol,
         protocol_port: int,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
         secret_id: str | NotGiven = NOT_GIVEN,
-        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -681,11 +681,11 @@ class AsyncListenersResource(AsyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         secret_id: Optional[str] | NotGiven = NOT_GIVEN,
-        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -925,11 +925,11 @@ class AsyncListenersResource(AsyncAPIResource):
         name: str,
         protocol: LbListenerProtocol,
         protocol_port: int,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
         secret_id: str | NotGiven = NOT_GIVEN,
-        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
@@ -1024,11 +1024,11 @@ class AsyncListenersResource(AsyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        allowed_cidrs: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         connection_limit: int | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         secret_id: Optional[str] | NotGiven = NOT_GIVEN,
-        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[SequenceNotStr[str]] | NotGiven = NOT_GIVEN,
         timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
         timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,

gcore/resources/cloud/load_balancers/load_balancers.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Iterable, Optional
+from typing import Dict, Iterable, Optional
 
 import httpx
 
@@ -30,7 +30,7 @@ from .statuses import (
     StatusesResourceWithStreamingResponse,
     AsyncStatusesResourceWithStreamingResponse,
 )
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ...._utils import maybe_transform, async_maybe_transform
 from .listeners import (
     ListenersResource,
@@ -325,7 +325,7 @@ class LoadBalancersResource(SyncAPIResource):
         offset: int | NotGiven = NOT_GIVEN,
         order_by: str | NotGiven = NOT_GIVEN,
         show_stats: bool | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1008,7 +1008,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         offset: int | NotGiven = NOT_GIVEN,
         order_by: str | NotGiven = NOT_GIVEN,
         show_stats: bool | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.

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

@@ -58,7 +58,7 @@ class HealthMonitorsResource(SyncAPIResource):
         type: LbHealthMonitorType,
         expected_codes: Optional[str] | NotGiven = NOT_GIVEN,
         http_method: Optional[HTTPMethod] | NotGiven = NOT_GIVEN,
-        max_retries_down: Optional[int] | NotGiven = NOT_GIVEN,
+        max_retries_down: int | NotGiven = NOT_GIVEN,
         url_path: Optional[str] | NotGiven = NOT_GIVEN,
         # 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.
@@ -68,7 +68,10 @@ class HealthMonitorsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create load balancer pool health monitor
+        Creates a health monitor for a load balancer pool to automatically check the
+        health status of pool members. The health monitor performs periodic checks on
+        pool members and removes unhealthy members from rotation, ensuring only healthy
+        servers receive traffic.
 
         Args:
           project_id: Project ID
@@ -85,7 +88,9 @@ class HealthMonitorsResource(SyncAPIResource):
 
           type: Health monitor type. Once health monitor is created, cannot be changed.
 
-          expected_codes: Can only be used together with `HTTP` or `HTTPS` health monitor type.
+          expected_codes: Expected HTTP response codes. Can be a single code or a range of codes. Can only
+              be used together with `HTTP` or `HTTPS` health monitor type. For example,
+              200,202,300-302,401,403,404,500-504. If not specified, the default is 200.
 
           http_method: HTTP method. Can only be used together with `HTTP` or `HTTPS` health monitor
               type.
@@ -143,8 +148,11 @@ class HealthMonitorsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
-        """
-        Delete load balancer pool health monitor
+        """Removes the health monitor from a load balancer pool.
+
+        After deletion, the pool
+        will no longer perform automatic health checks on its members, and all members
+        will remain in rotation regardless of their actual health status.
 
         Args:
           project_id: Project ID
@@ -209,7 +217,7 @@ class AsyncHealthMonitorsResource(AsyncAPIResource):
         type: LbHealthMonitorType,
         expected_codes: Optional[str] | NotGiven = NOT_GIVEN,
         http_method: Optional[HTTPMethod] | NotGiven = NOT_GIVEN,
-        max_retries_down: Optional[int] | NotGiven = NOT_GIVEN,
+        max_retries_down: int | NotGiven = NOT_GIVEN,
         url_path: Optional[str] | NotGiven = NOT_GIVEN,
         # 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.
@@ -219,7 +227,10 @@ class AsyncHealthMonitorsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create load balancer pool health monitor
+        Creates a health monitor for a load balancer pool to automatically check the
+        health status of pool members. The health monitor performs periodic checks on
+        pool members and removes unhealthy members from rotation, ensuring only healthy
+        servers receive traffic.
 
         Args:
           project_id: Project ID
@@ -236,7 +247,9 @@ class AsyncHealthMonitorsResource(AsyncAPIResource):
 
           type: Health monitor type. Once health monitor is created, cannot be changed.
 
-          expected_codes: Can only be used together with `HTTP` or `HTTPS` health monitor type.
+          expected_codes: Expected HTTP response codes. Can be a single code or a range of codes. Can only
+              be used together with `HTTP` or `HTTPS` health monitor type. For example,
+              200,202,300-302,401,403,404,500-504. If not specified, the default is 200.
 
           http_method: HTTP method. Can only be used together with `HTTP` or `HTTPS` health monitor
               type.
@@ -294,8 +307,11 @@ class AsyncHealthMonitorsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
-        """
-        Delete load balancer pool health monitor
+        """Removes the health monitor from a load balancer pool.
+
+        After deletion, the pool
+        will no longer perform automatic health checks on its members, and all members
+        will remain in rotation regardless of their actual health status.
 
         Args:
           project_id: Project ID

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

@@ -57,7 +57,7 @@ class MembersResource(SyncAPIResource):
         monitor_address: Optional[str] | NotGiven = NOT_GIVEN,
         monitor_port: Optional[int] | NotGiven = NOT_GIVEN,
         subnet_id: Optional[str] | NotGiven = NOT_GIVEN,
-        weight: Optional[int] | NotGiven = NOT_GIVEN,
+        weight: int | NotGiven = NOT_GIVEN,
         # 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,
@@ -99,7 +99,22 @@ class MembersResource(SyncAPIResource):
           subnet_id: `subnet_id` in which `address` is present. Either `subnet_id` or `instance_id`
               should be provided
 
-          weight: Member weight. Valid values are 0 < `weight` <= 256, defaults to 1.
+          weight: Member weight. Valid values are 0 < `weight` <= 256, defaults to 1. Controls
+              traffic distribution based on the pool's load balancing algorithm:
+
+              - `ROUND_ROBIN`: Distributes connections to each member in turn according to
+                weights. Higher weight = more turns in the cycle. Example: weights 3 vs 1 =
+                ~75% vs ~25% of requests.
+              - `LEAST_CONNECTIONS`: Sends new connections to the member with fewest active
+                connections, performing round-robin within groups of the same normalized load.
+                Higher weight = allowed to hold more simultaneous connections before being
+                considered 'more loaded'. Example: weights 2 vs 1 means 20 vs 10 active
+                connections is treated as balanced.
+              - `SOURCE_IP`: Routes clients consistently to the same member by hashing client
+                source IP; hash result is modulo total weight of running members. Higher
+                weight = more hash buckets, so more client IPs map to that member. Example:
+                weights 2 vs 1 = roughly two-thirds of distinct client IPs map to the
+                higher-weight member.
 
           extra_headers: Send extra headers
 
@@ -222,7 +237,7 @@ class AsyncMembersResource(AsyncAPIResource):
         monitor_address: Optional[str] | NotGiven = NOT_GIVEN,
         monitor_port: Optional[int] | NotGiven = NOT_GIVEN,
         subnet_id: Optional[str] | NotGiven = NOT_GIVEN,
-        weight: Optional[int] | NotGiven = NOT_GIVEN,
+        weight: int | NotGiven = NOT_GIVEN,
         # 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,
@@ -264,7 +279,22 @@ class AsyncMembersResource(AsyncAPIResource):
           subnet_id: `subnet_id` in which `address` is present. Either `subnet_id` or `instance_id`
               should be provided
 
-          weight: Member weight. Valid values are 0 < `weight` <= 256, defaults to 1.
+          weight: Member weight. Valid values are 0 < `weight` <= 256, defaults to 1. Controls
+              traffic distribution based on the pool's load balancing algorithm:
+
+              - `ROUND_ROBIN`: Distributes connections to each member in turn according to
+                weights. Higher weight = more turns in the cycle. Example: weights 3 vs 1 =
+                ~75% vs ~25% of requests.
+              - `LEAST_CONNECTIONS`: Sends new connections to the member with fewest active
+                connections, performing round-robin within groups of the same normalized load.
+                Higher weight = allowed to hold more simultaneous connections before being
+                considered 'more loaded'. Example: weights 2 vs 1 means 20 vs 10 active
+                connections is treated as balanced.
+              - `SOURCE_IP`: Routes clients consistently to the same member by hashing client
+                source IP; hash result is modulo total weight of running members. Higher
+                weight = more hash buckets, so more client IPs map to that member. Example:
+                weights 2 vs 1 = roughly two-thirds of distinct client IPs map to the
+                higher-weight member.
 
           extra_headers: Send extra headers
 

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

@@ -199,9 +199,21 @@ class PoolsResource(SyncAPIResource):
         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 @@ class PoolsResource(SyncAPIResource):
         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 @@ class AsyncPoolsResource(AsyncAPIResource):
         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 @@ class AsyncPoolsResource(AsyncAPIResource):
         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,