NFS over REST (#32496)

### Packages impacted by this PR


### Issues associated with this PR


### Describe the problem that is addressed by this PR


### What are the possible designs available to address the problem? If
there are more than one possible design, why was the one in this PR
chosen?


### Are there test cases added in this PR? _(If not, why?)_


### Provide a list of related PRs _(if any)_


### Command used to generate this PR:**_(Applicable only to SDK release
request PRs)_

### Checklists
- [ ] Added impacted package name to the issue description
- [ ] Does this PR needs any fixes in the SDK Generator?** _(If so,
create an Issue in the
[Autorest/typescript](https://github.com/Azure/autorest.typescript)
repository and link it here)_
- [ ] Added a changelog (if necessary)

Author: EmmaZhu

Diff for: common/config/rush/pnpm-lock.yaml

@@ -1,5 +1,12 @@
 # Release History
 
+## 12.27.0-beta.1 (2025-02-13)
+
+### Features Added
+
+- Added support for service version 2025-05-05.
+- Added support for NFS over REST.
+
 ## 12.26.0 (2024-11-13)
 
 ### Features Added

Diff for: sdk/storage/storage-file-share/CHANGELOG.md

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "js",
   "TagPrefix": "js/storage/storage-file-share",
-  "Tag": "js/storage/storage-file-share_8f5a651780"
+  "Tag": "js/storage/storage-file-share_183c6c916d"
 }

Diff for: sdk/storage/storage-file-share/assets.json

@@ -1,7 +1,7 @@
 {
   "name": "@azure/storage-file-share",
   "sdk-type": "client",
-  "version": "12.26.0",
+  "version": "12.27.0-beta.1",
   "description": "Microsoft Azure Storage SDK for JavaScript - File",
   "main": "./dist/index.js",
   "module": "./dist-esm/storage-file-share/src/index.js",

Diff for: sdk/storage/storage-file-share/package.json

@@ -196,10 +196,14 @@ export interface DirectoryCreateHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
+    nfsFileType?: NfsFileType;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -279,13 +283,17 @@ export interface DirectoryGetPropertiesHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
     metadata?: {
         [propertyName: string]: string;
     };
+    nfsFileType?: NfsFileType;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -431,10 +439,13 @@ export interface DirectorySetPropertiesHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -468,6 +479,7 @@ export interface FileAndDirectoryCreateCommonOptions {
     filePermissionFormat?: FilePermissionFormat;
     filePermissionKey?: string;
     lastWriteTime?: Date | TimeNowType;
+    posixProperties?: FilePosixProperties;
 }
 
 // @public (undocumented)
@@ -479,6 +491,7 @@ export interface FileAndDirectorySetPropertiesCommonOptions {
     filePermissionFormat?: FilePermissionFormat;
     filePermissionKey?: string;
     lastWriteTime?: Date | TimeNowType | TimePreserveType;
+    posixProperties?: FilePosixProperties;
 }
 
 // @public
@@ -499,6 +512,35 @@ export interface FileCloseHandlesHeaders {
     version?: string;
 }
 
+// @public
+export interface FileCreateHardLinkHeaders {
+    clientRequestId?: string;
+    date?: Date;
+    etag?: string;
+    fileChangeTime?: Date;
+    fileCreationTime?: Date;
+    fileId?: string;
+    fileLastWriteTime?: Date;
+    fileMode?: NfsFileMode;
+    fileParentId?: string;
+    group?: string;
+    lastModified?: Date;
+    linkCount?: number;
+    nfsFileType?: NfsFileType;
+    owner?: string;
+    requestId?: string;
+    version?: string;
+}
+
+// @public
+export interface FileCreateHardLinkOptions extends CommonOptions {
+    abortSignal?: AbortSignalLike;
+    leaseAccessConditions?: LeaseAccessConditions;
+}
+
+// @public
+export type FileCreateHardLinkResponse = WithResponse<FileCreateHardLinkHeaders, FileCreateHardLinkHeaders>;
+
 // @public
 export interface FileCreateHeaders {
     date?: Date;
@@ -509,10 +551,14 @@ export interface FileCreateHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
+    nfsFileType?: NfsFileType;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -532,6 +578,7 @@ export type FileCreateResponse = WithResponse<FileCreateHeaders, FileCreateHeade
 export interface FileDeleteHeaders {
     date?: Date;
     errorCode?: string;
+    linkCount?: number;
     requestId?: string;
     version?: string;
 }
@@ -576,16 +623,20 @@ export interface FileDownloadHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
     leaseDuration?: LeaseDurationType;
     leaseState?: LeaseStateType;
     leaseStatus?: LeaseStatusType;
+    linkCount?: number;
     metadata?: {
         [propertyName: string]: string;
     };
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -674,17 +725,22 @@ export interface FileGetPropertiesHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
     fileType?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
     leaseDuration?: LeaseDurationType;
     leaseState?: LeaseStateType;
     leaseStatus?: LeaseStatusType;
+    linkCount?: number;
     metadata?: {
         [propertyName: string]: string;
     };
+    nfsFileType?: NfsFileType;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -794,6 +850,14 @@ export type FilePermissionInheritType = "inherit";
 // @public
 export type FilePermissionPreserveType = "preserve";
 
+// @public
+export interface FilePosixProperties {
+    fileMode?: NfsFileMode;
+    fileType?: NfsFileType;
+    group?: string;
+    owner?: string;
+}
+
 // @public (undocumented)
 export interface FileProperties extends FileAndDirectorySetPropertiesCommonOptions, CommonOptions {
     abortSignal?: AbortSignalLike;
@@ -914,10 +978,14 @@ export interface FileSetHTTPHeadersHeaders {
     fileCreatedOn?: Date;
     fileId?: string;
     fileLastWriteOn?: Date;
+    fileMode?: NfsFileMode;
     fileParentId?: string;
     filePermissionKey?: string;
+    group?: string;
     isServerEncrypted?: boolean;
     lastModified?: Date;
+    linkCount?: number;
+    owner?: string;
     requestId?: string;
     version?: string;
 }
@@ -966,11 +1034,14 @@ export interface FileStartCopyHeaders {
 export interface FileStartCopyOptions extends CommonOptions {
     abortSignal?: AbortSignalLike;
     copyFileSmbInfo?: CopyFileSmbInfo;
+    fileModeCopyMode?: ModeCopyMode;
+    fileOwnerCopyMode?: OwnerCopyMode;
     filePermission?: string;
     filePermissionFormat?: FilePermissionFormat;
     filePermissionKey?: string;
     leaseAccessConditions?: LeaseAccessConditions;
     metadata?: Metadata;
+    posixProperties?: FilePosixProperties;
 }
 
 // @public
@@ -1237,9 +1308,34 @@ export interface Metrics {
     version: string;
 }
 
+// @public
+export type ModeCopyMode = "source" | "override";
+
 // @public
 export function newPipeline(credential?: Credential_2 | TokenCredential, pipelineOptions?: StoragePipelineOptions): Pipeline;
 
+// @public
+export interface NfsFileMode {
+    effectiveGroupIdentity: boolean;
+    effectiveUserIdentity: boolean;
+    group: PosixRolePermissions;
+    other: PosixRolePermissions;
+    owner: PosixRolePermissions;
+    stickyBit: boolean;
+}
+
+// @public
+export type NfsFileType = string;
+
+// @public
+export type OwnerCopyMode = "source" | "override";
+
+// @public
+export function parseOctalFileMode(input?: string): NfsFileMode | undefined;
+
+// @public
+export function parseSymbolicFileMode(input?: string): NfsFileMode | undefined;
+
 // @public
 export type PermissionCopyModeType = "source" | "override";
 
@@ -1264,6 +1360,13 @@ export interface PipelineOptions {
     shareTokenIntent?: ShareTokenIntent;
 }
 
+// @public
+export interface PosixRolePermissions {
+    execute: boolean;
+    read: boolean;
+    write: boolean;
+}
+
 // @public
 interface Range_2 {
     count?: number;
@@ -1639,6 +1742,7 @@ export class ShareFileClient extends StorageClient {
     abortCopyFromURL(copyId: string, options?: FileAbortCopyFromURLOptions): Promise<FileAbortCopyResponse>;
     clearRange(offset: number, contentLength: number, options?: FileClearRangeOptions): Promise<FileUploadRangeResponse>;
     create(size: number, options?: FileCreateOptions): Promise<FileCreateResponse>;
+    createHardLink(targetFile: string, options?: FileCreateHardLinkOptions): Promise<FileCreateHardLinkResponse>;
     delete(options?: FileDeleteOptions): Promise<FileDeleteResponse>;
     deleteIfExists(options?: FileDeleteOptions): Promise<FileDeleteIfExistsResponse>;
     download(offset?: number, count?: number, options?: FileDownloadOptions): Promise<FileDownloadResponseModel>;
@@ -2163,6 +2267,12 @@ export type TimeNowType = "now";
 // @public
 export type TimePreserveType = "preserve";
 
+// @public
+export function toOctalFileMode(input?: NfsFileMode): string | undefined;
+
+// @public
+export function toSymbolicFileMode(input?: NfsFileMode): string | undefined;
+
 export { WebResource }
 
 // @public