gcore 0.3.0__py3-none-any.whl → 0.5.0__py3-none-any.whl

gcore/resources/cloud/gpu_baremetal_clusters/gpu_baremetal_clusters.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import List, Iterable, Optional
+from typing import Dict, List, Iterable, Optional
 
 import httpx
 
@@ -58,7 +58,6 @@ from ....types.cloud import (
 )
 from ...._base_client import AsyncPaginator, make_request_options
 from ....types.cloud.task_id_list import TaskIDList
-from ....types.cloud.tag_update_map_param import TagUpdateMapParam
 from ....types.cloud.gpu_baremetal_cluster import GPUBaremetalCluster
 from ....types.cloud.gpu_baremetal_cluster_server_list import GPUBaremetalClusterServerList
 
@@ -113,7 +112,7 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         instances_count: int | NotGiven = NOT_GIVEN,
         password: str | NotGiven = NOT_GIVEN,
         ssh_key_name: str | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -123,8 +122,10 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Create bare metal GPU cluster
+        """Create a new GPU cluster with specified configuration.
+
+        The cluster can be
+        created with one or more nodes.
 
         Args:
           flavor: Flavor name
@@ -143,7 +144,7 @@ class GPUBaremetalClustersResource(SyncAPIResource):
               instance
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/cloud/ssh-keys/add-or-generate-ssh-key).
 
           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
@@ -440,8 +441,10 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        All cluster nodes must be specified to update the cluster image.
+        """Rebuild one or more nodes in a GPU cluster.
+
+        All cluster nodes must be specified
+        to update the cluster image.
 
         Args:
           nodes: List of nodes uuids to be rebuild
@@ -496,8 +499,10 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Resize bare metal GPU cluster
+        """Change the number of nodes in a GPU cluster.
+
+        The cluster can be scaled up or
+        down.
 
         Args:
           instances_count: Resized (total) number of instances
@@ -515,7 +520,7 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         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}")            
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
         return self._post(
             f"/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}/{cluster_id}/resize",
             body=maybe_transform(
@@ -539,7 +544,7 @@ class GPUBaremetalClustersResource(SyncAPIResource):
         name: str,
         instances_count: int | NotGiven = NOT_GIVEN,
         ssh_key_name: str | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -735,7 +740,7 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         instances_count: int | NotGiven = NOT_GIVEN,
         password: str | NotGiven = NOT_GIVEN,
         ssh_key_name: str | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         user_data: str | NotGiven = NOT_GIVEN,
         username: str | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
@@ -745,8 +750,10 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Create bare metal GPU cluster
+        """Create a new GPU cluster with specified configuration.
+
+        The cluster can be
+        created with one or more nodes.
 
         Args:
           flavor: Flavor name
@@ -765,7 +772,7 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
               instance
 
           ssh_key_name: Specifies the name of the SSH keypair, created via the
-              [/v1/`ssh_keys` endpoint](/docs/api-reference/ssh-keys/add-or-generate-ssh-key).
+              [/v1/`ssh_keys` endpoint](/docs/api-reference/cloud/ssh-keys/add-or-generate-ssh-key).
 
           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
@@ -1062,8 +1069,10 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        All cluster nodes must be specified to update the cluster image.
+        """Rebuild one or more nodes in a GPU cluster.
+
+        All cluster nodes must be specified
+        to update the cluster image.
 
         Args:
           nodes: List of nodes uuids to be rebuild
@@ -1118,8 +1127,10 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Resize bare metal GPU cluster
+        """Change the number of nodes in a GPU cluster.
+
+        The cluster can be scaled up or
+        down.
 
         Args:
           instances_count: Resized (total) number of instances
@@ -1137,7 +1148,7 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         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}")            
+            raise ValueError(f"Expected a non-empty value for `cluster_id` but received {cluster_id!r}")
         return await self._post(
             f"/cloud/v1/ai/clusters/gpu/{project_id}/{region_id}/{cluster_id}/resize",
             body=await async_maybe_transform(
@@ -1161,7 +1172,7 @@ class AsyncGPUBaremetalClustersResource(AsyncAPIResource):
         name: str,
         instances_count: int | NotGiven = NOT_GIVEN,
         ssh_key_name: str | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.

gcore/resources/cloud/gpu_baremetal_clusters/images.py

@@ -2,7 +2,7 @@
 
 from __future__ import annotations
 
-from typing import Optional
+from typing import Dict, Optional
 from typing_extensions import Literal
 
 import httpx
@@ -21,7 +21,6 @@ from ...._base_client import make_request_options
 from ....types.cloud.gpu_image import GPUImage
 from ....types.cloud.task_id_list import TaskIDList
 from ....types.cloud.gpu_image_list import GPUImageList
-from ....types.cloud.tag_update_map_param import TagUpdateMapParam
 from ....types.cloud.gpu_baremetal_clusters import image_upload_params
 
 __all__ = ["ImagesResource", "AsyncImagesResource"]
@@ -101,7 +100,7 @@ class ImagesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Delete bare metal GPU image by ID
+        Delete bare metal GPU image
 
         Args:
           project_id: Project ID
@@ -182,7 +181,7 @@ class ImagesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> GPUImage:
         """
-        Get bare metal GPU image by ID
+        Get bare metal GPU image
 
         Args:
           project_id: Project ID
@@ -227,7 +226,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Optional[Literal["linux", "windows"]] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -317,7 +316,7 @@ class ImagesResource(SyncAPIResource):
         os_type: Optional[Literal["linux", "windows"]] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
@@ -444,7 +443,7 @@ class AsyncImagesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
         """
-        Delete bare metal GPU image by ID
+        Delete bare metal GPU image
 
         Args:
           project_id: Project ID
@@ -525,7 +524,7 @@ class AsyncImagesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> GPUImage:
         """
-        Get bare metal GPU image by ID
+        Get bare metal GPU image
 
         Args:
           project_id: Project ID
@@ -570,7 +569,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Optional[Literal["linux", "windows"]] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.
         extra_headers: Headers | None = None,
@@ -660,7 +659,7 @@ class AsyncImagesResource(AsyncAPIResource):
         os_type: Optional[Literal["linux", "windows"]] | NotGiven = NOT_GIVEN,
         os_version: Optional[str] | NotGiven = NOT_GIVEN,
         ssh_key: Literal["allow", "deny", "required"] | NotGiven = NOT_GIVEN,
-        tags: TagUpdateMapParam | NotGiven = NOT_GIVEN,
+        tags: Dict[str, str] | NotGiven = NOT_GIVEN,
         polling_interval_seconds: int | NotGiven = NOT_GIVEN,
         # Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
         # The extra values given here take precedence over values defined on the client or passed to this method.

gcore/resources/cloud/gpu_baremetal_clusters/interfaces.py

@@ -53,7 +53,7 @@ class InterfacesResource(SyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> NetworkInterfaceList:
         """
-        Returns the network interfaces attached to the servers in the cluster.
+        Retrieve a list of network interfaces attached to the GPU cluster servers.
 
         Args:
           extra_headers: Send extra headers
@@ -113,7 +113,7 @@ class AsyncInterfacesResource(AsyncAPIResource):
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> NetworkInterfaceList:
         """
-        Returns the network interfaces attached to the servers in the cluster.
+        Retrieve a list of network interfaces attached to the GPU cluster servers.
 
         Args:
           extra_headers: Send extra headers

gcore/resources/cloud/gpu_baremetal_clusters/servers.py

@@ -65,8 +65,10 @@ class ServersResource(SyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Delete bare metal GPU server from cluster
+        """Delete a specific node from a GPU cluster.
+
+        The node must be in a state that
+        allows deletion.
 
         Args:
           delete_floatings: Set False if you do not want to delete assigned floating IPs. By default, it's
@@ -590,8 +592,10 @@ class AsyncServersResource(AsyncAPIResource):
         extra_body: Body | None = None,
         timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
     ) -> TaskIDList:
-        """
-        Delete bare metal GPU server from cluster
+        """Delete a specific node from a GPU cluster.
+
+        The node must be in a state that
+        allows deletion.
 
         Args:
           delete_floatings: Set False if you do not want to delete assigned floating IPs. By default, it's