STG97 Beta Features (Azure#44043)

* versioning changes for stg97 (Azure#43030)

* versioning changes for stg97

* removing assets file changes

---------

Co-authored-by: Isabelle <[email protected]>

* STG97 - NFS over REST (Azure#43112)

* wip

* temporary fix for FilesCreateHardLinkHeaders

* adding javadocs, and preparing for api review

* removing unused imports

* removing breaking change from ShareDirectory and adding accessor pattern

* changing nfs to posix and refactoring some client methods

* removing breaking changes from ShareDirectoryProperties, ShareFileInfo, and ShareFileProperties

* making NfsFileType a custom type

* addressing api review comments

* fixing documentation errors

* addressing linting report

* using deprecated HttpHeaders.getValue(String) in FilePosixProperties to prevent having to move it to the com.azure.storage.file.share package

* adjusting default value in FilePosixProperties

* fixing spotbugs issue

* adding try catch to hopefully resolve spotbugs issue

* still trying to address spotbugs issue

* addressing spotbugs issue

* adding ModeCopyMode and OwnerCopyMode to copy file options

* addressing comments

* removing unused imports and changing files classes to use lambda expressions for access helpers

* adding new recordings and editing old ones

* addressing comments

* fixing style

* fixing style and updating recording for getPropertiesOAuth

* changing customization for FilesCreateHardLinkHeaders, style, changelog edit

* removing leftover customization

---------

Co-authored-by: gunjansingh-msft <[email protected]>

Author: ibrandes

sdk/storage/azure-storage-blob/src/main/java/com/azure/storage/blob/BlobServiceVersion.java

@@ -132,7 +132,12 @@ public enum BlobServiceVersion implements ServiceVersion {
     /**
      * Service version {@code 2025-01-05}.
      */
-    V2025_01_05("2025-01-05");
+    V2025_01_05("2025-01-05"),
+
+    /**
+     * Service version {@code 2025-05-05}.
+     */
+    V2025_05_05("2025-05-05");
 
     private final String version;
 
@@ -154,6 +159,6 @@ public String getVersion() {
      * @return the latest {@link BlobServiceVersion}
      */
     public static BlobServiceVersion getLatest() {
-        return V2025_01_05;
+        return V2025_05_05;
     }
 }

sdk/storage/azure-storage-common/ci.system.properties

@@ -1,2 +1,2 @@
-AZURE_LIVE_TEST_SERVICE_VERSION=V2025_01_05
-AZURE_STORAGE_SAS_SERVICE_VERSION=2025-01-05
+AZURE_LIVE_TEST_SERVICE_VERSION=V2025_05_05
+AZURE_STORAGE_SAS_SERVICE_VERSION=2025-05-05

sdk/storage/azure-storage-common/src/main/java/com/azure/storage/common/implementation/Constants.java

@@ -88,7 +88,7 @@ public final class Constants {
     public static final String PROPERTY_AZURE_STORAGE_SAS_SERVICE_VERSION = "AZURE_STORAGE_SAS_SERVICE_VERSION";
 
     public static final String SAS_SERVICE_VERSION
-        = Configuration.getGlobalConfiguration().get(PROPERTY_AZURE_STORAGE_SAS_SERVICE_VERSION, "2025-01-05");
+        = Configuration.getGlobalConfiguration().get(PROPERTY_AZURE_STORAGE_SAS_SERVICE_VERSION, "2025-05-05");
 
     public static final String ADJUSTED_BLOB_LENGTH_KEY = "adjustedBlobLength";
 
@@ -218,7 +218,7 @@ public static final class HeaderConstants {
          * @deprecated For SAS Service Version use {@link Constants#SAS_SERVICE_VERSION}.
          */
         @Deprecated
-        public static final String TARGET_STORAGE_VERSION = "2025-01-05";
+        public static final String TARGET_STORAGE_VERSION = "2025-05-05";
 
         /**
          * Error code returned from the service.

sdk/storage/azure-storage-file-datalake/src/main/java/com/azure/storage/file/datalake/DataLakeServiceVersion.java

@@ -132,7 +132,12 @@ public enum DataLakeServiceVersion implements ServiceVersion {
     /**
      * Service version {@code 2025-01-05}.
      */
-    V2025_01_05("2025-01-05");
+    V2025_01_05("2025-01-05"),
+
+    /**
+     * Service version {@code 2025-05-05}.
+     */
+    V2025_05_05("2025-05-05");
 
     private final String version;
 
@@ -154,6 +159,6 @@ public String getVersion() {
      * @return the latest {@link DataLakeServiceVersion}
      */
     public static DataLakeServiceVersion getLatest() {
-        return V2025_01_05;
+        return V2025_05_05;
     }
 }

sdk/storage/azure-storage-file-datalake/src/main/java/com/azure/storage/file/datalake/implementation/util/TransformUtils.java

@@ -62,6 +62,8 @@ public static BlobServiceVersion toBlobServiceVersion(DataLakeServiceVersion ver
             return BlobServiceVersion.V2024_11_04;
         } else if (DataLakeServiceVersion.V2025_01_05.ordinal() == version.ordinal()) {
             return BlobServiceVersion.V2025_01_05;
+        } else if (DataLakeServiceVersion.V2025_05_05.ordinal() == version.ordinal()) {
+            return BlobServiceVersion.V2025_05_05;
         }
 
         return null;

sdk/storage/azure-storage-file-share/CHANGELOG.md

@@ -3,8 +3,15 @@
 ## 12.26.0-beta.1 (Unreleased)
 
 ### Features Added
+- Added support for NFS over REST. 
 
 ### 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()
 
 ### Bugs Fixed
 

sdk/storage/azure-storage-file-share/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "java",
   "TagPrefix": "java/storage/azure-storage-file-share",
-  "Tag": "java/storage/azure-storage-file-share_1ec39c35ed"
+  "Tag": "java/storage/azure-storage-file-share_793c5e10e5"
 }

sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/FileSmbProperties.java

@@ -202,6 +202,33 @@ String getFileChangeTimeString() {
         return fileChangeTime == null ? null : parseFileSMBDate(fileChangeTime);
     }
 
+    /**
+     * Gets the string representation of the file's {@link NtfsFileAttributes} or null if no value is set.
+     *
+     * @return The value of the file's {@link NtfsFileAttributes}.
+     */
+    String getNtfsFileAttributesString() {
+        return ntfsFileAttributes == null ? null : NtfsFileAttributes.toString(ntfsFileAttributes);
+    }
+
+    /**
+     * Gets the string representation of the file's creation time or null if no value is set.
+     *
+     * @return The value of the file's creation time.
+     */
+    String getFileCreationTimeString() {
+        return fileCreationTime == null ? null : parseFileSMBDate(fileCreationTime);
+    }
+
+    /**
+     * Gets the string representation of the file's last write time or null if no value is set.
+     *
+     * @return The value of the file's last write time.
+     */
+    String getFileLastWriteTimeString() {
+        return fileLastWriteTime == null ? null : parseFileSMBDate(fileLastWriteTime);
+    }
+
     /**
      * Given an <code>OffsetDateTime</code>, generates a {@code String} representing a date in the format needed for
      * file SMB properties

sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareAsyncClient.java

@@ -1693,8 +1693,8 @@ Mono<Response<ShareFileAsyncClient>> createFileWithResponse(String fileName, lon
         Map<String, String> metadata, ShareRequestConditions requestConditions, Context context) {
         ShareFileAsyncClient shareFileAsyncClient = getFileClient(fileName);
         return shareFileAsyncClient
-            .createWithResponse(maxSize, httpHeaders, smbProperties, filePermission, null, metadata, requestConditions,
-                context)
+            .createWithResponse(maxSize, httpHeaders, smbProperties, filePermission, null, null, metadata,
+                requestConditions, context)
             .map(response -> new SimpleResponse<>(response, shareFileAsyncClient));
     }
 

sdk/storage/azure-storage-file-share/src/main/java/com/azure/storage/file/share/ShareDirectoryAsyncClient.java

@@ -31,6 +31,7 @@
 import com.azure.storage.file.share.implementation.util.ShareSasImplUtil;
 import com.azure.storage.file.share.models.CloseHandlesInfo;
 import com.azure.storage.file.share.models.FilePermissionFormat;
+import com.azure.storage.file.share.models.FilePosixProperties;
 import com.azure.storage.file.share.models.HandleItem;
 import com.azure.storage.file.share.models.NtfsFileAttributes;
 import com.azure.storage.file.share.models.ShareDirectoryInfo;
@@ -39,6 +40,7 @@
 import com.azure.storage.file.share.models.ShareErrorCode;
 import com.azure.storage.file.share.models.ShareFileHttpHeaders;
 import com.azure.storage.file.share.models.ShareFileItem;
+import com.azure.storage.file.share.models.ShareFilePermission;
 import com.azure.storage.file.share.models.ShareRequestConditions;
 import com.azure.storage.file.share.models.ShareStorageException;
 import com.azure.storage.file.share.options.ShareDirectoryCreateOptions;
@@ -310,7 +312,8 @@ public Mono<ShareDirectoryInfo> create() {
     public Mono<Response<ShareDirectoryInfo>> createWithResponse(FileSmbProperties smbProperties, String filePermission,
         Map<String, String> metadata) {
         try {
-            return withContext(context -> createWithResponse(smbProperties, filePermission, null, metadata, context));
+            return withContext(
+                context -> createWithResponse(smbProperties, filePermission, null, null, metadata, context));
         } catch (RuntimeException ex) {
             return monoError(LOGGER, ex);
         }
@@ -350,32 +353,28 @@ public Mono<Response<ShareDirectoryInfo>> createWithResponse(FileSmbProperties s
     public Mono<Response<ShareDirectoryInfo>> createWithResponse(ShareDirectoryCreateOptions options) {
         try {
             return withContext(context -> createWithResponse(options.getSmbProperties(), options.getFilePermission(),
-                options.getFilePermissionFormat(), options.getMetadata(), context));
+                options.getFilePermissionFormat(), options.getPosixProperties(), options.getMetadata(), context));
         } catch (RuntimeException ex) {
             return monoError(LOGGER, ex);
         }
     }
 
     Mono<Response<ShareDirectoryInfo>> createWithResponse(FileSmbProperties smbProperties, String filePermission,
-        FilePermissionFormat filePermissionFormat, Map<String, String> metadata, Context context) {
-        FileSmbProperties properties = smbProperties == null ? new FileSmbProperties() : smbProperties;
+        FilePermissionFormat filePermissionFormat, FilePosixProperties posixProperties, Map<String, String> metadata,
+        Context context) {
+        context = context == null ? Context.NONE : context;
+        smbProperties = smbProperties == null ? new FileSmbProperties() : smbProperties;
+        posixProperties = posixProperties == null ? new FilePosixProperties() : posixProperties;
 
         // Checks that file permission and file permission key are valid
-        ModelHelper.validateFilePermissionAndKey(filePermission, properties.getFilePermissionKey());
-
-        // If file permission and file permission key are both not set then set default value
-        filePermission = properties.setFilePermission(filePermission, FileConstants.FILE_PERMISSION_INHERIT);
-        String filePermissionKey = properties.getFilePermissionKey();
-
-        String fileAttributes = properties.setNtfsFileAttributes(FileConstants.FILE_ATTRIBUTES_NONE);
-        String fileCreationTime = properties.setFileCreationTime(FileConstants.FILE_TIME_NOW);
-        String fileLastWriteTime = properties.setFileLastWriteTime(FileConstants.FILE_TIME_NOW);
-        String fileChangeTime = properties.getFileChangeTimeString();
-        context = context == null ? Context.NONE : context;
+        ModelHelper.validateFilePermissionAndKey(filePermission, smbProperties.getFilePermissionKey());
 
         return azureFileStorageClient.getDirectories()
-            .createWithResponseAsync(shareName, directoryPath, fileAttributes, null, metadata, filePermission,
-                filePermissionFormat, filePermissionKey, fileCreationTime, fileLastWriteTime, fileChangeTime, context)
+            .createWithResponseAsync(shareName, directoryPath, null, metadata, filePermission, filePermissionFormat,
+                smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
+                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
+                smbProperties.getFileChangeTimeString(), posixProperties.getOwner(), posixProperties.getGroup(),
+                posixProperties.getFileMode(), context)
             .map(ModelHelper::mapShareDirectoryInfo);
     }
 
@@ -455,14 +454,15 @@ Mono<Response<ShareDirectoryInfo>> createIfNotExistsWithResponse(ShareDirectoryC
         Context context) {
         try {
             options = options == null ? new ShareDirectoryCreateOptions() : options;
-            return createWithResponse(options.getSmbProperties(), options.getFilePermission(), null,
-                options.getMetadata(), context).onErrorResume(
-                    t -> t instanceof ShareStorageException && ((ShareStorageException) t).getStatusCode() == 409,
-                    t -> {
-                        HttpResponse response = ((ShareStorageException) t).getResponse();
-                        return Mono.just(new SimpleResponse<>(response.getRequest(), response.getStatusCode(),
-                            response.getHeaders(), null));
-                    });
+            return createWithResponse(options.getSmbProperties(), options.getFilePermission(),
+                options.getFilePermissionFormat(), options.getPosixProperties(), options.getMetadata(), context)
+                    .onErrorResume(
+                        t -> t instanceof ShareStorageException && ((ShareStorageException) t).getStatusCode() == 409,
+                        t -> {
+                            HttpResponse response = ((ShareStorageException) t).getResponse();
+                            return Mono.just(new SimpleResponse<>(response.getRequest(), response.getStatusCode(),
+                                response.getHeaders(), null));
+                        });
         } catch (RuntimeException ex) {
             return monoError(LOGGER, ex);
         }
@@ -729,7 +729,8 @@ public Mono<ShareDirectoryInfo> setProperties(FileSmbProperties smbProperties, S
     public Mono<Response<ShareDirectoryInfo>> setPropertiesWithResponse(FileSmbProperties smbProperties,
         String filePermission) {
         try {
-            return withContext(context -> setPropertiesWithResponse(smbProperties, filePermission, null, context));
+            return withContext(
+                context -> setPropertiesWithResponse(smbProperties, filePermission, null, null, context));
         } catch (RuntimeException ex) {
             return monoError(LOGGER, ex);
         }
@@ -763,35 +764,31 @@ public Mono<Response<ShareDirectoryInfo>> setPropertiesWithResponse(FileSmbPrope
     @ServiceMethod(returns = ReturnType.SINGLE)
     public Mono<Response<ShareDirectoryInfo>> setPropertiesWithResponse(ShareDirectorySetPropertiesOptions options) {
         try {
-            return withContext(context -> setPropertiesWithResponse(options.getSmbProperties(),
-                options.getFilePermissions().getPermission(), options.getFilePermissions().getPermissionFormat(),
-                context));
+            ShareFilePermission filePermission
+                = options.getFilePermissions() == null ? new ShareFilePermission() : options.getFilePermissions();
+            return withContext(
+                context -> setPropertiesWithResponse(options.getSmbProperties(), filePermission.getPermission(),
+                    filePermission.getPermissionFormat(), options.getPosixProperties(), context));
         } catch (RuntimeException ex) {
             return monoError(LOGGER, ex);
         }
     }
 
     Mono<Response<ShareDirectoryInfo>> setPropertiesWithResponse(FileSmbProperties smbProperties, String filePermission,
-        FilePermissionFormat filePermissionFormat, Context context) {
-
-        FileSmbProperties properties = smbProperties == null ? new FileSmbProperties() : smbProperties;
+        FilePermissionFormat filePermissionFormat, FilePosixProperties posixProperties, Context context) {
+        context = context == null ? Context.NONE : context;
+        smbProperties = smbProperties == null ? new FileSmbProperties() : smbProperties;
+        posixProperties = posixProperties == null ? new FilePosixProperties() : posixProperties;
 
         // Checks that file permission and file permission key are valid
-        ModelHelper.validateFilePermissionAndKey(filePermission, properties.getFilePermissionKey());
+        ModelHelper.validateFilePermissionAndKey(filePermission, smbProperties.getFilePermissionKey());
 
-        // If file permission and file permission key are both not set then set default value
-        filePermission = properties.setFilePermission(filePermission, FileConstants.PRESERVE);
-        String filePermissionKey = properties.getFilePermissionKey();
-
-        String fileAttributes = properties.setNtfsFileAttributes(FileConstants.PRESERVE);
-        String fileCreationTime = properties.setFileCreationTime(FileConstants.PRESERVE);
-        String fileLastWriteTime = properties.setFileLastWriteTime(FileConstants.PRESERVE);
-        String fileChangeTime = properties.getFileChangeTimeString();
-
-        context = context == null ? Context.NONE : context;
         return azureFileStorageClient.getDirectories()
-            .setPropertiesWithResponseAsync(shareName, directoryPath, fileAttributes, null, filePermission,
-                filePermissionFormat, filePermissionKey, fileCreationTime, fileLastWriteTime, fileChangeTime, context)
+            .setPropertiesWithResponseAsync(shareName, directoryPath, null, filePermission, filePermissionFormat,
+                smbProperties.getFilePermissionKey(), smbProperties.getNtfsFileAttributesString(),
+                smbProperties.getFileCreationTimeString(), smbProperties.getFileLastWriteTimeString(),
+                smbProperties.getFileChangeTimeString(), posixProperties.getOwner(), posixProperties.getGroup(),
+                posixProperties.getFileMode(), context)
             .map(ModelHelper::mapSetPropertiesResponse);
     }
 
@@ -1388,7 +1385,7 @@ public Mono<Response<ShareDirectoryAsyncClient>> createSubdirectoryWithResponse(
     Mono<Response<ShareDirectoryAsyncClient>> createSubdirectoryWithResponse(String subdirectoryName,
         FileSmbProperties smbProperties, String filePermission, Map<String, String> metadata, Context context) {
         ShareDirectoryAsyncClient createSubClient = getSubdirectoryClient(subdirectoryName);
-        return createSubClient.createWithResponse(smbProperties, filePermission, null, metadata, context)
+        return createSubClient.createWithResponse(smbProperties, filePermission, null, null, metadata, context)
             .map(response -> new SimpleResponse<>(response, createSubClient));
     }
 
@@ -1774,8 +1771,8 @@ Mono<Response<ShareFileAsyncClient>> createFileWithResponse(String fileName, lon
         Map<String, String> metadata, ShareRequestConditions requestConditions, Context context) {
         ShareFileAsyncClient shareFileAsyncClient = getFileClient(fileName);
         return shareFileAsyncClient
-            .createWithResponse(maxSize, httpHeaders, smbProperties, filePermission, null, metadata, requestConditions,
-                context)
+            .createWithResponse(maxSize, httpHeaders, smbProperties, filePermission, null, null, metadata,
+                requestConditions, context)
             .map(response -> new SimpleResponse<>(response, shareFileAsyncClient));
     }