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

gcore/resources/cloud/volumes.py

@@ -2,12 +2,12 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Iterable, Optional
 from typing_extensions import Literal, overload
 
 import httpx
 
-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 ..._resource import SyncAPIResource, AsyncAPIResource
@@ -403,7 +403,7 @@ class VolumesResource(SyncAPIResource):
         limit: int | NotGiven = NOT_GIVEN,
         name_part: str | NotGiven = NOT_GIVEN,
         offset: int | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[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.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -844,29 +844,8 @@ class VolumesResource(SyncAPIResource):
             cast_to=NoneType,
         )
 
-
-class AsyncVolumesResource(AsyncAPIResource):
-    @cached_property
-    def with_raw_response(self) -> AsyncVolumesResourceWithRawResponse:
-        """
-        This property can be used as a prefix for any HTTP method call to return
-        the raw response object instead of the parsed content.
-
-        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
-        """
-        return AsyncVolumesResourceWithRawResponse(self)
-
-    @cached_property
-    def with_streaming_response(self) -> AsyncVolumesResourceWithStreamingResponse:
-        """
-        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
-
-        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
-        """
-        return AsyncVolumesResourceWithStreamingResponse(self)
-
     @overload
-    async def create(
+    def create_and_poll(
         self,
         *,
         project_id: int | None = None,
@@ -881,14 +860,15 @@ class AsyncVolumesResource(AsyncAPIResource):
         tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
         type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
         | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """Create a new volume in the project and region.
+    ) -> Volume:
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
 
         The volume can be created from
         scratch, from an image, or from a snapshot. Optionally attach the volume to an
@@ -935,7 +915,7 @@ class AsyncVolumesResource(AsyncAPIResource):
         ...
 
     @overload
-    async def create(
+    def create_and_poll(
         self,
         *,
         project_id: int | None = None,
@@ -950,14 +930,15 @@ class AsyncVolumesResource(AsyncAPIResource):
         tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
         type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
         | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """Create a new volume in the project and region.
+    ) -> Volume:
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
 
         The volume can be created from
         scratch, from an image, or from a snapshot. Optionally attach the volume to an
@@ -1005,7 +986,7 @@ class AsyncVolumesResource(AsyncAPIResource):
         ...
 
     @overload
-    async def create(
+    def create_and_poll(
         self,
         *,
         project_id: int | None = None,
@@ -1019,14 +1000,15 @@ class AsyncVolumesResource(AsyncAPIResource):
         tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
         type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
         | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """Create a new volume in the project and region.
+    ) -> Volume:
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
 
         The volume can be created from
         scratch, from an image, or from a snapshot. Optionally attach the volume to an
@@ -1073,7 +1055,7 @@ class AsyncVolumesResource(AsyncAPIResource):
     @required_args(
         ["image_id", "name", "size", "source"], ["name", "snapshot_id", "source"], ["name", "size", "source"]
     )
-    async def create(
+    def create_and_poll(
         self,
         *,
         project_id: int | None = None,
@@ -1089,170 +1071,279 @@ class AsyncVolumesResource(AsyncAPIResource):
         type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
         | NotGiven = NOT_GIVEN,
         snapshot_id: str | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        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/volumes/{project_id}/{region_id}",
-            body=await async_maybe_transform(
-                {
-                    "image_id": image_id,
-                    "name": name,
-                    "size": size,
-                    "source": source,
-                    "attachment_tag": attachment_tag,
-                    "instance_id_to_attach_to": instance_id_to_attach_to,
-                    "lifecycle_policy_ids": lifecycle_policy_ids,
-                    "tags": tags,
-                    "type_name": type_name,
-                    "snapshot_id": snapshot_id,
-                },
-                volume_create_params.VolumeCreateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=TaskIDList,
+    ) -> Volume:
+        """Create a new volume in the project and region 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: TaskIDList = self.create(  # type: ignore
+            project_id=project_id,
+            region_id=region_id,
+            image_id=image_id,
+            name=name,
+            size=size,
+            source=source,
+            attachment_tag=attachment_tag,
+            instance_id_to_attach_to=instance_id_to_attach_to,
+            lifecycle_policy_ids=lifecycle_policy_ids,
+            tags=tags,
+            type_name=type_name,
+            snapshot_id=snapshot_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:  # type: ignore
+            raise ValueError("Expected at least one task to be created")
+        task = self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],  # type: ignore
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        if task.created_resources is None or task.created_resources.volumes is None or len(task.created_resources.volumes) != 1:
+            raise ValueError("Task completed but created_resources or volumes is missing or invalid")
+        created_volume_id = task.created_resources.volumes[0]
+        return self.get(
+            volume_id=created_volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
         )
 
-    async def update(
+    def delete_and_poll(
         self,
         volume_id: str,
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        name: str | NotGiven = NOT_GIVEN,
-        tags: Optional[TagUpdateMapParam] | NotGiven = NOT_GIVEN,
+        snapshots: str | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> Volume:
-        """
-        Rename a volume or update tags
-
-        Args:
-          project_id: Project ID
-
-          region_id: Region ID
+    ) -> None:
+        """Delete a volume and all its snapshots 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(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            snapshots=snapshots,
+            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,
+        )
 
-          volume_id: Volume ID
+    def attach_to_instance_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        instance_id: str,
+        attachment_tag: str | 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,
+    ) -> None:
+        """Attach the volume to 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."""
+        response = self.attach_to_instance(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            instance_id=instance_id,
+            attachment_tag=attachment_tag,
+            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,
+        )
 
-          name: Name
+    def detach_from_instance_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        instance_id: str,
+        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:
+        """Detach the volume from 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."""
+        response = self.detach_from_instance(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            instance_id=instance_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,
+        )
 
-          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
-              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
-              Unspecified tags remain unchanged. Read-only tags are always preserved and
-              cannot be modified. **Examples:**
+    def resize_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        size: int,
+        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,
+    ) -> Volume:
+        """Increase the size of a volume 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.resize(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            size=size,
+            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(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
 
-              - **Add/update tags:**
-                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
-                updates existing ones.
-              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
-              - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
-                tags are preserved).
-              - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
-                specified tags.
-              - **Mixed operations:**
-                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
-                adds/updates 'environment' and '`cost_center`' while removing
-                '`deprecated_tag`', preserving other existing tags.
-              - **Replace all:** first delete existing tags with null values, then add new
-                ones in the same request.
 
-          extra_headers: Send extra headers
+class AsyncVolumesResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncVolumesResourceWithRawResponse:
+        """
+        This property can be used as a prefix for any HTTP method call to return
+        the raw response object instead of the parsed content.
 
-          extra_query: Add additional query parameters to the request
+        For more information, see https://www.github.com/G-Core/gcore-python#accessing-raw-response-data-eg-headers
+        """
+        return AsyncVolumesResourceWithRawResponse(self)
 
-          extra_body: Add additional JSON properties to the request
+    @cached_property
+    def with_streaming_response(self) -> AsyncVolumesResourceWithStreamingResponse:
+        """
+        An alternative to `.with_raw_response` that doesn't eagerly read the response body.
 
-          timeout: Override the client-level default timeout for this request, in seconds
+        For more information, see https://www.github.com/G-Core/gcore-python#with_streaming_response
         """
-        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 volume_id:
-            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
-        return await self._patch(
-            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}",
-            body=await async_maybe_transform(
-                {
-                    "name": name,
-                    "tags": tags,
-                },
-                volume_update_params.VolumeUpdateParams,
-            ),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=Volume,
-        )
+        return AsyncVolumesResourceWithStreamingResponse(self)
 
-    def list(
+    @overload
+    async def create(
         self,
         *,
         project_id: int | None = None,
         region_id: int | None = None,
-        bootable: bool | NotGiven = NOT_GIVEN,
-        cluster_id: str | NotGiven = NOT_GIVEN,
-        has_attachments: bool | NotGiven = NOT_GIVEN,
-        id_part: str | NotGiven = NOT_GIVEN,
-        instance_id: str | NotGiven = NOT_GIVEN,
-        limit: int | NotGiven = NOT_GIVEN,
-        name_part: str | NotGiven = NOT_GIVEN,
-        offset: int | NotGiven = NOT_GIVEN,
-        tag_key: List[str] | NotGiven = NOT_GIVEN,
-        tag_key_value: str | NotGiven = NOT_GIVEN,
+        image_id: str,
+        name: str,
+        size: int,
+        source: Literal["image"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
-    ) -> AsyncPaginator[Volume, AsyncOffsetPage[Volume]]:
-        """Retrieve a list of volumes in the project and region.
+    ) -> TaskIDList:
+        """Create a new volume in the project and region.
 
-        The list can be filtered
-        by various parameters like bootable status, metadata/tags, attachments, instance
-        ID, name, and ID.
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
 
         Args:
           project_id: Project ID
 
           region_id: Region ID
 
-          bootable: Filter by bootable field
-
-          cluster_id: Filter volumes by k8s cluster ID
+          image_id: Image ID
 
-          has_attachments: Filter by the presence of attachments
+          name: Volume name
 
-          id_part: Filter the volume list result by the ID part of the volume
+          size: Volume size in GiB
 
-          instance_id: Filter volumes by instance ID
+          source: Volume source type
 
-          limit: Optional. Limit the number of returned items
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
 
-          name_part: Filter volumes by `name_part` inclusion in volume name.Any substring can be used
-              and volumes will be returned with names containing the substring.
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
 
-          offset: Optional. Offset value is used to exclude the first set of records from the
-              result
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
 
-          tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
 
-          tag_key_value: Optional. Filter by tag key-value pairs.
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
 
           extra_headers: Send extra headers
 
@@ -1262,7 +1353,337 @@ class AsyncVolumesResource(AsyncAPIResource):
 
           timeout: Override the client-level default timeout for this request, in seconds
         """
-        if project_id is None:
+        ...
+
+    @overload
+    async def create(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str,
+        snapshot_id: str,
+        source: Literal["snapshot"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        size: int | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
+    ) -> TaskIDList:
+        """Create a new volume in the project and region.
+
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          name: Volume name
+
+          snapshot_id: Snapshot ID
+
+          source: Volume source type
+
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
+
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
+
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
+
+          size: Volume size in GiB. If specified, value must be equal to respective snapshot
+              size
+
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
+
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
+
+          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 create(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str,
+        size: int,
+        source: Literal["new-volume"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
+    ) -> TaskIDList:
+        """Create a new volume in the project and region.
+
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          name: Volume name
+
+          size: Volume size in GiB
+
+          source: Volume source type
+
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
+
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
+
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
+
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
+
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
+
+          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(
+        ["image_id", "name", "size", "source"], ["name", "snapshot_id", "source"], ["name", "size", "source"]
+    )
+    async def create(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        image_id: str | NotGiven = NOT_GIVEN,
+        name: str,
+        size: int | NotGiven = NOT_GIVEN,
+        source: Literal["image"] | Literal["snapshot"] | Literal["new-volume"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | NotGiven = NOT_GIVEN,
+        snapshot_id: 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,
+        extra_query: Query | None = None,
+        extra_body: Body | None = None,
+        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
+    ) -> TaskIDList:
+        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/volumes/{project_id}/{region_id}",
+            body=await async_maybe_transform(
+                {
+                    "image_id": image_id,
+                    "name": name,
+                    "size": size,
+                    "source": source,
+                    "attachment_tag": attachment_tag,
+                    "instance_id_to_attach_to": instance_id_to_attach_to,
+                    "lifecycle_policy_ids": lifecycle_policy_ids,
+                    "tags": tags,
+                    "type_name": type_name,
+                    "snapshot_id": snapshot_id,
+                },
+                volume_create_params.VolumeCreateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TaskIDList,
+        )
+
+    async def update(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        name: str | NotGiven = NOT_GIVEN,
+        tags: Optional[TagUpdateMapParam] | 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,
+    ) -> Volume:
+        """
+        Rename a volume or update tags
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          volume_id: Volume ID
+
+          name: Name
+
+          tags: Update key-value tags using JSON Merge Patch semantics (RFC 7386). Provide
+              key-value pairs to add or update tags. Set tag values to `null` to remove tags.
+              Unspecified tags remain unchanged. Read-only tags are always preserved and
+              cannot be modified. **Examples:**
+
+              - **Add/update tags:**
+                `{'tags': {'environment': 'production', 'team': 'backend'}}` adds new tags or
+                updates existing ones.
+              - **Delete tags:** `{'tags': {'`old_tag`': null}}` removes specific tags.
+              - **Remove all tags:** `{'tags': null}` removes all user-managed tags (read-only
+                tags are preserved).
+              - **Partial update:** `{'tags': {'environment': 'staging'}}` only updates
+                specified tags.
+              - **Mixed operations:**
+                `{'tags': {'environment': 'production', '`cost_center`': 'engineering', '`deprecated_tag`': null}}`
+                adds/updates 'environment' and '`cost_center`' while removing
+                '`deprecated_tag`', preserving other existing tags.
+              - **Replace all:** first delete existing tags with null values, then add new
+                ones in the same request.
+
+          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 volume_id:
+            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
+        return await self._patch(
+            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}",
+            body=await async_maybe_transform(
+                {
+                    "name": name,
+                    "tags": tags,
+                },
+                volume_update_params.VolumeUpdateParams,
+            ),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    def list(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        bootable: bool | NotGiven = NOT_GIVEN,
+        cluster_id: str | NotGiven = NOT_GIVEN,
+        has_attachments: bool | NotGiven = NOT_GIVEN,
+        id_part: str | NotGiven = NOT_GIVEN,
+        instance_id: str | NotGiven = NOT_GIVEN,
+        limit: int | NotGiven = NOT_GIVEN,
+        name_part: str | NotGiven = NOT_GIVEN,
+        offset: int | NotGiven = NOT_GIVEN,
+        tag_key: SequenceNotStr[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.
+        # 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,
+    ) -> AsyncPaginator[Volume, AsyncOffsetPage[Volume]]:
+        """Retrieve a list of volumes in the project and region.
+
+        The list can be filtered
+        by various parameters like bootable status, metadata/tags, attachments, instance
+        ID, name, and ID.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          bootable: Filter by bootable field
+
+          cluster_id: Filter volumes by k8s cluster ID
+
+          has_attachments: Filter by the presence of attachments
+
+          id_part: Filter the volume list result by the ID part of the volume
+
+          instance_id: Filter volumes by instance ID
+
+          limit: Optional. Limit the number of returned items
+
+          name_part: Filter volumes by `name_part` inclusion in volume name.Any substring can be used
+              and volumes will be returned with names containing the substring.
+
+          offset: Optional. Offset value is used to exclude the first set of records from the
+              result
+
+          tag_key: Optional. Filter by tag keys. ?`tag_key`=key1&`tag_key`=key2
+
+          tag_key_value: Optional. Filter by tag key-value pairs.
+
+          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()
@@ -1511,28 +1932,280 @@ class AsyncVolumesResource(AsyncAPIResource):
             cast_to=TaskIDList,
         )
 
-    async def get(
+    async def get(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        # 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,
+    ) -> Volume:
+        """
+        Retrieve detailed information about a specific volume.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          volume_id: Volume ID
+
+          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 volume_id:
+            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
+        return await self._get(
+            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=Volume,
+        )
+
+    async def resize(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        size: int,
+        # 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,
+    ) -> TaskIDList:
+        """Increase the size of a volume.
+
+        The new size must be greater than the current
+        size.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          volume_id: Volume ID
+
+          size: New volume size in GiB
+
+          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 volume_id:
+            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
+        return await self._post(
+            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}/extend",
+            body=await async_maybe_transform({"size": size}, volume_resize_params.VolumeResizeParams),
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=TaskIDList,
+        )
+
+    async def revert_to_last_snapshot(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        # 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,
+    ) -> None:
+        """Revert a volume to its last snapshot.
+
+        The volume must be in an available state
+        to be reverted.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          volume_id: Volume ID
+
+          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 volume_id:
+            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
+        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
+        return await self._post(
+            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}/revert",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=NoneType,
+        )
+
+    @overload
+    async def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        image_id: str,
+        name: str,
+        size: int,
+        source: Literal["image"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
+    ) -> Volume:
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          image_id: Image ID
+
+          name: Volume name
+
+          size: Volume size in GiB
+
+          source: Volume source type
+
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
+
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
+
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
+
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
+
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
+
+          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 create_and_poll(
         self,
-        volume_id: str,
         *,
         project_id: int | None = None,
         region_id: int | None = None,
+        name: str,
+        snapshot_id: str,
+        source: Literal["snapshot"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        size: int | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> Volume:
-        """
-        Retrieve detailed information about a specific volume.
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
+
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
 
         Args:
           project_id: Project ID
 
           region_id: Region ID
 
-          volume_id: Volume ID
+          name: Volume name
+
+          snapshot_id: Snapshot ID
+
+          source: Volume source type
+
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
+
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
+
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
+
+          size: Volume size in GiB. If specified, value must be equal to respective snapshot
+              size
+
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
+
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
 
           extra_headers: Send extra headers
 
@@ -1542,47 +2215,64 @@ class AsyncVolumesResource(AsyncAPIResource):
 
           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 volume_id:
-            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
-        return await self._get(
-            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=Volume,
-        )
+        ...
 
-    async def resize(
+    @overload
+    async def create_and_poll(
         self,
-        volume_id: str,
         *,
         project_id: int | None = None,
         region_id: int | None = None,
+        name: str,
         size: int,
+        source: Literal["new-volume"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
-    ) -> TaskIDList:
-        """Increase the size of a volume.
+    ) -> Volume:
+        """Create a new volume in the project and region and poll for the result. Only the first task will be polled. If you need to poll more tasks, use the `tasks.poll` method.
 
-        The new size must be greater than the current
-        size.
+        The volume can be created from
+        scratch, from an image, or from a snapshot. Optionally attach the volume to an
+        instance during creation.
 
         Args:
           project_id: Project ID
 
           region_id: Region ID
 
-          volume_id: Volume ID
+          name: Volume name
 
-          size: New volume size in GiB
+          size: Volume size in GiB
+
+          source: Volume source type
+
+          attachment_tag: Block device attachment tag (not exposed in the user tags). Only used in
+              conjunction with `instance_id_to_attach_to`
+
+          instance_id_to_attach_to: `instance_id` to attach newly-created volume to
+
+          lifecycle_policy_ids: List of lifecycle policy IDs (snapshot creation schedules) to associate with the
+              volume
+
+          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
+              better organization and management. Some tags are read-only and cannot be
+              modified by the user. Tags are also integrated with cost reports, allowing cost
+              data to be filtered based on tag keys or values.
+
+          type_name: Volume type. Defaults to `standard`. If not specified for source `snapshot`,
+              volume type will be derived from the snapshot volume.
 
           extra_headers: Send extra headers
 
@@ -1592,67 +2282,219 @@ class AsyncVolumesResource(AsyncAPIResource):
 
           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 volume_id:
-            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
-        return await self._post(
-            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}/extend",
-            body=await async_maybe_transform({"size": size}, volume_resize_params.VolumeResizeParams),
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=TaskIDList,
+        ...
+
+    @required_args(
+        ["image_id", "name", "size", "source"], ["name", "snapshot_id", "source"], ["name", "size", "source"]
+    )
+    async def create_and_poll(
+        self,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        image_id: str | NotGiven = NOT_GIVEN,
+        name: str,
+        size: int | NotGiven = NOT_GIVEN,
+        source: Literal["image"] | Literal["snapshot"] | Literal["new-volume"],
+        attachment_tag: str | NotGiven = NOT_GIVEN,
+        instance_id_to_attach_to: str | NotGiven = NOT_GIVEN,
+        lifecycle_policy_ids: Iterable[int] | NotGiven = NOT_GIVEN,
+        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        type_name: Literal["cold", "ssd_hiiops", "ssd_local", "ssd_lowlatency", "standard", "ultra"]
+        | NotGiven = NOT_GIVEN,
+        snapshot_id: str | 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,
+    ) -> Volume:
+        """Create a new volume in the project and region 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: TaskIDList = await self.create(  # type: ignore
+            project_id=project_id,
+            region_id=region_id,
+            image_id=image_id,
+            name=name,
+            size=size,
+            source=source,
+            attachment_tag=attachment_tag,
+            instance_id_to_attach_to=instance_id_to_attach_to,
+            lifecycle_policy_ids=lifecycle_policy_ids,
+            tags=tags,
+            type_name=type_name,
+            snapshot_id=snapshot_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
+        )
+        if not response.tasks:  # type: ignore
+            raise ValueError("Expected at least one task to be created")
+        task = await self._client.cloud.tasks.poll(
+            task_id=response.tasks[0],  # type: ignore
+            extra_headers=extra_headers,
+            polling_interval_seconds=polling_interval_seconds,
+        )
+        if task.created_resources is None or task.created_resources.volumes is None or len(task.created_resources.volumes) != 1:
+            raise ValueError("Task completed but created_resources or volumes is missing or invalid")
+        created_volume_id = task.created_resources.volumes[0]
+        return await self.get(
+            volume_id=created_volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
         )
 
-    async def revert_to_last_snapshot(
+    async def delete_and_poll(
         self,
         volume_id: str,
         *,
         project_id: int | None = None,
         region_id: int | None = None,
+        snapshots: str | 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,
-        timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> None:
-        """Revert a volume to its last snapshot.
-
-        The volume must be in an available state
-        to be reverted.
-
-        Args:
-          project_id: Project ID
-
-          region_id: Region ID
-
-          volume_id: Volume ID
-
-          extra_headers: Send extra headers
+        """Delete a volume and all its snapshots 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(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            snapshots=snapshots,
+            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,
+        )
 
-          extra_query: Add additional query parameters to the request
+    async def attach_to_instance_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        instance_id: str,
+        attachment_tag: str | 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,
+    ) -> None:
+        """Attach the volume to 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."""
+        response = await self.attach_to_instance(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            instance_id=instance_id,
+            attachment_tag=attachment_tag,
+            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,
+        )
 
-          extra_body: Add additional JSON properties to the request
+    async def detach_from_instance_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        instance_id: str,
+        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:
+        """Detach the volume from 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."""
+        response = await self.detach_from_instance(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            instance_id=instance_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,
+        )
 
-          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 volume_id:
-            raise ValueError(f"Expected a non-empty value for `volume_id` but received {volume_id!r}")
-        extra_headers = {"Accept": "*/*", **(extra_headers or {})}
-        return await self._post(
-            f"/cloud/v1/volumes/{project_id}/{region_id}/{volume_id}/revert",
-            options=make_request_options(
-                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
-            ),
-            cast_to=NoneType,
+    async def resize_and_poll(
+        self,
+        volume_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        size: int,
+        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,
+    ) -> Volume:
+        """Increase the size of a volume 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.resize(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            size=size,
+            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(
+            volume_id=volume_id,
+            project_id=project_id,
+            region_id=region_id,
+            extra_headers=extra_headers,
+            extra_query=extra_query,
+            extra_body=extra_body,
+            timeout=timeout,
         )
 
 
@@ -1690,6 +2532,21 @@ class VolumesResourceWithRawResponse:
         self.revert_to_last_snapshot = to_raw_response_wrapper(
             volumes.revert_to_last_snapshot,
         )
+        self.create_and_poll = to_raw_response_wrapper(
+            volumes.create_and_poll,
+        )
+        self.delete_and_poll = to_raw_response_wrapper(
+            volumes.delete_and_poll,
+        )
+        self.attach_to_instance_and_poll = to_raw_response_wrapper(
+            volumes.attach_to_instance_and_poll,
+        )
+        self.detach_from_instance_and_poll = to_raw_response_wrapper(
+            volumes.detach_from_instance_and_poll,
+        )
+        self.resize_and_poll = to_raw_response_wrapper(
+            volumes.resize_and_poll,
+        )
 
 
 class AsyncVolumesResourceWithRawResponse:
@@ -1726,6 +2583,21 @@ class AsyncVolumesResourceWithRawResponse:
         self.revert_to_last_snapshot = async_to_raw_response_wrapper(
             volumes.revert_to_last_snapshot,
         )
+        self.create_and_poll = async_to_raw_response_wrapper(
+            volumes.create_and_poll,
+        )
+        self.delete_and_poll = async_to_raw_response_wrapper(
+            volumes.delete_and_poll,
+        )
+        self.attach_to_instance_and_poll = async_to_raw_response_wrapper(
+            volumes.attach_to_instance_and_poll,
+        )
+        self.detach_from_instance_and_poll = async_to_raw_response_wrapper(
+            volumes.detach_from_instance_and_poll,
+        )
+        self.resize_and_poll = async_to_raw_response_wrapper(
+            volumes.resize_and_poll,
+        )
 
 
 class VolumesResourceWithStreamingResponse:
@@ -1762,6 +2634,21 @@ class VolumesResourceWithStreamingResponse:
         self.revert_to_last_snapshot = to_streamed_response_wrapper(
             volumes.revert_to_last_snapshot,
         )
+        self.create_and_poll = to_streamed_response_wrapper(
+            volumes.create_and_poll,
+        )
+        self.delete_and_poll = to_streamed_response_wrapper(
+            volumes.delete_and_poll,
+        )
+        self.attach_to_instance_and_poll = to_streamed_response_wrapper(
+            volumes.attach_to_instance_and_poll,
+        )
+        self.detach_from_instance_and_poll = to_streamed_response_wrapper(
+            volumes.detach_from_instance_and_poll,
+        )
+        self.resize_and_poll = to_streamed_response_wrapper(
+            volumes.resize_and_poll,
+        )
 
 
 class AsyncVolumesResourceWithStreamingResponse:
@@ -1798,3 +2685,18 @@ class AsyncVolumesResourceWithStreamingResponse:
         self.revert_to_last_snapshot = async_to_streamed_response_wrapper(
             volumes.revert_to_last_snapshot,
         )
+        self.create_and_poll = async_to_streamed_response_wrapper(
+            volumes.create_and_poll,
+        )
+        self.delete_and_poll = async_to_streamed_response_wrapper(
+            volumes.delete_and_poll,
+        )
+        self.attach_to_instance_and_poll = async_to_streamed_response_wrapper(
+            volumes.attach_to_instance_and_poll,
+        )
+        self.detach_from_instance_and_poll = async_to_streamed_response_wrapper(
+            volumes.detach_from_instance_and_poll,
+        )
+        self.resize_and_poll = async_to_streamed_response_wrapper(
+            volumes.resize_and_poll,
+        )