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

gcore/resources/cloud/instances/images.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Optional
+from typing import Dict, List, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -74,7 +74,7 @@ class ImagesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Image:
         """
-        Update image fields
+        Update image properties and tags.
 
         Args:
           hw_firmware_type: Specifies the type of firmware with which to boot the guest.
@@ -146,10 +146,11 @@ class ImagesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ImageList:
-        """Retrieve an available images list.
+        """Retrieve a list of available images in the project and region.
 
-        Returned entities owned by the project and
-        public OR shared with the client
+        The list can be
+        filtered by visibility, tags, and other parameters. Returned entities are owned
+        by the project or are public/shared with the client.
 
         Args:
           include_prices: Show price
@@ -158,9 +159,7 @@ class ImagesResource(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/images/1/1'"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           visibility: Image visibility. Globally visible images are public
 
@@ -210,8 +209,10 @@ class ImagesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Delete the image
+        """Delete a specific image.
+
+        The image cannot be deleted if it is used by protected
+        snapshots.
 
         Args:
           extra_headers: Send extra headers
@@ -284,7 +285,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         source: Literal["volume"] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, 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.
         extra_headers: Headers | None = None,
@@ -292,8 +293,10 @@ class ImagesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Create image from volume
+        """Create a new image from a bootable volume.
+
+        The volume must be bootable to create
+        an image from it.
 
         Args:
           name: Image name
@@ -369,7 +372,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         source: Literal["volume"] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: 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.
@@ -430,7 +433,7 @@ class ImagesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Image:
         """
-        Get image
+        Retrieve detailed information about a specific image.
 
         Args:
           include_prices: Show price
@@ -477,7 +480,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, 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.
         extra_headers: Headers | None = None,
@@ -485,8 +488,10 @@ class ImagesResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Upload image
+        """Upload an image from a URL.
+
+        The image can be configured with various properties
+        like OS type, architecture, and tags.
 
         Args:
           name: Image name
@@ -571,7 +576,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: 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.
@@ -661,7 +666,7 @@ class AsyncImagesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Image:
         """
-        Update image fields
+        Update image properties and tags.
 
         Args:
           hw_firmware_type: Specifies the type of firmware with which to boot the guest.
@@ -733,10 +738,11 @@ class AsyncImagesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> ImageList:
-        """Retrieve an available images list.
+        """Retrieve a list of available images in the project and region.
 
-        Returned entities owned by the project and
-        public OR shared with the client
+        The list can be
+        filtered by visibility, tags, and other parameters. Returned entities are owned
+        by the project or are public/shared with the client.
 
         Args:
           include_prices: Show price
@@ -745,9 +751,7 @@ class AsyncImagesResource(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/images/1/1'"
+          tag_key_value: Filter by tag key-value pairs. Must be a valid JSON string.
 
           visibility: Image visibility. Globally visible images are public
 
@@ -797,8 +801,10 @@ class AsyncImagesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Delete the image
+        """Delete a specific image.
+
+        The image cannot be deleted if it is used by protected
+        snapshots.
 
         Args:
           extra_headers: Send extra headers
@@ -871,7 +877,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         source: Literal["volume"] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, 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.
         extra_headers: Headers | None = None,
@@ -879,8 +885,10 @@ class AsyncImagesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Create image from volume
+        """Create a new image from a bootable volume.
+
+        The volume must be bootable to create
+        an image from it.
 
         Args:
           name: Image name
@@ -956,7 +964,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         source: Literal["volume"] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: 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.
@@ -1017,7 +1025,7 @@ class AsyncImagesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Image:
         """
-        Get image
+        Retrieve detailed information about a specific image.
 
         Args:
           include_prices: Show price
@@ -1064,7 +1072,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, 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.
         extra_headers: Headers | None = None,
@@ -1072,8 +1080,10 @@ class AsyncImagesResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Upload image
+        """Upload an image from a URL.
+
+        The image can be configured with various properties
+        like OS type, architecture, and tags.
 
         Args:
           name: Image name
@@ -1158,7 +1168,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Literal["linux", "windows"] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: 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.

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)
@@ -198,7 +198,7 @@ class InstancesResource(SyncAPIResource):
                 sharing if needed.
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/cloud/ssh-keys/add-or-generate-ssh-key).
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
@@ -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)
@@ -1440,7 +1448,7 @@ class AsyncInstancesResource(AsyncAPIResource):
                 sharing if needed.
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/cloud/ssh-keys/add-or-generate-ssh-key).
 
           tags: Key-value tags to associate with the resource. A tag is a key-value pair that
               can be associated with a resource, enabling efficient filtering and grouping for
@@ -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