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

gcore/types/cloud/load_balancers/l7_policies/rule_replace_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, Required, TypedDict
 
+from ....._types import SequenceNotStr
+
 __all__ = ["RuleReplaceParams"]
 
 
@@ -31,7 +32,7 @@ class RuleReplaceParams(TypedDict, total=False):
     For example, the name of the cookie to evaluate.
     """
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """A list of simple strings assigned to the l7 rule"""
 
     type: Literal[

gcore/types/cloud/load_balancers/l7_policy_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, Required, TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["L7PolicyCreateParams"]
 
 
@@ -50,5 +51,5 @@ class L7PolicyCreateParams(TypedDict, total=False):
     Only valid if action is `REDIRECT_TO_URL`.
     """
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """A list of simple strings assigned to the resource."""

gcore/types/cloud/load_balancers/l7_policy_replace_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, Required, TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["L7PolicyReplaceParams"]
 
 
@@ -47,5 +48,5 @@ class L7PolicyReplaceParams(TypedDict, total=False):
     Only valid if action is `REDIRECT_TO_URL`.
     """
 
-    tags: List[str]
+    tags: SequenceNotStr[str]
     """A list of simple strings assigned to the resource."""

gcore/types/cloud/load_balancers/listener_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from ...._types import SequenceNotStr
 from ..lb_listener_protocol import LbListenerProtocol
 
 __all__ = ["ListenerCreateParams", "UserList"]
@@ -29,7 +30,7 @@ class ListenerCreateParams(TypedDict, total=False):
     protocol_port: Required[int]
     """Protocol port"""
 
-    allowed_cidrs: Optional[List[str]]
+    allowed_cidrs: Optional[SequenceNotStr[str]]
     """Network CIDRs from which service will be accessible"""
 
     connection_limit: int
@@ -47,7 +48,7 @@ class ListenerCreateParams(TypedDict, total=False):
     PROMETHEUS listener
     """
 
-    sni_secret_id: List[str]
+    sni_secret_id: SequenceNotStr[str]
     """
     List of secrets IDs containing PKCS12 format certificate/key bundles for
     `TERMINATED_HTTPS` or PROMETHEUS listeners

gcore/types/cloud/load_balancers/listener_update_params.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["ListenerUpdateParams", "UserList"]
 
 
@@ -15,7 +17,7 @@ class ListenerUpdateParams(TypedDict, total=False):
     region_id: int
     """Region ID"""
 
-    allowed_cidrs: Optional[List[str]]
+    allowed_cidrs: Optional[SequenceNotStr[str]]
     """Network CIDRs from which service will be accessible"""
 
     connection_limit: int
@@ -30,7 +32,7 @@ class ListenerUpdateParams(TypedDict, total=False):
     PROMETHEUS load balancer
     """
 
-    sni_secret_id: Optional[List[str]]
+    sni_secret_id: Optional[SequenceNotStr[str]]
     """
     List of secret's ID containing PKCS12 format certificate/key bundfles for
     `TERMINATED_HTTPS` or PROMETHEUS listeners

gcore/types/cloud/load_balancers/pool_create_params.py

@@ -78,7 +78,12 @@ class Healthmonitor(TypedDict, total=False):
     """Health monitor type. Once health monitor is created, cannot be changed."""
 
     expected_codes: Optional[str]
-    """Can only be used together with `HTTP` or `HTTPS` health monitor type."""
+    """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: Optional[HTTPMethod]
     """HTTP method.
@@ -86,7 +91,7 @@ class Healthmonitor(TypedDict, total=False):
     Can only be used together with `HTTP` or `HTTPS` health monitor type.
     """
 
-    max_retries_down: Optional[int]
+    max_retries_down: int
     """Number of failures before the member is switched to ERROR state."""
 
     url_path: Optional[str]
@@ -141,8 +146,26 @@ class Member(TypedDict, total=False):
     Either `subnet_id` or `instance_id` should be provided
     """
 
-    weight: Optional[int]
-    """Member weight. Valid values are 0 < `weight` <= 256, defaults to 1."""
+    weight: int
+    """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.
+    """
 
 
 class SessionPersistence(TypedDict, total=False):

gcore/types/cloud/load_balancers/pool_update_params.py

@@ -73,7 +73,12 @@ class Healthmonitor(TypedDict, total=False):
     """The maximum time to connect. Must be less than the delay value"""
 
     expected_codes: Optional[str]
-    """Can only be used together with `HTTP` or `HTTPS` health monitor type."""
+    """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: Optional[HTTPMethod]
     """HTTP method.
@@ -81,7 +86,7 @@ class Healthmonitor(TypedDict, total=False):
     Can only be used together with `HTTP` or `HTTPS` health monitor type.
     """
 
-    max_retries_down: Optional[int]
+    max_retries_down: int
     """Number of failures before the member is switched to ERROR state."""
 
     type: Optional[LbHealthMonitorType]
@@ -139,8 +144,26 @@ class Member(TypedDict, total=False):
     Either `subnet_id` or `instance_id` should be provided
     """
 
-    weight: Optional[int]
-    """Member weight. Valid values are 0 < `weight` <= 256, defaults to 1."""
+    weight: int
+    """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.
+    """
 
 
 class SessionPersistence(TypedDict, total=False):

gcore/types/cloud/load_balancers/pools/health_monitor_create_params.py

@@ -32,7 +32,12 @@ class HealthMonitorCreateParams(TypedDict, total=False):
     """Health monitor type. Once health monitor is created, cannot be changed."""
 
     expected_codes: Optional[str]
-    """Can only be used together with `HTTP` or `HTTPS` health monitor type."""
+    """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: Optional[HTTPMethod]
     """HTTP method.
@@ -40,7 +45,7 @@ class HealthMonitorCreateParams(TypedDict, total=False):
     Can only be used together with `HTTP` or `HTTPS` health monitor type.
     """
 
-    max_retries_down: Optional[int]
+    max_retries_down: int
     """Number of failures before the member is switched to ERROR state."""
 
     url_path: Optional[str]

gcore/types/cloud/load_balancers/pools/member_add_params.py

@@ -58,5 +58,23 @@ class MemberAddParams(TypedDict, total=False):
     Either `subnet_id` or `instance_id` should be provided
     """
 
-    weight: Optional[int]
-    """Member weight. Valid values are 0 < `weight` <= 256, defaults to 1."""
+    weight: int
+    """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.
+    """

gcore/types/cloud/member.py

@@ -45,7 +45,25 @@ class Member(BaseModel):
     """`subnet_id` in which `address` is present."""
 
     weight: int
-    """Member weight. Valid values are 0 < `weight` <= 256."""
+    """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.
+    """
 
     monitor_address: Optional[str] = None
     """An alternate IP address used for health monitoring of a backend member.

gcore/types/cloud/network_list_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, TypedDict
 
+from ..._types import SequenceNotStr
+
 __all__ = ["NetworkListParams"]
 
 
@@ -33,7 +34,7 @@ class NetworkListParams(TypedDict, total=False):
     directions (`created_at.desc`).
     """
 
-    tag_key: List[str]
+    tag_key: SequenceNotStr[str]
     """Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2"""
 
     tag_key_value: str

gcore/types/cloud/networks/subnet_create_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Iterable, Optional
+from typing import Dict, Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from ...._types import SequenceNotStr
 from ..ip_version import IPVersion
 
 __all__ = ["SubnetCreateParams", "HostRoute"]
@@ -32,7 +33,7 @@ class SubnetCreateParams(TypedDict, total=False):
     Must be explicitly 'false' when `gateway_ip` is null.
     """
 
-    dns_nameservers: Optional[List[str]]
+    dns_nameservers: Optional[SequenceNotStr[str]]
     """List IP addresses of DNS servers to advertise via DHCP."""
 
     enable_dhcp: bool

gcore/types/cloud/networks/subnet_list_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import Literal, TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["SubnetListParams"]
 
 
@@ -47,7 +48,7 @@ class SubnetListParams(TypedDict, total=False):
     directions (`name.asc`).
     """
 
-    tag_key: List[str]
+    tag_key: SequenceNotStr[str]
     """Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2"""
 
     tag_key_value: str

gcore/types/cloud/networks/subnet_update_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Iterable, Optional
 from typing_extensions import Required, TypedDict
 
+from ...._types import SequenceNotStr
 from ..tag_update_map_param import TagUpdateMapParam
 
 __all__ = ["SubnetUpdateParams", "HostRoute"]
@@ -17,7 +18,7 @@ class SubnetUpdateParams(TypedDict, total=False):
     region_id: int
     """Region ID"""
 
-    dns_nameservers: Optional[List[str]]
+    dns_nameservers: Optional[SequenceNotStr[str]]
     """List IP addresses of DNS servers to advertise via DHCP."""
 
     enable_dhcp: Optional[bool]

gcore/types/cloud/project.py

@@ -18,6 +18,15 @@ class Project(BaseModel):
     created_at: datetime
     """Datetime of creation, which is automatically generated."""
 
+    deleted_at: Optional[datetime] = None
+    """
+    Datetime of deletion, which is automatically generated if the project is
+    deleted.
+    """
+
+    description: Optional[str] = None
+    """Description of the project."""
+
     is_default: bool
     """Indicates if the project is the default one.
 
@@ -30,15 +39,6 @@ class Project(BaseModel):
     state: str
     """The state of the project."""
 
-    deleted_at: Optional[datetime] = None
-    """
-    Datetime of deletion, which is automatically generated if the project is
-    deleted.
-    """
-
-    description: Optional[str] = None
-    """Description of the project."""
-
     task_id: Optional[str] = None
     """The UUID of the active task that currently holds a lock on the resource.
 

gcore/types/cloud/region.py

@@ -22,9 +22,6 @@ class Region(BaseModel):
     access_level: Literal["core", "edge"]
     """The access level of the region."""
 
-    ai_service_endpoint_id: Optional[int] = None
-    """AI service API endpoint ID"""
-
     available_volume_types: Optional[List[str]] = None
     """List of available volume types, 'standard', '`ssd_hiiops`', 'cold']."""
 

gcore/types/cloud/reserved_fixed_ips/vip_replace_connected_ports_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["VipReplaceConnectedPortsParams"]
 
 
@@ -13,5 +14,5 @@ class VipReplaceConnectedPortsParams(TypedDict, total=False):
 
     region_id: int
 
-    port_ids: List[str]
+    port_ids: SequenceNotStr[str]
     """List of port IDs that will share one VIP"""

gcore/types/cloud/reserved_fixed_ips/vip_update_connected_ports_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import TypedDict
 
+from ...._types import SequenceNotStr
+
 __all__ = ["VipUpdateConnectedPortsParams"]
 
 
@@ -13,5 +14,5 @@ class VipUpdateConnectedPortsParams(TypedDict, total=False):
 
     region_id: int
 
-    port_ids: List[str]
+    port_ids: SequenceNotStr[str]
     """List of port IDs that will share one VIP"""

gcore/types/cloud/security_group_create_params.py

@@ -2,9 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Iterable, Optional
+from typing import Dict, Iterable, Optional
 from typing_extensions import Literal, Required, TypedDict
 
+from ..._types import SequenceNotStr
+
 __all__ = ["SecurityGroupCreateParams", "SecurityGroup", "SecurityGroupSecurityGroupRule"]
 
 
@@ -16,7 +18,7 @@ class SecurityGroupCreateParams(TypedDict, total=False):
     security_group: Required[SecurityGroup]
     """Security group"""
 
-    instances: List[str]
+    instances: SequenceNotStr[str]
     """List of instances"""
 
 

gcore/types/cloud/security_group_list_params.py

@@ -2,9 +2,10 @@
 
 from __future__ import annotations
 
-from typing import List
 from typing_extensions import TypedDict
 
+from ..._types import SequenceNotStr
+
 __all__ = ["SecurityGroupListParams"]
 
 
@@ -19,7 +20,7 @@ class SecurityGroupListParams(TypedDict, total=False):
     offset: int
     """Offset value is used to exclude the first set of records from the result"""
 
-    tag_key: List[str]
+    tag_key: SequenceNotStr[str]
     """Filter by tag keys."""
 
     tag_key_value: str

gcore/types/cloud/task_id_list.py

@@ -9,4 +9,11 @@ __all__ = ["TaskIDList"]
 
 class TaskIDList(BaseModel):
     tasks: List[str]
-    """List of task IDs"""
+    """List of task IDs representing asynchronous operations.
+
+    Use these IDs to monitor operation progress:
+
+    - `GET /v1/tasks/{`task_id`}` - Check individual task status and details Poll
+      task status until completion (`FINISHED`/`ERROR`) before proceeding with
+      dependent operations.
+    """

gcore/types/cloud/task_list_params.py

@@ -67,25 +67,25 @@ class TaskListParams(TypedDict, total=False):
     '`create_faas_function`', '`create_faas_namespace`', '`create_fip`',
     '`create_gpu_virtual_cluster`', '`create_image`',
     '`create_inference_application`', '`create_inference_instance`',
-    '`create_inference_instance_key`', '`create_k8s_cluster_pool_v2`',
-    '`create_k8s_cluster_v2`', '`create_l7policy`', '`create_l7rule`',
-    '`create_lblistener`', '`create_lbmember`', '`create_lbpool`',
-    '`create_lbpool_health_monitor`', '`create_loadbalancer`', '`create_network`',
-    '`create_reserved_fixed_ip`', '`create_router`', '`create_secret`',
-    '`create_servergroup`', '`create_sfs`', '`create_snapshot`', '`create_subnet`',
-    '`create_vm`', '`create_volume`', '`deactivate_ddos_profile`',
-    '`delete_ai_cluster_gpu`', '`delete_caas_container`',
-    '`delete_dbaas_postgres_cluster`', '`delete_ddos_profile`',
-    '`delete_faas_function`', '`delete_faas_namespace`', '`delete_fip`',
-    '`delete_gpu_virtual_cluster`', '`delete_gpu_virtual_server`', '`delete_image`',
-    '`delete_inference_application`', '`delete_inference_instance`',
-    '`delete_k8s_cluster_pool_v2`', '`delete_k8s_cluster_v2`', '`delete_l7policy`',
-    '`delete_l7rule`', '`delete_lblistener`', '`delete_lbmember`',
-    '`delete_lbmetadata`', '`delete_lbpool`', '`delete_loadbalancer`',
-    '`delete_network`', '`delete_reserved_fixed_ip`', '`delete_router`',
-    '`delete_secret`', '`delete_servergroup`', '`delete_sfs`', '`delete_snapshot`',
-    '`delete_subnet`', '`delete_vm`', '`delete_volume`', '`detach_vm_interface`',
-    '`detach_volume`', '`download_image`', '`downscale_ai_cluster_gpu`',
+    '`create_k8s_cluster_pool_v2`', '`create_k8s_cluster_v2`', '`create_l7policy`',
+    '`create_l7rule`', '`create_lblistener`', '`create_lbmember`',
+    '`create_lbpool`', '`create_lbpool_health_monitor`', '`create_loadbalancer`',
+    '`create_network`', '`create_reserved_fixed_ip`', '`create_router`',
+    '`create_secret`', '`create_servergroup`', '`create_sfs`', '`create_snapshot`',
+    '`create_subnet`', '`create_vm`', '`create_volume`',
+    '`deactivate_ddos_profile`', '`delete_ai_cluster_gpu`',
+    '`delete_caas_container`', '`delete_dbaas_postgres_cluster`',
+    '`delete_ddos_profile`', '`delete_faas_function`', '`delete_faas_namespace`',
+    '`delete_fip`', '`delete_gpu_virtual_cluster`', '`delete_gpu_virtual_server`',
+    '`delete_image`', '`delete_inference_application`',
+    '`delete_inference_instance`', '`delete_k8s_cluster_pool_v2`',
+    '`delete_k8s_cluster_v2`', '`delete_l7policy`', '`delete_l7rule`',
+    '`delete_lblistener`', '`delete_lbmember`', '`delete_lbmetadata`',
+    '`delete_lbpool`', '`delete_loadbalancer`', '`delete_network`',
+    '`delete_reserved_fixed_ip`', '`delete_router`', '`delete_secret`',
+    '`delete_servergroup`', '`delete_sfs`', '`delete_snapshot`', '`delete_subnet`',
+    '`delete_vm`', '`delete_volume`', '`detach_vm_interface`', '`detach_volume`',
+    '`download_image`', '`downscale_ai_cluster_gpu`',
     '`downscale_gpu_virtual_cluster`', '`extend_sfs`', '`extend_volume`',
     '`failover_loadbalancer`', '`hard_reboot_gpu_baremetal_server`',
     '`hard_reboot_gpu_virtual_cluster`', '`hard_reboot_gpu_virtual_server`',
@@ -102,10 +102,10 @@ class TaskListParams(TypedDict, total=False):
     '`stop_gpu_virtual_cluster`', '`stop_gpu_virtual_server`', '`stop_vm`',
     '`suspend_vm`', '`sync_private_flavors`', '`update_ddos_profile`',
     '`update_inference_application`', '`update_inference_instance`',
-    '`update_inference_instance_key`', '`update_k8s_cluster_v2`',
-    '`update_lbmetadata`', '`update_port_allowed_address_pairs`',
-    '`update_tags_gpu_virtual_cluster`', '`upgrade_k8s_cluster_v2`',
-    '`upscale_ai_cluster_gpu`', '`upscale_gpu_virtual_cluster`']
+    '`update_k8s_cluster_v2`', '`update_lbmetadata`',
+    '`update_port_allowed_address_pairs`', '`update_tags_gpu_virtual_cluster`',
+    '`upgrade_k8s_cluster_v2`', '`upscale_ai_cluster_gpu`',
+    '`upscale_gpu_virtual_cluster`']
     """
 
     to_timestamp: Annotated[Union[str, datetime, None], PropertyInfo(format="iso8601")]