gcore 0.16.0__py3-none-any.whl → 0.23.0__py3-none-any.whl

gcore/resources/cloud/gpu_virtual_clusters/interfaces.py

@@ -0,0 +1,187 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+import httpx
+
+from ...._types import Body, Query, Headers, NotGiven, not_given
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+from ...._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...._base_client import make_request_options
+from ....types.cloud.gpu_virtual_clusters.gpu_virtual_interface_list import GPUVirtualInterfaceList
+
+__all__ = ["InterfacesResource", "AsyncInterfacesResource"]
+
+
+class InterfacesResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> InterfacesResourceWithRawResponse:
+        """
+        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 InterfacesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> InterfacesResourceWithStreamingResponse:
+        """
+        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 InterfacesResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        cluster_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,
+    ) -> GPUVirtualInterfaceList:
+        """
+        List all network interfaces for servers in a virtual GPU cluster.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return self._get(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/interfaces",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GPUVirtualInterfaceList,
+        )
+
+
+class AsyncInterfacesResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncInterfacesResourceWithRawResponse:
+        """
+        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 AsyncInterfacesResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncInterfacesResourceWithStreamingResponse:
+        """
+        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 AsyncInterfacesResourceWithStreamingResponse(self)
+
+    async def list(
+        self,
+        cluster_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,
+    ) -> GPUVirtualInterfaceList:
+        """
+        List all network interfaces for servers in a virtual GPU cluster.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return await self._get(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/interfaces",
+            options=make_request_options(
+                extra_headers=extra_headers, extra_query=extra_query, extra_body=extra_body, timeout=timeout
+            ),
+            cast_to=GPUVirtualInterfaceList,
+        )
+
+
+class InterfacesResourceWithRawResponse:
+    def __init__(self, interfaces: InterfacesResource) -> None:
+        self._interfaces = interfaces
+
+        self.list = to_raw_response_wrapper(
+            interfaces.list,
+        )
+
+
+class AsyncInterfacesResourceWithRawResponse:
+    def __init__(self, interfaces: AsyncInterfacesResource) -> None:
+        self._interfaces = interfaces
+
+        self.list = async_to_raw_response_wrapper(
+            interfaces.list,
+        )
+
+
+class InterfacesResourceWithStreamingResponse:
+    def __init__(self, interfaces: InterfacesResource) -> None:
+        self._interfaces = interfaces
+
+        self.list = to_streamed_response_wrapper(
+            interfaces.list,
+        )
+
+
+class AsyncInterfacesResourceWithStreamingResponse:
+    def __init__(self, interfaces: AsyncInterfacesResource) -> None:
+        self._interfaces = interfaces
+
+        self.list = async_to_streamed_response_wrapper(
+            interfaces.list,
+        )

gcore/resources/cloud/gpu_virtual_clusters/servers.py

@@ -0,0 +1,506 @@
+# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+from __future__ import annotations
+
+from typing import Union
+from datetime import datetime
+from typing_extensions import Literal
+
+import httpx
+
+from ...._types import Body, Omit, Query, Headers, NotGiven, SequenceNotStr, omit, not_given
+from ...._utils import maybe_transform, async_maybe_transform
+from ...._compat import cached_property
+from ...._resource import SyncAPIResource, AsyncAPIResource
+from ...._response import (
+    to_raw_response_wrapper,
+    to_streamed_response_wrapper,
+    async_to_raw_response_wrapper,
+    async_to_streamed_response_wrapper,
+)
+from ...._base_client import make_request_options
+from ....types.cloud.task_id_list import TaskIDList
+from ....types.cloud.gpu_virtual_clusters import server_list_params, server_delete_params
+from ....types.cloud.gpu_virtual_clusters.gpu_virtual_cluster_server_list import GPUVirtualClusterServerList
+
+__all__ = ["ServersResource", "AsyncServersResource"]
+
+
+class ServersResource(SyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> ServersResourceWithRawResponse:
+        """
+        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 ServersResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> ServersResourceWithStreamingResponse:
+        """
+        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 ServersResourceWithStreamingResponse(self)
+
+    def list(
+        self,
+        cluster_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        changed_before: Union[str, datetime] | Omit = omit,
+        changed_since: Union[str, datetime] | Omit = omit,
+        ip_address: str | Omit = omit,
+        limit: int | Omit = omit,
+        name: str | Omit = omit,
+        offset: int | Omit = omit,
+        order_by: Literal["created_at.asc", "created_at.desc", "status.asc", "status.desc"] | Omit = omit,
+        status: Literal[
+            "ACTIVE",
+            "BUILD",
+            "ERROR",
+            "HARD_REBOOT",
+            "MIGRATING",
+            "PAUSED",
+            "REBOOT",
+            "REBUILD",
+            "RESIZE",
+            "REVERT_RESIZE",
+            "SHELVED",
+            "SHELVED_OFFLOADED",
+            "SHUTOFF",
+            "SOFT_DELETED",
+            "SUSPENDED",
+            "VERIFY_RESIZE",
+        ]
+        | Omit = omit,
+        uuids: SequenceNotStr[str] | Omit = omit,
+        # 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,
+    ) -> GPUVirtualClusterServerList:
+        """
+        List all servers in a virtual GPU cluster.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          changed_before: Filters the results to include only servers whose last change timestamp is less
+              than the specified datetime. Format: ISO 8601.
+
+          changed_since: Filters the results to include only servers whose last change timestamp is
+              greater than or equal to the specified datetime. Format: ISO 8601.
+
+          ip_address: Filter servers by ip address.
+
+          limit: Limit of items on a single page
+
+          name: Filter servers by name. You can provide a full or partial name, servers with
+              matching names will be returned. For example, entering 'test' will return all
+              servers that contain 'test' in their name.
+
+          offset: Offset in results list
+
+          order_by: Order field
+
+          status: Filters servers by status.
+
+          uuids: Filter servers by uuid.
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return self._get(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/servers",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "changed_before": changed_before,
+                        "changed_since": changed_since,
+                        "ip_address": ip_address,
+                        "limit": limit,
+                        "name": name,
+                        "offset": offset,
+                        "order_by": order_by,
+                        "status": status,
+                        "uuids": uuids,
+                    },
+                    server_list_params.ServerListParams,
+                ),
+            ),
+            cast_to=GPUVirtualClusterServerList,
+        )
+
+    def delete(
+        self,
+        server_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        cluster_id: str,
+        all_floating_ips: bool | Omit = omit,
+        all_reserved_fixed_ips: bool | Omit = omit,
+        all_volumes: bool | Omit = omit,
+        floating_ip_ids: SequenceNotStr[str] | Omit = omit,
+        reserved_fixed_ip_ids: SequenceNotStr[str] | Omit = omit,
+        volume_ids: SequenceNotStr[str] | Omit = omit,
+        # 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:
+        """
+        Delete a server from a virtual GPU cluster and its associated resources.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          server_id: Server unique identifier
+
+          all_floating_ips: Flag indicating whether the floating ips associated with server / cluster are
+              deleted
+
+          all_reserved_fixed_ips: Flag indicating whether the reserved fixed ips associated with server / cluster
+              are deleted
+
+          all_volumes: Flag indicating whether all attached volumes are deleted
+
+          floating_ip_ids: Optional list of floating ips to be deleted
+
+          reserved_fixed_ip_ids: Optional list of reserved fixed ips to be deleted
+
+          volume_ids: Optional list of volumes to be deleted
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        if not server_id:
+            raise ValueError(f"Expected a non-empty value for `server_id` but received {server_id!r}")
+        return self._delete(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/servers/{server_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=maybe_transform(
+                    {
+                        "all_floating_ips": all_floating_ips,
+                        "all_reserved_fixed_ips": all_reserved_fixed_ips,
+                        "all_volumes": all_volumes,
+                        "floating_ip_ids": floating_ip_ids,
+                        "reserved_fixed_ip_ids": reserved_fixed_ip_ids,
+                        "volume_ids": volume_ids,
+                    },
+                    server_delete_params.ServerDeleteParams,
+                ),
+            ),
+            cast_to=TaskIDList,
+        )
+
+
+class AsyncServersResource(AsyncAPIResource):
+    @cached_property
+    def with_raw_response(self) -> AsyncServersResourceWithRawResponse:
+        """
+        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 AsyncServersResourceWithRawResponse(self)
+
+    @cached_property
+    def with_streaming_response(self) -> AsyncServersResourceWithStreamingResponse:
+        """
+        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 AsyncServersResourceWithStreamingResponse(self)
+
+    async def list(
+        self,
+        cluster_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        changed_before: Union[str, datetime] | Omit = omit,
+        changed_since: Union[str, datetime] | Omit = omit,
+        ip_address: str | Omit = omit,
+        limit: int | Omit = omit,
+        name: str | Omit = omit,
+        offset: int | Omit = omit,
+        order_by: Literal["created_at.asc", "created_at.desc", "status.asc", "status.desc"] | Omit = omit,
+        status: Literal[
+            "ACTIVE",
+            "BUILD",
+            "ERROR",
+            "HARD_REBOOT",
+            "MIGRATING",
+            "PAUSED",
+            "REBOOT",
+            "REBUILD",
+            "RESIZE",
+            "REVERT_RESIZE",
+            "SHELVED",
+            "SHELVED_OFFLOADED",
+            "SHUTOFF",
+            "SOFT_DELETED",
+            "SUSPENDED",
+            "VERIFY_RESIZE",
+        ]
+        | Omit = omit,
+        uuids: SequenceNotStr[str] | Omit = omit,
+        # 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,
+    ) -> GPUVirtualClusterServerList:
+        """
+        List all servers in a virtual GPU cluster.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          changed_before: Filters the results to include only servers whose last change timestamp is less
+              than the specified datetime. Format: ISO 8601.
+
+          changed_since: Filters the results to include only servers whose last change timestamp is
+              greater than or equal to the specified datetime. Format: ISO 8601.
+
+          ip_address: Filter servers by ip address.
+
+          limit: Limit of items on a single page
+
+          name: Filter servers by name. You can provide a full or partial name, servers with
+              matching names will be returned. For example, entering 'test' will return all
+              servers that contain 'test' in their name.
+
+          offset: Offset in results list
+
+          order_by: Order field
+
+          status: Filters servers by status.
+
+          uuids: Filter servers by uuid.
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        return await self._get(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/servers",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "changed_before": changed_before,
+                        "changed_since": changed_since,
+                        "ip_address": ip_address,
+                        "limit": limit,
+                        "name": name,
+                        "offset": offset,
+                        "order_by": order_by,
+                        "status": status,
+                        "uuids": uuids,
+                    },
+                    server_list_params.ServerListParams,
+                ),
+            ),
+            cast_to=GPUVirtualClusterServerList,
+        )
+
+    async def delete(
+        self,
+        server_id: str,
+        *,
+        project_id: int | None = None,
+        region_id: int | None = None,
+        cluster_id: str,
+        all_floating_ips: bool | Omit = omit,
+        all_reserved_fixed_ips: bool | Omit = omit,
+        all_volumes: bool | Omit = omit,
+        floating_ip_ids: SequenceNotStr[str] | Omit = omit,
+        reserved_fixed_ip_ids: SequenceNotStr[str] | Omit = omit,
+        volume_ids: SequenceNotStr[str] | Omit = omit,
+        # 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:
+        """
+        Delete a server from a virtual GPU cluster and its associated resources.
+
+        Args:
+          project_id: Project ID
+
+          region_id: Region ID
+
+          cluster_id: Cluster unique identifier
+
+          server_id: Server unique identifier
+
+          all_floating_ips: Flag indicating whether the floating ips associated with server / cluster are
+              deleted
+
+          all_reserved_fixed_ips: Flag indicating whether the reserved fixed ips associated with server / cluster
+              are deleted
+
+          all_volumes: Flag indicating whether all attached volumes are deleted
+
+          floating_ip_ids: Optional list of floating ips to be deleted
+
+          reserved_fixed_ip_ids: Optional list of reserved fixed ips to be deleted
+
+          volume_ids: Optional list of volumes to be deleted
+
+          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 cluster_id:
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
+        if not server_id:
+            raise ValueError(f"Expected a non-empty value for `server_id` but received {server_id!r}")
+        return await self._delete(
+            f"/cloud/v3/gpu/virtual/{project_id}/{region_id}/clusters/{cluster_id}/servers/{server_id}",
+            options=make_request_options(
+                extra_headers=extra_headers,
+                extra_query=extra_query,
+                extra_body=extra_body,
+                timeout=timeout,
+                query=await async_maybe_transform(
+                    {
+                        "all_floating_ips": all_floating_ips,
+                        "all_reserved_fixed_ips": all_reserved_fixed_ips,
+                        "all_volumes": all_volumes,
+                        "floating_ip_ids": floating_ip_ids,
+                        "reserved_fixed_ip_ids": reserved_fixed_ip_ids,
+                        "volume_ids": volume_ids,
+                    },
+                    server_delete_params.ServerDeleteParams,
+                ),
+            ),
+            cast_to=TaskIDList,
+        )
+
+
+class ServersResourceWithRawResponse:
+    def __init__(self, servers: ServersResource) -> None:
+        self._servers = servers
+
+        self.list = to_raw_response_wrapper(
+            servers.list,
+        )
+        self.delete = to_raw_response_wrapper(
+            servers.delete,
+        )
+
+
+class AsyncServersResourceWithRawResponse:
+    def __init__(self, servers: AsyncServersResource) -> None:
+        self._servers = servers
+
+        self.list = async_to_raw_response_wrapper(
+            servers.list,
+        )
+        self.delete = async_to_raw_response_wrapper(
+            servers.delete,
+        )
+
+
+class ServersResourceWithStreamingResponse:
+    def __init__(self, servers: ServersResource) -> None:
+        self._servers = servers
+
+        self.list = to_streamed_response_wrapper(
+            servers.list,
+        )
+        self.delete = to_streamed_response_wrapper(
+            servers.delete,
+        )
+
+
+class AsyncServersResourceWithStreamingResponse:
+    def __init__(self, servers: AsyncServersResource) -> None:
+        self._servers = servers
+
+        self.list = async_to_streamed_response_wrapper(
+            servers.list,
+        )
+        self.delete = async_to_streamed_response_wrapper(
+            servers.delete,
+        )