gcore 0.1.0a2__py3-none-any.whl → 0.3.0__py3-none-any.whl

gcore/resources/cloud/load_balancers/listeners.py

@@ -81,6 +81,10 @@ class ListenersResource(SyncAPIResource):
         Create load balancer listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           loadbalancer_id: Load balancer ID
 
           name: Load balancer listener name
@@ -94,13 +98,13 @@ class ListenersResource(SyncAPIResource):
           connection_limit: Limit of the simultaneous connections
 
           insert_x_forwarded: Add headers X-Forwarded-For, X-Forwarded-Port, X-Forwarded-Proto to requests.
-              Only used with HTTP or TERMINATED_HTTPS protocols.
+              Only used with HTTP or `TERMINATED_HTTPS` protocols.
 
-          secret_id: ID of the secret where PKCS12 file is stored for TERMINATED_HTTPS or PROMETHEUS
-              listener
+          secret_id: ID of the secret where PKCS12 file is stored for `TERMINATED_HTTPS` or
+              PROMETHEUS listener
 
           sni_secret_id: List of secrets IDs containing PKCS12 format certificate/key bundles for
-              TERMINATED_HTTPS or PROMETHEUS listeners
+              `TERMINATED_HTTPS` or PROMETHEUS listeners
 
           timeout_client_data: Frontend client inactivity timeout in milliseconds
 
@@ -174,17 +178,23 @@ class ListenersResource(SyncAPIResource):
         Update listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
           allowed_cidrs: Network CIDRs from which service will be accessible
 
           connection_limit: Limit of simultaneous connections
 
           name: Load balancer listener name
 
-          secret_id: ID of the secret where PKCS12 file is stored for TERMINATED_HTTPS or PROMETHEUS
-              load balancer
+          secret_id: ID of the secret where PKCS12 file is stored for `TERMINATED_HTTPS` or
+              PROMETHEUS load balancer
 
           sni_secret_id: List of secret's ID containing PKCS12 format certificate/key bundfles for
-              TERMINATED_HTTPS or PROMETHEUS listeners
+              `TERMINATED_HTTPS` or PROMETHEUS listeners
 
           timeout_client_data: Frontend client inactivity timeout in milliseconds
 
@@ -248,9 +258,13 @@ class ListenersResource(SyncAPIResource):
         List load balancer listeners
 
         Args:
-          loadbalancer_id: Load balancer ID
+          project_id: Project ID
 
-          show_stats: Show statistics
+          region_id: Region ID
+
+          loadbalancer_id: Load Balancer ID
+
+          show_stats: Show stats
 
           extra_headers: Send extra headers
 
@@ -299,6 +313,12 @@ class ListenersResource(SyncAPIResource):
         Delete load balancer listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -339,7 +359,13 @@ class ListenersResource(SyncAPIResource):
         Get listener
 
         Args:
-          show_stats: Show statistics
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
+          show_stats: Show stats
 
           extra_headers: Send extra headers
 
@@ -367,6 +393,163 @@ class ListenersResource(SyncAPIResource):
             cast_to=LoadBalancerListenerDetail,
         )
 
+    def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        loadbalancer_id: str,
+        name: str,
+        protocol: LbListenerProtocol,
+        protocol_port: int,
+        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        connection_limit: int | NotGiven = NOT_GIVEN,
+        insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
+        secret_id: str | NotGiven = NOT_GIVEN,
+        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
+        user_list: Iterable[listener_create_params.UserList] | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> LoadBalancerListenerDetail:
+        response = self.create(
+            project_id=project_id,
+            region_id=region_id,
+            loadbalancer_id=loadbalancer_id,
+            name=name,
+            protocol=protocol,
+            protocol_port=protocol_port,
+            allowed_cidrs=allowed_cidrs,
+            connection_limit=connection_limit,
+            insert_x_forwarded=insert_x_forwarded,
+            secret_id=secret_id,
+            sni_secret_id=sni_secret_id,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            user_list=user_list,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks or len(response.tasks) != 1:
+            raise ValueError(f"Expected exactly one task to be created")
+        task = self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            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:
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return self.get(
+            listener_id=task.created_resources.listeners[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
+    def delete_and_poll(
+        self,
+        listener_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> None:
+        """
+        Delete listener and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.delete(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+
+    def update_and_poll(
+        self,
+        listener_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        connection_limit: int | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
+        user_list: Optional[Iterable[listener_update_params.UserList]] | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> LoadBalancerListenerDetail:
+        """
+        Update listener and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = self.update(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            allowed_cidrs=allowed_cidrs,
+            connection_limit=connection_limit,
+            name=name,
+            secret_id=secret_id,
+            sni_secret_id=sni_secret_id,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            user_list=user_list,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return self.get(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
 
 class AsyncListenersResource(AsyncAPIResource):
     @cached_property
@@ -417,6 +600,10 @@ class AsyncListenersResource(AsyncAPIResource):
         Create load balancer listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           loadbalancer_id: Load balancer ID
 
           name: Load balancer listener name
@@ -430,13 +617,13 @@ class AsyncListenersResource(AsyncAPIResource):
           connection_limit: Limit of the simultaneous connections
 
           insert_x_forwarded: Add headers X-Forwarded-For, X-Forwarded-Port, X-Forwarded-Proto to requests.
-              Only used with HTTP or TERMINATED_HTTPS protocols.
+              Only used with HTTP or `TERMINATED_HTTPS` protocols.
 
-          secret_id: ID of the secret where PKCS12 file is stored for TERMINATED_HTTPS or PROMETHEUS
-              listener
+          secret_id: ID of the secret where PKCS12 file is stored for `TERMINATED_HTTPS` or
+              PROMETHEUS listener
 
           sni_secret_id: List of secrets IDs containing PKCS12 format certificate/key bundles for
-              TERMINATED_HTTPS or PROMETHEUS listeners
+              `TERMINATED_HTTPS` or PROMETHEUS listeners
 
           timeout_client_data: Frontend client inactivity timeout in milliseconds
 
@@ -510,17 +697,23 @@ class AsyncListenersResource(AsyncAPIResource):
         Update listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
           allowed_cidrs: Network CIDRs from which service will be accessible
 
           connection_limit: Limit of simultaneous connections
 
           name: Load balancer listener name
 
-          secret_id: ID of the secret where PKCS12 file is stored for TERMINATED_HTTPS or PROMETHEUS
-              load balancer
+          secret_id: ID of the secret where PKCS12 file is stored for `TERMINATED_HTTPS` or
+              PROMETHEUS load balancer
 
           sni_secret_id: List of secret's ID containing PKCS12 format certificate/key bundfles for
-              TERMINATED_HTTPS or PROMETHEUS listeners
+              `TERMINATED_HTTPS` or PROMETHEUS listeners
 
           timeout_client_data: Frontend client inactivity timeout in milliseconds
 
@@ -584,9 +777,13 @@ class AsyncListenersResource(AsyncAPIResource):
         List load balancer listeners
 
         Args:
-          loadbalancer_id: Load balancer ID
+          project_id: Project ID
+
+          region_id: Region ID
 
-          show_stats: Show statistics
+          loadbalancer_id: Load Balancer ID
+
+          show_stats: Show stats
 
           extra_headers: Send extra headers
 
@@ -635,6 +832,12 @@ class AsyncListenersResource(AsyncAPIResource):
         Delete load balancer listener
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -675,7 +878,13 @@ class AsyncListenersResource(AsyncAPIResource):
         Get listener
 
         Args:
-          show_stats: Show statistics
+          project_id: Project ID
+
+          region_id: Region ID
+
+          listener_id: Listener ID
+
+          show_stats: Show stats
 
           extra_headers: Send extra headers
 
@@ -703,6 +912,162 @@ class AsyncListenersResource(AsyncAPIResource):
             cast_to=LoadBalancerListenerDetail,
         )
 
+    async def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        loadbalancer_id: str,
+        name: str,
+        protocol: LbListenerProtocol,
+        protocol_port: int,
+        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        connection_limit: int | NotGiven = NOT_GIVEN,
+        insert_x_forwarded: bool | NotGiven = NOT_GIVEN,
+        secret_id: str | NotGiven = NOT_GIVEN,
+        sni_secret_id: List[str] | NotGiven = NOT_GIVEN,
+        timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
+        user_list: Iterable[listener_create_params.UserList] | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> LoadBalancerListenerDetail:
+        response = await self.create(
+            project_id=project_id,
+            region_id=region_id,
+            loadbalancer_id=loadbalancer_id,
+            name=name,
+            protocol=protocol,
+            protocol_port=protocol_port,
+            allowed_cidrs=allowed_cidrs,
+            connection_limit=connection_limit,
+            insert_x_forwarded=insert_x_forwarded,
+            secret_id=secret_id,
+            sni_secret_id=sni_secret_id,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            user_list=user_list,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks or len(response.tasks) != 1:
+            raise ValueError(f"Expected exactly one task to be created")
+        task = await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            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:
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return await self.get(
+            listener_id=task.created_resources.listeners[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+    
+    async def delete_and_poll(
+        self,
+        listener_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> None:
+        """
+        Delete listener and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.delete(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )    
+
+    async def update_and_poll(
+        self,
+        listener_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        allowed_cidrs: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        connection_limit: int | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        sni_secret_id: Optional[List[str]] | NotGiven = NOT_GIVEN,
+        timeout_client_data: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_connect: Optional[int] | NotGiven = NOT_GIVEN,
+        timeout_member_data: Optional[int] | NotGiven = NOT_GIVEN,
+        user_list: Optional[Iterable[listener_update_params.UserList]] | NotGiven = NOT_GIVEN,
+        polling_interval_seconds: int | NotGiven = NOT_GIVEN,
+        timeout: float | httpx.Timeout | None | 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+    ) -> LoadBalancerListenerDetail:
+        """
+        Update listener and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        response = await self.update(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            allowed_cidrs=allowed_cidrs,
+            connection_limit=connection_limit,
+            name=name,
+            secret_id=secret_id,
+            sni_secret_id=sni_secret_id,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            user_list=user_list,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:
+            raise ValueError("Expected at least one task to be created")
+        await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        return await self.get(
+            listener_id=listener_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
 
 class ListenersResourceWithRawResponse:
     def __init__(self, listeners: ListenersResource) -> None: