Azure · l0lawrence · Mar 24, 2026 · Mar 24, 2026 · Mar 24, 2026 · Mar 24, 2026
@@ -4,10 +4,9 @@
 
 ### Features Added
 
-## 12.25.0 (2026-06-08)
-
-### Features Added
-- Stable release of features from 12.25.0b1
+### Other Changes
+- Content-Type for append_data has changed from application/json to octet-stream
+- Dropped support for legacy transports
 
 ## 12.24.0 (2026-05-14)
 
@@ -23,7 +22,7 @@ basis and with retries. Prior to this fix logging may have not behaved as expect
 
 ### Features Added
 - Added support for service version 2026-06-06.
-- Added support for connection strings and `account_url`s to accept URLs with `-ipv6` and `-dualstack` suffixes
+- Added support for connection strings and `account_url`s to accept URLs with `-ipv6` and `-dualstack` suffixes 
 for `DataLakeServiceClient`, `FileSystemClient`, `DataLakeDirectoryClient`, and `DataLakeFileClient`.
 - Added support for `DataLakeDirectoryClient` and `DataLakeFileClient`'s `set_tags` and `get_tags` APIs
 to conditionally set and get tags associated with a directory or file client, respectively.
@@ -35,15 +34,15 @@ to conditionally set and get tags associated with a directory or file client, re
 
 ### Features Added
 - Added support for service version 2026-04-06.
-- Added support for the keyword `user_delegation_tid` to `DataLakeServiceClient.get_user_delegation_key`
-API, which can be used in `generate_file_system_sas`, `generate_directory_sas`, and `generate_file_sas`
-to specify the Tenant ID that is authorized to use the generated SAS URL. Note that `user_delegation_tid`
+- Added support for the keyword `user_delegation_tid` to `DataLakeServiceClient.get_user_delegation_key` 
+API, which can be used in `generate_file_system_sas`, `generate_directory_sas`, and `generate_file_sas` 
+to specify the Tenant ID that is authorized to use the generated SAS URL. Note that `user_delegation_tid` 
 must be used together with `user_delegation_oid`.
-- Added support for the keyword `request_headers` to `generate_file_system_sas`, `generate_directory_sas`,
-and `generate_file_sas` which specifies a set of headers and their corresponding values that
+- Added support for the keyword `request_headers` to `generate_file_system_sas`, `generate_directory_sas`, 
+and `generate_file_sas` which specifies a set of headers and their corresponding values that 
 must be present in the request header when using the generated SAS.
-- Added support for the keyword `request_query_params` to `generate_file_system_sas`, `generate_directory_sas`,
-and `generate_file_sas` which specifies a set of query parameters and their corresponding values that
+- Added support for the keyword `request_query_params` to `generate_file_system_sas`, `generate_directory_sas`, 
+and `generate_file_sas` which specifies a set of query parameters and their corresponding values that 
 must be present in the request URL when using the generated SAS.
 
 ### Other Changes
@@ -70,9 +69,9 @@ significantly better throughput on large file downloads for most environments.
 - Added the ability to skip auto decompression on `DataLakeFileClient.download_file` via the `decompress` keyword.
 
 ### Other Changes
-- Migrated any previously documented `kwarg` arguments to be named keywords.
+- Migrated any previously documented `kwarg` arguments to be named keywords. 
 Some public types may have been adjusted if they were previously erroneous or incomplete.
-- Removed `__enter__` and `__exit__` attributes for all asynchronous client objects for raising explicit `TypeError`,
+- Removed `__enter__` and `__exit__` attributes for all asynchronous client objects for raising explicit `TypeError`, 
 and let the `AttributeError` raise directly.
 
 ## 12.22.0 (2025-10-15)
@@ -81,7 +80,7 @@ and let the `AttributeError` raise directly.
 - Stable release of features from 12.22.0b1
 
 ### Other Changes
-- Removed `__enter__` and `__exit__` attributes for all asynchronous client objects for raising explicit `TypeError`,
+- Removed `__enter__` and `__exit__` attributes for all asynchronous client objects for raising explicit `TypeError`, 
 and let the `AttributeError` raise directly.
 
 ## 12.21.0 (2025-07-16)
@@ -100,7 +99,7 @@ This version and all future versions will require Python 3.9+. Python 3.8 is no
 
 ### Features Added
 - Added support for service version 2025-07-05.
-- Added support for OAuth authentication in `FileSystemClient`'s `get_file_system_access_policy`
+- Added support for OAuth authentication in `FileSystemClient`'s `get_file_system_access_policy` 
 and `set_file_system_access_policy` APIs.
 - Added support for progress tracking to `DataLakeFileClient`'s `upload_data` and `download_file`
 APIs via a new optional callback, `progress_hook`.

@@ -1,7 +1,7 @@
 include *.md
-include azure/__init__.py
-include azure/storage/__init__.py
 include LICENSE
+include azure/storage/filedatalake/py.typed
 recursive-include tests *.py
 recursive-include samples *.py *.md
-include azure/storage/filedatalake/py.typed
+include azure/__init__.py
+include azure/storage/__init__.py
@@ -0,0 +1,6 @@
+{
+  "apiVersion": "2026-06-06",
+  "apiVersions": {
+    "Storage.DataLake": "2026-06-06"
+  }
+}
@@ -0,0 +1,69 @@
+{
+    "CrossLanguagePackageId": "Storage.DataLake",
+    "CrossLanguageDefinitionId": {
+        "azure.storage.filedatalake.models.AclFailedEntry": "Storage.DataLake.AclFailedEntry",
+        "azure.storage.filedatalake.models.BlobHierarchyListSegment": "Storage.DataLake.BlobHierarchyListSegment",
+        "azure.storage.filedatalake.models.BlobItemInternal": "Storage.DataLake.BlobItem",
+        "azure.storage.filedatalake.models.BlobPrefix": "Storage.DataLake.BlobPrefix",
+        "azure.storage.filedatalake.models.BlobPropertiesInternal": "Storage.DataLake.BlobPropertiesInternal",
+        "azure.storage.filedatalake.models.FileSystemItem": "Storage.DataLake.FileSystemItem",
+        "azure.storage.filedatalake.models.FileSystemList": "Storage.DataLake.FileSystemList",
+        "azure.storage.filedatalake.models.ListBlobsHierarchySegmentResponse": "Storage.DataLake.ListBlobsHierarchySegmentResponse",
+        "azure.storage.filedatalake.models.Path": "Storage.DataLake.PathItem",
+        "azure.storage.filedatalake.models.PathList": "Storage.DataLake.PathList",
+        "azure.storage.filedatalake.models.SetAccessControlRecursiveResponse": "Storage.DataLake.SetAccessControlRecursiveResponse",
+        "azure.storage.filedatalake.models.StorageError": "Storage.DataLake.StorageError",
+        "azure.storage.filedatalake.models.StorageErrorBody": "Storage.DataLake.StorageErrorBody",
+        "azure.storage.filedatalake.models.FileSystemResourceType": "Storage.DataLake.FileSystemResourceType",
+        "azure.storage.filedatalake.models.ListBlobsIncludeItem": "Storage.DataLake.ListBlobsIncludeItem",
+        "azure.storage.filedatalake.models.ListBlobsShowOnly": "Storage.DataLake.ListBlobsShowOnly",
+        "azure.storage.filedatalake.models.PathResourceType": "Storage.DataLake.PathResourceType",
+        "azure.storage.filedatalake.models.PathRenameMode": "Storage.DataLake.PathRenameMode",
+        "azure.storage.filedatalake.models.EncryptionAlgorithmType": "Storage.DataLake.EncryptionAlgorithmType",
+        "azure.storage.filedatalake.models.PathExpiryOptions": "Storage.DataLake.PathExpiryOptions",
+        "azure.storage.filedatalake.models.PathUpdateAction": "Storage.DataLake.PathUpdateAction",
+        "azure.storage.filedatalake.models.PathSetAccessControlRecursiveMode": "Storage.DataLake.PathSetAccessControlRecursiveMode",
+        "azure.storage.filedatalake.models.PathLeaseAction": "Storage.DataLake.PathLeaseAction",
+        "azure.storage.filedatalake.models.PathGetPropertiesAction": "Storage.DataLake.PathGetPropertiesAction",
+        "azure.storage.filedatalake.models.LeaseAction": "Storage.DataLake.LeaseAction",
+        "azure.storage.filedatalake.models.AccountResourceType": "Storage.DataLake.AccountResourceType",
+        "azure.storage.filedatalake.operations.FileSystemOperations.create": "Storage.DataLake.FileSystem.create",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.create": "Storage.DataLake.FileSystem.create",
+        "azure.storage.filedatalake.operations.FileSystemOperations.set_properties": "Storage.DataLake.FileSystem.setProperties",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.set_properties": "Storage.DataLake.FileSystem.setProperties",
+        "azure.storage.filedatalake.operations.FileSystemOperations.get_properties": "Storage.DataLake.FileSystem.getProperties",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.get_properties": "Storage.DataLake.FileSystem.getProperties",
+        "azure.storage.filedatalake.operations.FileSystemOperations.delete": "Storage.DataLake.FileSystem.delete",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.delete": "Storage.DataLake.FileSystem.delete",
+        "azure.storage.filedatalake.operations.FileSystemOperations.list_paths": "Storage.DataLake.FileSystem.listPaths",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.list_paths": "Storage.DataLake.FileSystem.listPaths",
+        "azure.storage.filedatalake.operations.FileSystemOperations.list_blob_hierarchy_segment": "Storage.DataLake.FileSystem.listBlobHierarchySegment",
+        "azure.storage.filedatalake.aio.operations.FileSystemOperations.list_blob_hierarchy_segment": "Storage.DataLake.FileSystem.listBlobHierarchySegment",
+        "azure.storage.filedatalake.operations.PathOperations.create": "Storage.DataLake.Path.create",
+        "azure.storage.filedatalake.aio.operations.PathOperations.create": "Storage.DataLake.Path.create",
+        "azure.storage.filedatalake.operations.PathOperations.update": "Storage.DataLake.Path.update",
+        "azure.storage.filedatalake.aio.operations.PathOperations.update": "Storage.DataLake.Path.update",
+        "azure.storage.filedatalake.operations.PathOperations.lease": "Storage.DataLake.Path.lease",
+        "azure.storage.filedatalake.aio.operations.PathOperations.lease": "Storage.DataLake.Path.lease",
+        "azure.storage.filedatalake.operations.PathOperations.read": "Storage.DataLake.Path.read",
+        "azure.storage.filedatalake.aio.operations.PathOperations.read": "Storage.DataLake.Path.read",
+        "azure.storage.filedatalake.operations.PathOperations.get_properties": "Storage.DataLake.Path.getProperties",
+        "azure.storage.filedatalake.aio.operations.PathOperations.get_properties": "Storage.DataLake.Path.getProperties",
+        "azure.storage.filedatalake.operations.PathOperations.delete": "Storage.DataLake.Path.delete",
+        "azure.storage.filedatalake.aio.operations.PathOperations.delete": "Storage.DataLake.Path.delete",
+        "azure.storage.filedatalake.operations.PathOperations.set_access_control": "Storage.DataLake.Path.setAccessControl",
+        "azure.storage.filedatalake.aio.operations.PathOperations.set_access_control": "Storage.DataLake.Path.setAccessControl",
+        "azure.storage.filedatalake.operations.PathOperations.set_access_control_recursive": "Storage.DataLake.Path.setAccessControlRecursive",
+        "azure.storage.filedatalake.aio.operations.PathOperations.set_access_control_recursive": "Storage.DataLake.Path.setAccessControlRecursive",
+        "azure.storage.filedatalake.operations.PathOperations.flush_data": "Storage.DataLake.Path.flushData",
+        "azure.storage.filedatalake.aio.operations.PathOperations.flush_data": "Storage.DataLake.Path.flushData",
+        "azure.storage.filedatalake.operations.PathOperations.append_data": "Storage.DataLake.Path.appendData",
+        "azure.storage.filedatalake.aio.operations.PathOperations.append_data": "Storage.DataLake.Path.appendData",
+        "azure.storage.filedatalake.operations.PathOperations.set_expiry": "Storage.DataLake.Path.setExpiry",
+        "azure.storage.filedatalake.aio.operations.PathOperations.set_expiry": "Storage.DataLake.Path.setExpiry",
+        "azure.storage.filedatalake.operations.PathOperations.undelete": "Storage.DataLake.Path.undelete",
+        "azure.storage.filedatalake.aio.operations.PathOperations.undelete": "Storage.DataLake.Path.undelete",
+        "azure.storage.filedatalake.operations.ServiceOperations.list_file_systems": "Storage.DataLake.Service.listFileSystems",
+        "azure.storage.filedatalake.aio.operations.ServiceOperations.list_file_systems": "Storage.DataLake.Service.listFileSystems"
+    }
+}
@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/storage/azure-storage-file-datalake",
-  "Tag": "python/storage/azure-storage-file-datalake_34be4c4176"
+  "Tag": "python/storage/azure-storage-file-datalake_b74774dee3"
 }
@@ -76,6 +76,7 @@
     "DataLakeDirectoryClient",
     "DataLakeFileClient",
     "DataLakeFileQueryError",
+    "DataLakeFileQueryError",
     "DataLakeLeaseClient",
     "DataLakeServiceClient",
     "DeletedPathProperties",

@@ -87,7 +87,7 @@ def __init__(
         directory_name: str,
         credential: Optional[
             Union[str, Dict[str, str], "AzureNamedKeyCredential", "AzureSasCredential", "TokenCredential"]
-        ] = None,
+        ] = None,  # pylint: disable=line-too-long
         **kwargs: Any,
     ) -> None:
         super(DataLakeDirectoryClient, self).__init__(
@@ -102,7 +102,7 @@ def from_connection_string(
         directory_name: str,
         credential: Optional[
             Union[str, Dict[str, str], "AzureNamedKeyCredential", "AzureSasCredential", "TokenCredential"]
-        ] = None,
+        ] = None,  # pylint: disable=line-too-long
         **kwargs: Any,
     ) -> Self:
         """

@@ -90,7 +90,7 @@ def __init__(
         file_path: str,
         credential: Optional[
             Union[str, Dict[str, str], "AzureNamedKeyCredential", "AzureSasCredential", "TokenCredential"]
-        ] = None,
+        ] = None,  # pylint: disable=line-too-long
         **kwargs: Any,
     ) -> None:
         super(DataLakeFileClient, self).__init__(
@@ -105,7 +105,7 @@ def from_connection_string(
         file_path: str,
         credential: Optional[
             Union[str, Dict[str, str], "AzureNamedKeyCredential", "AzureSasCredential", "TokenCredential"]
-        ] = None,
+        ] = None,  # pylint: disable=line-too-long
         **kwargs: Any,
     ) -> Self:
         """
@@ -379,7 +379,9 @@ def set_file_expiry(
             expiry_time = convert_datetime_to_rfc1123(expires_on)
         elif expires_on is not None:
             expiry_time = str(expires_on)
-        self._datalake_client_for_blob_operation.path.set_expiry(expiry_options, expires_on=expiry_time, **kwargs)
+        self._datalake_client_for_blob_operation.path.set_expiry(
+            expiry_options=expiry_options, expires_on=expiry_time, **kwargs
+        )
 
     @distributed_trace
     def upload_data(

@@ -66,10 +66,11 @@ def _append_data_options(
         "position": offset,
         "content_length": length,
         "validate_content": validate_content,
-        "cpk_info": cpk_info,
         "timeout": kwargs.pop("timeout", None),
         "cls": return_response_headers,
     }
+    if cpk_info:
+        options.update(cpk_info)
     options.update(kwargs)
     return options
 
@@ -83,7 +84,7 @@ def _flush_data_options(
 ) -> Dict[str, Any]:
     mod_conditions = get_mod_conditions(kwargs)
 
-    path_http_headers = None
+    path_http_headers = {}
     if content_settings:
         path_http_headers = get_path_http_headers(content_settings)
 
@@ -93,14 +94,15 @@ def _flush_data_options(
     options = {
         "position": offset,
         "content_length": 0,
-        "path_http_headers": path_http_headers,
         "retain_uncommitted_data": retain_uncommitted_data,
         "close": kwargs.pop("close", False),
-        "modified_access_conditions": mod_conditions,
-        "cpk_info": cpk_info,
         "timeout": kwargs.pop("timeout", None),
         "cls": return_response_headers,
     }
+    options.update(path_http_headers)
+    options.update(mod_conditions)
+    if cpk_info:
+        options.update(cpk_info)
     options.update(kwargs)
     return options
 
@@ -141,12 +143,17 @@ def _upload_options(
         max_concurrency = DEFAULT_MAX_CONCURRENCY
 
     kwargs["properties"] = add_metadata_headers(metadata)
-    kwargs["lease_access_conditions"] = get_access_conditions(kwargs.pop("lease", None))
-    kwargs["modified_access_conditions"] = get_mod_conditions(kwargs)
-    kwargs["cpk_info"] = get_cpk_info(scheme, kwargs)
+    lease_id = get_access_conditions(kwargs.pop("lease", None))
+    if lease_id:
+        kwargs["lease_id"] = lease_id
+    mod_conditions = get_mod_conditions(kwargs)
+    kwargs.update(mod_conditions)
+    cpk_info = get_cpk_info(scheme, kwargs)
+    if cpk_info:
+        kwargs.update(cpk_info)
 
     if content_settings:
-        kwargs["path_http_headers"] = get_path_http_headers(content_settings)
+        kwargs.update(get_path_http_headers(content_settings))
 
     kwargs["stream"] = stream
     kwargs["length"] = length

@@ -1,3 +1,4 @@
+# pylint: disable=line-too-long,useless-suppression
 # -------------------------------------------------------------------------
 # Copyright (c) Microsoft Corporation. All rights reserved.
 # Licensed under the MIT License. See License.txt in the project root for