gcore 0.10.0__py3-none-any.whl → 0.11.0__py3-none-any.whl

gcore/resources/cloud/instances/images.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Optional
+from typing import Dict, Optional
 from typing_extensions import Literal
 
 import httpx
 
-from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven, SequenceNotStr
 from ...._utils import maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from ...._resource import SyncAPIResource, AsyncAPIResource
@@ -136,7 +136,7 @@ class ImagesResource(SyncAPIResource):
         region_id: int | None = None,
         include_prices: bool | NotGiven = NOT_GIVEN,
         private: str | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         visibility: Literal["private", "public", "shared"] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -728,7 +728,7 @@ class AsyncImagesResource(AsyncAPIResource):
         region_id: int | None = None,
         include_prices: bool | NotGiven = NOT_GIVEN,
         private: str | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
         visibility: Literal["private", "public", "shared"] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.

gcore/resources/cloud/instances/instances.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Dict, List, Union, Iterable, Optional
+from typing import Dict, Union, Iterable, Optional
 from datetime import datetime
 from typing_extensions import Literal, overload
 
@@ -32,7 +32,7 @@ from .metrics import (
     MetricsResourceWithStreamingResponse,
     AsyncMetricsResourceWithStreamingResponse,
 )
-from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven
+from ...._types import NOT_GIVEN, Body, Query, Headers, NoneType, NotGiven, SequenceNotStr
 from ...._utils import required_args, maybe_transform, async_maybe_transform
 from ...._compat import cached_property
 from .interfaces import (
@@ -417,7 +417,7 @@ class InstancesResource(SyncAPIResource):
         ]
         | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
-        tag_value: List[str] | NotGiven = NOT_GIVEN,
+        tag_value: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         type_ddos_profile: Literal["basic", "advanced"] | NotGiven = NOT_GIVEN,
         uuid: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
@@ -773,6 +773,125 @@ class InstancesResource(SyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    @overload
+    def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["start"],
+        activate_profile: Optional[bool] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        The action can be one of: start, stop, reboot, powercycle, suspend or resume.
+        Suspend and resume are not available for bare metal instances.
+
+        Args:
+          action: Instance action name
+
+          activate_profile: Used on start instance to activate Advanced DDoS profile
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        ...
+
+    @overload
+    def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["reboot", "reboot_hard", "resume", "stop", "suspend"],
+        # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        The action can be one of: start, stop, reboot, powercycle, suspend or resume.
+        Suspend and resume are not available for bare metal instances.
+
+        Args:
+          action: Instance action name
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        ...
+
+    @required_args(["action"])
+    def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["start", "reboot", "reboot_hard", "resume", "stop", "suspend"],
+        activate_profile: Optional[bool] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        Perform the action on the instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        if region_id is None:
+            region_id = self._client._get_cloud_region_id_path_param()
+        if not instance_id:
+            raise ValueError(f"Expected a non-empty value for `instance_id` but received {instance_id!r}")
+        response = self._post(
+            f"/cloud/v2/instances/{project_id}/{region_id}/{instance_id}/action",
+            body=maybe_transform(
+                {
+                    "action": action,
+                    "activate_profile": activate_profile,
+                },
+                instance_action_params.InstanceActionParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TaskIDList,
+        )
+        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,
+        )
+        return self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     def add_to_placement_group(
         self,
         instance_id: str,
@@ -1667,7 +1786,7 @@ class AsyncInstancesResource(AsyncAPIResource):
         ]
         | NotGiven = NOT_GIVEN,
         tag_key_value: str | NotGiven = NOT_GIVEN,
-        tag_value: List[str] | NotGiven = NOT_GIVEN,
+        tag_value: SequenceNotStr[str] | NotGiven = NOT_GIVEN,
         type_ddos_profile: Literal["basic", "advanced"] | NotGiven = NOT_GIVEN,
         uuid: str | NotGiven = NOT_GIVEN,
         with_ddos: bool | NotGiven = NOT_GIVEN,
@@ -2023,6 +2142,125 @@ class AsyncInstancesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
+    @overload
+    async def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["start"],
+        activate_profile: Optional[bool] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        The action can be one of: start, stop, reboot, powercycle, suspend or resume.
+        Suspend and resume are not available for bare metal instances.
+
+        Args:
+          action: Instance action name
+
+          activate_profile: Used on start instance to activate Advanced DDoS profile
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        ...
+
+    @overload
+    async def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["reboot", "reboot_hard", "resume", "stop", "suspend"],
+        # 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        The action can be one of: start, stop, reboot, powercycle, suspend or resume.
+        Suspend and resume are not available for bare metal instances.
+
+        Args:
+          action: Instance action name
+
+          extra_headers: Send extra headers
+
+          extra_query: Add additional query parameters to the request
+
+          extra_body: Add additional JSON properties to the request
+
+          timeout: Override the client-level default timeout for this request, in seconds
+        """
+        ...
+
+    @required_args(["action"])
+    async def action_and_poll(
+        self,
+        instance_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        action: Literal["start", "reboot", "reboot_hard", "resume", "stop", "suspend"],
+        activate_profile: Optional[bool] | 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,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> Instance:
+        """
+        Perform the action on the instance and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+        """
+        if project_id is None:
+            project_id = self._client._get_cloud_project_id_path_param()
+        if region_id is None:
+            region_id = self._client._get_cloud_region_id_path_param()
+        if not instance_id:
+            raise ValueError(f"Expected a non-empty value for `instance_id` but received {instance_id!r}")
+        response = await self._post(
+            f"/cloud/v2/instances/{project_id}/{region_id}/{instance_id}/action",
+            body=await async_maybe_transform(
+                {
+                    "action": action,
+                    "activate_profile": activate_profile,
+                },
+                instance_action_params.InstanceActionParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TaskIDList,
+        )
+        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,
+        )
+        return await self.get(
+            instance_id=instance_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+        )
+
     async def add_to_placement_group(
         self,
         instance_id: str,
@@ -2591,6 +2829,9 @@ class InstancesResourceWithRawResponse:
         self.action = to_raw_response_wrapper(
             instances.action,
         )
+        self.action_and_poll = to_raw_response_wrapper(
+            instances.action_and_poll,
+        )
         self.add_to_placement_group = to_raw_response_wrapper(
             instances.add_to_placement_group,
         )
@@ -2655,6 +2896,9 @@ class AsyncInstancesResourceWithRawResponse:
         self.action = async_to_raw_response_wrapper(
             instances.action,
         )
+        self.action_and_poll = async_to_raw_response_wrapper(
+            instances.action_and_poll,
+        )
         self.add_to_placement_group = async_to_raw_response_wrapper(
             instances.add_to_placement_group,
         )
@@ -2719,6 +2963,9 @@ class InstancesResourceWithStreamingResponse:
         self.action = to_streamed_response_wrapper(
             instances.action,
         )
+        self.action_and_poll = to_streamed_response_wrapper(
+            instances.action_and_poll,
+        )
         self.add_to_placement_group = to_streamed_response_wrapper(
             instances.add_to_placement_group,
         )
@@ -2783,6 +3030,9 @@ class AsyncInstancesResourceWithStreamingResponse:
         self.action = async_to_streamed_response_wrapper(
             instances.action,
         )
+        self.action_and_poll = async_to_streamed_response_wrapper(
+            instances.action_and_poll,
+        )
         self.add_to_placement_group = async_to_streamed_response_wrapper(
             instances.add_to_placement_group,
         )