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

databricks/sdk/service/dashboards.py

@@ -1758,9 +1758,7 @@ class GenieAPI:
         raise TimeoutError(f"timed out after {timeout}: {status_message}")
 
     def create_message(self, space_id: str, conversation_id: str, content: str) -> Wait[GenieMessage]:
-        """Create conversation message.
-
-        Create new message in a [conversation](:method:genie/startconversation). The AI response uses all
+        """Create new message in a [conversation](:method:genie/startconversation). The AI response uses all
         previously created messages in the conversation to respond.
 
         :param space_id: str
@@ -1806,9 +1804,7 @@ class GenieAPI:
     def execute_message_attachment_query(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """Execute message attachment SQL query.
-
-        Execute the SQL for a message query attachment. Use this API when the query attachment has expired and
+        """Execute the SQL for a message query attachment. Use this API when the query attachment has expired and
         needs to be re-executed.
 
         :param space_id: str
@@ -1837,9 +1833,7 @@ class GenieAPI:
     def execute_message_query(
         self, space_id: str, conversation_id: str, message_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """[Deprecated] Execute SQL query in a conversation message.
-
-        Execute the SQL query in the message.
+        """Execute the SQL query in the message.
 
         :param space_id: str
           Genie space ID
@@ -1865,9 +1859,7 @@ class GenieAPI:
     def generate_download_full_query_result(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str
     ) -> GenieGenerateDownloadFullQueryResultResponse:
-        """Generate full query result download.
-
-        Initiates a new SQL execution and returns a `download_id` that you can use to track the progress of
+        """Initiates a new SQL execution and returns a `download_id` that you can use to track the progress of
         the download. The query result is stored in an external link and can be retrieved using the [Get
         Download Full Query Result](:method:genie/getdownloadfullqueryresult) API. Warning: Databricks
         strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.
@@ -1899,9 +1891,7 @@ class GenieAPI:
     def get_download_full_query_result(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str, download_id: str
     ) -> GenieGetDownloadFullQueryResultResponse:
-        """Get download full query result.
-
-        After [Generating a Full Query Result Download](:method:genie/getdownloadfullqueryresult) and
+        """After [Generating a Full Query Result Download](:method:genie/getdownloadfullqueryresult) and
         successfully receiving a `download_id`, use this API to poll the download progress. When the download
         is complete, the API returns one or more external links to the query result files. Warning: Databricks
         strongly recommends that you protect the URLs that are returned by the `EXTERNAL_LINKS` disposition.
@@ -1936,9 +1926,7 @@ class GenieAPI:
         return GenieGetDownloadFullQueryResultResponse.from_dict(res)
 
     def get_message(self, space_id: str, conversation_id: str, message_id: str) -> GenieMessage:
-        """Get conversation message.
-
-        Get message from conversation.
+        """Get message from conversation.
 
         :param space_id: str
           The ID associated with the Genie space where the target conversation is located.
@@ -1964,9 +1952,7 @@ class GenieAPI:
     def get_message_attachment_query_result(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """Get message attachment SQL query result.
-
-        Get the result of SQL query if the message has a query attachment. This is only available if a message
+        """Get the result of SQL query if the message has a query attachment. This is only available if a message
         has a query attachment and the message status is `EXECUTING_QUERY` OR `COMPLETED`.
 
         :param space_id: str
@@ -1995,9 +1981,7 @@ class GenieAPI:
     def get_message_query_result(
         self, space_id: str, conversation_id: str, message_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """[Deprecated] Get conversation message SQL query result.
-
-        Get the result of SQL query if the message has a query attachment. This is only available if a message
+        """Get the result of SQL query if the message has a query attachment. This is only available if a message
         has a query attachment and the message status is `EXECUTING_QUERY`.
 
         :param space_id: str
@@ -2024,9 +2008,7 @@ class GenieAPI:
     def get_message_query_result_by_attachment(
         self, space_id: str, conversation_id: str, message_id: str, attachment_id: str
     ) -> GenieGetMessageQueryResultResponse:
-        """[Deprecated] Get conversation message SQL query result.
-
-        Get the result of SQL query if the message has a query attachment. This is only available if a message
+        """Get the result of SQL query if the message has a query attachment. This is only available if a message
         has a query attachment and the message status is `EXECUTING_QUERY` OR `COMPLETED`.
 
         :param space_id: str
@@ -2053,9 +2035,7 @@ class GenieAPI:
         return GenieGetMessageQueryResultResponse.from_dict(res)
 
     def get_space(self, space_id: str) -> GenieSpace:
-        """Get Genie Space.
-
-        Get details of a Genie Space.
+        """Get details of a Genie Space.
 
         :param space_id: str
           The ID associated with the Genie space
@@ -2073,9 +2053,7 @@ class GenieAPI:
     def list_spaces(
         self, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> GenieListSpacesResponse:
-        """List Genie spaces.
-
-        Get list of Genie Spaces.
+        """Get list of Genie Spaces.
 
         :param page_size: int (optional)
           Maximum number of spaces to return per page
@@ -2098,9 +2076,7 @@ class GenieAPI:
         return GenieListSpacesResponse.from_dict(res)
 
     def start_conversation(self, space_id: str, content: str) -> Wait[GenieMessage]:
-        """Start conversation.
-
-        Start a new conversation.
+        """Start a new conversation.
 
         :param space_id: str
           The ID associated with the Genie space where you want to start a conversation.
@@ -2142,9 +2118,7 @@ class LakeviewAPI:
         self._api = api_client
 
     def create(self, dashboard: Dashboard) -> Dashboard:
-        """Create dashboard.
-
-        Create a draft dashboard.
+        """Create a draft dashboard.
 
         :param dashboard: :class:`Dashboard`
 
@@ -2263,9 +2237,7 @@ class LakeviewAPI:
         )
 
     def get(self, dashboard_id: str) -> Dashboard:
-        """Get dashboard.
-
-        Get a draft dashboard.
+        """Get a draft dashboard.
 
         :param dashboard_id: str
           UUID identifying the dashboard.
@@ -2281,9 +2253,7 @@ class LakeviewAPI:
         return Dashboard.from_dict(res)
 
     def get_published(self, dashboard_id: str) -> PublishedDashboard:
-        """Get published dashboard.
-
-        Get the current published dashboard.
+        """Get the current published dashboard.
 
         :param dashboard_id: str
           UUID identifying the published dashboard.
@@ -2473,9 +2443,7 @@ class LakeviewAPI:
         parent_path: Optional[str] = None,
         update_parameter_syntax: Optional[bool] = None,
     ) -> Dashboard:
-        """Migrate dashboard.
-
-        Migrates a classic SQL dashboard to Lakeview.
+        """Migrates a classic SQL dashboard to Lakeview.
 
         :param source_dashboard_id: str
           UUID of the dashboard to be migrated.
@@ -2509,9 +2477,7 @@ class LakeviewAPI:
     def publish(
         self, dashboard_id: str, *, embed_credentials: Optional[bool] = None, warehouse_id: Optional[str] = None
     ) -> PublishedDashboard:
-        """Publish dashboard.
-
-        Publish the current draft dashboard.
+        """Publish the current draft dashboard.
 
         :param dashboard_id: str
           UUID identifying the dashboard to be published.
@@ -2537,9 +2503,7 @@ class LakeviewAPI:
         return PublishedDashboard.from_dict(res)
 
     def trash(self, dashboard_id: str):
-        """Trash dashboard.
-
-        Trash a dashboard.
+        """Trash a dashboard.
 
         :param dashboard_id: str
           UUID identifying the dashboard.
@@ -2554,9 +2518,7 @@ class LakeviewAPI:
         self._api.do("DELETE", f"/api/2.0/lakeview/dashboards/{dashboard_id}", headers=headers)
 
     def unpublish(self, dashboard_id: str):
-        """Unpublish dashboard.
-
-        Unpublish the dashboard.
+        """Unpublish the dashboard.
 
         :param dashboard_id: str
           UUID identifying the published dashboard.
@@ -2571,9 +2533,7 @@ class LakeviewAPI:
         self._api.do("DELETE", f"/api/2.0/lakeview/dashboards/{dashboard_id}/published", headers=headers)
 
     def update(self, dashboard_id: str, dashboard: Dashboard) -> Dashboard:
-        """Update dashboard.
-
-        Update a draft dashboard.
+        """Update a draft dashboard.
 
         :param dashboard_id: str
           UUID identifying the dashboard.
@@ -2622,9 +2582,7 @@ class LakeviewEmbeddedAPI:
     def get_published_dashboard_token_info(
         self, dashboard_id: str, *, external_value: Optional[str] = None, external_viewer_id: Optional[str] = None
     ) -> GetPublishedDashboardTokenInfoResponse:
-        """Read an information of a published dashboard to mint an OAuth token.
-
-        Get a required authorization details and scopes of a published dashboard to mint an OAuth token. The
+        """Get a required authorization details and scopes of a published dashboard to mint an OAuth token. The
         `authorization_details` can be enriched to apply additional restriction.
 
         Example: Adding the following `authorization_details` object to downscope the viewer permission to

databricks/sdk/service/database.py

@@ -74,11 +74,15 @@ class DatabaseCatalog:
 
 @dataclass
 class DatabaseCredential:
+    expiration_time: Optional[str] = None
+
     token: Optional[str] = None
 
     def as_dict(self) -> dict:
         """Serializes the DatabaseCredential into a dictionary suitable for use as a JSON request body."""
         body = {}
+        if self.expiration_time is not None:
+            body["expiration_time"] = self.expiration_time
         if self.token is not None:
             body["token"] = self.token
         return body
@@ -86,6 +90,8 @@ class DatabaseCredential:
     def as_shallow_dict(self) -> dict:
         """Serializes the DatabaseCredential into a shallow dictionary of its immediate attributes."""
         body = {}
+        if self.expiration_time is not None:
+            body["expiration_time"] = self.expiration_time
         if self.token is not None:
             body["token"] = self.token
         return body
@@ -93,7 +99,7 @@ class DatabaseCredential:
     @classmethod
     def from_dict(cls, d: Dict[str, Any]) -> DatabaseCredential:
         """Deserializes the DatabaseCredential from a dictionary."""
-        return cls(token=d.get("token", None))
+        return cls(expiration_time=d.get("expiration_time", None), token=d.get("token", None))
 
 
 @dataclass
@@ -113,6 +119,12 @@ class DatabaseInstance:
     creator: Optional[str] = None
     """The email of the creator of the instance."""
 
+    effective_stopped: Optional[bool] = None
+    """xref AIP-129. `stopped` is owned by the client, while `effective_stopped` is owned by the
+    server. `stopped` will only be set in Create/Update response messages if and only if the user
+    provides the field via the request. `effective_stopped` on the other hand will always bet set in
+    all response messages (Create/Update/Get/List)."""
+
     pg_version: Optional[str] = None
     """The version of Postgres running on the instance."""
 
@@ -137,6 +149,8 @@ class DatabaseInstance:
             body["creation_time"] = self.creation_time
         if self.creator is not None:
             body["creator"] = self.creator
+        if self.effective_stopped is not None:
+            body["effective_stopped"] = self.effective_stopped
         if self.name is not None:
             body["name"] = self.name
         if self.pg_version is not None:
@@ -160,6 +174,8 @@ class DatabaseInstance:
             body["creation_time"] = self.creation_time
         if self.creator is not None:
             body["creator"] = self.creator
+        if self.effective_stopped is not None:
+            body["effective_stopped"] = self.effective_stopped
         if self.name is not None:
             body["name"] = self.name
         if self.pg_version is not None:
@@ -181,6 +197,7 @@ class DatabaseInstance:
             capacity=d.get("capacity", None),
             creation_time=d.get("creation_time", None),
             creator=d.get("creator", None),
+            effective_stopped=d.get("effective_stopped", None),
             name=d.get("name", None),
             pg_version=d.get("pg_version", None),
             read_write_dns=d.get("read_write_dns", None),
@@ -227,9 +244,6 @@ class DatabaseTable:
     postgres database. Note that this has implications for the `create_database_objects_is_missing`
     field in `spec`."""
 
-    table_serving_url: Optional[str] = None
-    """Data serving REST API URL for this table"""
-
     def as_dict(self) -> dict:
         """Serializes the DatabaseTable into a dictionary suitable for use as a JSON request body."""
         body = {}
@@ -239,8 +253,6 @@ class DatabaseTable:
             body["logical_database_name"] = self.logical_database_name
         if self.name is not None:
             body["name"] = self.name
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
         return body
 
     def as_shallow_dict(self) -> dict:
@@ -252,8 +264,6 @@ class DatabaseTable:
             body["logical_database_name"] = self.logical_database_name
         if self.name is not None:
             body["name"] = self.name
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
         return body
 
     @classmethod
@@ -263,7 +273,6 @@ class DatabaseTable:
             database_instance_name=d.get("database_instance_name", None),
             logical_database_name=d.get("logical_database_name", None),
             name=d.get("name", None),
-            table_serving_url=d.get("table_serving_url", None),
         )
 
 
@@ -487,9 +496,6 @@ class SyncedDatabaseTable:
     spec: Optional[SyncedTableSpec] = None
     """Specification of a synced database table."""
 
-    table_serving_url: Optional[str] = None
-    """Data serving REST API URL for this table"""
-
     unity_catalog_provisioning_state: Optional[ProvisioningInfoState] = None
     """The provisioning state of the synced table entity in Unity Catalog. This is distinct from the
     state of the data synchronization pipeline (i.e. the table may be in "ACTIVE" but the pipeline
@@ -508,8 +514,6 @@ class SyncedDatabaseTable:
             body["name"] = self.name
         if self.spec:
             body["spec"] = self.spec.as_dict()
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
         if self.unity_catalog_provisioning_state is not None:
             body["unity_catalog_provisioning_state"] = self.unity_catalog_provisioning_state.value
         return body
@@ -527,8 +531,6 @@ class SyncedDatabaseTable:
             body["name"] = self.name
         if self.spec:
             body["spec"] = self.spec
-        if self.table_serving_url is not None:
-            body["table_serving_url"] = self.table_serving_url
         if self.unity_catalog_provisioning_state is not None:
             body["unity_catalog_provisioning_state"] = self.unity_catalog_provisioning_state
         return body
@@ -542,7 +544,6 @@ class SyncedDatabaseTable:
             logical_database_name=d.get("logical_database_name", None),
             name=d.get("name", None),
             spec=_from_dict(d, "spec", SyncedTableSpec),
-            table_serving_url=d.get("table_serving_url", None),
             unity_catalog_provisioning_state=_enum(d, "unity_catalog_provisioning_state", ProvisioningInfoState),
         )
 
@@ -744,11 +745,14 @@ class SyncedTableSpec:
     """If true, the synced table's logical database and schema resources in PG will be created if they
     do not already exist."""
 
-    new_pipeline_spec: Optional[NewPipelineSpec] = None
-    """Spec of new pipeline. Should be empty if pipeline_id is set"""
+    existing_pipeline_id: Optional[str] = None
+    """User-specified ID of a pre-existing pipeline to bin pack. This field is optional, and should be
+    empty if new_pipeline_spec is set. This field will only be set by the server in response
+    messages if it is specified in the request. The SyncedTableStatus message will always contain
+    the effective pipeline ID (either client provided or server generated), however."""
 
-    pipeline_id: Optional[str] = None
-    """ID of the associated pipeline. Should be empty if new_pipeline_spec is set"""
+    new_pipeline_spec: Optional[NewPipelineSpec] = None
+    """Spec of new pipeline. Should be empty if pipeline_id / existing_pipeline_id is set"""
 
     primary_key_columns: Optional[List[str]] = None
     """Primary Key columns to be used for data insert/update in the destination."""
@@ -767,10 +771,10 @@ class SyncedTableSpec:
         body = {}
         if self.create_database_objects_if_missing is not None:
             body["create_database_objects_if_missing"] = self.create_database_objects_if_missing
+        if self.existing_pipeline_id is not None:
+            body["existing_pipeline_id"] = self.existing_pipeline_id
         if self.new_pipeline_spec:
             body["new_pipeline_spec"] = self.new_pipeline_spec.as_dict()
-        if self.pipeline_id is not None:
-            body["pipeline_id"] = self.pipeline_id
         if self.primary_key_columns:
             body["primary_key_columns"] = [v for v in self.primary_key_columns]
         if self.scheduling_policy is not None:
@@ -786,10 +790,10 @@ class SyncedTableSpec:
         body = {}
         if self.create_database_objects_if_missing is not None:
             body["create_database_objects_if_missing"] = self.create_database_objects_if_missing
+        if self.existing_pipeline_id is not None:
+            body["existing_pipeline_id"] = self.existing_pipeline_id
         if self.new_pipeline_spec:
             body["new_pipeline_spec"] = self.new_pipeline_spec
-        if self.pipeline_id is not None:
-            body["pipeline_id"] = self.pipeline_id
         if self.primary_key_columns:
             body["primary_key_columns"] = self.primary_key_columns
         if self.scheduling_policy is not None:
@@ -805,8 +809,8 @@ class SyncedTableSpec:
         """Deserializes the SyncedTableSpec from a dictionary."""
         return cls(
             create_database_objects_if_missing=d.get("create_database_objects_if_missing", None),
+            existing_pipeline_id=d.get("existing_pipeline_id", None),
             new_pipeline_spec=_from_dict(d, "new_pipeline_spec", NewPipelineSpec),
-            pipeline_id=d.get("pipeline_id", None),
             primary_key_columns=d.get("primary_key_columns", None),
             scheduling_policy=_enum(d, "scheduling_policy", SyncedTableSchedulingPolicy),
             source_table_full_name=d.get("source_table_full_name", None),
@@ -848,6 +852,10 @@ class SyncedTableStatus:
     message: Optional[str] = None
     """A text description of the current state of the synced table."""
 
+    pipeline_id: Optional[str] = None
+    """ID of the associated pipeline. The pipeline ID may have been provided by the client (in the case
+    of bin packing), or generated by the server (when creating a new pipeline)."""
+
     provisioning_status: Optional[SyncedTableProvisioningStatus] = None
     """Detailed status of a synced table. Shown if the synced table is in the
     PROVISIONING_PIPELINE_RESOURCES or the PROVISIONING_INITIAL_SNAPSHOT state."""
@@ -867,6 +875,8 @@ class SyncedTableStatus:
             body["failed_status"] = self.failed_status.as_dict()
         if self.message is not None:
             body["message"] = self.message
+        if self.pipeline_id is not None:
+            body["pipeline_id"] = self.pipeline_id
         if self.provisioning_status:
             body["provisioning_status"] = self.provisioning_status.as_dict()
         if self.triggered_update_status:
@@ -884,6 +894,8 @@ class SyncedTableStatus:
             body["failed_status"] = self.failed_status
         if self.message is not None:
             body["message"] = self.message
+        if self.pipeline_id is not None:
+            body["pipeline_id"] = self.pipeline_id
         if self.provisioning_status:
             body["provisioning_status"] = self.provisioning_status
         if self.triggered_update_status:
@@ -898,6 +910,7 @@ class SyncedTableStatus:
             detailed_state=_enum(d, "detailed_state", SyncedTableState),
             failed_status=_from_dict(d, "failed_status", SyncedTableFailedStatus),
             message=d.get("message", None),
+            pipeline_id=d.get("pipeline_id", None),
             provisioning_status=_from_dict(d, "provisioning_status", SyncedTableProvisioningStatus),
             triggered_update_status=_from_dict(d, "triggered_update_status", SyncedTableTriggeredUpdateStatus),
         )
@@ -1047,10 +1060,12 @@ class DatabaseAPI:
           By default, a instance cannot be deleted if it has descendant instances created via PITR. If this
           flag is specified as true, all descendent instances will be deleted as well.
         :param purge: bool (optional)
-          If false, the database instance is soft deleted. Soft deleted instances behave as if they are
-          deleted, and cannot be used for CRUD operations nor connected to. However they can be undeleted by
-          calling the undelete API for a limited time. If true, the database instance is hard deleted and
-          cannot be undeleted.
+          Note purge=false is in development. If false, the database instance is soft deleted (implementation
+          pending). Soft deleted instances behave as if they are deleted, and cannot be used for CRUD
+          operations nor connected to. However they can be undeleted by calling the undelete API for a limited
+          time (implementation pending). If true, the database instance is hard deleted and cannot be
+          undeleted. For the time being, setting this value to true is required to delete an instance (soft
+          delete is not yet supported).
 
 
         """

databricks/sdk/service/files.py

@@ -739,9 +739,7 @@ class DbfsAPI:
         self._api = api_client
 
     def add_block(self, handle: int, data: str):
-        """Append data block.
-
-        Appends a block of data to the stream specified by the input handle. If the handle does not exist,
+        """Appends a block of data to the stream specified by the input handle. If the handle does not exist,
         this call will throw an exception with ``RESOURCE_DOES_NOT_EXIST``.
 
         If the block of data exceeds 1 MB, this call will throw an exception with ``MAX_BLOCK_SIZE_EXCEEDED``.
@@ -766,9 +764,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/add-block", body=body, headers=headers)
 
     def close(self, handle: int):
-        """Close the stream.
-
-        Closes the stream specified by the input handle. If the handle does not exist, this call throws an
+        """Closes the stream specified by the input handle. If the handle does not exist, this call throws an
         exception with ``RESOURCE_DOES_NOT_EXIST``.
 
         :param handle: int
@@ -787,9 +783,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/close", body=body, headers=headers)
 
     def create(self, path: str, *, overwrite: Optional[bool] = None) -> CreateResponse:
-        """Open a stream.
-
-        Opens a stream to write to a file and returns a handle to this stream. There is a 10 minute idle
+        """Opens a stream to write to a file and returns a handle to this stream. There is a 10 minute idle
         timeout on this handle. If a file or directory already exists on the given path and __overwrite__ is
         set to false, this call will throw an exception with ``RESOURCE_ALREADY_EXISTS``.
 
@@ -819,9 +813,7 @@ class DbfsAPI:
         return CreateResponse.from_dict(res)
 
     def delete(self, path: str, *, recursive: Optional[bool] = None):
-        """Delete a file/directory.
-
-        Delete the file or directory (optionally recursively delete all files in the directory). This call
+        """Delete the file or directory (optionally recursively delete all files in the directory). This call
         throws an exception with `IO_ERROR` if the path is a non-empty directory and `recursive` is set to
         `false` or on other similar errors.
 
@@ -857,9 +849,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/delete", body=body, headers=headers)
 
     def get_status(self, path: str) -> FileInfo:
-        """Get the information of a file or directory.
-
-        Gets the file information for a file or directory. If the file or directory does not exist, this call
+        """Gets the file information for a file or directory. If the file or directory does not exist, this call
         throws an exception with `RESOURCE_DOES_NOT_EXIST`.
 
         :param path: str
@@ -879,9 +869,7 @@ class DbfsAPI:
         return FileInfo.from_dict(res)
 
     def list(self, path: str) -> Iterator[FileInfo]:
-        """List directory contents or file details.
-
-        List the contents of a directory, or details of the file. If the file or directory does not exist,
+        """List the contents of a directory, or details of the file. If the file or directory does not exist,
         this call throws an exception with `RESOURCE_DOES_NOT_EXIST`.
 
         When calling list on a large directory, the list operation will time out after approximately 60
@@ -909,9 +897,7 @@ class DbfsAPI:
         return parsed if parsed is not None else []
 
     def mkdirs(self, path: str):
-        """Create a directory.
-
-        Creates the given directory and necessary parent directories if they do not exist. If a file (not a
+        """Creates the given directory and necessary parent directories if they do not exist. If a file (not a
         directory) exists at any prefix of the input path, this call throws an exception with
         `RESOURCE_ALREADY_EXISTS`. **Note**: If this operation fails, it might have succeeded in creating some
         of the necessary parent directories.
@@ -932,9 +918,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/mkdirs", body=body, headers=headers)
 
     def move(self, source_path: str, destination_path: str):
-        """Move a file.
-
-        Moves a file from one location to another location within DBFS. If the source file does not exist,
+        """Moves a file from one location to another location within DBFS. If the source file does not exist,
         this call throws an exception with `RESOURCE_DOES_NOT_EXIST`. If a file already exists in the
         destination path, this call throws an exception with `RESOURCE_ALREADY_EXISTS`. If the given source
         path is a directory, this call always recursively moves all files.
@@ -959,9 +943,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/move", body=body, headers=headers)
 
     def put(self, path: str, *, contents: Optional[str] = None, overwrite: Optional[bool] = None):
-        """Upload a file.
-
-        Uploads a file through the use of multipart form post. It is mainly used for streaming uploads, but
+        """Uploads a file through the use of multipart form post. It is mainly used for streaming uploads, but
         can also be used as a convenient single call for data upload.
 
         Alternatively you can pass contents as base64 string.
@@ -996,9 +978,7 @@ class DbfsAPI:
         self._api.do("POST", "/api/2.0/dbfs/put", body=body, headers=headers)
 
     def read(self, path: str, *, length: Optional[int] = None, offset: Optional[int] = None) -> ReadResponse:
-        """Get the contents of a file.
-
-        Returns the contents of a file. If the file does not exist, this call throws an exception with
+        """Returns the contents of a file. If the file does not exist, this call throws an exception with
         `RESOURCE_DOES_NOT_EXIST`. If the path is a directory, the read length is negative, or if the offset
         is negative, this call throws an exception with `INVALID_PARAMETER_VALUE`. If the read length exceeds
         1 MB, this call throws an exception with `MAX_READ_SIZE_EXCEEDED`.
@@ -1057,9 +1037,7 @@ class FilesAPI:
         self._api = api_client
 
     def create_directory(self, directory_path: str):
-        """Create a directory.
-
-        Creates an empty directory. If necessary, also creates any parent directories of the new, empty
+        """Creates an empty directory. If necessary, also creates any parent directories of the new, empty
         directory (like the shell command `mkdir -p`). If called on an existing directory, returns a success
         response; this method is idempotent (it will succeed if the directory already exists).
 
@@ -1076,9 +1054,7 @@ class FilesAPI:
         )
 
     def delete(self, file_path: str):
-        """Delete a file.
-
-        Deletes a file. If the request is successful, there is no response body.
+        """Deletes a file. If the request is successful, there is no response body.
 
         :param file_path: str
           The absolute path of the file.
@@ -1091,9 +1067,7 @@ class FilesAPI:
         self._api.do("DELETE", f"/api/2.0/fs/files{_escape_multi_segment_path_parameter(file_path)}", headers=headers)
 
     def delete_directory(self, directory_path: str):
-        """Delete a directory.
-
-        Deletes an empty directory.
+        """Deletes an empty directory.
 
         To delete a non-empty directory, first delete all of its contents. This can be done by listing the
         directory contents and deleting each file and subdirectory recursively.
@@ -1111,9 +1085,7 @@ class FilesAPI:
         )
 
     def download(self, file_path: str) -> DownloadResponse:
-        """Download a file.
-
-        Downloads a file. The file contents are the response body. This is a standard HTTP file download, not
+        """Downloads a file. The file contents are the response body. This is a standard HTTP file download, not
         a JSON RPC. It supports the Range and If-Unmodified-Since HTTP headers.
 
         :param file_path: str
@@ -1140,9 +1112,7 @@ class FilesAPI:
         return DownloadResponse.from_dict(res)
 
     def get_directory_metadata(self, directory_path: str):
-        """Get directory metadata.
-
-        Get the metadata of a directory. The response HTTP headers contain the metadata. There is no response
+        """Get the metadata of a directory. The response HTTP headers contain the metadata. There is no response
         body.
 
         This method is useful to check if a directory exists and the caller has access to it.
@@ -1163,9 +1133,7 @@ class FilesAPI:
         )
 
     def get_metadata(self, file_path: str) -> GetMetadataResponse:
-        """Get file metadata.
-
-        Get the metadata of a file. The response HTTP headers contain the metadata. There is no response body.
+        """Get the metadata of a file. The response HTTP headers contain the metadata. There is no response body.
 
         :param file_path: str
           The absolute path of the file.
@@ -1190,9 +1158,7 @@ class FilesAPI:
     def list_directory_contents(
         self, directory_path: str, *, page_size: Optional[int] = None, page_token: Optional[str] = None
     ) -> Iterator[DirectoryEntry]:
-        """List directory contents.
-
-        Returns the contents of a directory. If there is no directory at the specified path, the API returns a
+        """Returns the contents of a directory. If there is no directory at the specified path, the API returns a
         HTTP 404 error.
 
         :param directory_path: str
@@ -1242,9 +1208,7 @@ class FilesAPI:
             query["page_token"] = json["next_page_token"]
 
     def upload(self, file_path: str, contents: BinaryIO, *, overwrite: Optional[bool] = None):
-        """Upload a file.
-
-        Uploads a file of up to 5 GiB. The file contents should be sent as the request body as raw bytes (an
+        """Uploads a file of up to 5 GiB. The file contents should be sent as the request body as raw bytes (an
         octet stream); do not encode or otherwise modify the bytes before sending. The contents of the
         resulting file will be exactly the bytes sent in the request body. If the request is successful, there
         is no response body.