databricks-sdk 0.28.0__py3-none-any.whl → 0.29.0__py3-none-any.whl

databricks/sdk/service/marketplace.py

@@ -59,6 +59,38 @@ class AssetType(Enum):
     ASSET_TYPE_UNSPECIFIED = 'ASSET_TYPE_UNSPECIFIED'
 
 
+@dataclass
+class BatchGetListingsResponse:
+    listings: Optional[List[Listing]] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the BatchGetListingsResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.listings: body['listings'] = [v.as_dict() for v in self.listings]
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> BatchGetListingsResponse:
+        """Deserializes the BatchGetListingsResponse from a dictionary."""
+        return cls(listings=_repeated_dict(d, 'listings', Listing))
+
+
+@dataclass
+class BatchGetProvidersResponse:
+    providers: Optional[List[ProviderInfo]] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the BatchGetProvidersResponse into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.providers: body['providers'] = [v.as_dict() for v in self.providers]
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> BatchGetProvidersResponse:
+        """Deserializes the BatchGetProvidersResponse from a dictionary."""
+        return cls(providers=_repeated_dict(d, 'providers', ProviderInfo))
+
+
 class Category(Enum):
 
     ADVERTISING_AND_MARKETING = 'ADVERTISING_AND_MARKETING'
@@ -1265,11 +1297,16 @@ class Listing:
 
     id: Optional[str] = None
 
+    provider_summary: Optional[ProviderListingSummaryInfo] = None
+    """we can not use just ProviderListingSummary since we already have same name on entity side of the
+    state"""
+
     def as_dict(self) -> dict:
         """Serializes the Listing into a dictionary suitable for use as a JSON request body."""
         body = {}
         if self.detail: body['detail'] = self.detail.as_dict()
         if self.id is not None: body['id'] = self.id
+        if self.provider_summary: body['provider_summary'] = self.provider_summary.as_dict()
         if self.summary: body['summary'] = self.summary.as_dict()
         return body
 
@@ -1278,6 +1315,7 @@ class Listing:
         """Deserializes the Listing from a dictionary."""
         return cls(detail=_from_dict(d, 'detail', ListingDetail),
                    id=d.get('id', None),
+                   provider_summary=_from_dict(d, 'provider_summary', ProviderListingSummaryInfo),
                    summary=_from_dict(d, 'summary', ListingSummary))
 
 
@@ -1695,6 +1733,37 @@ class ProviderAnalyticsDashboard:
         return cls(id=d.get('id', None))
 
 
+@dataclass
+class ProviderIconFile:
+    icon_file_id: Optional[str] = None
+
+    icon_file_path: Optional[str] = None
+
+    icon_type: Optional[ProviderIconType] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the ProviderIconFile into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.icon_file_id is not None: body['icon_file_id'] = self.icon_file_id
+        if self.icon_file_path is not None: body['icon_file_path'] = self.icon_file_path
+        if self.icon_type is not None: body['icon_type'] = self.icon_type.value
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> ProviderIconFile:
+        """Deserializes the ProviderIconFile from a dictionary."""
+        return cls(icon_file_id=d.get('icon_file_id', None),
+                   icon_file_path=d.get('icon_file_path', None),
+                   icon_type=_enum(d, 'icon_type', ProviderIconType))
+
+
+class ProviderIconType(Enum):
+
+    DARK = 'DARK'
+    PRIMARY = 'PRIMARY'
+    PROVIDER_ICON_TYPE_UNSPECIFIED = 'PROVIDER_ICON_TYPE_UNSPECIFIED'
+
+
 @dataclass
 class ProviderInfo:
     name: str
@@ -1768,6 +1837,33 @@ class ProviderInfo:
                    term_of_service_link=d.get('term_of_service_link', None))
 
 
+@dataclass
+class ProviderListingSummaryInfo:
+    """we can not use just ProviderListingSummary since we already have same name on entity side of the
+    state"""
+
+    description: Optional[str] = None
+
+    icon_files: Optional[List[ProviderIconFile]] = None
+
+    name: Optional[str] = None
+
+    def as_dict(self) -> dict:
+        """Serializes the ProviderListingSummaryInfo into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.description is not None: body['description'] = self.description
+        if self.icon_files: body['icon_files'] = [v.as_dict() for v in self.icon_files]
+        if self.name is not None: body['name'] = self.name
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> ProviderListingSummaryInfo:
+        """Deserializes the ProviderListingSummaryInfo from a dictionary."""
+        return cls(description=d.get('description', None),
+                   icon_files=_repeated_dict(d, 'icon_files', ProviderIconFile),
+                   name=d.get('name', None))
+
+
 @dataclass
 class RegionInfo:
     cloud: Optional[str] = None
@@ -2532,6 +2628,26 @@ class ConsumerListingsAPI:
     def __init__(self, api_client):
         self._api = api_client
 
+    def batch_get(self, *, ids: Optional[List[str]] = None) -> BatchGetListingsResponse:
+        """Get one batch of listings. One may specify up to 50 IDs per request.
+        
+        Batch get a published listing in the Databricks Marketplace that the consumer has access to.
+        
+        :param ids: List[str] (optional)
+        
+        :returns: :class:`BatchGetListingsResponse`
+        """
+
+        query = {}
+        if ids is not None: query['ids'] = [v for v in ids]
+        headers = {'Accept': 'application/json', }
+
+        res = self._api.do('GET',
+                           '/api/2.1/marketplace-consumer/listings:batchGet',
+                           query=query,
+                           headers=headers)
+        return BatchGetListingsResponse.from_dict(res)
+
     def get(self, id: str) -> GetListingResponse:
         """Get listing.
         
@@ -2780,6 +2896,26 @@ class ConsumerProvidersAPI:
     def __init__(self, api_client):
         self._api = api_client
 
+    def batch_get(self, *, ids: Optional[List[str]] = None) -> BatchGetProvidersResponse:
+        """Get one batch of providers. One may specify up to 50 IDs per request.
+        
+        Batch get a provider in the Databricks Marketplace with at least one visible listing.
+        
+        :param ids: List[str] (optional)
+        
+        :returns: :class:`BatchGetProvidersResponse`
+        """
+
+        query = {}
+        if ids is not None: query['ids'] = [v for v in ids]
+        headers = {'Accept': 'application/json', }
+
+        res = self._api.do('GET',
+                           '/api/2.1/marketplace-consumer/providers:batchGet',
+                           query=query,
+                           headers=headers)
+        return BatchGetProvidersResponse.from_dict(res)
+
     def get(self, id: str) -> GetProviderResponse:
         """Get a provider.
         

databricks/sdk/service/oauth2.py

@@ -160,6 +160,28 @@ class CreateServicePrincipalSecretResponse:
                    update_time=d.get('update_time', None))
 
 
+@dataclass
+class DataPlaneInfo:
+    authorization_details: Optional[str] = None
+    """Authorization details as a string."""
+
+    endpoint_url: Optional[str] = None
+    """The URL of the endpoint for this operation in the dataplane."""
+
+    def as_dict(self) -> dict:
+        """Serializes the DataPlaneInfo into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.authorization_details is not None: body['authorization_details'] = self.authorization_details
+        if self.endpoint_url is not None: body['endpoint_url'] = self.endpoint_url
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> DataPlaneInfo:
+        """Deserializes the DataPlaneInfo from a dictionary."""
+        return cls(authorization_details=d.get('authorization_details', None),
+                   endpoint_url=d.get('endpoint_url', None))
+
+
 @dataclass
 class DeleteCustomAppIntegrationOutput:
 

databricks/sdk/service/pipelines.py

@@ -1242,7 +1242,7 @@ class PipelineLibrary:
     """Specification of a maven library to be installed."""
 
     notebook: Optional[NotebookLibrary] = None
-    """The path to a notebook that defines a pipeline and is stored in the <Databricks> workspace."""
+    """The path to a notebook that defines a pipeline and is stored in the Databricks workspace."""
 
     def as_dict(self) -> dict:
         """Serializes the PipelineLibrary into a dictionary suitable for use as a JSON request body."""

databricks/sdk/service/serving.py

@@ -15,6 +15,8 @@ from ._internal import Wait, _enum, _from_dict, _repeated_dict
 
 _LOG = logging.getLogger('databricks.sdk')
 
+from databricks.sdk.service import oauth2
+
 # all definitions in this file are in alphabetical order
 
 
@@ -100,8 +102,8 @@ class AnthropicConfig:
 @dataclass
 class App:
     name: str
-    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens
-    and be between 2 and 30 characters long. It must be unique within the workspace."""
+    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens.
+    It must be unique within the workspace."""
 
     active_deployment: Optional[AppDeployment] = None
     """The active deployment of the app."""
@@ -118,6 +120,10 @@ class App:
     pending_deployment: Optional[AppDeployment] = None
     """The pending deployment of the app."""
 
+    service_principal_id: Optional[int] = None
+
+    service_principal_name: Optional[str] = None
+
     status: Optional[AppStatus] = None
 
     update_time: Optional[str] = None
@@ -138,6 +144,9 @@ class App:
         if self.description is not None: body['description'] = self.description
         if self.name is not None: body['name'] = self.name
         if self.pending_deployment: body['pending_deployment'] = self.pending_deployment.as_dict()
+        if self.service_principal_id is not None: body['service_principal_id'] = self.service_principal_id
+        if self.service_principal_name is not None:
+            body['service_principal_name'] = self.service_principal_name
         if self.status: body['status'] = self.status.as_dict()
         if self.update_time is not None: body['update_time'] = self.update_time
         if self.updater is not None: body['updater'] = self.updater
@@ -153,6 +162,8 @@ class App:
                    description=d.get('description', None),
                    name=d.get('name', None),
                    pending_deployment=_from_dict(d, 'pending_deployment', AppDeployment),
+                   service_principal_id=d.get('service_principal_id', None),
+                   service_principal_name=d.get('service_principal_name', None),
                    status=_from_dict(d, 'status', AppStatus),
                    update_time=d.get('update_time', None),
                    updater=d.get('updater', None),
@@ -162,7 +173,14 @@ class App:
 @dataclass
 class AppDeployment:
     source_code_path: str
-    """The source code path of the deployment."""
+    """The workspace file system path of the source code used to create the app deployment. This is
+    different from `deployment_artifacts.source_code_path`, which is the path used by the deployed
+    app. The former refers to the original source code location of the app in the workspace during
+    deployment creation, whereas the latter provides a system generated stable snapshotted source
+    code path used by the deployment."""
+
+    mode: AppDeploymentMode
+    """The mode of which the deployment will manage the source code."""
 
     create_time: Optional[str] = None
     """The creation time of the deployment. Formatted timestamp in ISO 6801."""
@@ -189,6 +207,7 @@ class AppDeployment:
         if self.creator is not None: body['creator'] = self.creator
         if self.deployment_artifacts: body['deployment_artifacts'] = self.deployment_artifacts.as_dict()
         if self.deployment_id is not None: body['deployment_id'] = self.deployment_id
+        if self.mode is not None: body['mode'] = self.mode.value
         if self.source_code_path is not None: body['source_code_path'] = self.source_code_path
         if self.status: body['status'] = self.status.as_dict()
         if self.update_time is not None: body['update_time'] = self.update_time
@@ -201,6 +220,7 @@ class AppDeployment:
                    creator=d.get('creator', None),
                    deployment_artifacts=_from_dict(d, 'deployment_artifacts', AppDeploymentArtifacts),
                    deployment_id=d.get('deployment_id', None),
+                   mode=_enum(d, 'mode', AppDeploymentMode),
                    source_code_path=d.get('source_code_path', None),
                    status=_from_dict(d, 'status', AppDeploymentStatus),
                    update_time=d.get('update_time', None))
@@ -209,7 +229,7 @@ class AppDeployment:
 @dataclass
 class AppDeploymentArtifacts:
     source_code_path: Optional[str] = None
-    """The source code of the deployment."""
+    """The snapshotted workspace file system path of the source code loaded by the deployed app."""
 
     def as_dict(self) -> dict:
         """Serializes the AppDeploymentArtifacts into a dictionary suitable for use as a JSON request body."""
@@ -223,9 +243,15 @@ class AppDeploymentArtifacts:
         return cls(source_code_path=d.get('source_code_path', None))
 
 
+class AppDeploymentMode(Enum):
+
+    AUTO_SYNC = 'AUTO_SYNC'
+    MODE_UNSPECIFIED = 'MODE_UNSPECIFIED'
+    SNAPSHOT = 'SNAPSHOT'
+
+
 class AppDeploymentState(Enum):
 
-    CANCELLED = 'CANCELLED'
     FAILED = 'FAILED'
     IN_PROGRESS = 'IN_PROGRESS'
     STATE_UNSPECIFIED = 'STATE_UNSPECIFIED'
@@ -275,15 +301,11 @@ class AppState(Enum):
     CREATING = 'CREATING'
     DELETED = 'DELETED'
     DELETING = 'DELETING'
-    DEPLOYED = 'DEPLOYED'
-    DEPLOYING = 'DEPLOYING'
     ERROR = 'ERROR'
     IDLE = 'IDLE'
-    READY = 'READY'
     RUNNING = 'RUNNING'
     STARTING = 'STARTING'
     STATE_UNSPECIFIED = 'STATE_UNSPECIFIED'
-    UPDATING = 'UPDATING'
 
 
 @dataclass
@@ -311,19 +333,18 @@ class AppStatus:
 class AutoCaptureConfigInput:
     catalog_name: Optional[str] = None
     """The name of the catalog in Unity Catalog. NOTE: On update, you cannot change the catalog name if
-    it was already set."""
+    the inference table is already enabled."""
 
     enabled: Optional[bool] = None
-    """If inference tables are enabled or not. NOTE: If you have already disabled payload logging once,
-    you cannot enable again."""
+    """Indicates whether the inference table is enabled."""
 
     schema_name: Optional[str] = None
     """The name of the schema in Unity Catalog. NOTE: On update, you cannot change the schema name if
-    it was already set."""
+    the inference table is already enabled."""
 
     table_name_prefix: Optional[str] = None
     """The prefix of the table in Unity Catalog. NOTE: On update, you cannot change the prefix name if
-    it was already set."""
+    the inference table is already enabled."""
 
     def as_dict(self) -> dict:
         """Serializes the AutoCaptureConfigInput into a dictionary suitable for use as a JSON request body."""
@@ -349,7 +370,7 @@ class AutoCaptureConfigOutput:
     """The name of the catalog in Unity Catalog."""
 
     enabled: Optional[bool] = None
-    """If inference tables are enabled or not."""
+    """Indicates whether the inference table is enabled."""
 
     schema_name: Optional[str] = None
     """The name of the schema in Unity Catalog."""
@@ -461,7 +482,14 @@ class CohereConfig:
 @dataclass
 class CreateAppDeploymentRequest:
     source_code_path: str
-    """The source code path of the deployment."""
+    """The workspace file system path of the source code used to create the app deployment. This is
+    different from `deployment_artifacts.source_code_path`, which is the path used by the deployed
+    app. The former refers to the original source code location of the app in the workspace during
+    deployment creation, whereas the latter provides a system generated stable snapshotted source
+    code path used by the deployment."""
+
+    mode: AppDeploymentMode
+    """The mode of which the deployment will manage the source code."""
 
     app_name: Optional[str] = None
     """The name of the app."""
@@ -470,20 +498,23 @@ class CreateAppDeploymentRequest:
         """Serializes the CreateAppDeploymentRequest into a dictionary suitable for use as a JSON request body."""
         body = {}
         if self.app_name is not None: body['app_name'] = self.app_name
+        if self.mode is not None: body['mode'] = self.mode.value
         if self.source_code_path is not None: body['source_code_path'] = self.source_code_path
         return body
 
     @classmethod
     def from_dict(cls, d: Dict[str, any]) -> CreateAppDeploymentRequest:
         """Deserializes the CreateAppDeploymentRequest from a dictionary."""
-        return cls(app_name=d.get('app_name', None), source_code_path=d.get('source_code_path', None))
+        return cls(app_name=d.get('app_name', None),
+                   mode=_enum(d, 'mode', AppDeploymentMode),
+                   source_code_path=d.get('source_code_path', None))
 
 
 @dataclass
 class CreateAppRequest:
     name: str
-    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens
-    and be between 2 and 30 characters long. It must be unique within the workspace."""
+    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens.
+    It must be unique within the workspace."""
 
     description: Optional[str] = None
     """The description of the app."""
@@ -1118,6 +1149,23 @@ class ListEndpointsResponse:
         return cls(endpoints=_repeated_dict(d, 'endpoints', ServingEndpoint))
 
 
+@dataclass
+class ModelDataPlaneInfo:
+    query_info: Optional[oauth2.DataPlaneInfo] = None
+    """Information required to query DataPlane API 'query' endpoint."""
+
+    def as_dict(self) -> dict:
+        """Serializes the ModelDataPlaneInfo into a dictionary suitable for use as a JSON request body."""
+        body = {}
+        if self.query_info: body['query_info'] = self.query_info.as_dict()
+        return body
+
+    @classmethod
+    def from_dict(cls, d: Dict[str, any]) -> ModelDataPlaneInfo:
+        """Deserializes the ModelDataPlaneInfo from a dictionary."""
+        return cls(query_info=_from_dict(d, 'query_info', oauth2.DataPlaneInfo))
+
+
 @dataclass
 class OpenAiConfig:
     microsoft_entra_client_id: Optional[str] = None
@@ -2172,6 +2220,9 @@ class ServingEndpointDetailed:
     creator: Optional[str] = None
     """The email of the user who created the serving endpoint."""
 
+    data_plane_info: Optional[ModelDataPlaneInfo] = None
+    """Information required to query DataPlane APIs."""
+
     endpoint_url: Optional[str] = None
     """Endpoint invocation url if route optimization is enabled for endpoint"""
 
@@ -2209,6 +2260,7 @@ class ServingEndpointDetailed:
         if self.config: body['config'] = self.config.as_dict()
         if self.creation_timestamp is not None: body['creation_timestamp'] = self.creation_timestamp
         if self.creator is not None: body['creator'] = self.creator
+        if self.data_plane_info: body['data_plane_info'] = self.data_plane_info.as_dict()
         if self.endpoint_url is not None: body['endpoint_url'] = self.endpoint_url
         if self.id is not None: body['id'] = self.id
         if self.last_updated_timestamp is not None:
@@ -2228,6 +2280,7 @@ class ServingEndpointDetailed:
         return cls(config=_from_dict(d, 'config', EndpointCoreConfigOutput),
                    creation_timestamp=d.get('creation_timestamp', None),
                    creator=d.get('creator', None),
+                   data_plane_info=_from_dict(d, 'data_plane_info', ModelDataPlaneInfo),
                    endpoint_url=d.get('endpoint_url', None),
                    id=d.get('id', None),
                    last_updated_timestamp=d.get('last_updated_timestamp', None),
@@ -2351,6 +2404,12 @@ class ServingEndpointPermissionsRequest:
                    serving_endpoint_id=d.get('serving_endpoint_id', None))
 
 
+@dataclass
+class StartAppRequest:
+    name: Optional[str] = None
+    """The name of the app."""
+
+
 @dataclass
 class StopAppRequest:
     name: Optional[str] = None
@@ -2391,8 +2450,8 @@ class TrafficConfig:
 @dataclass
 class UpdateAppRequest:
     name: str
-    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens
-    and be between 2 and 30 characters long. It must be unique within the workspace."""
+    """The name of the app. The name must contain only lowercase alphanumeric characters and hyphens.
+    It must be unique within the workspace."""
 
     description: Optional[str] = None
     """The description of the app."""
@@ -2521,13 +2580,13 @@ class AppsAPI:
         raise TimeoutError(f'timed out after {timeout}: {status_message}')
 
     def create(self, name: str, *, description: Optional[str] = None) -> Wait[App]:
-        """Create an App.
+        """Create an app.
         
         Creates a new app.
         
         :param name: str
-          The name of the app. The name must contain only lowercase alphanumeric characters and hyphens and be
-          between 2 and 30 characters long. It must be unique within the workspace.
+          The name of the app. The name must contain only lowercase alphanumeric characters and hyphens. It
+          must be unique within the workspace.
         :param description: str (optional)
           The description of the app.
         
@@ -2550,21 +2609,43 @@ class AppsAPI:
                         timeout=timedelta(minutes=20)) -> App:
         return self.create(description=description, name=name).result(timeout=timeout)
 
-    def create_deployment(self, app_name: str, source_code_path: str) -> Wait[AppDeployment]:
-        """Create an App Deployment.
+    def delete(self, name: str):
+        """Delete an app.
+        
+        Deletes an app.
+        
+        :param name: str
+          The name of the app.
+        
+        
+        """
+
+        headers = {'Accept': 'application/json', }
+
+        self._api.do('DELETE', f'/api/2.0/preview/apps/{name}', headers=headers)
+
+    def deploy(self, app_name: str, source_code_path: str, mode: AppDeploymentMode) -> Wait[AppDeployment]:
+        """Create an app deployment.
         
         Creates an app deployment for the app with the supplied name.
         
         :param app_name: str
           The name of the app.
         :param source_code_path: str
-          The source code path of the deployment.
+          The workspace file system path of the source code used to create the app deployment. This is
+          different from `deployment_artifacts.source_code_path`, which is the path used by the deployed app.
+          The former refers to the original source code location of the app in the workspace during deployment
+          creation, whereas the latter provides a system generated stable snapshotted source code path used by
+          the deployment.
+        :param mode: :class:`AppDeploymentMode`
+          The mode of which the deployment will manage the source code.
         
         :returns:
           Long-running operation waiter for :class:`AppDeployment`.
           See :method:wait_get_deployment_app_succeeded for more details.
         """
         body = {}
+        if mode is not None: body['mode'] = mode.value
         if source_code_path is not None: body['source_code_path'] = source_code_path
         headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
 
@@ -2577,28 +2658,16 @@ class AppsAPI:
                     app_name=app_name,
                     deployment_id=op_response['deployment_id'])
 
-    def create_deployment_and_wait(self, app_name: str, source_code_path: str,
-                                   timeout=timedelta(minutes=20)) -> AppDeployment:
-        return self.create_deployment(app_name=app_name,
-                                      source_code_path=source_code_path).result(timeout=timeout)
-
-    def delete(self, name: str):
-        """Delete an App.
-        
-        Deletes an app.
-        
-        :param name: str
-          The name of the app.
-        
-        
-        """
-
-        headers = {'Accept': 'application/json', }
-
-        self._api.do('DELETE', f'/api/2.0/preview/apps/{name}', headers=headers)
+    def deploy_and_wait(self,
+                        app_name: str,
+                        source_code_path: str,
+                        mode: AppDeploymentMode,
+                        timeout=timedelta(minutes=20)) -> AppDeployment:
+        return self.deploy(app_name=app_name, mode=mode,
+                           source_code_path=source_code_path).result(timeout=timeout)
 
     def get(self, name: str) -> App:
-        """Get an App.
+        """Get an app.
         
         Retrieves information for the app with the supplied name.
         
@@ -2614,7 +2683,7 @@ class AppsAPI:
         return App.from_dict(res)
 
     def get_deployment(self, app_name: str, deployment_id: str) -> AppDeployment:
-        """Get an App Deployment.
+        """Get an app deployment.
         
         Retrieves information for the app deployment with the supplied name and deployment id.
         
@@ -2634,7 +2703,7 @@ class AppsAPI:
         return AppDeployment.from_dict(res)
 
     def get_environment(self, name: str) -> AppEnvironment:
-        """Get App Environment.
+        """Get app environment.
         
         Retrieves app environment.
         
@@ -2650,7 +2719,7 @@ class AppsAPI:
         return AppEnvironment.from_dict(res)
 
     def list(self, *, page_size: Optional[int] = None, page_token: Optional[str] = None) -> Iterator[App]:
-        """List Apps.
+        """List apps.
         
         Lists all apps in the workspace.
         
@@ -2681,7 +2750,7 @@ class AppsAPI:
                          *,
                          page_size: Optional[int] = None,
                          page_token: Optional[str] = None) -> Iterator[AppDeployment]:
-        """List App Deployments.
+        """List app deployments.
         
         Lists all app deployments for the app with the supplied name.
         
@@ -2712,8 +2781,24 @@ class AppsAPI:
                 return
             query['page_token'] = json['next_page_token']
 
+    def start(self, name: str) -> AppDeployment:
+        """Start an app.
+        
+        Start the last active deployment of the app in the workspace.
+        
+        :param name: str
+          The name of the app.
+        
+        :returns: :class:`AppDeployment`
+        """
+
+        headers = {'Accept': 'application/json', 'Content-Type': 'application/json', }
+
+        res = self._api.do('POST', f'/api/2.0/preview/apps/{name}/start', headers=headers)
+        return AppDeployment.from_dict(res)
+
     def stop(self, name: str):
-        """Stop an App.
+        """Stop an app.
         
         Stops the active deployment of the app in the workspace.
         
@@ -2728,13 +2813,13 @@ class AppsAPI:
         self._api.do('POST', f'/api/2.0/preview/apps/{name}/stop', headers=headers)
 
     def update(self, name: str, *, description: Optional[str] = None) -> App:
-        """Update an App.
+        """Update an app.
         
         Updates the app with the supplied name.
         
         :param name: str
-          The name of the app. The name must contain only lowercase alphanumeric characters and hyphens and be
-          between 2 and 30 characters long. It must be unique within the workspace.
+          The name of the app. The name must contain only lowercase alphanumeric characters and hyphens. It
+          must be unique within the workspace.
         :param description: str (optional)
           The description of the app.