@azure/storage-file-share 12.26.0 → 12.27.0-alpha.20250218.1

package/dist-esm/storage-file-share/src/Clients.js

@@ -4,14 +4,13 @@ import { __asyncGenerator, __asyncValues, __await } from "tslib";
 import { isTokenCredential } from "@azure/core-auth";
 import { isNode } from "@azure/core-util";
 import { isPipelineLike, newPipeline } from "./Pipeline";
-import { DEFAULT_MAX_DOWNLOAD_RETRY_REQUESTS, DEFAULT_HIGH_LEVEL_CONCURRENCY, FILE_MAX_SIZE_BYTES, FILE_RANGE_MAX_SIZE_BYTES, URLConstants, FileAttributesPreserve, FileAttributesNone, } from "./utils/constants";
-import { appendToURLPath, setURLParameter, truncatedISO8061Date, extractConnectionStringParts, getShareNameAndPathFromUrl, appendToURLQuery, httpAuthorizationToString, setURLPath, setURLQueries, EscapePath, ConvertInternalResponseOfListFiles, ConvertInternalResponseOfListHandles, assertResponse, removeEmptyString, asSharePermission, } from "./utils/utils.common";
+import { DEFAULT_MAX_DOWNLOAD_RETRY_REQUESTS, DEFAULT_HIGH_LEVEL_CONCURRENCY, FILE_MAX_SIZE_BYTES, FILE_RANGE_MAX_SIZE_BYTES, URLConstants, } from "./utils/constants";
+import { appendToURLPath, setURLParameter, truncatedISO8061Date, extractConnectionStringParts, getShareNameAndPathFromUrl, appendToURLQuery, httpAuthorizationToString, setURLPath, setURLQueries, EscapePath, ConvertInternalResponseOfListFiles, ConvertInternalResponseOfListHandles, assertResponse, removeEmptyString, asSharePermission, parseOctalFileMode, toOctalFileMode, } from "./utils/utils.common";
 import { Credential } from "../../storage-blob/src/credentials/Credential";
 import { StorageSharedKeyCredential } from "../../storage-blob/src/credentials/StorageSharedKeyCredential";
 import { AnonymousCredential } from "../../storage-blob/src/credentials/AnonymousCredential";
 import { tracingClient } from "./utils/tracing";
 import { StorageClient } from "./StorageClient";
-import { FileSystemAttributes } from "./FileSystemAttributes";
 import { FileDownloadResponse } from "./FileDownloadResponse";
 import { rangeToString } from "./Range";
 import { fileAttributesToString, fileCreationTimeToString, fileLastWriteTimeToString, validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions, validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions, toShareProtocolsString, toShareProtocols, fileChangeTimeToString, } from "./models";
@@ -97,7 +96,7 @@ export class ShareClient extends StorageClient {
     /**
      * Creates a new share under the specified account. If the share with
      * the same name already exists, the operation fails.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-share
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-share
      *
      * @param options - Options to Share Create operation.
      * @returns Response data for the Share Create operation.
@@ -110,7 +109,7 @@ export class ShareClient extends StorageClient {
     /**
      * Creates a new share under the specified account. If the share with
      * the same name already exists, it is not changed.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-share
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-share
      *
      * @param options -
      */
@@ -153,7 +152,7 @@ export class ShareClient extends StorageClient {
     }
     /**
      * Creates a new subdirectory under this share.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Create operation.
@@ -172,7 +171,7 @@ export class ShareClient extends StorageClient {
     /**
      * Removes the specified empty sub directory under this share.
      * Note that the directory must be empty before it can be deleted.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Delete operation.
@@ -187,7 +186,7 @@ export class ShareClient extends StorageClient {
     /**
      * Creates a new file or replaces a file under the root directory of this share.
      * Note it only initializes the file with no content.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
      *
      * @param fileName -
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
@@ -218,7 +217,7 @@ export class ShareClient extends StorageClient {
      * a share. An attempt to perform this operation on a share snapshot will fail with 400
      * (`InvalidQueryParameterValue`)
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
      *
      * @param directoryName -
      * @param fileName -
@@ -258,7 +257,7 @@ export class ShareClient extends StorageClient {
     /**
      * Returns all user-defined metadata and system properties for the specified
      * share.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-share-properties
      *
      * WARNING: The `metadata` object returned in the response will have its keys in lowercase, even if
      * they originally contained uppercase characters. This differs from the metadata keys returned by
@@ -276,7 +275,7 @@ export class ShareClient extends StorageClient {
     /**
      * Marks the specified share for deletion. The share and any directories or files
      * contained within it are later deleted during garbage collection.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-share
      *
      * @param options - Options to Share Delete operation.
      * @returns Response data for the Share Delete operation.
@@ -289,7 +288,7 @@ export class ShareClient extends StorageClient {
     /**
      * Marks the specified share for deletion if it exists. The share and any directories or files
      * contained within it are later deleted during garbage collection.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-share
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-share
      *
      * @param options -
      */
@@ -313,7 +312,7 @@ export class ShareClient extends StorageClient {
      *
      * If no option provided, or no metadata defined in the option parameter, the share
      * metadata will be removed.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-metadata
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-share-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed.
      * @param option - Options to Share Set Metadata operation.
@@ -331,7 +330,7 @@ export class ShareClient extends StorageClient {
      * WARNING: JavaScript Date will potential lost precision when parsing start and expiry string.
      * For example, new Date("2018-12-31T03:44:23.8827891Z").toISOString() will get "2018-12-31T03:44:23.882Z".
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-share-acl
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-share-acl
      *
      * @param option - Options to Share Get Access Policy operation.
      * @returns Response data for the Share Get Access Policy operation.
@@ -380,7 +379,7 @@ export class ShareClient extends StorageClient {
      * When you establish a stored access policy on a share, it may take up to 30 seconds to take effect.
      * During this interval, a shared access signature that is associated with the stored access policy will
      * fail with status code 403 (Forbidden), until the access policy becomes active.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-share-acl
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-share-acl
      *
      * @param shareAcl - Array of signed identifiers, each having a unique Id and details of access policy.
      * @param option - Options to Share Set Access Policy operation.
@@ -459,7 +458,7 @@ export class ShareClient extends StorageClient {
     /**
      * Creates a file permission (a security descriptor) at the share level.
      * The created security descriptor can be used for the files/directories in the share.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-permission
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-permission
      *
      * @param options - Options to Share Create Permission operation.
      * @param filePermission - File permission described in the SDDL
@@ -472,7 +471,7 @@ export class ShareClient extends StorageClient {
     /**
      * Gets the Security Descriptor Definition Language (SDDL) for a given file permission key
      * which indicates a security descriptor.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-permission
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-permission
      *
      * @param options - Options to Share Create Permission operation.
      * @param filePermissionKey - File permission key which indicates the security descriptor of the permission.
@@ -497,7 +496,7 @@ export class ShareClient extends StorageClient {
      * Generates a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -515,7 +514,7 @@ export class ShareClient extends StorageClient {
      * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -577,7 +576,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Creates a new directory under the specified share or parent directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
      *
      * @param options - Options to Directory Create operation.
      * @returns Response data for the Directory  operation.
@@ -585,21 +584,20 @@ export class ShareDirectoryClient extends StorageClient {
     async create(options = {}) {
         if (!options.fileAttributes) {
             options = validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(options);
-            // By default set it as a directory.
-            const attributes = new FileSystemAttributes();
-            attributes.directory = true;
-            options.fileAttributes = attributes;
         }
         return tracingClient.withSpan("ShareDirectoryClient-create", options, async (updatedOptions) => {
-            return assertResponse(await this.context.create(updatedOptions.fileAttributes
-                ? fileAttributesToString(updatedOptions.fileAttributes)
-                : FileAttributesNone, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime) }), this.shareClientConfig)));
+            var _a, _b, _c;
+            const rawResponse = await this.context.create(Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileAttributes: updatedOptions.fileAttributes
+                    ? fileAttributesToString(updatedOptions.fileAttributes)
+                    : undefined, owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode) }), this.shareClientConfig));
+            const wrappedRes = Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) });
+            return assertResponse(wrappedRes);
         });
     }
     /**
      * Creates a new directory under the specified share or parent directory if it does not already exists.
      * If the directory already exists, it is not modified.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
      *
      * @param options -
      */
@@ -620,7 +618,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Sets properties on the directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-directory-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-directory-properties
      *
      * @param DirectoryProperties - Directory properties. If no values are provided,
      *                                            existing values will be preserved.
@@ -628,9 +626,11 @@ export class ShareDirectoryClient extends StorageClient {
     async setProperties(properties = {}) {
         properties = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(properties);
         return tracingClient.withSpan("ShareDirectoryClient-setProperties", properties, async (updatedOptions) => {
-            return assertResponse(await this.context.setProperties(updatedOptions.fileAttributes
-                ? fileAttributesToString(updatedOptions.fileAttributes)
-                : FileAttributesPreserve, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime) }), this.shareClientConfig)));
+            var _a, _b, _c;
+            const rawResponse = await this.context.setProperties(Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileAttributes: updatedOptions.fileAttributes
+                    ? fileAttributesToString(updatedOptions.fileAttributes)
+                    : undefined, owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode) }), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
@@ -652,7 +652,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Creates a new subdirectory under this directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Create operation.
@@ -671,7 +671,7 @@ export class ShareDirectoryClient extends StorageClient {
     /**
      * Removes the specified empty sub directory under this directory.
      * Note that the directory must be empty before it can be deleted.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
      *
      * @param directoryName -
      * @param options - Options to Directory Delete operation.
@@ -685,7 +685,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Creates a new file or replaces a file under this directory. Note it only initializes the file with no content.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
      *
      * @param fileName -
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
@@ -714,7 +714,7 @@ export class ShareDirectoryClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
      *
      * @param fileName - Name of the file to delete
      * @param options - Options to File Delete operation.
@@ -778,20 +778,21 @@ export class ShareDirectoryClient extends StorageClient {
      * Returns all system properties for the specified directory, and can also be used to check the
      * existence of a directory. The data returned does not include the files in the directory or any
      * subdirectories.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-directory-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-directory-properties
      *
      * @param options - Options to Directory Get Properties operation.
      * @returns Response data for the Directory Get Properties operation.
      */
     async getProperties(options = {}) {
         return tracingClient.withSpan("ShareDirectoryClient-getProperties", options, async (updatedOptions) => {
-            return assertResponse(await this.context.getProperties(Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig)));
+            const rawResponse = await this.context.getProperties(Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
      * Removes the specified empty directory. Note that the directory must be empty before it can be
      * deleted.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
      *
      * @param options - Options to Directory Delete operation.
      * @returns Response data for the Directory Delete operation.
@@ -804,7 +805,7 @@ export class ShareDirectoryClient extends StorageClient {
     /**
      * Removes the specified empty directory if it exists. Note that the directory must be empty before it can be
      * deleted.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-directory
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-directory
      *
      * @param options -
      */
@@ -826,7 +827,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Updates user defined metadata for the specified directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-directory-metadata
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-directory-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed
      * @param options - Options to Directory Set Metadata operation.
@@ -1030,7 +1031,7 @@ export class ShareDirectoryClient extends StorageClient {
     /**
      * Returns a list of files or directories under the specified share or directory. It lists the
      * contents only for a single level of the directory hierarchy.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-directories-and-files
      *
      * @param marker - A string value that identifies the portion of the list to be returned with the next list operation.
      * @param options - Options to Directory List Files and Directories Segment operation.
@@ -1200,7 +1201,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Lists handles for a directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-handles
      *
      * @param marker - Optional. A string value that identifies the portion of the list to be
      *                          returned with the next list handles operation. The operation returns a
@@ -1224,7 +1225,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Force close all handles for a directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param marker - Optional. A string value that identifies the position of handles that will
      *                          be closed with the next force close handles operation.
@@ -1245,7 +1246,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Force close all handles for a directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param options -
      */
@@ -1272,7 +1273,7 @@ export class ShareDirectoryClient extends StorageClient {
     }
     /**
      * Force close a specific handle for a directory.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param aborter - Create a new Aborter instance with Aborter.none or Aborter.timeout(),
      *                          goto documents of Aborter for more examples about request cancellation
@@ -1403,7 +1404,7 @@ export class ShareFileClient extends StorageClient {
     }
     /**
      * Creates a new file or replaces a file. Note it only initializes the file with no content.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-file
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-file
      *
      * @param size - Specifies the maximum size in bytes for the file, up to 4 TB.
      * @param options - Options to File Create operation.
@@ -1430,9 +1431,12 @@ export class ShareFileClient extends StorageClient {
         options = validateAndSetDefaultsForFileAndDirectoryCreateCommonOptions(options);
         options.fileHttpHeaders = options.fileHttpHeaders || {};
         return tracingClient.withSpan("ShareFileClient-create", options, async (updatedOptions) => {
-            return assertResponse(await this.context.create(size, updatedOptions.fileAttributes
-                ? fileAttributesToString(updatedOptions.fileAttributes)
-                : FileAttributesNone, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime) }), this.shareClientConfig)));
+            var _a, _b, _c, _d;
+            const rawResponse = await this.context.create(size, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileAttributes: updatedOptions.fileAttributes
+                    ? fileAttributesToString(updatedOptions.fileAttributes)
+                    : undefined, owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode), nfsFileType: (_d = updatedOptions.posixProperties) === null || _d === void 0 ? void 0 : _d.fileType }), this.shareClientConfig));
+            const wrappedRes = Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) });
+            return assertResponse(wrappedRes);
         });
     }
     /**
@@ -1441,7 +1445,7 @@ export class ShareFileClient extends StorageClient {
      * * In Node.js, data returns in a Readable stream `readableStreamBody`
      * * In browsers, data returns in a promise `contentAsBlob`
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-file
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-file
      *
      * @param offset - From which position of the file to download, greater than or equal to 0
      * @param count - How much data to be downloaded, greater than 0. Will download to the end when undefined
@@ -1502,9 +1506,10 @@ export class ShareFileClient extends StorageClient {
                 throw new RangeError(`rangeGetContentMD5 only works with partial data downloading`);
             }
             const downloadFullFile = offset === 0 && !count;
-            const res = assertResponse(await this.context.download(Object.assign(Object.assign(Object.assign({}, updatedOptions), { requestOptions: {
+            const rawResponse = await this.context.download(Object.assign(Object.assign(Object.assign({}, updatedOptions), { requestOptions: {
                     onDownloadProgress: isNode ? undefined : updatedOptions.onProgress, // for Node.js, progress is reported by RetriableReadableStream
-                }, range: downloadFullFile ? undefined : rangeToString({ offset, count }) }), this.shareClientConfig)));
+                }, range: downloadFullFile ? undefined : rangeToString({ offset, count }) }), this.shareClientConfig));
+            const res = assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
             // Return browser response immediately
             if (!isNode) {
                 return res;
@@ -1571,19 +1576,20 @@ export class ShareFileClient extends StorageClient {
     /**
      * Returns all user-defined metadata, standard HTTP properties, and system properties
      * for the file. It does not return the content of the file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-file-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-file-properties
      *
      * @param options - Options to File Get Properties operation.
      * @returns Response data for the File Get Properties operation.
      */
     async getProperties(options = {}) {
         return tracingClient.withSpan("ShareFileClient-getProperties", options, async (updatedOptions) => {
-            return assertResponse(await this.context.getProperties(Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig)));
+            const rawResponse = await this.context.getProperties(Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
      * Sets properties on the file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
      *
      * @param properties - File properties. For file HTTP headers(e.g. Content-Type),
      *                                       if no values are provided, existing HTTP headers will be removed.
@@ -1594,9 +1600,11 @@ export class ShareFileClient extends StorageClient {
         properties = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(properties);
         properties.fileHttpHeaders = properties.fileHttpHeaders || {};
         return tracingClient.withSpan("ShareFileClient-setProperties", properties, async (updatedOptions) => {
-            return assertResponse(await this.context.setHttpHeaders(updatedOptions.fileAttributes
-                ? fileAttributesToString(updatedOptions.fileAttributes)
-                : FileAttributesPreserve, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime) }), this.shareClientConfig)));
+            var _a, _b, _c;
+            const rawResponse = await this.context.setHttpHeaders(Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileAttributes: updatedOptions.fileAttributes
+                    ? fileAttributesToString(updatedOptions.fileAttributes)
+                    : undefined, owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode) }), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
@@ -1611,7 +1619,7 @@ export class ShareFileClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
      *
      * @param options - Options to File Delete operation.
      * @returns Response data for the File Delete operation.
@@ -1633,7 +1641,7 @@ export class ShareFileClient extends StorageClient {
      * Delete File is not supported on a share snapshot, which is a read-only copy of
      * a share. An attempt to perform this operation on a share snapshot will fail with 400 (InvalidQueryParameterValue)
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-file2
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-file2
      *
      * @param options -
      */
@@ -1658,7 +1666,7 @@ export class ShareFileClient extends StorageClient {
      *
      * If no option provided, or no value provided for the file HTTP headers in the options,
      * these file HTTP headers without a value will be cleared.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
      *
      * @param FileHttpHeaders - File HTTP headers like Content-Type.
      *                                             Provide undefined will remove existing HTTP headers.
@@ -1669,15 +1677,17 @@ export class ShareFileClient extends StorageClient {
         // FileAttributes, filePermission, createTime, lastWriteTime will all be preserved
         options = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(options);
         return tracingClient.withSpan("ShareFileClient-setHTTPHeaders", options, async (updatedOptions) => {
-            return assertResponse(await this.context.setHttpHeaders(updatedOptions.fileAttributes
-                ? fileAttributesToString(updatedOptions.fileAttributes)
-                : FileAttributesPreserve, Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileHttpHeaders, fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime) }), this.shareClientConfig)));
+            var _a, _b, _c;
+            const rawResponse = await this.context.setHttpHeaders(Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileHttpHeaders, fileCreatedOn: fileCreationTimeToString(updatedOptions.creationTime), fileLastWriteOn: fileLastWriteTimeToString(updatedOptions.lastWriteTime), fileChangeOn: fileChangeTimeToString(updatedOptions.changeTime), fileAttributes: updatedOptions.fileAttributes
+                    ? fileAttributesToString(updatedOptions.fileAttributes)
+                    : undefined, owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode) }), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
      * Resize file.
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-properties
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-properties
      *
      * @param length - Resizes a file to the specified size in bytes.
      *                        If the specified byte value is less than the current size of the file,
@@ -1692,7 +1702,9 @@ export class ShareFileClient extends StorageClient {
         // FileAttributes, filePermission, createTime, lastWriteTime will all be preserved.
         options = validateAndSetDefaultsForFileAndDirectorySetPropertiesCommonOptions(options);
         return tracingClient.withSpan("ShareFileClient-resize", options, async (updatedOptions) => {
-            return assertResponse(await this.context.setHttpHeaders(fileAttributesToString(updatedOptions.fileAttributes), Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileContentLength: length, fileChangeOn: fileChangeTimeToString(options.changeTime), fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime) }), this.shareClientConfig)));
+            var _a, _b, _c;
+            const rawResponse = await this.context.setHttpHeaders(Object.assign(Object.assign(Object.assign({}, updatedOptions), { fileContentLength: length, fileChangeOn: fileChangeTimeToString(options.changeTime), fileCreatedOn: fileCreationTimeToString(options.creationTime), fileLastWriteOn: fileLastWriteTimeToString(options.lastWriteTime), fileAttributes: fileAttributesToString(updatedOptions.fileAttributes), owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = options.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode) }), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
         });
     }
     /**
@@ -1700,7 +1712,7 @@ export class ShareFileClient extends StorageClient {
      *
      * If no metadata defined in the option parameter, the file
      * metadata will be removed.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-file-metadata
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-file-metadata
      *
      * @param metadata - If no metadata provided, all existing directory metadata will be removed
      * @param options - Options to File Set Metadata operation.
@@ -1831,13 +1843,14 @@ export class ShareFileClient extends StorageClient {
      */
     async startCopyFromURL(copySource, options = {}) {
         return tracingClient.withSpan("ShareFileClient-startCopyFromURL", options, async (updatedOptions) => {
-            return assertResponse(await this.context.startCopy(copySource, Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig)));
+            var _a, _b, _c;
+            return assertResponse(await this.context.startCopy(copySource, Object.assign(Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig), { owner: (_a = updatedOptions.posixProperties) === null || _a === void 0 ? void 0 : _a.owner, group: (_b = updatedOptions.posixProperties) === null || _b === void 0 ? void 0 : _b.group, fileMode: toOctalFileMode((_c = updatedOptions.posixProperties) === null || _c === void 0 ? void 0 : _c.fileMode), fileModeCopyMode: updatedOptions.fileModeCopyMode, fileOwnerCopyMode: updatedOptions.fileOwnerCopyMode })));
         });
     }
     /**
      * Aborts a pending Copy File operation, and leaves a destination file with zero length and full
      * metadata.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/abort-copy-file
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/abort-copy-file
      *
      * @param copyId - Id of the Copy File operation to abort.
      * @param options - Options to File Abort Copy From URL operation.
@@ -2170,7 +2183,7 @@ export class ShareFileClient extends StorageClient {
     }
     /**
      * Lists handles for a file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/list-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-handles
      *
      * @param marker - Optional. A string value that identifies the portion of the list to be
      *                          returned with the next list handles operation. The operation returns a
@@ -2280,7 +2293,7 @@ export class ShareFileClient extends StorageClient {
     }
     /**
      * Force close all handles for a file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param marker - Optional. A string value that identifies the position of handles that will
      *                          be closed with the next force close handles operation.
@@ -2301,7 +2314,7 @@ export class ShareFileClient extends StorageClient {
     }
     /**
      * Force close all handles for a file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param options - Options to force close handles operation.
      */
@@ -2328,7 +2341,7 @@ export class ShareFileClient extends StorageClient {
     }
     /**
      * Force close a specific handle for a file.
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/force-close-handles
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/force-close-handles
      *
      * @param handleId - Specific handle ID, cannot be asterisk "*".
      *                          Use forceCloseAllHandles() to close all handles.
@@ -2346,6 +2359,18 @@ export class ShareFileClient extends StorageClient {
             return response;
         });
     }
+    /**
+     * NFS only.  Creates a hard link to the file file specified by path.
+     * @param targetFile - Path of the file to create the hard link to, not including the share.
+     *  For example: "targetDirectory/targetSubDirectory/.../targetFile"
+     * @param options - Options to create hard link operation.
+     */
+    async createHardLink(targetFile, options = {}) {
+        return tracingClient.withSpan("ShareFileClient-createHardLink", options, async (updatedOptions) => {
+            const rawResponse = await this.context.createHardLink(targetFile, Object.assign(Object.assign({}, updatedOptions), this.shareClientConfig));
+            return assertResponse(Object.assign(Object.assign({}, rawResponse), { _response: rawResponse._response, fileMode: parseOctalFileMode(rawResponse.fileMode) }));
+        });
+    }
     /**
      * Get a {@link ShareLeaseClient} that manages leases on the file.
      *
@@ -2361,7 +2386,7 @@ export class ShareFileClient extends StorageClient {
      * Generates a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -2379,7 +2404,7 @@ export class ShareFileClient extends StorageClient {
      * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
      * and parameters passed in. The SAS is signed by the shared key credential of the client.
      *
-     * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
+     * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
      *
      * @param options - Optional parameters.
      * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -2449,9 +2474,9 @@ export class ShareFileClient extends StorageClient {
 }
 /**
  * A client that manages leases for a {@link ShareFileClient} or {@link ShareClient}.
- * @see https://docs.microsoft.com/rest/api/storageservices/lease-file
+ * @see https://learn.microsoft.com/rest/api/storageservices/lease-file
  * and
- * @see https://docs.microsoft.com/rest/api/storageservices/lease-share
+ * @see https://learn.microsoft.com/rest/api/storageservices/lease-share
  */
 export class ShareLeaseClient {
     /**