gcore 0.3.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

gcore/resources/cloud/instances/instances.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Union, Iterable, Optional
+from typing import Dict, List, Union, Iterable, Optional
 from datetime import datetime
 from typing_extensions import Literal, overload
 
@@ -68,7 +68,6 @@ from ....types.cloud.console import Console
 from ....types.cloud.instance import Instance
 from ....types.cloud.task_id_list import TaskIDList
 from ....types.cloud.instance_interface import InstanceInterface
-from ....types.cloud.tag_update_map_param import TagUpdateMapParam
 
 __all__ = ["InstancesResource", "AsyncInstancesResource"]
 
@@ -125,7 +124,7 @@ class InstancesResource(SyncAPIResource):
         security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
         servergroup_id: str | NotGiven = NOT_GIVEN,
         ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -135,8 +134,9 @@ class InstancesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        For Linux,
+        """Create an instance with specified configuration.
+
+        How to get access: For Linux,
 
         - Use the `user_data` field to provide a
           [cloud-init script](https://cloudinit.readthedocs.io/en/latest/reference/examples.html)
@@ -270,7 +270,7 @@ class InstancesResource(SyncAPIResource):
         security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
         servergroup_id: str | NotGiven = NOT_GIVEN,
         ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
@@ -429,8 +429,10 @@ class InstancesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SyncOffsetPage[Instance]:
-        """
-        List instances
+        """List all instances in the specified project and region.
+
+        Results can be filtered
+        by various parameters like name, status, and IP address.
 
         Args:
           project_id: Project ID
@@ -485,9 +487,7 @@ class InstancesResource(SyncAPIResource):
 
           status: Filters instances by status.
 
-          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "`tag_key_value`={"key": "value"}" --url
-              "https://example.com/cloud/v1/resource/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs.
 
           tag_value: Optional. Filter by tag values. ?`tag_value`=value1&`tag_value`=value2
 
@@ -787,8 +787,10 @@ class InstancesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Put instance into the server group
+        """Add an instance to a server group.
+
+        The instance must not already be in a server
+        group. Bare metal servers do not support server groups.
 
         Args:
           servergroup_id: Anti-affinity or affinity or soft-anti-affinity server group ID.
@@ -1008,8 +1010,11 @@ class InstancesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Instance:
-        """
-        **Cookie Parameters**:
+        """Retrieve detailed information about a specific instance.
+
+        The response content
+        language for `ddos_profile` can be controlled via the 'language' cookie
+        parameter. **Cookie Parameters**:
 
         - `language` (str, optional): Language for the response content. Affects the
           `ddos_profile` field. Supported values:
@@ -1107,8 +1112,10 @@ class InstancesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Remove instance from the server group
+        """Remove an instance from its current server group.
+
+        The instance must be in a
+        server group to be removed. Bare metal servers do not support server groups.
 
         Args:
           extra_headers: Send extra headers
@@ -1367,7 +1374,7 @@ class AsyncInstancesResource(AsyncAPIResource):
         security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
         servergroup_id: str | NotGiven = NOT_GIVEN,
         ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -1377,8 +1384,9 @@ class AsyncInstancesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        For Linux,
+        """Create an instance with specified configuration.
+
+        How to get access: For Linux,
 
         - Use the `user_data` field to provide a
           [cloud-init script](https://cloudinit.readthedocs.io/en/latest/reference/examples.html)
@@ -1512,7 +1520,7 @@ class AsyncInstancesResource(AsyncAPIResource):
         security_groups: Iterable[instance_create_params.SecurityGroup] | NotGiven = NOT_GIVEN,
         servergroup_id: str | NotGiven = NOT_GIVEN,
         ssh_key_name: Optional[str] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
@@ -1671,8 +1679,10 @@ class AsyncInstancesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AsyncPaginator[Instance, AsyncOffsetPage[Instance]]:
-        """
-        List instances
+        """List all instances in the specified project and region.
+
+        Results can be filtered
+        by various parameters like name, status, and IP address.
 
         Args:
           project_id: Project ID
@@ -1727,9 +1737,7 @@ class AsyncInstancesResource(AsyncAPIResource):
 
           status: Filters instances by status.
 
-          tag_key_value: Optional. Filter by tag key-value pairs. curl -G --data-urlencode
-              "`tag_key_value`={"key": "value"}" --url
-              "https://example.com/cloud/v1/resource/1/1"
+          tag_key_value: Optional. Filter by tag key-value pairs.
 
           tag_value: Optional. Filter by tag values. ?`tag_value`=value1&`tag_value`=value2
 
@@ -2029,8 +2037,10 @@ class AsyncInstancesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Put instance into the server group
+        """Add an instance to a server group.
+
+        The instance must not already be in a server
+        group. Bare metal servers do not support server groups.
 
         Args:
           servergroup_id: Anti-affinity or affinity or soft-anti-affinity server group ID.
@@ -2250,8 +2260,11 @@ class AsyncInstancesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Instance:
-        """
-        **Cookie Parameters**:
+        """Retrieve detailed information about a specific instance.
+
+        The response content
+        language for `ddos_profile` can be controlled via the 'language' cookie
+        parameter. **Cookie Parameters**:
 
         - `language` (str, optional): Language for the response content. Affects the
           `ddos_profile` field. Supported values:
@@ -2349,8 +2362,10 @@ class AsyncInstancesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Remove instance from the server group
+        """Remove an instance from its current server group.
+
+        The instance must be in a
+        server group to be removed. Bare metal servers do not support server groups.
 
         Args:
           extra_headers: Send extra headers

gcore/resources/cloud/instances/interfaces.py

@@ -59,7 +59,7 @@ class InterfacesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> NetworkInterfaceList:
         """
-        List network interfaces attached to the instance
+        List all network interfaces attached to the specified instance.
 
         Args:
           extra_headers: Send extra headers
@@ -415,7 +415,7 @@ class AsyncInterfacesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> NetworkInterfaceList:
         """
-        List network interfaces attached to the instance
+        List all network interfaces attached to the specified instance.
 
         Args:
           extra_headers: Send extra headers

gcore/resources/cloud/ip_ranges.py

@@ -49,7 +49,23 @@ class IPRangesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> IPRanges:
-        """List of all Edge Cloud Egress Public IPs."""
+        """
+        Returns the complete list of IPv4 and IPv6 address ranges that Cloud uses for
+        outbound (egress) traffic. Typical reasons to call this endpoint:
+
+        - Host-file delivery workflows – You upload images or other assets to the Cloud
+          and share a download link that points to your own infrastructure. Add these
+          egress prefixes to your firewall or object-storage allow-list so our clients
+          can fetch the files without being blocked.
+        - Push integrations / webhooks – You subscribe to the user-actions event log and
+          Cloud pushes events to your listener endpoint. Whitelisting the egress IP
+          ranges lets you accept only traffic that originates from us.
+        - General security controls, audit tooling, or SIEM rules that need to verify
+          that traffic truly comes from the Cloud. The list is global (covers all
+          regions) and refreshed automatically whenever Gcore allocates new egress IP
+          space. The response is an array of CIDR blocks; duplicate prefixes are not
+          returned.
+        """
         return self._get(
             "/cloud/public/v1/ipranges/egress",
             options=make_request_options(
@@ -89,7 +105,23 @@ class AsyncIPRangesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> IPRanges:
-        """List of all Edge Cloud Egress Public IPs."""
+        """
+        Returns the complete list of IPv4 and IPv6 address ranges that Cloud uses for
+        outbound (egress) traffic. Typical reasons to call this endpoint:
+
+        - Host-file delivery workflows – You upload images or other assets to the Cloud
+          and share a download link that points to your own infrastructure. Add these
+          egress prefixes to your firewall or object-storage allow-list so our clients
+          can fetch the files without being blocked.
+        - Push integrations / webhooks – You subscribe to the user-actions event log and
+          Cloud pushes events to your listener endpoint. Whitelisting the egress IP
+          ranges lets you accept only traffic that originates from us.
+        - General security controls, audit tooling, or SIEM rules that need to verify
+          that traffic truly comes from the Cloud. The list is global (covers all
+          regions) and refreshed automatically whenever Gcore allocates new egress IP
+          space. The response is an array of CIDR blocks; duplicate prefixes are not
+          returned.
+        """
         return await self._get(
             "/cloud/public/v1/ipranges/egress",
             options=make_request_options(

gcore/resources/cloud/load_balancers/l7_policies/l7_policies.py

@@ -381,7 +381,11 @@ class L7PoliciesResource(SyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.l7polices or len(task.created_resources.l7polices) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.l7polices
+            or len(task.created_resources.l7polices) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return self.get(
             l7policy_id=task.created_resources.l7polices[0],
@@ -824,7 +828,11 @@ class AsyncL7PoliciesResource(AsyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.l7polices or len(task.created_resources.l7polices) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.l7polices
+            or len(task.created_resources.l7polices) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return await self.get(
             l7policy_id=task.created_resources.l7polices[0],

gcore/resources/cloud/load_balancers/listeners.py

@@ -175,7 +175,7 @@ class ListenersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Update listener
+        Update load balancer listener
 
         Args:
           project_id: Project ID
@@ -356,7 +356,7 @@ class ListenersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancerListenerDetail:
         """
-        Get listener
+        Get load balancer listener
 
         Args:
           project_id: Project ID
@@ -447,7 +447,11 @@ class ListenersResource(SyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.listeners or len(task.created_resources.listeners) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.listeners
+            or len(task.created_resources.listeners) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return self.get(
             listener_id=task.created_resources.listeners[0],
@@ -694,7 +698,7 @@ class AsyncListenersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Update listener
+        Update load balancer listener
 
         Args:
           project_id: Project ID
@@ -875,7 +879,7 @@ class AsyncListenersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancerListenerDetail:
         """
-        Get listener
+        Get load balancer listener
 
         Args:
           project_id: Project ID
@@ -966,7 +970,11 @@ class AsyncListenersResource(AsyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.listeners or len(task.created_resources.listeners) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.listeners
+            or len(task.created_resources.listeners) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return await self.get(
             listener_id=task.created_resources.listeners[0],
@@ -975,7 +983,7 @@ class AsyncListenersResource(AsyncAPIResource):
             extra_headers=extra_headers,
             timeout=timeout,
         )
-    
+
     async def delete_and_poll(
         self,
         listener_id: str,
@@ -1008,7 +1016,7 @@ class AsyncListenersResource(AsyncAPIResource):
             task_id=response.tasks[0],
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
-        )    
+        )
 
     async def update_and_poll(
         self,
@@ -1069,6 +1077,7 @@ class AsyncListenersResource(AsyncAPIResource):
             timeout=timeout,
         )
 
+
 class ListenersResourceWithRawResponse:
     def __init__(self, listeners: ListenersResource) -> None:
         self._listeners = listeners

gcore/resources/cloud/load_balancers/load_balancers.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable
+from typing import Dict, List, Iterable, Optional
 
 import httpx
 
@@ -141,7 +141,7 @@ class LoadBalancersResource(SyncAPIResource):
         name: str | NotGiven = NOT_GIVEN,
         name_template: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         vip_ip_family: InterfaceIPFamily | NotGiven = NOT_GIVEN,
         vip_network_id: str | NotGiven = NOT_GIVEN,
         vip_port_id: str | NotGiven = NOT_GIVEN,
@@ -240,6 +240,7 @@ class LoadBalancersResource(SyncAPIResource):
         logging: load_balancer_update_params.Logging | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
+        tags: Optional[TagUpdateMapParam] | 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,
@@ -248,8 +249,10 @@ class LoadBalancersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancer:
         """
-        Rename load balancer, activate/deactivate logs or update preferred connectivity
-        for load balancer
+        Rename load balancer, activate/deactivate logging, update preferred connectivity
+        type and/or modify load balancer tags. The request will only process the fields
+        that are provided in the request body. Any fields that are not included will
+        remain unchanged.
 
         Args:
           logging: Logging configuration
@@ -259,6 +262,26 @@ class LoadBalancersResource(SyncAPIResource):
           preferred_connectivity: Preferred option to establish connectivity between load balancer and its pools
               members
 
+          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
@@ -280,6 +303,7 @@ class LoadBalancersResource(SyncAPIResource):
                     "logging": logging,
                     "name": name,
                     "preferred_connectivity": preferred_connectivity,
+                    "tags": tags,
                 },
                 load_balancer_update_params.LoadBalancerUpdateParams,
             ),
@@ -334,9 +358,7 @@ class LoadBalancersResource(SyncAPIResource):
 
           tag_key: Filter by tag keys.
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "`tag_key_value`={"key": "value"}" --url
-              "http://localhost:1111/v1/loadbalancers/1/1"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           with_ddos: Show Advanced DDoS protection profile, if exists
 
@@ -433,7 +455,7 @@ class LoadBalancersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Failover loadbalancer
+        Failover load balancer
 
         Args:
           force: Validate current load balancer status before failover or not.
@@ -531,7 +553,7 @@ class LoadBalancersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Resize loadbalancer
+        Resize load balancer
 
         Args:
           flavor: Name of the desired flavor to resize to.
@@ -571,7 +593,7 @@ class LoadBalancersResource(SyncAPIResource):
         name: str | NotGiven = NOT_GIVEN,
         name_template: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         vip_ip_family: InterfaceIPFamily | NotGiven = NOT_GIVEN,
         vip_network_id: str | NotGiven = NOT_GIVEN,
         vip_port_id: str | NotGiven = NOT_GIVEN,
@@ -611,7 +633,11 @@ class LoadBalancersResource(SyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.loadbalancers or len(task.created_resources.loadbalancers) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.loadbalancers
+            or len(task.created_resources.loadbalancers) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return self.get(
             loadbalancer_id=task.created_resources.loadbalancers[0],
@@ -798,7 +824,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         name: str | NotGiven = NOT_GIVEN,
         name_template: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         vip_ip_family: InterfaceIPFamily | NotGiven = NOT_GIVEN,
         vip_network_id: str | NotGiven = NOT_GIVEN,
         vip_port_id: str | NotGiven = NOT_GIVEN,
@@ -897,6 +923,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         logging: load_balancer_update_params.Logging | NotGiven = NOT_GIVEN,
         name: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
+        tags: Optional[TagUpdateMapParam] | 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,
@@ -905,8 +932,10 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancer:
         """
-        Rename load balancer, activate/deactivate logs or update preferred connectivity
-        for load balancer
+        Rename load balancer, activate/deactivate logging, update preferred connectivity
+        type and/or modify load balancer tags. The request will only process the fields
+        that are provided in the request body. Any fields that are not included will
+        remain unchanged.
 
         Args:
           logging: Logging configuration
@@ -916,6 +945,26 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
           preferred_connectivity: Preferred option to establish connectivity between load balancer and its pools
               members
 
+          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
@@ -937,6 +986,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
                     "logging": logging,
                     "name": name,
                     "preferred_connectivity": preferred_connectivity,
+                    "tags": tags,
                 },
                 load_balancer_update_params.LoadBalancerUpdateParams,
             ),
@@ -991,9 +1041,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
 
           tag_key: Filter by tag keys.
 
-          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string. curl -G
-              --data-urlencode "`tag_key_value`={"key": "value"}" --url
-              "http://localhost:1111/v1/loadbalancers/1/1"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           with_ddos: Show Advanced DDoS protection profile, if exists
 
@@ -1090,7 +1138,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Failover loadbalancer
+        Failover load balancer
 
         Args:
           force: Validate current load balancer status before failover or not.
@@ -1190,7 +1238,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Resize loadbalancer
+        Resize load balancer
 
         Args:
           flavor: Name of the desired flavor to resize to.
@@ -1230,7 +1278,7 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
         name: str | NotGiven = NOT_GIVEN,
         name_template: str | NotGiven = NOT_GIVEN,
         preferred_connectivity: LoadBalancerMemberConnectivity | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         vip_ip_family: InterfaceIPFamily | NotGiven = NOT_GIVEN,
         vip_network_id: str | NotGiven = NOT_GIVEN,
         vip_port_id: str | NotGiven = NOT_GIVEN,
@@ -1270,7 +1318,11 @@ class AsyncLoadBalancersResource(AsyncAPIResource):
             extra_headers=extra_headers,
             polling_interval_seconds=polling_interval_seconds,
         )
-        if not task.created_resources or not task.created_resources.loadbalancers or len(task.created_resources.loadbalancers) != 1:
+        if (
+            not task.created_resources
+            or not task.created_resources.loadbalancers
+            or len(task.created_resources.loadbalancers) != 1
+        ):
             raise ValueError(f"Expected exactly one resource to be created in a task")
         return await self.get(
             loadbalancer_id=task.created_resources.loadbalancers[0],

gcore/resources/cloud/load_balancers/metrics.py

@@ -59,7 +59,7 @@ class MetricsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancerMetricsList:
         """
-        Get loadbalancer metrics, including cpu, memory and network
+        Get load balancer metrics, including cpu, memory and network
 
         Args:
           time_interval: Time interval
@@ -132,7 +132,7 @@ class AsyncMetricsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> LoadBalancerMetricsList:
         """
-        Get loadbalancer metrics, including cpu, memory and network
+        Get load balancer metrics, including cpu, memory and network
 
         Args:
           time_interval: Time interval

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

@@ -68,7 +68,7 @@ class HealthMonitorsResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create Load Balancer Pool Health Monitor
+        Create load balancer pool health monitor
 
         Args:
           project_id: Project ID
@@ -219,7 +219,7 @@ class AsyncHealthMonitorsResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create Load Balancer Pool Health Monitor
+        Create load balancer pool health monitor
 
         Args:
           project_id: Project ID