gcore 0.2.0__py3-none-any.whl → 0.4.0__py3-none-any.whl

gcore/resources/cloud/instances/flavors.py

@@ -2,8 +2,6 @@
 
 from __future__ import annotations
 
-from typing import Iterable
-
 import httpx
 
 from ...._types import NOT_GIVEN, Body, Query, Headers, NotGiven
@@ -17,7 +15,7 @@ from ...._response import (
     async_to_streamed_response_wrapper,
 )
 from ...._base_client import make_request_options
-from ....types.cloud.instances import flavor_list_params, flavor_list_suitable_params, flavor_list_for_resize_params
+from ....types.cloud.instances import flavor_list_params
 from ....types.cloud.instances.instance_flavor_list import InstanceFlavorList
 
 __all__ = ["FlavorsResource", "AsyncFlavorsResource"]
@@ -59,11 +57,11 @@ class FlavorsResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> InstanceFlavorList:
-        """Retrieve a list of flavors.
+        """Retrieve a list of available instance flavors in the project and region.
 
-        When the include_prices query parameter is
-        specified, the list shows prices. A client in trial mode gets all price values
-        as 0. If you get Pricing Error contact the support
+        When
+        `include_prices` is specified, the list includes pricing information. Trial mode
+        clients see all prices as 0. Contact support for pricing errors.
 
         Args:
           disabled: Flag for filtering disabled flavors in the region. Defaults to true
@@ -106,104 +104,6 @@ class FlavorsResource(SyncAPIResource):
             cast_to=InstanceFlavorList,
         )
 
-    def list_for_resize(
-        self,
-        instance_id: str,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        include_prices: 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,
-    ) -> InstanceFlavorList:
-        """
-        List suitable flavors for instance resize
-
-        Args:
-          include_prices: Set to true if flavor listing should include flavor prices
-
-          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
-        """
-        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}")
-        return self._get(
-            f"/cloud/v1/instances/{project_id}/{region_id}/{instance_id}/available_flavors",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {"include_prices": include_prices}, flavor_list_for_resize_params.FlavorListForResizeParams
-                ),
-            ),
-            cast_to=InstanceFlavorList,
-        )
-
-    def list_suitable(
-        self,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        volumes: Iterable[flavor_list_suitable_params.Volume],
-        include_prices: 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,
-    ) -> InstanceFlavorList:
-        """List suitable flavors for instance creation
-
-        Args:
-          volumes: Volumes details.
-
-        Non-important info such as names may be omitted.
-
-          include_prices: Set to true if flavor listing should include flavor prices
-
-          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
-        """
-        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()
-        return self._post(
-            f"/cloud/v1/instances/{project_id}/{region_id}/available_flavors",
-            body=maybe_transform({"volumes": volumes}, flavor_list_suitable_params.FlavorListSuitableParams),
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=maybe_transform(
-                    {"include_prices": include_prices}, flavor_list_suitable_params.FlavorListSuitableParams
-                ),
-            ),
-            cast_to=InstanceFlavorList,
-        )
-
 
 class AsyncFlavorsResource(AsyncAPIResource):
     @cached_property
@@ -241,11 +141,11 @@ class AsyncFlavorsResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> InstanceFlavorList:
-        """Retrieve a list of flavors.
+        """Retrieve a list of available instance flavors in the project and region.
 
-        When the include_prices query parameter is
-        specified, the list shows prices. A client in trial mode gets all price values
-        as 0. If you get Pricing Error contact the support
+        When
+        `include_prices` is specified, the list includes pricing information. Trial mode
+        clients see all prices as 0. Contact support for pricing errors.
 
         Args:
           disabled: Flag for filtering disabled flavors in the region. Defaults to true
@@ -288,106 +188,6 @@ class AsyncFlavorsResource(AsyncAPIResource):
             cast_to=InstanceFlavorList,
         )
 
-    async def list_for_resize(
-        self,
-        instance_id: str,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        include_prices: 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,
-    ) -> InstanceFlavorList:
-        """
-        List suitable flavors for instance resize
-
-        Args:
-          include_prices: Set to true if flavor listing should include flavor prices
-
-          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
-        """
-        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}")
-        return await self._get(
-            f"/cloud/v1/instances/{project_id}/{region_id}/{instance_id}/available_flavors",
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"include_prices": include_prices}, flavor_list_for_resize_params.FlavorListForResizeParams
-                ),
-            ),
-            cast_to=InstanceFlavorList,
-        )
-
-    async def list_suitable(
-        self,
-        *,
-        project_id: int | None = None,
-        region_id: int | None = None,
-        volumes: Iterable[flavor_list_suitable_params.Volume],
-        include_prices: 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,
-    ) -> InstanceFlavorList:
-        """List suitable flavors for instance creation
-
-        Args:
-          volumes: Volumes details.
-
-        Non-important info such as names may be omitted.
-
-          include_prices: Set to true if flavor listing should include flavor prices
-
-          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
-        """
-        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()
-        return await self._post(
-            f"/cloud/v1/instances/{project_id}/{region_id}/available_flavors",
-            body=await async_maybe_transform(
-                {"volumes": volumes}, flavor_list_suitable_params.FlavorListSuitableParams
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers,
-                extra_query=extra_query,
-                extra_body=extra_body,
-                timeout=timeout,
-                query=await async_maybe_transform(
-                    {"include_prices": include_prices}, flavor_list_suitable_params.FlavorListSuitableParams
-                ),
-            ),
-            cast_to=InstanceFlavorList,
-        )
-
 
 class FlavorsResourceWithRawResponse:
     def __init__(self, flavors: FlavorsResource) -> None:
@@ -396,12 +196,6 @@ class FlavorsResourceWithRawResponse:
         self.list = to_raw_response_wrapper(
             flavors.list,
         )
-        self.list_for_resize = to_raw_response_wrapper(
-            flavors.list_for_resize,
-        )
-        self.list_suitable = to_raw_response_wrapper(
-            flavors.list_suitable,
-        )
 
 
 class AsyncFlavorsResourceWithRawResponse:
@@ -411,12 +205,6 @@ class AsyncFlavorsResourceWithRawResponse:
         self.list = async_to_raw_response_wrapper(
             flavors.list,
         )
-        self.list_for_resize = async_to_raw_response_wrapper(
-            flavors.list_for_resize,
-        )
-        self.list_suitable = async_to_raw_response_wrapper(
-            flavors.list_suitable,
-        )
 
 
 class FlavorsResourceWithStreamingResponse:
@@ -426,12 +214,6 @@ class FlavorsResourceWithStreamingResponse:
         self.list = to_streamed_response_wrapper(
             flavors.list,
         )
-        self.list_for_resize = to_streamed_response_wrapper(
-            flavors.list_for_resize,
-        )
-        self.list_suitable = to_streamed_response_wrapper(
-            flavors.list_suitable,
-        )
 
 
 class AsyncFlavorsResourceWithStreamingResponse:
@@ -441,9 +223,3 @@ class AsyncFlavorsResourceWithStreamingResponse:
         self.list = async_to_streamed_response_wrapper(
             flavors.list,
         )
-        self.list_for_resize = async_to_streamed_response_wrapper(
-            flavors.list_for_resize,
-        )
-        self.list_suitable = async_to_streamed_response_wrapper(
-            flavors.list_suitable,
-        )

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.