# Release History ## 12.31.0-beta.2 (Unreleased) ### Features Added ### Breaking Changes ### Bugs Fixed ### Other Changes ## 12.30.0 (2026-05-14) ### Features Added - Added support for improved error handling for file share provisioning. - Added cross-tenant support for principal bound delegation SAS. - Added support for service version 2026-04-06. ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.32.3` to version `12.33.0`. ## 12.29.3 (2026-05-05) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.32.2` to version `12.32.3`. - Upgraded `azure-core-http-netty` from `1.16.3` to version `1.16.4`. - Upgraded `azure-core` from `1.57.1` to version `1.58.0`. ## 12.31.0-beta.1 (2026-03-25) ### Features Added - Added support for uploading up to 4 MiB of data with create file APIs. - Added support for service version 2026-06-06. ## 12.30.0-beta.1 (2026-02-19) ### Features Added - Added support for improved error handling for file share provisioning. - Added cross-tenant support for principal bound delegation SAS. - Added support for service version 2026-04-06. ## 12.29.2 (2026-02-05) ### Bugs Fixed - Fixed a bug where builders were only using a single credential when multiple credentials were added and credentials were silently overwritten for principle-bound user delegation SAS. All credential changes will now be logged at the info level; invalid combinations of credentials will throw an error. ### Other Changes #### Dependency Updates - Updated `azure-storage-blob` from `12.33.1` to `12.33.2` in `azure-storage-blob`. - updated `azure-storage-common` from `12.32.1` to `12.32.2` in `azure-storage-common`. ### Bugs Fixed - Fixed a bug where builders were only using a single credential when multiple credentials were added and credentials were silently overwritten for principle-bound user delegation SAS. All credential changes will now be logged at the info level; invalid combinations of credentials will throw an error. This is a _potentially breaking_ change if users were incorrectly applying multiple credentials ## 12.29.1 (2026-01-29) ### Other Changes #### Dependency Updates - Upgraded `azure-core-http-netty` from `1.16.2` to version `1.16.3`. - Upgraded `azure-storage-common` from `12.32.0` to version `12.32.1`. - Upgraded `azure-core` from `1.57.0` to version `1.57.1`. ## 12.29.0 (2026-01-15) ### Features Added - Added support for User Delegation SAS. - Added support for Principal-Bound Identity User Delegation SAS. - Added support for the `ShareServiceProperties.Protocol.SMB.EncryptionInTransit` parameter on `ShareServiceClient.setProperties()` APIs. - Added support for service version 2026-02-06. ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.31.0` to version `12.32.0`. ## 12.29.0-beta.1 (2025-12-03) ### Features Added - Added support for User Delegation SAS. - Added support for Principal-Bound Identity User Delegation SAS. - Added support for the `ShareServiceProperties.Protocol.SMB.EncryptionInTransit` parameter on `ShareServiceClient.setProperties()` APIs. - Added support for service version 2026-02-06. ## 12.28.0 (2025-10-21) ### Features Added - Added support for bearer token challenges. - Added `ShareErrorCode.ShareSnapshotNotFound`. - Added more useful error message when the SDK encounters an x-ms-version mismatch issue. - Added support for service version 2025-11-05. ### Bugs Fixed - Fixed a bug where `ShareDirectoryClient.exists` and `ShareFileClient.exists` did not properly handle 404's with the error code `ParentNotFound`. ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.30.0` to version `12.31.0`. - Upgraded `azure-core` from `1.55.5` to version `1.57.0`. - Upgraded `azure-core-http-netty` from `1.15.13` to version `1.16.2`. ## 12.27.3 (2025-09-25) ### Other Changes #### Dependency Updates - Upgraded `azure-core-http-netty` from `1.16.0` to version `1.16.1`. - Upgraded `azure-core` from `1.56.0` to version `1.56.1`. - Upgraded `azure-storage-common` from `12.30.2` to version `12.30.3`. ## 12.27.2 (2025-08-21) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.55.5` to version `1.56.0`. - Upgraded `azure-core-http-netty` from `1.15.13` to version `1.16.0`. - Upgraded `azure-storage-common` from `12.30.1` to version `12.30.2`. ## 12.27.1 (2025-07-29) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.55.3` to version `1.55.5`. - Upgraded `azure-storage-common` from `12.30.0` to version `12.31.0-beta.2`. - Upgraded `azure-core-http-netty` from `1.15.11` to version `1.15.13`. ## 12.27.0 (2025-07-16) ### Features Added - Added the `ShareFileClient.CreateSymbolicLink()`, `.CreateSymbolicLinkAsync()`, `.GetSymbolicLink()`, and `.GetSymbolicLinkAsync()` APIs. - Added support for service version 2025-07-05. ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.29.0` to version `12.30.0`. - Upgraded `azure-core` from `1.55.2` to version `1.55.3`. - Upgraded `azure-core-http-netty` from `1.15.10` to version `1.15.11`. ## 12.28.0-beta.1 (2025-07-09) ### Features Added - Added support for bearer token challenges. - Added `ShareErrorCode.ShareSnapshotNotFound`. - Added more useful error message when the SDK encounters an x-ms-version mismatch issue. - Added support for service version 2025-11-05. ## 12.26.1 (2025-06-19) ### Other Changes #### Dependency Updates - Upgraded `azure-core-http-netty` from `1.15.11` to version `1.15.12`. - Upgraded `azure-storage-common` from `12.29.0` to version `12.30.0-beta.2`. - Upgraded `azure-core` from `1.55.3` to version `1.55.4`. ## 12.27.0-beta.1 (2025-05-06) ### Features Added - Added the `ShareFileClient.CreateSymbolicLink()`, `.CreateSymbolicLinkAsync()`, `.GetSymbolicLink()`, and `.GetSymbolicLinkAsync()` APIs. - Added support for service version 2025-07-05. ## 12.26.0 (2025-03-11) ### Features Added - Added support for NFS over REST. - Added support for service version 2025-05-05. ### Breaking Changes - The following APIs no longer send the x-ms-file-permission, x-ms-file-attributes, x-ms-file-creation-time, and x-ms-file-last-write-time request headers by default. These headers have been optional in the REST API since x-ms-version 2021-06-08: - ShareDirectoryClient/ShareDirectoryAsyncClient.createWithResponse() - ShareDirectoryClient/ShareDirectoryAsyncClient.setPropertiesWithResponse() - ShareFileClient/ShareFileAsyncClient.createWithResponse() - ShareFileClient/ShareFileAsyncClient.beginCopy() - ShareFileClient/ShareFileAsyncClient.setPropertiesWithResponse() ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.28.1` to version `12.29.0`. ## 12.25.2 (2025-03-03) ### Other Changes #### Dependency Updates - Upgraded `azure-xml` from `1.1.0` to version `1.2.0`. - Upgraded `azure-storage-common` from `12.28.0` to version `12.29.0-beta.2`. - Upgraded `azure-core` from `1.54.0` to version `1.55.2`. - Upgraded `azure-core-http-netty` from `1.15.6` to version `1.15.10`. ## 12.26.0-beta.1 (2025-02-11) ### Features Added - Added support for NFS over REST. - Added support for service version 2025-05-05. ### Breaking Changes - The following APIs no longer send the x-ms-file-permission, x-ms-file-attributes, x-ms-file-creation-time, and x-ms-file-last-write-time request headers by default. These headers have been optional in the REST API since x-ms-version 2021-06-08: - ShareDirectoryClient/ShareDirectoryAsyncClient.createWithResponse() - ShareDirectoryClient/ShareDirectoryAsyncClient.setPropertiesWithResponse() - ShareFileClient/ShareFileAsyncClient.createWithResponse() - ShareFileClient/ShareFileAsyncClient.beginCopy() - ShareFileClient/ShareFileAsyncClient.setPropertiesWithResponse() ## 12.25.1 (2024-12-04) ### Bugs Fixed - `ShareFileClient.downloadToFile()` now retries for a maximum of 5 times when the download fails due to a network error. Previously, the maximum number of retries was unintentionally higher (maximum of 15), which could lead to writing in incorrect positions in the file when retried more than 5 times. ## 12.25.0 (2024-11-13) ### Features Added - Added support for the provisioned V2 billing model. - Added support for specifying the binary file permission format for ShareFileClient.beginCopy and ShareFileAsyncClient.beginCopy - Added ShareAccessTier Premium value. - Added support for service version 2025-01-05. ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.52.0` to version `1.54.0`. - Upgraded `azure-core-http-netty` from `1.15.4` to version `1.15.6`. - Upgraded `azure-storage-common` from `12.27.0` to version `12.28.0`. ## 12.25.0-beta.1 (2024-10-17) ### Features Added - Added support for the provisioned V2 billing model. - Added support for specifying the binary file permission format for ShareFileClient.beginCopy and ShareFileAsyncClient.beginCopy - Added ShareAccessTier Premium value. - Added support for service version 2025-01-05. ## 12.24.0 (2024-09-17) ### Features Added - Added support for token-based authentication for all APIs. - Added support for paid bursting on premium file share accounts. - Added support for binary format for file permissions. - Added ability to retrieve SAS string to sign for debugging purposes. - Added support for service version 2024-11-04. ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.50.0` to version `1.52.0`. - Upgraded `azure-core-http-netty` from `1.15.2` to version `1.15.4`. - Upgraded `azure-storage-common` from `12.26.0` to version `12.27.0`. ## 12.24.0-beta.1 (2024-08-06) ### Features Added - Added support for token-based authentication for all APIs. - Added support for paid bursting on premium file share accounts. - Added support for binary format for file permissions. - Added ability to retrieve SAS string to sign for debugging purposes. - Added support for service version 2024-11-04. ## 12.23.0 (2024-07-18) ### Features Added - Added support for snapshot management on NFS shares. - Added authorization error details in responses. - Added support for service version 2024-08-04. ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.49.1` to version `1.50.0`. - Upgraded `azure-core-http-netty` from `1.15.1` to version `1.15.2`. - Upgraded `azure-storage-common` from `12.25.1` to version `12.26.0`. ## 12.23.0-beta.1 (2024-06-11) ### Features Added - Added support for snapshot management on NFS shares. - Added authorization error details in responses. - Added support for service version 2024-08-04. ## 12.22.1 (2024-06-06) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.49.0` to version `1.49.1`. - Upgraded `azure-core-http-netty` from `1.15.0` to version `1.15.1`. - Upgraded `azure-storage-common` from `12.25.0` to version `12.25.1`. ## 12.22.0 (2024-05-15) ### Features Added - Added support for service versions 2024-02-04 and 2024-05-04. - Added `clientName` property on `HandleItem` that specifies the name of the client machine where the share is being mounted. - Added rename support for `listRange` API via `supportRename` in `ShareFileListRangesDiffOptions`. ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.48.0` to version `1.49.0`. - Upgraded `azure-core-http-netty` from `1.14.2` to version `1.15.0`. - Upgraded `azure-storage-common` from `12.25.0-beta.2` to version `12.25.0`. ## 12.21.4 (2024-04-23) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.47.0` to version `1.48.0`. - Upgraded `azure-core-http-netty` from `1.14.1` to version `1.14.2`. - Upgraded `azure-storage-common` from `12.24.3` to version `12.25.0-beta.2`. ## 12.22.0-beta.1 (2024-04-15) ### Features Added - Added support for service versions 2024-02-04 and 2024-05-04. - Added `clientName` property on `HandleItem` that specifies the name of the client machine where the share is being mounted. - Added rename support for `listRange` API via `supportRename` in `ShareFileListRangesDiffOptions`. ## 12.21.3 (2024-03-20) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.24.2` to version `12.24.3`. - Upgraded `azure-core` from `1.46.0` to version `1.47.0`. - Upgraded `azure-core-http-netty` from `1.14.0` to version `1.14.1`. ## 12.21.2 (2024-02-22) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.24.1` to version `12.24.2`. - Upgraded `azure-core` from `1.45.1` to version `1.46.0`. - Upgraded `azure-core-http-netty` from `1.13.11` to version `1.14.0`. ## 12.21.1 (2023-12-04) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.24.0` to version `12.24.1`. - Upgraded `azure-core-http-netty` from `1.13.10` to version `1.13.11`. - Upgraded `azure-core` from `1.45.0` to version `1.45.1`. ## 12.21.0 (2023-11-08) ### Features Added - Added support for service versions 2023-11-03. - Added support for ShareAudience. ## 12.20.1 (2023-10-24) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.23.0` to version `12.23.1`. - Upgraded `azure-core-http-netty` from `1.13.7` to version `1.13.9`. - Upgraded `azure-core` from `1.43.0` to version `1.44.1`. ## 12.21.0-beta.1 (2023-10-19) ### Features Added - Added support for service versions 2023-11-03. - Added support for ShareAudience. ## 12.20.0 (2023-09-12) ### Features Added - Added support for service versions 2023-05-03 and 2023-08-03. ## 12.19.1 (2023-08-18) ### Other Changes #### Dependency Updates - Upgraded `azure-storage-common` from `12.22.0` to version `12.22.1`. - Upgraded `azure-core-http-netty` from `1.13.5` to version `1.13.6`. - Upgraded `azure-core` from `1.41.0` to version `1.42.0`. ## 12.20.0-beta.1 (2023-08-08) ### Features Added - Added support for service versions 2023-05-03 and 2023-08-03. ## 12.19.0 (2023-07-11) ### Features Added - Added support for the `2023-01-03` service version. - Added `ShareFileHandleAccessRights` property on `HandleItem` that specifies access rights for a file handle. ## 12.18.2 (2023-06-14) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.39.0` to version `1.40.0`. - Upgraded `azure-core-http-netty` from `1.13.3` to version `1.13.4`. - Upgraded `azure-storage-common` from `12.21.1` to version `12.21.2`. ## 12.19.0-beta.1 (2023-05-30) ### Features Added - Added support for 2023-01-03 service version. - Added `ShareFileHandleAccessRights` property on `HandleItem` that specifies access rights for a file handle. ## 12.18.1 (2023-05-23) ### Other Changes #### Dependency Updates - Upgraded `azure-core-http-netty` from `1.13.2` to version `1.13.3`. - Upgraded `azure-core` from `1.38.0` to version `1.39.0`. - Upgraded `azure-storage-common` from `12.21.0` to version `12.21.1`. ## 12.18.0 (2023-04-13) ### Features Added - Added support for 2022-11-02 service version. - Added support for `TokenCredential` to be used for authentication. **Note:** When using a `TokenCredential`, the new keyword parameter `ShareTokenIntent` is **required** and must be provided. Additionally, this form of authentication is only supported for certain operations in the Data Plane SDK. - Added support for `allowTrailingDot` and `allowSourceTrailingDot` on client construction. When `allowTrailingDot` is provided, the service will not silently remove any trailing `.` character from directory/file names for all operations made from that client. `allowSourceTrailingDot` will apply this same rule to source files when performing a rename or copy operation. - Added support for reading and writing a file via SeekableByteChannel. ## 12.18.0-beta.1 (2023-03-28) ### Features Added - Added support for 2022-11-02 service version. - Added support for `TokenCredential` to be used for authentication. **Note:** When using a `TokenCredential`, the new keyword parameter `ShareTokenIntent` is **required** and must be provided. Additionally, this form of authentication is only supported for certain operations in the Data Plane SDK. - Added support for `allowTrailingDot` and `allowSourceTrailingDot` on client construction. When `allowTrailingDot` is provided, the service will not silently remove any trailing `.` character from directory/file names for all operations made from that client. `allowSourceTrailingDot` will apply this same rule to source files when performing a rename or copy operation. - Added support for reading and writing a file via SeekableByteChannel. ## 12.17.1 (2023-03-16) ### Other Changes #### Dependency Updates - Upgraded `azure-core-http-netty` from `1.13.0` to version `1.13.1`. - Upgraded `azure-storage-common` from `12.20.0` to version `12.20.1`. - Upgraded `azure-core` from `1.36.0` to version `1.37.0`. ## 12.17.0 (2023-02-21) ### Features Added - Added support for 2021-12-02 service version. - Added support for invalid XML characters in file and directory names for `ShareDirectoryClient.listFilesAndDirectories()`, `ShareDirectoryClient.listHandles()`, and `ShareFileClient.listHandles()`. ## 12.16.3 (2023-02-09) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.35.0` to version `1.36.0`. - Upgraded `azure-core-http-netty` from `1.12.8` to version `1.13.0`. - Upgraded `azure-storage-common` from `12.19.2` to version `12.19.3`. ## 12.17.0-beta.1 (2023-02-07) ### Features Added - Added support for 2021-12-02 service version. - Added support for invalid XML characters in file and directory names for `ShareDirectoryClient.listFilesAndDirectories()`, `ShareDirectoryClient.listHandles()`, and `ShareFileClient.listHandles()`. ## 12.16.2 (2023-01-10) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.34.0` to version `1.35.0`. - Upgraded `azure-core-http-netty` from `1.12.7` to version `1.12.8`. - Upgraded `azure-storage-common` from `12.19.1` to version `12.19.2`. ## 12.16.1 (2022-11-15) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.33.0` to version `1.34.0`. - Upgraded `azure-core-http-netty` from `1.12.6` to version `1.12.7`. - Upgraded `azure-storage-common` from `12.19.0` to version `12.19.1`. ## 12.16.0 (2022-10-11) ### Features Added - Added support for 2021-10-04 service version. ### Bugs Fixed - Fixed a bug that would cause auth failures when trying to rename a file share/directory share while authenticating with a sas. #### Dependency Updates - Upgraded `azure-core` from `1.32.0` to version `1.33.0`. - Upgraded `azure-core-http-netty` from `1.12.5` to version `1.12.6`. - Upgraded `azure-storage-common` from `12.18.1` to version `12.19.0`. ## 12.15.1 (2022-09-12) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.31.0` to version `1.32.0`. - Upgraded `azure-core-http-netty` from `1.12.4` to version `1.12.5`. - Upgraded `azure-storage-common` from `12.18.0` to version `12.18.1`. ## 12.16.0-beta.1 (2022-09-06) ### Features Added - Added support for 2021-10-04 service version. ### Bugs Fixed - Fixed a bug that would cause auth failures when trying to rename a file share/directory share while authenticating with a sas. ## 12.15.0 (2022-08-12) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.30.0` to version `1.31.0`. - Upgraded `azure-core-http-netty` from `1.12.3` to version `1.12.4`. - Upgraded `azure-storage-common` from `12.17.0` to version `12.18.0-beta.1`. ## 12.14.0 (2022-07-07) ### Features Added - GA release for 2021-08-06 service version. ## 12.14.0-beta.1 (2022-06-15) ### Features Added - Added support for the 2021-08-06 service version. - Added new overload of ShareFileClient.BeginCopy() and ShareFileAsyncClient.BeginCopy(), added new parameters allowing the copying of the source file's CreatedOn, LastWrittenOn, FileAttributes and ChangedOn properties. ## 12.13.1 (2022-06-08) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.28.0` to version `1.29.1`. - Upgraded `azure-core-http-netty` from `1.12.0` to version `1.12.2`. - Upgraded `azure-storage-common` from `12.16.0` to version `12.16.1`. ## 12.13.0 (2022-05-25) ### Other Changes - GA release for STG 82 ## 12.12.2 (2022-05-12) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.27.0` to version `1.28.0`. - Upgraded `azure-core-http-netty` from `1.11.9` to version `1.12.0`. - Upgraded `azure-storage-common` from `12.15.1` to version `12.15.2`. ## 12.13.0-beta.1 (2022-05-06) ### Features Added - Added support for the 2021-06-08 service version. - Added support for setting the change time on directory/file create, set properties, and rename - Added support for setting content type on file rename. - Added support for FileLastWrittenMode. ## 12.12.1 (2022-04-07) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.26.0` to version `1.27.0`. - Upgraded `azure-core-http-netty` from `1.11.8` to version `1.11.9`. - Upgraded `azure-storage-common` from `12.15.0` to version `12.15.1`. ## 12.12.0 (2022-03-09) ### Other Changes - GA release for STG 79, 80, 81 ## 12.11.4 (2022-02-11) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.24.1` to version `1.25.0`. - Upgraded `azure-core-http-netty` from `1.11.6` to version `1.11.7`. - Upgraded `azure-storage-common` from `12.14.2` to version `12.14.3`. ## 12.12.0-beta.3 (2022-02-09) ### Features Added - Added support for the 2021-04-10 service version. - Added support for renaming files and directories. ## 12.11.3 (2022-01-14) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.22.0` to version `1.24.1`. - Upgraded `azure-core-http-netty` from `1.11.2` to version `1.11.6`. - Upgraded `azure-storage-common` from `12.14.1` to version `12.14.2`. ## 12.12.0-beta.2 (2021-12-07) ### Features Added - Added support for the 2021-02-12 service version. - Added support for new bandwidth limits. ### Bugs Fixed - Fixed a bug that would cause authenticating with a sas token to fail if the timestamps in the token were formatted differently. ## 12.11.2 (2021-11-10) ### Other Changes #### Dependency Updates - Upgraded `azure-core` from `1.21.0` to version `1.22.0`. - Upgraded `azure-core-http-netty` from `1.11.1` to version `1.11.2`. - Upgraded `azure-storage-common` from `12.14.0` to version `12.14.1`. ## 12.12.0-beta.1 (2021-11-05) ### Features Added - Added support for the 2020-12-06 service version. ## 12.11.1 (2021-10-12) ### Other Changes #### Dependency Updates - Updated to version `12.14.0` of `azure-storage-common` - Updated to version `1.21.0` of `azure-core` ## 12.11.0 (2021-09-15) - GA release ## 12.11.0-beta.1 (2021-07-28) - Added support to reliably download a file. - Added support for the 2020-10-02 service version. - Fixed a bug that was cause an Exception when downloading a zero length file. ## 12.10.0 (2021-06-09) - GA release ## 12.10.0-beta.1 (2021-05-13) - Added support for the 2020-08-04 service version. - Added back ability to create a ShareLeaseClient for a Share or Share Snapshot. - Added upload() overloads to ShareFileClient supporting large ranges and parallel upload. - Deprecated old upload() overloads on ShareFileClient that only supported single Put Range operations, replacing them with uploadRange() methods. ## 12.9.1 (2021-05-13) ### Dependency Updates - Updated `azure-core` to version `1.16.0` - Updated `azure-storage-common` to version `12.11.1` ## 12.9.0 (2021-04-29) - ShareLeaseClient now updates it's leaseID through a lease change. - Fixed a bug where working with a root directory client could improperly form requests and subdirectory clients ## 12.9.0-beta.3 (2021-04-16) - Updated azure-storage-common dependencies. ## 12.9.0-beta.2 (2021-03-29) - Updated azure-storage-common and azure-core dependencies. ## 12.9.0-beta.1 (2021-02-10) - Added support for the 2020-06-12 service version. ## 12.8.0 (2021-01-14) - GA release ## 12.8.0-beta.1 (2020-12-07) - Exposed ClientOptions on all client builders, allowing users to set a custom application id and custom headers. - Fixed a bug where snapshot would be appended to a share snapshot instead of sharesnapshot. - Fixed a bug where the sharesnapshot query parameter would be ignored in share and share file client builders. - Fixed a bug where the error message would not be displayed the exception message of a HEAD request. - Added a MetadataValidationPolicy to check for leading and trailing whitespace in metadata that would cause Auth failures. - Added support for the 2020-04-08 service version. - Added support for specifying enabled protocols on share creation - Added support for setting root squash on share creation and through set properties. ## 12.7.0 (2020-11-11) - Added support to specify whether or not a pipeline policy should be added per call or per retry. - Added support for setting access tier on a share through ShareClient.create, ShareClient.setAccessTier. - Added support for getting access tier on a share through ShareClient.getProperties, ShareServiceClient.listShares - Fixed a bug where interspersed element types returned by range diff listing would deserialize incorrectly. - Renamed setAccessTier to setProperties and deprecated setQuotaInGb in favor of setProperties. - Renamed DeleteSnapshotsOptionType to ShareSnapshotsDeleteOptionType in ShareClient.delete - Removed ability to create a ShareLeaseClient for a Share or Share Snapshot. This feature has been rescheduled for future release. ## 12.7.0-beta.1 (2020-10-01) - Added support for the 2020-02-10 service version. - Added support to getFileRanges on a previous snapshot by adding the getFileRangesDiff API. - Added support to set whether or not smb multichannel is enabled. - Added support to lease shares and snapshot shares. - Added support to specify a lease id for share operations. - Fixed a bug where getProperties on a file client would throw a HttpResponseException instead of ShareStorageException. - Fixed a bug where snapshot would be appended to a share snapshot instead of sharesnapshot. - Fixed a bug that would cause auth failures when building a client by passing an endpoint which had a sas token with protocol set to https,http - Fixed a bug where a custom application id in HttpLogOptions would not be added to the User Agent String. ## 12.6.0 (2020-08-13) - GA release for 2019-12-12 service version ## 12.6.0-beta.1 (2020-07-07) - Added support for the 2019-12-12 service version. - Added support for restoring file share. ## 12.5.0 (2020-06-12) - Fixed bug in ShareFileClient.uploadRangeFromUrl and ShareFileClient.beginCopy where sourceUrl was not getting encoded. - Updated azure-storage-common and azure-core dependencies. ## 12.4.1 (2020-05-06) - Updated `azure-core` version to `1.5.0` to pickup fixes for percent encoding `UTF-8` and invalid leading bytes in a body string. ## 12.4.0 (2020-04-06) - Fixed an issue where whitespace would cause NtfsFileAttributes.toAttributes/fromAttributes to result in an error parsing the attributes. - Fixed a bug where the Date header wouldn't be updated with a new value on request retry. ## 12.3.0 (2020-03-11) - Added support for exists methods on Share, ShareDirectory and ShareFile clients. ## 12.2.0 (2020-02-12) - Fixed bug in ShareClient.getStatistics where shareUsageInGB was not properly converted. Added parameter to ShareStatistics to include a shareUsageInBytes parameter. - Fixed bug where ShareDirectoryAsyncClient.getFileClient appended an extra / for files in the root directory. - Added support for the 2019-07-07 service version. - Added support for file leases. Includes adding the ShareLeaseClientBuilder, ShareLeaseClient, and ShareLeaseAsync client and overloads accepting leaseIds for operations that support leases. - Added failedClosedHandles property to CloseHandlesInfo to allow users to access number of failed handles in forceCloseAllHandles and closeHandle. - Added support for obtaining premium file properties in ShareServiceClient.listShares and ShareClient.getProperties. - Added support for additional start copy parameters - FileSmbProperties, file permission, file permission copy mode, set archive and ignore read only. ## 12.1.1 (2020-02-10) - Updated `azure-core-http-netty` to version 1.3.0 - Update `azure-storage-common` to version 12.3.1 ## 12.1.0 (2020-01-08) This package's [documentation](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file-share_12.1.0/sdk/storage/azure-storage-file-share/README.md) and [samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file-share_12.1.0/sdk/storage/azure-storage-file-share/src/samples/java/com/azure/storage/file/share) ## 12.1.0-beta.1 (2019-12-18) - Added SAS generation methods on clients to improve discoverability and convenience of sas. Deprecated setFilePath, setShareName generateSasQueryParameters methods on ShareServiceSasSignatureValues to direct users to using the methods added on clients. ## 12.0.0 (2019-12-04) This package's [documentation](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file-share_12.0.0/sdk/storage/azure-storage-file-share/README.md) and [samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file-share_12.0.0/sdk/storage/azure-storage-file-share/src/samples/java/com/azure/storage/file/share) - GA release. - Changed return type for forceCloseHandle from void to CloseHandlesInfo. - Changed return type for forceCloseAllHandles from int to CloseHandlesInfo. - Upgraded to version 1.1.0 of Azure Core. ## 12.0.0-preview.5 (2019-10-31) - Renamed FileReference to StorageFileItem - Changed response of ShareClient.listFilesAndDirectories FileReference to StorageFileItem - FileUploadRangeFromUrlInfo eTag() changed to getETag() and lastModified() changed to getLastModidified() - Changed response of FileAsyncClient.download() from Mono to Flux - Renamed FileAsyncClient.downloadWithPropertiesWithResponse to downloadLoadWithResponse - Removed FileAsyncClient.uploadWithResponse(Flux, long, long) - Changed response of FileClient.download() from FileDownloadInfo to voif - Renamed FileClient.downloadWithPropertiesWithResponse to downloadLoadWithResponse - Changed FileClient upload methods to take InputStreams instead of ByteBuffers - Removed FileClient.uploadWithResponse(ByteBuffer, long, long) - Deleted FileDownloadInfo - Removed FileProperty from public API - Removed BaseFileClientBuilder - Removed FileClientBuilder, ShareClientBuilder, and FileServiceClientBuilder inheritance of BaseFileClientBuilder - Renamed ListShatesOptions getMaxResults and setMaxResults to getMaxResultsPerPage and setMaxResultsPerPage - Removes StorageError and StorageErrorException from public API - Renamed StorageErrorCode to FileErrorCode, SignedIdentifier to FileSignedIdentifier, StorageServiceProperties to FileServiceProperties, CorRules to FileCorRules, AccessPolicy to FileAccessPolicy, and Metrics to FileMetrics - Renamed FileHTTPHeaders to FileHttpHeaders and removed File from getter names - Replaced forceCloseHandles(String, boolean) with forceCloseHandle(String) and forceCloseHandles(boolean) - Renamed StorageException to FileStorageException - Added FileServiceVersion and the ability to set it on client builders - Replaced URL parameters with String on uploadRangeFromUrl - Replaced startCopy with beginCopy and return poller - Renamed FileSasPermission getters to use has prefix - Changed return type for FileClient.downloadWithProperties from Response to FileDownloadResponse and FileAsyncClient.downloadWithProperties from Mono>> to Mono ## 12.0.0-preview.4 (2019-10-08) For details on the Azure SDK for Java (October 2019 Preview) release, you can refer to the [release announcement](https://aka.ms/azure-sdk-preview4-java). This package's [documentation](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file_12.0.0-preview.4/sdk/storage/azure-storage-file/README.md) and [samples](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file_12.0.0-preview.4/sdk/storage/azure-storage-file/src/samples/java/com/azure/storage/file) - Getters and setters were updated to use Java Bean notation. - Added `getShareName`, `getDirectoryPath` and `getFilePath` for fetching the resource names. - Updated to be fully compliant with the Java 9 Platform Module System. - Changed `VoidResponse` to `Response` on sync API, and `Mono` to `Mono>` on async API. - Fixed metadata does not allow capital letter issue. [`Bug 5295`](https://github.com/Azure/azure-sdk-for-java/issues/5295) - Updated the return type of `downloadToFile` API to `FileProperties` on sync API and `Mono` on async API. - `getFileServiceUrl`, `getShareUrl`, `getDirectoryUrl`, `getFileUrl` API now returns URL with scheme, host, resource name and snapshot if any. - Removed SAS token generation APIs from clients, use FileServiceSasSignatureValues to generate SAS tokens. - Removed `SASTokenCredential`, `SASTokenCredentialPolicy` and the corresponding `credential(SASTokenCredential)` method in client builder, and added sasToken(String) instead. ## 12.0.0-preview.3 (2019-09-10) For details on the Azure SDK for Java (September 2019 Preview) release, you can refer to the [release announcement](https://aka.ms/azure-sdk-preview3-java). This package's [documentation](https://github.com/Azure/azure-sdk-for-java/blob/085c8570b411defff26860ef56ea189af07d3d6a/sdk/storage/azure-storage-file/README.md) and [samples](https://github.com/Azure/azure-sdk-for-java/tree/085c8570b411defff26860ef56ea189af07d3d6a/sdk/storage/azure-storage-file/src/samples/java/com/azure/storage/file) demonstrate the new API. - Added tracing telemetry on maximum overload API. - Added generate SAS token APIs. - Throw `StorageException` with error code when get error response from service. - Moved `ReactorNettyClient` into a separate module as default plugin. Customer can configure a custom http client through builder. - Throw `UnexpectedLengthException` when the upload body length does not match the input length. [GitHub #4193](https://github.com/Azure/azure-sdk-for-java/issues/4193) - Added validation policy to check the equality of request client id between request and response. - Added `PageFlux` on async APIs and `PageIterable` on sync APIs. - Upgraded to use service version 2019-02-02 from 2018-11-09. - Replaced `ByteBuf` with `ByteBuffer` and removed dependency on `Netty`. - Added `uploadRangeFromUrl` APIs on sync and async File client. - Added `timeout` parameter for sync APIs which allows requests throw exception if no response received within the time span. - Added `azure-storage-common` as a dependency. - Added the ability for the user to obtain file SMB properties and file permissions from getProperties APIs on File and Directory and download APIs on File. - Added setProperties APIs on sync and async Directory client. Allows users to set file SMB properties and file permission. **Breaking changes: New API design** - Changed list responses to `PagedFlux` on async APIs and `PagedIterable` on sync APIs. - Replaced setHttpHeaders with setProperties APIs on sync and async File client. Additionally Allows users to set file SMB properties and file permission. - Added file smb properties and file permission parameters to create APIs on sync and async File and Directory clients. ## 12.0.0-preview.2 (2019-08-08) Version 12.0.0-preview.2 is a preview of our efforts in creating a client library that is developer-friendly, idiomatic to the Java ecosystem, and as consistent across different languages and platforms as possible. The principles that guide our efforts can be found in the [Azure SDK Design Guidelines for Java](https://aka.ms/azsdk/guide/java). For details on the Azure SDK for Java (August 2019 Preview) release, you can refer to the [release announcement](https://azure.github.io/azure-sdk/releases/2019-08-06/java.html). This package's [documentation](https://github.com/Azure/azure-sdk-for-java/blob/azure-storage-file_12.0.0-preview.2/sdk/storage/azure-storage-file/README.md) and [samples](https://github.com/Azure/azure-sdk-for-java/tree/azure-storage-file_12.0.0-preview.2/sdk/storage/azure-storage-file/src/samples/java/com/azure/storage/file) demonstrate the new API. ### Features included in `azure-storage-file` - This is initial SDK release for storage file service. - Packages scoped by functionality - `azure-storage-file` contains a `FileServiceClient`, `FileServiceAsyncClient`, `ShareClient`, `ShareAsyncClient`, `DirectoryClient`, `DirectoryAsyncClient`, `FileClient` and `FileAsyncClient` for storage file operations. - Client instances are scoped to storage file service. - Reactive streams support using [Project Reactor](https://projectreactor.io/).