gcore 0.1.0a1__py3-none-any.whl → 0.2.0__py3-none-any.whl

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

@@ -102,6 +102,10 @@ class PoolsResource(SyncAPIResource):
         Create load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           lb_algorithm: Load balancer algorithm
 
           name: Pool name
@@ -200,6 +204,12 @@ class PoolsResource(SyncAPIResource):
         they will be overwritten.
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           ca_secret_id: Secret ID of CA certificate bundle
 
           crl_secret_id: Secret ID of CA revocation list file
@@ -283,12 +293,15 @@ class PoolsResource(SyncAPIResource):
         List load balancer pools
 
         Args:
-          details: If true, show member and healthmonitor details of each pool (increases request
-              time)
+          project_id: Project ID
+
+          region_id: Region ID
 
-          listener_id: Load balancer listener ID
+          details: Show members and Health Monitor details
 
-          loadbalancer_id: Load balancer ID
+          listener_id: Listener ID
+
+          loadbalancer_id: Load Balancer ID
 
           extra_headers: Send extra headers
 
@@ -338,6 +351,12 @@ class PoolsResource(SyncAPIResource):
         Delete load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -377,6 +396,12 @@ class PoolsResource(SyncAPIResource):
         Get load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -399,6 +424,171 @@ class PoolsResource(SyncAPIResource):
             cast_to=LoadBalancerPool,
         )
 
+    def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        lb_algorithm: LbAlgorithm,
+        name: str,
+        protocol: LbPoolProtocol,
+        ca_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        crl_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        healthmonitor: Optional[pool_create_params.Healthmonitor] | NotGiven = NOT_GIVEN,
+        listener_id: Optional[str] | NotGiven = NOT_GIVEN,
+        loadbalancer_id: Optional[str] | NotGiven = NOT_GIVEN,
+        members: Optional[Iterable[pool_create_params.Member]] | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        session_persistence: Optional[pool_create_params.SessionPersistence] | 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,
+        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,
+    ) -> LoadBalancerPool:
+        response = self.create(
+            project_id=project_id,
+            region_id=region_id,
+            lb_algorithm=lb_algorithm,
+            name=name,
+            protocol=protocol,
+            ca_secret_id=ca_secret_id,
+            crl_secret_id=crl_secret_id,
+            healthmonitor=healthmonitor,
+            listener_id=listener_id,
+            loadbalancer_id=loadbalancer_id,
+            members=members,
+            secret_id=secret_id,
+            session_persistence=session_persistence,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            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.pools or len(task.created_resources.pools) != 1:
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return self.get(
+            pool_id=task.created_resources.pools[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
+    def delete_and_poll(
+        self,
+        pool_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 pool 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(
+            pool_id=pool_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,
+        pool_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        ca_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        crl_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        healthmonitor: Optional[pool_update_params.Healthmonitor] | NotGiven = NOT_GIVEN,
+        lb_algorithm: LbAlgorithm | NotGiven = NOT_GIVEN,
+        members: Optional[Iterable[pool_update_params.Member]] | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        protocol: LbPoolProtocol | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        session_persistence: Optional[pool_update_params.SessionPersistence] | 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,
+        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,
+    ) -> LoadBalancerPool:
+        """
+        Update pool 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(
+            pool_id=pool_id,
+            project_id=project_id,
+            region_id=region_id,
+            ca_secret_id=ca_secret_id,
+            crl_secret_id=crl_secret_id,
+            healthmonitor=healthmonitor,
+            lb_algorithm=lb_algorithm,
+            members=members,
+            name=name,
+            protocol=protocol,
+            secret_id=secret_id,
+            session_persistence=session_persistence,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            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(
+            pool_id=pool_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
 
 class AsyncPoolsResource(AsyncAPIResource):
     @cached_property
@@ -458,6 +648,10 @@ class AsyncPoolsResource(AsyncAPIResource):
         Create load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           lb_algorithm: Load balancer algorithm
 
           name: Pool name
@@ -556,6 +750,12 @@ class AsyncPoolsResource(AsyncAPIResource):
         they will be overwritten.
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           ca_secret_id: Secret ID of CA certificate bundle
 
           crl_secret_id: Secret ID of CA revocation list file
@@ -639,12 +839,15 @@ class AsyncPoolsResource(AsyncAPIResource):
         List load balancer pools
 
         Args:
-          details: If true, show member and healthmonitor details of each pool (increases request
-              time)
+          project_id: Project ID
+
+          region_id: Region ID
 
-          listener_id: Load balancer listener ID
+          details: Show members and Health Monitor details
 
-          loadbalancer_id: Load balancer ID
+          listener_id: Listener ID
+
+          loadbalancer_id: Load Balancer ID
 
           extra_headers: Send extra headers
 
@@ -694,6 +897,12 @@ class AsyncPoolsResource(AsyncAPIResource):
         Delete load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -733,6 +942,12 @@ class AsyncPoolsResource(AsyncAPIResource):
         Get load balancer pool
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          pool_id: Pool ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -755,6 +970,171 @@ class AsyncPoolsResource(AsyncAPIResource):
             cast_to=LoadBalancerPool,
         )
 
+    async def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        lb_algorithm: LbAlgorithm,
+        name: str,
+        protocol: LbPoolProtocol,
+        ca_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        crl_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        healthmonitor: Optional[pool_create_params.Healthmonitor] | NotGiven = NOT_GIVEN,
+        listener_id: Optional[str] | NotGiven = NOT_GIVEN,
+        loadbalancer_id: Optional[str] | NotGiven = NOT_GIVEN,
+        members: Optional[Iterable[pool_create_params.Member]] | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        session_persistence: Optional[pool_create_params.SessionPersistence] | 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,
+        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,
+    ) -> LoadBalancerPool:
+        response = await self.create(
+            project_id=project_id,
+            region_id=region_id,
+            lb_algorithm=lb_algorithm,
+            name=name,
+            protocol=protocol,
+            ca_secret_id=ca_secret_id,
+            crl_secret_id=crl_secret_id,
+            healthmonitor=healthmonitor,
+            listener_id=listener_id,
+            loadbalancer_id=loadbalancer_id,
+            members=members,
+            secret_id=secret_id,
+            session_persistence=session_persistence,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            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.pools or len(task.created_resources.pools) != 1:
+            raise ValueError(f"Expected exactly one resource to be created in a task")
+        return await self.get(
+            pool_id=task.created_resources.pools[0],
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
+    async def delete_and_poll(
+        self,
+        pool_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 pool 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(
+            pool_id=pool_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,
+        pool_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        ca_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        crl_secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        healthmonitor: Optional[pool_update_params.Healthmonitor] | NotGiven = NOT_GIVEN,
+        lb_algorithm: LbAlgorithm | NotGiven = NOT_GIVEN,
+        members: Optional[Iterable[pool_update_params.Member]] | NotGiven = NOT_GIVEN,
+        name: str | NotGiven = NOT_GIVEN,
+        protocol: LbPoolProtocol | NotGiven = NOT_GIVEN,
+        secret_id: Optional[str] | NotGiven = NOT_GIVEN,
+        session_persistence: Optional[pool_update_params.SessionPersistence] | 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,
+        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,
+    ) -> LoadBalancerPool:
+        """
+        Update pool 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(
+            pool_id=pool_id,
+            project_id=project_id,
+            region_id=region_id,
+            ca_secret_id=ca_secret_id,
+            crl_secret_id=crl_secret_id,
+            healthmonitor=healthmonitor,
+            lb_algorithm=lb_algorithm,
+            members=members,
+            name=name,
+            protocol=protocol,
+            secret_id=secret_id,
+            session_persistence=session_persistence,
+            timeout_client_data=timeout_client_data,
+            timeout_member_connect=timeout_member_connect,
+            timeout_member_data=timeout_member_data,
+            timeout=timeout,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+        )
+        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(
+            pool_id=pool_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            timeout=timeout,
+        )
+
 
 class PoolsResourceWithRawResponse:
     def __init__(self, pools: PoolsResource) -> None:

gcore/resources/cloud/networks/networks.py

@@ -91,6 +91,10 @@ class NetworksResource(SyncAPIResource):
         Create network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           name: Network name
 
           create_router: Defaults to True
@@ -150,6 +154,12 @@ class NetworksResource(SyncAPIResource):
         Change network name
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           name: Name.
 
           extra_headers: Send extra headers
@@ -182,7 +192,7 @@ class NetworksResource(SyncAPIResource):
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | 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,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -196,17 +206,23 @@ class NetworksResource(SyncAPIResource):
         List networks
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          project_id: Project ID
+
+          region_id: Region ID
+
+          limit: Optional. Limit the number of returned items
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
 
-          order_by: Order networks by fields and directions (name.asc). Default is `created_at.asc`.
+          order_by: Ordering networks list result by `name`, `created_at` fields of the network and
+              directions (`created_at.desc`).
 
-          tag_key: Filter by tag keys.
+          tag_key: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2
 
-          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/networks/1/1"
+          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"
 
           extra_headers: Send extra headers
 
@@ -259,6 +275,12 @@ class NetworksResource(SyncAPIResource):
         Delete network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -298,6 +320,12 @@ class NetworksResource(SyncAPIResource):
         Get network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -369,6 +397,10 @@ class AsyncNetworksResource(AsyncAPIResource):
         Create network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
           name: Network name
 
           create_router: Defaults to True
@@ -428,6 +460,12 @@ class AsyncNetworksResource(AsyncAPIResource):
         Change network name
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           name: Name.
 
           extra_headers: Send extra headers
@@ -460,7 +498,7 @@ class AsyncNetworksResource(AsyncAPIResource):
         region_id: int | None = None,
         limit: int | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
-        order_by: str | 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,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -474,17 +512,23 @@ class AsyncNetworksResource(AsyncAPIResource):
         List networks
 
         Args:
-          limit: Limit the number of returned limit request entities.
+          project_id: Project ID
+
+          region_id: Region ID
+
+          limit: Optional. Limit the number of returned items
 
-          offset: Offset value is used to exclude the first set of records from the result.
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
 
-          order_by: Order networks by fields and directions (name.asc). Default is `created_at.asc`.
+          order_by: Ordering networks list result by `name`, `created_at` fields of the network and
+              directions (`created_at.desc`).
 
-          tag_key: Filter by tag keys.
+          tag_key: Optional. Filter by tag keys. ?tag_key=key1&tag_key=key2
 
-          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/networks/1/1"
+          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"
 
           extra_headers: Send extra headers
 
@@ -537,6 +581,12 @@ class AsyncNetworksResource(AsyncAPIResource):
         Delete network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request
@@ -576,6 +626,12 @@ class AsyncNetworksResource(AsyncAPIResource):
         Get network
 
         Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          network_id: Network ID
+
           extra_headers: Send extra headers
 
           extra_query: Add additional query parameters to the request