databricks-sdk 0.55.0__py3-none-any.whl → 0.57.0__py3-none-any.whl

databricks/sdk/service/compute.py

@@ -3528,16 +3528,10 @@ class CustomPolicyTag:
     key: str
     """The key of the tag. - Must be unique among all custom tags of the same policy - Cannot be
     “budget-policy-name”, “budget-policy-id” or "budget-policy-resolution-result" - these
-    tags are preserved.
-    
-    - Follows the regex pattern defined in cluster-common/conf/src/ClusterTagConstraints.scala
-    (https://src.dev.databricks.com/databricks/universe@1647196627c8dc7b4152ad098a94b86484b93a6c/-/blob/cluster-common/conf/src/ClusterTagConstraints.scala?L17)"""
+    tags are preserved."""
 
     value: Optional[str] = None
-    """The value of the tag.
-    
-    - Follows the regex pattern defined in cluster-common/conf/src/ClusterTagConstraints.scala
-    (https://src.dev.databricks.com/databricks/universe@1647196627c8dc7b4152ad098a94b86484b93a6c/-/blob/cluster-common/conf/src/ClusterTagConstraints.scala?L24)"""
+    """The value of the tag."""
 
     def as_dict(self) -> dict:
         """Serializes the CustomPolicyTag into a dictionary suitable for use as a JSON request body."""
@@ -4781,25 +4775,19 @@ class Environment:
     non-notebook task, and DLT's environment for classic and serverless pipelines. In this minimal
     environment spec, only pip dependencies are supported."""
 
-    client: str
-    """Client version used by the environment The client is the user-facing environment of the runtime.
-    Each client comes with a specific set of pre-installed libraries. The version is a string,
-    consisting of the major client version."""
+    client: Optional[str] = None
+    """Use `environment_version` instead."""
 
     dependencies: Optional[List[str]] = None
     """List of pip dependencies, as supported by the version of pip in this environment. Each
-    dependency is a pip requirement file line
-    https://pip.pypa.io/en/stable/reference/requirements-file-format/ Allowed dependency could be
-    <requirement specifier>, <archive url/path>, <local project path>(WSFS or Volumes in
-    Databricks), <vcs project url> E.g. dependencies: ["foo==0.0.1", "-r
-    /Workspace/test/requirements.txt"]"""
+    dependency is a valid pip requirements file line per
+    https://pip.pypa.io/en/stable/reference/requirements-file-format/. Allowed dependencies include
+    a requirement specifier, an archive URL, a local project path (such as WSFS or UC Volumes in
+    Databricks), or a VCS project URL."""
 
     environment_version: Optional[str] = None
-    """We renamed `client` to `environment_version` in notebook exports. This field is meant solely so
-    that imported notebooks with `environment_version` can be deserialized correctly, in a
-    backwards-compatible way (i.e. if `client` is specified instead of `environment_version`, it
-    will be deserialized correctly). Do NOT use this field for any other purpose, e.g. notebook
-    storage. This field is not yet exposed to customers (e.g. in the jobs API)."""
+    """Required. Environment version used by the environment. Each version comes with a specific Python
+    version and a set of Python packages. The version is a string, consisting of an integer."""
 
     jar_dependencies: Optional[List[str]] = None
     """List of jar dependencies, should be string representing volume paths. For example:
@@ -5038,6 +5026,7 @@ class EventType(Enum):
     AUTOSCALING_BACKOFF = "AUTOSCALING_BACKOFF"
     AUTOSCALING_FAILED = "AUTOSCALING_FAILED"
     AUTOSCALING_STATS_REPORT = "AUTOSCALING_STATS_REPORT"
+    CLUSTER_MIGRATED = "CLUSTER_MIGRATED"
     CREATING = "CREATING"
     DBFS_DOWN = "DBFS_DOWN"
     DID_NOT_EXPAND_DISK = "DID_NOT_EXPAND_DISK"
@@ -9082,6 +9071,7 @@ class TerminationReasonCode(Enum):
     DRIVER_OUT_OF_MEMORY = "DRIVER_OUT_OF_MEMORY"
     DRIVER_POD_CREATION_FAILURE = "DRIVER_POD_CREATION_FAILURE"
     DRIVER_UNEXPECTED_FAILURE = "DRIVER_UNEXPECTED_FAILURE"
+    DRIVER_UNHEALTHY = "DRIVER_UNHEALTHY"
     DRIVER_UNREACHABLE = "DRIVER_UNREACHABLE"
     DRIVER_UNRESPONSIVE = "DRIVER_UNRESPONSIVE"
     DYNAMIC_SPARK_CONF_SIZE_EXCEEDED = "DYNAMIC_SPARK_CONF_SIZE_EXCEEDED"
@@ -9844,9 +9834,7 @@ class ClusterPoliciesAPI:
         policy_family_definition_overrides: Optional[str] = None,
         policy_family_id: Optional[str] = None,
     ) -> CreatePolicyResponse:
-        """Create a new policy.
-
-        Creates a new policy with prescribed settings.
+        """Creates a new policy with prescribed settings.
 
         :param definition: str (optional)
           Policy definition document expressed in [Databricks Cluster Policy Definition Language].
@@ -9904,9 +9892,7 @@ class ClusterPoliciesAPI:
         return CreatePolicyResponse.from_dict(res)
 
     def delete(self, policy_id: str):
-        """Delete a cluster policy.
-
-        Delete a policy for a cluster. Clusters governed by this policy can still run, but cannot be edited.
+        """Delete a policy for a cluster. Clusters governed by this policy can still run, but cannot be edited.
 
         :param policy_id: str
           The ID of the policy to delete.
@@ -9935,9 +9921,7 @@ class ClusterPoliciesAPI:
         policy_family_definition_overrides: Optional[str] = None,
         policy_family_id: Optional[str] = None,
     ):
-        """Update a cluster policy.
-
-        Update an existing policy for cluster. This operation may make some clusters governed by the previous
+        """Update an existing policy for cluster. This operation may make some clusters governed by the previous
         policy invalid.
 
         :param policy_id: str
@@ -9999,9 +9983,7 @@ class ClusterPoliciesAPI:
         self._api.do("POST", "/api/2.0/policies/clusters/edit", body=body, headers=headers)
 
     def get(self, policy_id: str) -> Policy:
-        """Get a cluster policy.
-
-        Get a cluster policy entity. Creation and editing is available to admins only.
+        """Get a cluster policy entity. Creation and editing is available to admins only.
 
         :param policy_id: str
           Canonical unique identifier for the Cluster Policy.
@@ -10020,9 +10002,7 @@ class ClusterPoliciesAPI:
         return Policy.from_dict(res)
 
     def get_permission_levels(self, cluster_policy_id: str) -> GetClusterPolicyPermissionLevelsResponse:
-        """Get cluster policy permission levels.
-
-        Gets the permission levels that a user can have on an object.
+        """Gets the permission levels that a user can have on an object.
 
         :param cluster_policy_id: str
           The cluster policy for which to get or manage permissions.
@@ -10040,9 +10020,7 @@ class ClusterPoliciesAPI:
         return GetClusterPolicyPermissionLevelsResponse.from_dict(res)
 
     def get_permissions(self, cluster_policy_id: str) -> ClusterPolicyPermissions:
-        """Get cluster policy permissions.
-
-        Gets the permissions of a cluster policy. Cluster policies can inherit permissions from their root
+        """Gets the permissions of a cluster policy. Cluster policies can inherit permissions from their root
         object.
 
         :param cluster_policy_id: str
@@ -10061,9 +10039,7 @@ class ClusterPoliciesAPI:
     def list(
         self, *, sort_column: Optional[ListSortColumn] = None, sort_order: Optional[ListSortOrder] = None
     ) -> Iterator[Policy]:
-        """List cluster policies.
-
-        Returns a list of policies accessible by the requesting user.
+        """Returns a list of policies accessible by the requesting user.
 
         :param sort_column: :class:`ListSortColumn` (optional)
           The cluster policy attribute to sort by. * `POLICY_CREATION_TIME` - Sort result list by policy
@@ -10091,9 +10067,7 @@ class ClusterPoliciesAPI:
     def set_permissions(
         self, cluster_policy_id: str, *, access_control_list: Optional[List[ClusterPolicyAccessControlRequest]] = None
     ) -> ClusterPolicyPermissions:
-        """Set cluster policy permissions.
-
-        Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
+        """Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
         permissions if none are specified. Objects can inherit permissions from their root object.
 
         :param cluster_policy_id: str
@@ -10118,9 +10092,7 @@ class ClusterPoliciesAPI:
     def update_permissions(
         self, cluster_policy_id: str, *, access_control_list: Optional[List[ClusterPolicyAccessControlRequest]] = None
     ) -> ClusterPolicyPermissions:
-        """Update cluster policy permissions.
-
-        Updates the permissions on a cluster policy. Cluster policies can inherit permissions from their root
+        """Updates the permissions on a cluster policy. Cluster policies can inherit permissions from their root
         object.
 
         :param cluster_policy_id: str
@@ -10236,9 +10208,7 @@ class ClustersAPI:
         raise TimeoutError(f"timed out after {timeout}: {status_message}")
 
     def change_owner(self, cluster_id: str, owner_username: str):
-        """Change cluster owner.
-
-        Change the owner of the cluster. You must be an admin and the cluster must be terminated to perform
+        """Change the owner of the cluster. You must be an admin and the cluster must be terminated to perform
         this operation. The service principal application ID can be supplied as an argument to
         `owner_username`.
 
@@ -10295,9 +10265,7 @@ class ClustersAPI:
         use_ml_runtime: Optional[bool] = None,
         workload_type: Optional[WorkloadType] = None,
     ) -> Wait[ClusterDetails]:
-        """Create new cluster.
-
-        Creates a new Spark cluster. This method will acquire new instances from the cloud provider if
+        """Creates a new Spark cluster. This method will acquire new instances from the cloud provider if
         necessary. This method is asynchronous; the returned ``cluster_id`` can be used to poll the cluster
         status. When this method returns, the cluster will be in a ``PENDING`` state. The cluster will be
         usable once it enters a ``RUNNING`` state. Note: Databricks may not be able to acquire some of the
@@ -10625,9 +10593,7 @@ class ClustersAPI:
         ).result(timeout=timeout)
 
     def delete(self, cluster_id: str) -> Wait[ClusterDetails]:
-        """Terminate cluster.
-
-        Terminates the Spark cluster with the specified ID. The cluster is removed asynchronously. Once the
+        """Terminates the Spark cluster with the specified ID. The cluster is removed asynchronously. Once the
         termination has completed, the cluster will be in a `TERMINATED` state. If the cluster is already in a
         `TERMINATING` or `TERMINATED` state, nothing will happen.
 
@@ -10691,9 +10657,7 @@ class ClustersAPI:
         use_ml_runtime: Optional[bool] = None,
         workload_type: Optional[WorkloadType] = None,
     ) -> Wait[ClusterDetails]:
-        """Update cluster configuration.
-
-        Updates the configuration of a cluster to match the provided attributes and size. A cluster can be
+        """Updates the configuration of a cluster to match the provided attributes and size. A cluster can be
         updated if it is in a `RUNNING` or `TERMINATED` state.
 
         If a cluster is updated while in a `RUNNING` state, it will be restarted so that the new attributes
@@ -11028,9 +10992,7 @@ class ClustersAPI:
         page_token: Optional[str] = None,
         start_time: Optional[int] = None,
     ) -> Iterator[ClusterEvent]:
-        """List cluster activity events.
-
-        Retrieves a list of events about the activity of a cluster. This API is paginated. If there are more
+        """Retrieves a list of events about the activity of a cluster. This API is paginated. If there are more
         events to read, the response includes all the parameters necessary to request the next page of events.
 
         :param cluster_id: str
@@ -11098,9 +11060,7 @@ class ClustersAPI:
             body = json["next_page"]
 
     def get(self, cluster_id: str) -> ClusterDetails:
-        """Get cluster info.
-
-        Retrieves the information for a cluster given its identifier. Clusters can be described while they are
+        """Retrieves the information for a cluster given its identifier. Clusters can be described while they are
         running, or up to 60 days after they are terminated.
 
         :param cluster_id: str
@@ -11120,9 +11080,7 @@ class ClustersAPI:
         return ClusterDetails.from_dict(res)
 
     def get_permission_levels(self, cluster_id: str) -> GetClusterPermissionLevelsResponse:
-        """Get cluster permission levels.
-
-        Gets the permission levels that a user can have on an object.
+        """Gets the permission levels that a user can have on an object.
 
         :param cluster_id: str
           The cluster for which to get or manage permissions.
@@ -11138,9 +11096,7 @@ class ClustersAPI:
         return GetClusterPermissionLevelsResponse.from_dict(res)
 
     def get_permissions(self, cluster_id: str) -> ClusterPermissions:
-        """Get cluster permissions.
-
-        Gets the permissions of a cluster. Clusters can inherit permissions from their root object.
+        """Gets the permissions of a cluster. Clusters can inherit permissions from their root object.
 
         :param cluster_id: str
           The cluster for which to get or manage permissions.
@@ -11163,9 +11119,7 @@ class ClustersAPI:
         page_token: Optional[str] = None,
         sort_by: Optional[ListClustersSortBy] = None,
     ) -> Iterator[ClusterDetails]:
-        """List clusters.
-
-        Return information about all pinned and active clusters, and all clusters terminated within the last
+        """Return information about all pinned and active clusters, and all clusters terminated within the last
         30 days. Clusters terminated prior to this period are not included.
 
         :param filter_by: :class:`ListClustersFilterBy` (optional)
@@ -11205,9 +11159,7 @@ class ClustersAPI:
             query["page_token"] = json["next_page_token"]
 
     def list_node_types(self) -> ListNodeTypesResponse:
-        """List node types.
-
-        Returns a list of supported Spark node types. These node types can be used to launch a cluster.
+        """Returns a list of supported Spark node types. These node types can be used to launch a cluster.
 
         :returns: :class:`ListNodeTypesResponse`
         """
@@ -11220,9 +11172,7 @@ class ClustersAPI:
         return ListNodeTypesResponse.from_dict(res)
 
     def list_zones(self) -> ListAvailableZonesResponse:
-        """List availability zones.
-
-        Returns a list of availability zones where clusters can be created in (For example, us-west-2a). These
+        """Returns a list of availability zones where clusters can be created in (For example, us-west-2a). These
         zones can be used to launch a cluster.
 
         :returns: :class:`ListAvailableZonesResponse`
@@ -11236,9 +11186,7 @@ class ClustersAPI:
         return ListAvailableZonesResponse.from_dict(res)
 
     def permanent_delete(self, cluster_id: str):
-        """Permanently delete cluster.
-
-        Permanently deletes a Spark cluster. This cluster is terminated and resources are asynchronously
+        """Permanently deletes a Spark cluster. This cluster is terminated and resources are asynchronously
         removed.
 
         In addition, users will no longer see permanently deleted clusters in the cluster list, and API users
@@ -11260,9 +11208,7 @@ class ClustersAPI:
         self._api.do("POST", "/api/2.1/clusters/permanent-delete", body=body, headers=headers)
 
     def pin(self, cluster_id: str):
-        """Pin cluster.
-
-        Pinning a cluster ensures that the cluster will always be returned by the ListClusters API. Pinning a
+        """Pinning a cluster ensures that the cluster will always be returned by the ListClusters API. Pinning a
         cluster that is already pinned will have no effect. This API can only be called by workspace admins.
 
         :param cluster_id: str
@@ -11282,9 +11228,7 @@ class ClustersAPI:
     def resize(
         self, cluster_id: str, *, autoscale: Optional[AutoScale] = None, num_workers: Optional[int] = None
     ) -> Wait[ClusterDetails]:
-        """Resize cluster.
-
-        Resizes a cluster to have a desired number of workers. This will fail unless the cluster is in a
+        """Resizes a cluster to have a desired number of workers. This will fail unless the cluster is in a
         `RUNNING` state.
 
         :param cluster_id: str
@@ -11334,9 +11278,7 @@ class ClustersAPI:
         return self.resize(autoscale=autoscale, cluster_id=cluster_id, num_workers=num_workers).result(timeout=timeout)
 
     def restart(self, cluster_id: str, *, restart_user: Optional[str] = None) -> Wait[ClusterDetails]:
-        """Restart cluster.
-
-        Restarts a Spark cluster with the supplied ID. If the cluster is not currently in a `RUNNING` state,
+        """Restarts a Spark cluster with the supplied ID. If the cluster is not currently in a `RUNNING` state,
         nothing will happen.
 
         :param cluster_id: str
@@ -11370,9 +11312,7 @@ class ClustersAPI:
     def set_permissions(
         self, cluster_id: str, *, access_control_list: Optional[List[ClusterAccessControlRequest]] = None
     ) -> ClusterPermissions:
-        """Set cluster permissions.
-
-        Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
+        """Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
         permissions if none are specified. Objects can inherit permissions from their root object.
 
         :param cluster_id: str
@@ -11393,9 +11333,7 @@ class ClustersAPI:
         return ClusterPermissions.from_dict(res)
 
     def spark_versions(self) -> GetSparkVersionsResponse:
-        """List available Spark versions.
-
-        Returns the list of available Spark versions. These versions can be used to launch a cluster.
+        """Returns the list of available Spark versions. These versions can be used to launch a cluster.
 
         :returns: :class:`GetSparkVersionsResponse`
         """
@@ -11408,9 +11346,7 @@ class ClustersAPI:
         return GetSparkVersionsResponse.from_dict(res)
 
     def start(self, cluster_id: str) -> Wait[ClusterDetails]:
-        """Start terminated cluster.
-
-        Starts a terminated Spark cluster with the supplied ID. This works similar to `createCluster` except:
+        """Starts a terminated Spark cluster with the supplied ID. This works similar to `createCluster` except:
         - The previous cluster id and attributes are preserved. - The cluster starts with the last specified
         cluster size. - If the previous cluster was an autoscaling cluster, the current cluster starts with
         the minimum number of nodes. - If the cluster is not currently in a ``TERMINATED`` state, nothing will
@@ -11440,9 +11376,7 @@ class ClustersAPI:
         return self.start(cluster_id=cluster_id).result(timeout=timeout)
 
     def unpin(self, cluster_id: str):
-        """Unpin cluster.
-
-        Unpinning a cluster will allow the cluster to eventually be removed from the ListClusters API.
+        """Unpinning a cluster will allow the cluster to eventually be removed from the ListClusters API.
         Unpinning a cluster that is not pinned will have no effect. This API can only be called by workspace
         admins.
 
@@ -11463,9 +11397,7 @@ class ClustersAPI:
     def update(
         self, cluster_id: str, update_mask: str, *, cluster: Optional[UpdateClusterResource] = None
     ) -> Wait[ClusterDetails]:
-        """Update cluster configuration (partial).
-
-        Updates the configuration of a cluster to match the partial set of attributes and size. Denote which
+        """Updates the configuration of a cluster to match the partial set of attributes and size. Denote which
         fields to update using the `update_mask` field in the request body. A cluster can be updated if it is
         in a `RUNNING` or `TERMINATED` state. If a cluster is updated while in a `RUNNING` state, it will be
         restarted so that the new attributes can take effect. If a cluster is updated while in a `TERMINATED`
@@ -11526,9 +11458,7 @@ class ClustersAPI:
     def update_permissions(
         self, cluster_id: str, *, access_control_list: Optional[List[ClusterAccessControlRequest]] = None
     ) -> ClusterPermissions:
-        """Update cluster permissions.
-
-        Updates the permissions on a cluster. Clusters can inherit permissions from their root object.
+        """Updates the permissions on a cluster. Clusters can inherit permissions from their root object.
 
         :param cluster_id: str
           The cluster for which to get or manage permissions.
@@ -11667,9 +11597,7 @@ class CommandExecutionAPI:
     def cancel(
         self, *, cluster_id: Optional[str] = None, command_id: Optional[str] = None, context_id: Optional[str] = None
     ) -> Wait[CommandStatusResponse]:
-        """Cancel a command.
-
-        Cancels a currently running command within an execution context.
+        """Cancels a currently running command within an execution context.
 
         The command ID is obtained from a prior successful call to __execute__.
 
@@ -11713,9 +11641,7 @@ class CommandExecutionAPI:
         return self.cancel(cluster_id=cluster_id, command_id=command_id, context_id=context_id).result(timeout=timeout)
 
     def command_status(self, cluster_id: str, context_id: str, command_id: str) -> CommandStatusResponse:
-        """Get command info.
-
-        Gets the status of and, if available, the results from a currently executing command.
+        """Gets the status of and, if available, the results from a currently executing command.
 
         The command ID is obtained from a prior successful call to __execute__.
 
@@ -11741,9 +11667,7 @@ class CommandExecutionAPI:
         return CommandStatusResponse.from_dict(res)
 
     def context_status(self, cluster_id: str, context_id: str) -> ContextStatusResponse:
-        """Get status.
-
-        Gets the status for an execution context.
+        """Gets the status for an execution context.
 
         :param cluster_id: str
         :param context_id: str
@@ -11766,9 +11690,7 @@ class CommandExecutionAPI:
     def create(
         self, *, cluster_id: Optional[str] = None, language: Optional[Language] = None
     ) -> Wait[ContextStatusResponse]:
-        """Create an execution context.
-
-        Creates an execution context for running cluster commands.
+        """Creates an execution context for running cluster commands.
 
         If successful, this method returns the ID of the new execution context.
 
@@ -11804,9 +11726,7 @@ class CommandExecutionAPI:
         return self.create(cluster_id=cluster_id, language=language).result(timeout=timeout)
 
     def destroy(self, cluster_id: str, context_id: str):
-        """Delete an execution context.
-
-        Deletes an execution context.
+        """Deletes an execution context.
 
         :param cluster_id: str
         :param context_id: str
@@ -11833,9 +11753,7 @@ class CommandExecutionAPI:
         context_id: Optional[str] = None,
         language: Optional[Language] = None,
     ) -> Wait[CommandStatusResponse]:
-        """Run a command.
-
-        Runs a cluster command in the given execution context, using the provided language.
+        """Runs a cluster command in the given execution context, using the provided language.
 
         If successful, it returns an ID for tracking the status of the command's execution.
 
@@ -11903,9 +11821,7 @@ class GlobalInitScriptsAPI:
     def create(
         self, name: str, script: str, *, enabled: Optional[bool] = None, position: Optional[int] = None
     ) -> CreateResponse:
-        """Create init script.
-
-        Creates a new global init script in this workspace.
+        """Creates a new global init script in this workspace.
 
         :param name: str
           The name of the script
@@ -11944,9 +11860,7 @@ class GlobalInitScriptsAPI:
         return CreateResponse.from_dict(res)
 
     def delete(self, script_id: str):
-        """Delete init script.
-
-        Deletes a global init script.
+        """Deletes a global init script.
 
         :param script_id: str
           The ID of the global init script.
@@ -11961,9 +11875,7 @@ class GlobalInitScriptsAPI:
         self._api.do("DELETE", f"/api/2.0/global-init-scripts/{script_id}", headers=headers)
 
     def get(self, script_id: str) -> GlobalInitScriptDetailsWithContent:
-        """Get an init script.
-
-        Gets all the details of a script, including its Base64-encoded contents.
+        """Gets all the details of a script, including its Base64-encoded contents.
 
         :param script_id: str
           The ID of the global init script.
@@ -11979,9 +11891,7 @@ class GlobalInitScriptsAPI:
         return GlobalInitScriptDetailsWithContent.from_dict(res)
 
     def list(self) -> Iterator[GlobalInitScriptDetails]:
-        """Get init scripts.
-
-        Get a list of all global init scripts for this workspace. This returns all properties for each script
+        """Get a list of all global init scripts for this workspace. This returns all properties for each script
         but **not** the script contents. To retrieve the contents of a script, use the [get a global init
         script](:method:globalinitscripts/get) operation.
 
@@ -11999,9 +11909,7 @@ class GlobalInitScriptsAPI:
     def update(
         self, script_id: str, name: str, script: str, *, enabled: Optional[bool] = None, position: Optional[int] = None
     ):
-        """Update init script.
-
-        Updates a global init script, specifying only the fields to change. All fields are optional.
+        """Updates a global init script, specifying only the fields to change. All fields are optional.
         Unspecified fields retain their current value.
 
         :param script_id: str
@@ -12078,9 +11986,7 @@ class InstancePoolsAPI:
         preloaded_docker_images: Optional[List[DockerImage]] = None,
         preloaded_spark_versions: Optional[List[str]] = None,
     ) -> CreateInstancePoolResponse:
-        """Create a new instance pool.
-
-        Creates a new instance pool using idle and ready-to-use cloud instances.
+        """Creates a new instance pool using idle and ready-to-use cloud instances.
 
         :param instance_pool_name: str
           Pool name requested by the user. Pool name must be unique. Length must be between 1 and 100
@@ -12167,9 +12073,7 @@ class InstancePoolsAPI:
         return CreateInstancePoolResponse.from_dict(res)
 
     def delete(self, instance_pool_id: str):
-        """Delete an instance pool.
-
-        Deletes the instance pool permanently. The idle instances in the pool are terminated asynchronously.
+        """Deletes the instance pool permanently. The idle instances in the pool are terminated asynchronously.
 
         :param instance_pool_id: str
           The instance pool to be terminated.
@@ -12197,9 +12101,7 @@ class InstancePoolsAPI:
         max_capacity: Optional[int] = None,
         min_idle_instances: Optional[int] = None,
     ):
-        """Edit an existing instance pool.
-
-        Modifies the configuration of an existing instance pool.
+        """Modifies the configuration of an existing instance pool.
 
         :param instance_pool_id: str
           Instance pool ID
@@ -12254,9 +12156,7 @@ class InstancePoolsAPI:
         self._api.do("POST", "/api/2.0/instance-pools/edit", body=body, headers=headers)
 
     def get(self, instance_pool_id: str) -> GetInstancePool:
-        """Get instance pool information.
-
-        Retrieve the information for an instance pool based on its identifier.
+        """Retrieve the information for an instance pool based on its identifier.
 
         :param instance_pool_id: str
           The canonical unique identifier for the instance pool.
@@ -12275,9 +12175,7 @@ class InstancePoolsAPI:
         return GetInstancePool.from_dict(res)
 
     def get_permission_levels(self, instance_pool_id: str) -> GetInstancePoolPermissionLevelsResponse:
-        """Get instance pool permission levels.
-
-        Gets the permission levels that a user can have on an object.
+        """Gets the permission levels that a user can have on an object.
 
         :param instance_pool_id: str
           The instance pool for which to get or manage permissions.
@@ -12295,9 +12193,7 @@ class InstancePoolsAPI:
         return GetInstancePoolPermissionLevelsResponse.from_dict(res)
 
     def get_permissions(self, instance_pool_id: str) -> InstancePoolPermissions:
-        """Get instance pool permissions.
-
-        Gets the permissions of an instance pool. Instance pools can inherit permissions from their root
+        """Gets the permissions of an instance pool. Instance pools can inherit permissions from their root
         object.
 
         :param instance_pool_id: str
@@ -12314,9 +12210,7 @@ class InstancePoolsAPI:
         return InstancePoolPermissions.from_dict(res)
 
     def list(self) -> Iterator[InstancePoolAndStats]:
-        """List instance pool info.
-
-        Gets a list of instance pools with their statistics.
+        """Gets a list of instance pools with their statistics.
 
         :returns: Iterator over :class:`InstancePoolAndStats`
         """
@@ -12332,9 +12226,7 @@ class InstancePoolsAPI:
     def set_permissions(
         self, instance_pool_id: str, *, access_control_list: Optional[List[InstancePoolAccessControlRequest]] = None
     ) -> InstancePoolPermissions:
-        """Set instance pool permissions.
-
-        Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
+        """Sets permissions on an object, replacing existing permissions if they exist. Deletes all direct
         permissions if none are specified. Objects can inherit permissions from their root object.
 
         :param instance_pool_id: str
@@ -12357,9 +12249,7 @@ class InstancePoolsAPI:
     def update_permissions(
         self, instance_pool_id: str, *, access_control_list: Optional[List[InstancePoolAccessControlRequest]] = None
     ) -> InstancePoolPermissions:
-        """Update instance pool permissions.
-
-        Updates the permissions on an instance pool. Instance pools can inherit permissions from their root
+        """Updates the permissions on an instance pool. Instance pools can inherit permissions from their root
         object.
 
         :param instance_pool_id: str
@@ -12401,9 +12291,7 @@ class InstanceProfilesAPI:
         is_meta_instance_profile: Optional[bool] = None,
         skip_validation: Optional[bool] = None,
     ):
-        """Register an instance profile.
-
-        Registers an instance profile in Databricks. In the UI, you can then give users the permission to use
+        """Registers an instance profile in Databricks. In the UI, you can then give users the permission to use
         this instance profile when launching clusters.
 
         This API is only available to admin users.
@@ -12455,9 +12343,7 @@ class InstanceProfilesAPI:
         iam_role_arn: Optional[str] = None,
         is_meta_instance_profile: Optional[bool] = None,
     ):
-        """Edit an instance profile.
-
-        The only supported field to change is the optional IAM role ARN associated with the instance profile.
+        """The only supported field to change is the optional IAM role ARN associated with the instance profile.
         It is required to specify the IAM role ARN if both of the following are true:
 
         * Your role name and instance profile name do not match. The name is the part after the last slash in
@@ -12503,9 +12389,7 @@ class InstanceProfilesAPI:
         self._api.do("POST", "/api/2.0/instance-profiles/edit", body=body, headers=headers)
 
     def list(self) -> Iterator[InstanceProfile]:
-        """List available instance profiles.
-
-        List the instance profiles that the calling user can use to launch a cluster.
+        """List the instance profiles that the calling user can use to launch a cluster.
 
         This API is available to all users.
 
@@ -12521,9 +12405,7 @@ class InstanceProfilesAPI:
         return parsed if parsed is not None else []
 
     def remove(self, instance_profile_arn: str):
-        """Remove the instance profile.
-
-        Remove the instance profile with the provided ARN. Existing clusters with this instance profile will
+        """Remove the instance profile with the provided ARN. Existing clusters with this instance profile will
         continue to function.
 
         This API is only accessible to admin users.
@@ -12563,9 +12445,7 @@ class LibrariesAPI:
         self._api = api_client
 
     def all_cluster_statuses(self) -> Iterator[ClusterLibraryStatuses]:
-        """Get all statuses.
-
-        Get the status of all libraries on all clusters. A status is returned for all libraries installed on
+        """Get the status of all libraries on all clusters. A status is returned for all libraries installed on
         this cluster via the API or the libraries UI.
 
         :returns: Iterator over :class:`ClusterLibraryStatuses`
@@ -12580,9 +12460,7 @@ class LibrariesAPI:
         return parsed if parsed is not None else []
 
     def cluster_status(self, cluster_id: str) -> Iterator[LibraryFullStatus]:
-        """Get status.
-
-        Get the status of libraries on a cluster. A status is returned for all libraries installed on this
+        """Get the status of libraries on a cluster. A status is returned for all libraries installed on this
         cluster via the API or the libraries UI. The order of returned libraries is as follows: 1. Libraries
         set to be installed on this cluster, in the order that the libraries were added to the cluster, are
         returned first. 2. Libraries that were previously requested to be installed on this cluster or, but
@@ -12606,9 +12484,7 @@ class LibrariesAPI:
         return parsed if parsed is not None else []
 
     def install(self, cluster_id: str, libraries: List[Library]):
-        """Add a library.
-
-        Add libraries to install on a cluster. The installation is asynchronous; it happens in the background
+        """Add libraries to install on a cluster. The installation is asynchronous; it happens in the background
         after the completion of this request.
 
         :param cluster_id: str
@@ -12631,9 +12507,7 @@ class LibrariesAPI:
         self._api.do("POST", "/api/2.0/libraries/install", body=body, headers=headers)
 
     def uninstall(self, cluster_id: str, libraries: List[Library]):
-        """Uninstall libraries.
-
-        Set libraries to uninstall from a cluster. The libraries won't be uninstalled until the cluster is
+        """Set libraries to uninstall from a cluster. The libraries won't be uninstalled until the cluster is
         restarted. A request to uninstall a library that is not currently installed is ignored.
 
         :param cluster_id: str
@@ -12672,9 +12546,7 @@ class PolicyComplianceForClustersAPI:
     def enforce_compliance(
         self, cluster_id: str, *, validate_only: Optional[bool] = None
     ) -> EnforceClusterComplianceResponse:
-        """Enforce cluster policy compliance.
-
-        Updates a cluster to be compliant with the current version of its policy. A cluster can be updated if
+        """Updates a cluster to be compliant with the current version of its policy. A cluster can be updated if
         it is in a `RUNNING` or `TERMINATED` state.
 
         If a cluster is updated while in a `RUNNING` state, it will be restarted so that the new attributes
@@ -12708,9 +12580,7 @@ class PolicyComplianceForClustersAPI:
         return EnforceClusterComplianceResponse.from_dict(res)
 
     def get_compliance(self, cluster_id: str) -> GetClusterComplianceResponse:
-        """Get cluster policy compliance.
-
-        Returns the policy compliance status of a cluster. Clusters could be out of compliance if their policy
+        """Returns the policy compliance status of a cluster. Clusters could be out of compliance if their policy
         was updated after the cluster was last edited.
 
         :param cluster_id: str
@@ -12732,9 +12602,7 @@ class PolicyComplianceForClustersAPI:
     def list_compliance(
         self, policy_id: str, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[ClusterCompliance]:
-        """List cluster policy compliance.
-
-        Returns the policy compliance status of all clusters that use a given policy. Clusters could be out of
+        """Returns the policy compliance status of all clusters that use a given policy. Clusters could be out of
         compliance if their policy was updated after the cluster was last edited.
 
         :param policy_id: str
@@ -12785,9 +12653,7 @@ class PolicyFamiliesAPI:
         self._api = api_client
 
     def get(self, policy_family_id: str, *, version: Optional[int] = None) -> PolicyFamily:
-        """Get policy family information.
-
-        Retrieve the information for an policy family based on its identifier and version
+        """Retrieve the information for an policy family based on its identifier and version
 
         :param policy_family_id: str
           The family ID about which to retrieve information.
@@ -12808,9 +12674,7 @@ class PolicyFamiliesAPI:
         return PolicyFamily.from_dict(res)
 
     def list(self, *, max_results: Optional[int] = None, page_token: Optional[str] = None) -> Iterator[PolicyFamily]:
-        """List policy families.
-
-        Returns the list of policy definition types available to use at their latest version. This API is
+        """Returns the list of policy definition types available to use at their latest version. This API is
         paginated.
 
         :param max_results: int (optional)