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

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

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

@@ -78,7 +78,9 @@ class MembersResource(SyncAPIResource):
 
           protocol_port: Member IP port
 
-          admin_state_up: true if enabled. Defaults to true
+          admin_state_up: Administrative state of the resource. When set to true, the resource is enabled
+              and operational. When set to false, the resource is disabled and will not
+              process traffic. When null is passed, the value is skipped and defaults to true.
 
           instance_id: Either `subnet_id` or `instance_id` should be provided
 
@@ -233,7 +235,9 @@ class AsyncMembersResource(AsyncAPIResource):
 
           protocol_port: Member IP port
 
-          admin_state_up: true if enabled. Defaults to true
+          admin_state_up: Administrative state of the resource. When set to true, the resource is enabled
+              and operational. When set to false, the resource is disabled and will not
+              process traffic. When null is passed, the value is skipped and defaults to true.
 
           instance_id: Either `subnet_id` or `instance_id` should be provided
 

gcore/resources/cloud/networks/networks.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List
+from typing import Dict, List, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -78,7 +78,7 @@ class NetworksResource(SyncAPIResource):
         region_id: int | None = None,
         name: str,
         create_router: bool | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         type: Literal["vlan", "vxlan"] | 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.
@@ -142,7 +142,8 @@ class NetworksResource(SyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        name: str,
+        name: str | 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,
@@ -150,8 +151,11 @@ class NetworksResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Network:
-        """
-        Change network name
+        """Rename network and/or update network 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:
           project_id: Project ID
@@ -162,6 +166,26 @@ class NetworksResource(SyncAPIResource):
 
           name: 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
@@ -178,7 +202,13 @@ class NetworksResource(SyncAPIResource):
             raise ValueError(f"Expected a non-empty value for `network_id` but received {network_id!r}")
         return self._patch(
             f"/cloud/v1/networks/{project_id}/{region_id}/{network_id}",
-            body=maybe_transform({"name": name}, network_update_params.NetworkUpdateParams),
+            body=maybe_transform(
+                {
+                    "name": name,
+                    "tags": tags,
+                },
+                network_update_params.NetworkUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -191,6 +221,7 @@ class NetworksResource(SyncAPIResource):
         project_id: int | None = None,
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
         order_by: Literal["created_at.asc", "created_at.desc", "name.asc", "name.desc"] | NotGiven = NOT_GIVEN,
         tag_key: List[str] | NotGiven = NOT_GIVEN,
@@ -212,6 +243,8 @@ class NetworksResource(SyncAPIResource):
 
           limit: Optional. Limit the number of returned items
 
+          name: Filter networks by name
+
           offset: Optional. Offset value is used to exclude the first set of records from the
               result
 
@@ -220,9 +253,7 @@ class NetworksResource(SyncAPIResource):
 
           tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
 
-          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.
 
           extra_headers: Send extra headers
 
@@ -247,6 +278,7 @@ class NetworksResource(SyncAPIResource):
                 query=maybe_transform(
                     {
                         "limit": limit,
+                        "name": name,
                         "offset": offset,
                         "order_by": order_by,
                         "tag_key": tag_key,
@@ -384,7 +416,7 @@ class AsyncNetworksResource(AsyncAPIResource):
         region_id: int | None = None,
         name: str,
         create_router: bool | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         type: Literal["vlan", "vxlan"] | 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.
@@ -448,7 +480,8 @@ class AsyncNetworksResource(AsyncAPIResource):
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        name: str,
+        name: str | 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,
@@ -456,8 +489,11 @@ class AsyncNetworksResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Network:
-        """
-        Change network name
+        """Rename network and/or update network 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:
           project_id: Project ID
@@ -468,6 +504,26 @@ class AsyncNetworksResource(AsyncAPIResource):
 
           name: 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
@@ -484,7 +540,13 @@ class AsyncNetworksResource(AsyncAPIResource):
             raise ValueError(f"Expected a non-empty value for `network_id` but received {network_id!r}")
         return await self._patch(
             f"/cloud/v1/networks/{project_id}/{region_id}/{network_id}",
-            body=await async_maybe_transform({"name": name}, network_update_params.NetworkUpdateParams),
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "tags": tags,
+                },
+                network_update_params.NetworkUpdateParams,
+            ),
             options=make_request_options(
                 extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
             ),
@@ -497,6 +559,7 @@ class AsyncNetworksResource(AsyncAPIResource):
         project_id: int | None = None,
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
         order_by: Literal["created_at.asc", "created_at.desc", "name.asc", "name.desc"] | NotGiven = NOT_GIVEN,
         tag_key: List[str] | NotGiven = NOT_GIVEN,
@@ -518,6 +581,8 @@ class AsyncNetworksResource(AsyncAPIResource):
 
           limit: Optional. Limit the number of returned items
 
+          name: Filter networks by name
+
           offset: Optional. Offset value is used to exclude the first set of records from the
               result
 
@@ -526,9 +591,7 @@ class AsyncNetworksResource(AsyncAPIResource):
 
           tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
 
-          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.
 
           extra_headers: Send extra headers
 
@@ -553,6 +616,7 @@ class AsyncNetworksResource(AsyncAPIResource):
                 query=maybe_transform(
                     {
                         "limit": limit,
+                        "name": name,
                         "offset": offset,
                         "order_by": order_by,
                         "tag_key": tag_key,

gcore/resources/cloud/networks/routers.py

@@ -68,7 +68,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create router
+        Create a new router with the specified configuration.
 
         Args:
           name: name of router
@@ -125,7 +125,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Update router
+        Update the configuration of an existing router.
 
         Args:
           external_gateway_info: New external gateway.
@@ -179,12 +179,12 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> SyncOffsetPage[Router]:
         """
-        List routers
+        List all routers in the specified project and region.
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          limit: Limit the number of returned routers
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Offset value is used to exclude the first set of records from the result
 
           extra_headers: Send extra headers
 
@@ -231,7 +231,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Delete router
+        Delete a specific router and all its associated resources.
 
         Args:
           extra_headers: Send extra headers
@@ -272,7 +272,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Attach subnet to router
+        Attach a subnet to an existing router.
 
         Args:
           project_id: Project ID
@@ -330,7 +330,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Detach subnet from router
+        Detach a subnet from an existing router.
 
         Args:
           subnet_id: Target IP is identified by it's subnet
@@ -372,7 +372,7 @@ class RoutersResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Get specific router
+        Get detailed information about a specific router.
 
         Args:
           extra_headers: Send extra headers
@@ -435,7 +435,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Create router
+        Create a new router with the specified configuration.
 
         Args:
           name: name of router
@@ -492,7 +492,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Update router
+        Update the configuration of an existing router.
 
         Args:
           external_gateway_info: New external gateway.
@@ -546,12 +546,12 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> AsyncPaginator[Router, AsyncOffsetPage[Router]]:
         """
-        List routers
+        List all routers in the specified project and region.
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          limit: Limit the number of returned routers
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Offset value is used to exclude the first set of records from the result
 
           extra_headers: Send extra headers
 
@@ -598,7 +598,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Delete router
+        Delete a specific router and all its associated resources.
 
         Args:
           extra_headers: Send extra headers
@@ -639,7 +639,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Attach subnet to router
+        Attach a subnet to an existing router.
 
         Args:
           project_id: Project ID
@@ -697,7 +697,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Detach subnet from router
+        Detach a subnet from an existing router.
 
         Args:
           subnet_id: Target IP is identified by it's subnet
@@ -741,7 +741,7 @@ class AsyncRoutersResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Router:
         """
-        Get specific router
+        Get detailed information about a specific router.
 
         Args:
           extra_headers: Send extra headers