lightning-sdk 0.2.13__py3-none-any.whl → 0.2.15__py3-none-any.whl

lightning_sdk/cli/serve.py

@@ -1,5 +1,6 @@
 import concurrent.futures
 import os
+import re
 import socket
 import subprocess
 import time
@@ -8,13 +9,14 @@ from datetime import datetime
 from enum import Enum
 from pathlib import Path
 from threading import Thread
-from typing import Dict, List, Optional, TypedDict, Union
+from typing import Any, Dict, List, Optional, TypedDict, Union
 from urllib.parse import urlencode
 
 import click
 from rich.console import Console
 from rich.progress import Progress, SpinnerColumn, TextColumn, TimeElapsedColumn
 from rich.prompt import Confirm
+from rich.syntax import Syntax
 
 from lightning_sdk import Machine, Teamspace
 from lightning_sdk.api import UserApi
@@ -53,12 +55,12 @@ def deploy() -> None:
     """Deploy a LitServe model.
 
     Example:
-        lightning deploy server.py  # deploy to the cloud
+        lightning deploy server.py --cloud # deploy to the cloud
 
     Example:
-        lightning deploy server.py --local  # run locally
+        lightning deploy server.py  # run locally
 
-    You can deploy the API to the cloud by running `lightning deploy server.py`.
+    You can deploy the API to the cloud by running `lightning deploy server.py --cloud`.
     This will build a docker container for the server.py script and deploy it to the Lightning AI platform.
     """
 
@@ -73,11 +75,11 @@ def deploy() -> None:
     help="Generate a client for the model",
 )
 @click.option(
-    "--local",
+    "--cloud",
     is_flag=True,
     default=False,
     flag_value=True,
-    help="Run the model locally",
+    help="Run the model on cloud",
 )
 @click.option("--name", default=None, help="Name of the deployed API (e.g., 'classification-api', 'Llama-api')")
 @click.option(
@@ -133,7 +135,7 @@ def deploy() -> None:
 @click.option("--port", default=8000, help="The port to expose the API on.")
 @click.option("--min_replica", "--min-replica", default=0, help="Number of replicas to start with.")
 @click.option("--max_replica", "--max-replica", default=1, help="Number of replicas to scale up to.")
-@click.option("--replicas", "--replicas", default=1, help="Deployment will start with this many replicas.")
+@click.option("--replicas", default=1, help="Deployment will start with this many replicas.")
 @click.option(
     "--no_credentials",
     "--no-credentials",
@@ -145,7 +147,7 @@ def deploy() -> None:
 def api(
     script_path: str,
     easy: bool,
-    local: bool,
+    cloud: bool,
     name: Optional[str],
     non_interactive: bool,
     machine: Optional[str],
@@ -165,7 +167,7 @@ def api(
     return api_impl(
         script_path=script_path,
         easy=easy,
-        local=local,
+        cloud=cloud,
         name=name,
         non_interactive=non_interactive,
         machine=machine,
@@ -186,7 +188,7 @@ def api(
 def api_impl(
     script_path: Union[str, Path],
     easy: bool = False,
-    local: bool = False,
+    cloud: bool = False,
     name: Optional[str] = None,
     tag: Optional[str] = None,
     non_interactive: bool = False,
@@ -217,7 +219,7 @@ def api_impl(
         timestr = datetime.now().strftime("%b-%d-%H_%M")
         name = f"litserve-{timestr}".lower()
 
-    if local:
+    if not cloud:
         try:
             subprocess.run(
                 ["python", str(script_path)],
@@ -253,16 +255,26 @@ def api_impl(
     )
 
 
+class _AuthMode(Enum):
+    DEVBOX = "dev"
+    DEPLOY = "deploy"
+
+
 class _AuthServer(AuthServer):
+    def __init__(self, mode: _AuthMode, *args: Any, **kwargs: Any) -> None:
+        self._mode = mode
+        super().__init__(*args, **kwargs)
+
     def get_auth_url(self, port: int) -> str:
         redirect_uri = f"http://localhost:{port}/login-complete"
-        params = urlencode({"redirectTo": redirect_uri, "okbhrt": LITSERVE_CODE})
+        params = urlencode({"redirectTo": redirect_uri, "mode": self._mode.value, "okbhrt": LITSERVE_CODE})
         return f"{env.LIGHTNING_CLOUD_URL}/sign-in?{params}"
 
 
 class _Auth(Auth):
-    def __init__(self, shall_confirm: bool = False) -> None:
+    def __init__(self, mode: _AuthMode, shall_confirm: bool = False) -> None:
         super().__init__()
+        self._mode = mode
         self._shall_confirm = shall_confirm
 
     def _run_server(self) -> None:
@@ -278,11 +290,11 @@ class _Auth(Auth):
         print("Opening browser for authentication...")
         print("Please come back to the terminal after logging in.")
         time.sleep(3)
-        _AuthServer().login_with_browser(self)
+        _AuthServer(self._mode).login_with_browser(self)
 
 
-def authenticate(shall_confirm: bool = True) -> None:
-    auth = _Auth(shall_confirm)
+def authenticate(mode: _AuthMode, shall_confirm: bool = True) -> None:
+    auth = _Auth(mode, shall_confirm)
     auth.authenticate()
 
 
@@ -485,12 +497,23 @@ class _LitServeDevbox:
                     progress.update(upload_task, advance=1)
 
 
+def _detect_port(script_path: Path) -> int:
+    with open(script_path) as f:
+        content = f.read()
+
+    # Try to match server.run first and then any variable name and then default port=8000
+    match = re.search(r"server\.run\s*\([^)]*port\s*=\s*(\d+)", content) or re.search(
+        r"\w+\.run\s*\([^)]*port\s*=\s*(\d+)", content
+    )
+    return int(match.group(1)) if match else 8000
+
+
 def _handle_devbox(
     name: str,
     script_path: Path,
     console: Console,
     non_interactive: bool = False,
-    devbox: Machine = "CPU",
+    devbox: Union[Machine, str] = Machine.CPU,
     interruptible: bool = False,
     teamspace: Optional[str] = None,
     org: Optional[str] = None,
@@ -500,46 +523,75 @@ def _handle_devbox(
         console.print("❌ Error: Only Python files (.py) are supported for development servers", style="red")
         return
 
-    resolved_teamspace = select_teamspace(teamspace, org, user)
+    authenticate(_AuthMode.DEVBOX, shall_confirm=not non_interactive)
+    user_status = poll_verified_status()
+    if not user_status["verified"]:
+        console.print("❌ Verify phone number to continue. Visit lightning.ai.", style="red")
+        return
+    if not user_status["onboarded"]:
+        console.print("onboarding user")
+        onboarding = _Onboarding(console)
+        resolved_teamspace = onboarding.select_teamspace(teamspace, org, user)
+    else:
+        resolved_teamspace = select_teamspace(teamspace, org, user)
     studio = Studio(name=name, teamspace=resolved_teamspace)
+    studio.install_plugin("custom-port")
     lit_devbox = _LitServeDevbox()
 
     studio_url = _get_studio_url(studio, turn_on=True)
     pathlib_path = Path(script_path).resolve()
-    ok = False
+    browser_opened = False
     studio_path = f"{studio.owner.name}/{studio.teamspace.name}/{studio.name}"
 
     console.print("\n=== Lightning Studio Setup ===")
     console.print(f"🔧 [bold]Setting up Studio:[/bold] {studio_path}")
     console.print(f"📁 [bold]Local project:[/bold] {pathlib_path.parent}")
 
-    upload_state = lit_devbox.resolve_previous_upload(studio, pathlib_path.parent)
+    upload_state = lit_devbox.resolve_previous_upload(studio, str(pathlib_path.parent))
     if non_interactive:
         console.print(f"🌐 [bold]Opening Studio:[/bold] [link={studio_url}]{studio_url}[/link]")
-        ok = webbrowser.open(studio_url)
+        browser_opened = webbrowser.open(studio_url)
     else:
         if Confirm.ask("Would you like to open your Studio in the browser?", default=True):
             console.print(f"🌐 [bold]Opening Studio:[/bold] [link={studio_url}]{studio_url}[/link]")
-            ok = webbrowser.open(studio_url)
+            browser_opened = webbrowser.open(studio_url)
 
-    if not ok:
+    if not browser_opened:
         console.print(f"🔗 [bold]Access Studio:[/bold] [link={studio_url}]{studio_url}[/link]")
 
-    console.print("\n⚡ Initializing Studio (this typically takes 1-2 minutes)...")
-    studio.start(machine=devbox, interruptible=interruptible)
-    studio.install_plugin("custom-port")
-    console.print("🔌 Configuring server port...")
-    studio.run_plugin("custom-port", port=8000)  # TODO: Remove hardcoded port and fetch from LitServe
+    # Start the Studio in the background and return immediately using threading
+    console.print("\n⚡ Initializing Studio in the background...")
+    studio_thread = Thread(target=studio.start, args=(devbox, interruptible))
+    studio_thread.start()
 
     console.print("📤 Syncing project files to Studio...")
     lit_devbox.upload_folder(studio, pathlib_path.parent, upload_state)
 
+    # Wait for the Studio to start
+    console.print("⚡ Waiting for Studio to start...")
+    studio_thread.join()
+
+    try:
+        console.print("🚀 Starting server...")
+        studio.run_and_detach(f"python {script_path}", timeout=10)
+    except Exception as e:
+        console.print("❌ Error while starting server", style="red")
+        syntax = Syntax(f"{e}", "bash", theme="monokai")
+        console.print(syntax)
+        console.print(f"\n🔄 [bold]To fix:[/bold] Edit your code in Studio and run with: [u]python {script_path}[/u]")
+        return
+
+    port = _detect_port(pathlib_path)
+    console.print("🔌 Configuring server port...")
+    port_url = studio.run_plugin("custom-port", port=port)
+
     # Add completion message with next steps
     console.print("\n✅ Studio ready!")
     console.print("\n📋 [bold]Next steps:[/bold]")
     console.print("  [bold]1.[/bold] Server code will be available in the Studio")
     console.print("  [bold]2.[/bold] The Studio is now running with the specified configuration")
     console.print("  [bold]3.[/bold] Modify and run your server directly in the Studio")
+    console.print(f"  [bold]4.[/bold] Your server will be accessible on [link={port_url}]{port_url}[/link]")
     # TODO: Once server running is implemented
 
 
@@ -563,7 +615,7 @@ def _handle_cloud(
 ) -> None:
     if not is_connected():
         console.print("❌ Internet connection required to deploy to the cloud.", style="red")
-        console.print("To run locally instead, use: `lightning serve [SCRIPT | server.py] --local`")
+        console.print("To run locally instead, use: `lightning serve [SCRIPT | server.py]`")
         return
 
     deployment_name = os.path.basename(repository)
@@ -605,7 +657,7 @@ def _handle_cloud(
     # Push the container to the registry
     console.print("\nPushing container to registry. It may take a while...", style="bold")
     # Authenticate with LitServe affiliate
-    authenticate(shall_confirm=not non_interactive)
+    authenticate(_AuthMode.DEPLOY, shall_confirm=not non_interactive)
     user_status = poll_verified_status()
     cloudspace_id: Optional[str] = None
     from_onboarding = False

lightning_sdk/cli/teamspace_menu.py

@@ -22,7 +22,15 @@ class _TeamspacesMenu:
     def _get_teamspace_from_name(
         self, teamspace: str, possible_teamspaces: Dict[str, Dict[str, str]]
     ) -> Dict[str, str]:
-        owner, name = teamspace.split("/", maxsplit=1)
+        try:
+            owner, name = teamspace.split("/", maxsplit=1)
+        except ValueError as e:
+            raise ValueError(
+                f"Invalid teamspace format: '{teamspace}'. "
+                "Teamspace should be specified as '{teamspace_owner}/{teamspace_name}' "
+                "(e.g., 'my-org/my-teamspace')."
+            ) from e
+
         for _, ts in possible_teamspaces.items():
             if ts["name"] == name and (ts["user"] == owner or ts["org"] == owner):
                 return ts

lightning_sdk/cli/upload.py

@@ -125,7 +125,6 @@ def file(path: str, studio: Optional[str] = None, remote_path: Optional[str] = N
     help="The name of the cloud account to store the Container in.",
 )
 @click.option(
-    "--platform",
     "--platform",
     default="linux/amd64",
     help="This is the platform the container pulled and push to Lightning AI will run on.",

lightning_sdk/lightning_cloud/openapi/__init__.py

@@ -49,6 +49,7 @@ from lightning_sdk.lightning_cloud.openapi.api.models_store_api import ModelsSto
 from lightning_sdk.lightning_cloud.openapi.api.organizations_service_api import OrganizationsServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.pipeline_templates_service_api import PipelineTemplatesServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.pipelines_service_api import PipelinesServiceApi
+from lightning_sdk.lightning_cloud.openapi.api.product_license_service_api import ProductLicenseServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.profiler_service_api import ProfilerServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.projects_service_api import ProjectsServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.quest_service_api import QuestServiceApi
@@ -281,8 +282,10 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_code_version_st
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_cold_start_metrics import V1CloudSpaceColdStartMetrics
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_cold_start_metrics_stats import V1CloudSpaceColdStartMetricsStats
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_engagement_response import V1CloudSpaceEngagementResponse
+from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_environment_config import V1CloudSpaceEnvironmentConfig
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_environment_template import V1CloudSpaceEnvironmentTemplate
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_environment_template_config import V1CloudSpaceEnvironmentTemplateConfig
+from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_environment_type import V1CloudSpaceEnvironmentType
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_instance_collab_status import V1CloudSpaceInstanceCollabStatus
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_instance_config import V1CloudSpaceInstanceConfig
 from lightning_sdk.lightning_cloud.openapi.models.v1_cloud_space_instance_startup_status import V1CloudSpaceInstanceStartupStatus
@@ -310,6 +313,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_state import V1Clus
 from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_status import V1ClusterStatus
 from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_tagging_options import V1ClusterTaggingOptions
 from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_type import V1ClusterType
+from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_upload import V1ClusterUpload
 from lightning_sdk.lightning_cloud.openapi.models.v1_cluster_usage_restriction import V1ClusterUsageRestriction
 from lightning_sdk.lightning_cloud.openapi.models.v1_collab_action import V1CollabAction
 from lightning_sdk.lightning_cloud.openapi.models.v1_collab_session import V1CollabSession
@@ -496,6 +500,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_gallery_app import V1Galler
 from lightning_sdk.lightning_cloud.openapi.models.v1_gallery_component import V1GalleryComponent
 from lightning_sdk.lightning_cloud.openapi.models.v1_gcp_data_connection import V1GcpDataConnection
 from lightning_sdk.lightning_cloud.openapi.models.v1_gcp_data_connection_setup import V1GcpDataConnectionSetup
+from lightning_sdk.lightning_cloud.openapi.models.v1_ge_list_deployment_routing_telemetry_response import V1GeListDeploymentRoutingTelemetryResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_generate_ssh_key_pair_request import V1GenerateSSHKeyPairRequest
 from lightning_sdk.lightning_cloud.openapi.models.v1_get_affiliate_link_response import V1GetAffiliateLinkResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_get_agent_job_env_response import V1GetAgentJobEnvResponse
@@ -660,6 +665,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_list_org_roles_response imp
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_organization_cluster_encryption_keys_response import V1ListOrganizationClusterEncryptionKeysResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_organizations_response import V1ListOrganizationsResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_pipelines_response import V1ListPipelinesResponse
+from lightning_sdk.lightning_cloud.openapi.models.v1_list_product_licenses_response import V1ListProductLicensesResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_profiler_captures_response import V1ListProfilerCapturesResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_project_artifacts_response import V1ListProjectArtifactsResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_list_project_cluster_accelerators_response import V1ListProjectClusterAcceleratorsResponse
@@ -716,6 +722,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_metrics_tracker import V1Me
 from lightning_sdk.lightning_cloud.openapi.models.v1_model import V1Model
 from lightning_sdk.lightning_cloud.openapi.models.v1_model_file import V1ModelFile
 from lightning_sdk.lightning_cloud.openapi.models.v1_model_version_archive import V1ModelVersionArchive
+from lightning_sdk.lightning_cloud.openapi.models.v1_modify_filesystem_volume_response import V1ModifyFilesystemVolumeResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_mount_target import V1MountTarget
 from lightning_sdk.lightning_cloud.openapi.models.v1_multi_machine_job import V1MultiMachineJob
 from lightning_sdk.lightning_cloud.openapi.models.v1_multi_machine_job_event import V1MultiMachineJobEvent
@@ -749,6 +756,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_parameter import V
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_parameter_placement import V1PipelineParameterPlacement
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_parameter_placement_type import V1PipelineParameterPlacementType
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_parameter_type import V1PipelineParameterType
+from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_state import V1PipelineState
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_step import V1PipelineStep
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_step_status import V1PipelineStepStatus
 from lightning_sdk.lightning_cloud.openapi.models.v1_pipeline_step_type import V1PipelineStepType
@@ -758,6 +766,8 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_plugin import V1Plugin
 from lightning_sdk.lightning_cloud.openapi.models.v1_plugins_list_response import V1PluginsListResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_post_cloud_space_artifact_events_response import V1PostCloudSpaceArtifactEventsResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_presigned_url import V1PresignedUrl
+from lightning_sdk.lightning_cloud.openapi.models.v1_product_license import V1ProductLicense
+from lightning_sdk.lightning_cloud.openapi.models.v1_product_license_check_response import V1ProductLicenseCheckResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_profiler_capture import V1ProfilerCapture
 from lightning_sdk.lightning_cloud.openapi.models.v1_profiler_enabled_response import V1ProfilerEnabledResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_project import V1Project
@@ -867,6 +877,7 @@ from lightning_sdk.lightning_cloud.openapi.models.v1_transfer_org_balance_respon
 from lightning_sdk.lightning_cloud.openapi.models.v1_transfer_project_balance_response import V1TransferProjectBalanceResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_transfer_user_balance_request import V1TransferUserBalanceRequest
 from lightning_sdk.lightning_cloud.openapi.models.v1_transfer_user_balance_response import V1TransferUserBalanceResponse
+from lightning_sdk.lightning_cloud.openapi.models.v1_trigger_filesystem_upgrade_response import V1TriggerFilesystemUpgradeResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_unpublish_cloud_space_response import V1UnpublishCloudSpaceResponse
 from lightning_sdk.lightning_cloud.openapi.models.v1_update_agent_status_request import V1UpdateAgentStatusRequest
 from lightning_sdk.lightning_cloud.openapi.models.v1_update_agent_status_response import V1UpdateAgentStatusResponse

lightning_sdk/lightning_cloud/openapi/api/__init__.py

@@ -30,6 +30,7 @@ from lightning_sdk.lightning_cloud.openapi.api.models_store_api import ModelsSto
 from lightning_sdk.lightning_cloud.openapi.api.organizations_service_api import OrganizationsServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.pipeline_templates_service_api import PipelineTemplatesServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.pipelines_service_api import PipelinesServiceApi
+from lightning_sdk.lightning_cloud.openapi.api.product_license_service_api import ProductLicenseServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.profiler_service_api import ProfilerServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.projects_service_api import ProjectsServiceApi
 from lightning_sdk.lightning_cloud.openapi.api.quest_service_api import QuestServiceApi

lightning_sdk/lightning_cloud/openapi/api/billing_service_api.py

@@ -942,6 +942,8 @@ class BillingServiceApi(object):
         :param datetime to:
         :param str user_id:
         :param str time_zone:
+        :param int limit:
+        :param datetime search_after:
         :return: V1UsageReport
                  If the method is called asynchronously,
                  returns the request thread.
@@ -971,12 +973,14 @@ class BillingServiceApi(object):
         :param datetime to:
         :param str user_id:
         :param str time_zone:
+        :param int limit:
+        :param datetime search_after:
         :return: V1UsageReport
                  If the method is called asynchronously,
                  returns the request thread.
         """
 
-        all_params = ['org_id', 'project_id', 'cluster_id', 'resource_type', 'resource_id', '_from', 'to', 'user_id', 'time_zone']  # noqa: E501
+        all_params = ['org_id', 'project_id', 'cluster_id', 'resource_type', 'resource_id', '_from', 'to', 'user_id', 'time_zone', 'limit', 'search_after']  # noqa: E501
         all_params.append('async_req')
         all_params.append('_return_http_data_only')
         all_params.append('_preload_content')
@@ -1015,6 +1019,10 @@ class BillingServiceApi(object):
             query_params.append(('userId', params['user_id']))  # noqa: E501
         if 'time_zone' in params:
             query_params.append(('timeZone', params['time_zone']))  # noqa: E501
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+        if 'search_after' in params:
+            query_params.append(('searchAfter', params['search_after']))  # noqa: E501
 
         header_params = {}
 

lightning_sdk/lightning_cloud/openapi/api/cloud_space_service_api.py

@@ -6122,6 +6122,127 @@ class CloudSpaceServiceApi(object):
             _request_timeout=params.get('_request_timeout'),
             collection_formats=collection_formats)
 
+    def cloud_space_service_list_cloud_spaces_bulk(self, **kwargs) -> 'V1ListCloudSpacesResponse':  # noqa: E501
+        """cloud_space_service_list_cloud_spaces_bulk  # noqa: E501
+
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.cloud_space_service_list_cloud_spaces_bulk(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param str project_id:
+        :param str cluster_id:
+        :param str page_token:
+        :param str limit:
+        :param str name:
+        :param str user_id:
+        :param bool active_only:
+        :param bool is_favorite:
+        :param bool is_locked:
+        :return: V1ListCloudSpacesResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+        kwargs['_return_http_data_only'] = True
+        if kwargs.get('async_req'):
+            return self.cloud_space_service_list_cloud_spaces_bulk_with_http_info(**kwargs)  # noqa: E501
+        else:
+            (data) = self.cloud_space_service_list_cloud_spaces_bulk_with_http_info(**kwargs)  # noqa: E501
+            return data
+
+    def cloud_space_service_list_cloud_spaces_bulk_with_http_info(self, **kwargs) -> 'V1ListCloudSpacesResponse':  # noqa: E501
+        """cloud_space_service_list_cloud_spaces_bulk  # noqa: E501
+
+        This method makes a synchronous HTTP request by default. To make an
+        asynchronous HTTP request, please pass async_req=True
+        >>> thread = api.cloud_space_service_list_cloud_spaces_bulk_with_http_info(async_req=True)
+        >>> result = thread.get()
+
+        :param async_req bool
+        :param str project_id:
+        :param str cluster_id:
+        :param str page_token:
+        :param str limit:
+        :param str name:
+        :param str user_id:
+        :param bool active_only:
+        :param bool is_favorite:
+        :param bool is_locked:
+        :return: V1ListCloudSpacesResponse
+                 If the method is called asynchronously,
+                 returns the request thread.
+        """
+
+        all_params = ['project_id', 'cluster_id', 'page_token', 'limit', 'name', 'user_id', 'active_only', 'is_favorite', 'is_locked']  # noqa: E501
+        all_params.append('async_req')
+        all_params.append('_return_http_data_only')
+        all_params.append('_preload_content')
+        all_params.append('_request_timeout')
+
+        params = locals()
+        for key, val in six.iteritems(params['kwargs']):
+            if key not in all_params:
+                raise TypeError(
+                    "Got an unexpected keyword argument '%s'"
+                    " to method cloud_space_service_list_cloud_spaces_bulk" % key
+                )
+            params[key] = val
+        del params['kwargs']
+
+        collection_formats = {}
+
+        path_params = {}
+
+        query_params = []
+        if 'project_id' in params:
+            query_params.append(('projectId', params['project_id']))  # noqa: E501
+        if 'cluster_id' in params:
+            query_params.append(('clusterId', params['cluster_id']))  # noqa: E501
+        if 'page_token' in params:
+            query_params.append(('pageToken', params['page_token']))  # noqa: E501
+        if 'limit' in params:
+            query_params.append(('limit', params['limit']))  # noqa: E501
+        if 'name' in params:
+            query_params.append(('name', params['name']))  # noqa: E501
+        if 'user_id' in params:
+            query_params.append(('userId', params['user_id']))  # noqa: E501
+        if 'active_only' in params:
+            query_params.append(('activeOnly', params['active_only']))  # noqa: E501
+        if 'is_favorite' in params:
+            query_params.append(('isFavorite', params['is_favorite']))  # noqa: E501
+        if 'is_locked' in params:
+            query_params.append(('isLocked', params['is_locked']))  # noqa: E501
+
+        header_params = {}
+
+        form_params = []
+        local_var_files = {}
+
+        body_params = None
+        # HTTP header `Accept`
+        header_params['Accept'] = self.api_client.select_header_accept(
+            ['application/json'])  # noqa: E501
+
+        # Authentication setting
+        auth_settings = []  # noqa: E501
+
+        return self.api_client.call_api(
+            '/v1/cloudspaces', 'GET',
+            path_params,
+            query_params,
+            header_params,
+            body=body_params,
+            post_params=form_params,
+            files=local_var_files,
+            response_type='V1ListCloudSpacesResponse',  # noqa: E501
+            auth_settings=auth_settings,
+            async_req=params.get('async_req'),
+            _return_http_data_only=params.get('_return_http_data_only'),
+            _preload_content=params.get('_preload_content', True),
+            _request_timeout=params.get('_request_timeout'),
+            collection_formats=collection_formats)
+
     def cloud_space_service_list_installed_plugins(self, project_id: 'str', id: 'str', **kwargs) -> 'V1PluginsListResponse':  # noqa: E501
         """cloud_space_service_list_installed_plugins  # noqa: E501