@azure/storage-file-datalake 12.25.0-beta.1 → 12.26.0-alpha.20250319.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/LICENSE +3 -3
  2. package/README.md +25 -30
  3. package/dist/index.js +63 -72
  4. package/dist/index.js.map +1 -1
  5. package/dist-esm/storage-blob/src/StorageBrowserPolicyFactory.js.map +1 -1
  6. package/dist-esm/storage-blob/src/StorageRetryPolicyFactory.js.map +1 -1
  7. package/dist-esm/storage-blob/src/policies/AnonymousCredentialPolicy.js.map +1 -1
  8. package/dist-esm/storage-blob/src/policies/CredentialPolicy.js.map +1 -1
  9. package/dist-esm/storage-blob/src/policies/RequestPolicy.js.map +1 -1
  10. package/dist-esm/storage-blob/src/policies/StorageBrowserPolicy.js.map +1 -1
  11. package/dist-esm/storage-blob/src/policies/StorageBrowserPolicyV2.js.map +1 -1
  12. package/dist-esm/storage-blob/src/policies/StorageCorrectContentLengthPolicy.browser.js.map +1 -1
  13. package/dist-esm/storage-blob/src/policies/StorageCorrectContentLengthPolicy.js.map +1 -1
  14. package/dist-esm/storage-blob/src/policies/StorageRetryPolicy.js.map +1 -1
  15. package/dist-esm/storage-blob/src/policies/StorageRetryPolicyV2.js +1 -1
  16. package/dist-esm/storage-blob/src/policies/StorageRetryPolicyV2.js.map +1 -1
  17. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicy.js +2 -2
  18. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicy.js.map +1 -1
  19. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicyV2.browser.js.map +1 -1
  20. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicyV2.js +2 -2
  21. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicyV2.js.map +1 -1
  22. package/dist-esm/storage-blob/src/utils/BlobQuickQueryStream.js.map +1 -1
  23. package/dist-esm/storage-blob/src/utils/RetriableReadableStream.js.map +1 -1
  24. package/dist-esm/storage-blob/src/utils/cache.js.map +1 -1
  25. package/dist-esm/storage-blob/src/utils/constants.js +2 -2
  26. package/dist-esm/storage-blob/src/utils/constants.js.map +1 -1
  27. package/dist-esm/storage-blob/src/utils/utils.common.js +3 -3
  28. package/dist-esm/storage-blob/src/utils/utils.common.js.map +1 -1
  29. package/dist-esm/storage-blob/src/utils/utils.node.js +1 -1
  30. package/dist-esm/storage-blob/src/utils/utils.node.js.map +1 -1
  31. package/dist-esm/storage-file-datalake/src/DataLakeFileSystemClient.js +15 -16
  32. package/dist-esm/storage-file-datalake/src/DataLakeFileSystemClient.js.map +1 -1
  33. package/dist-esm/storage-file-datalake/src/DataLakeLeaseClient.js.map +1 -1
  34. package/dist-esm/storage-file-datalake/src/DataLakeServiceClient.js +7 -8
  35. package/dist-esm/storage-file-datalake/src/DataLakeServiceClient.js.map +1 -1
  36. package/dist-esm/storage-file-datalake/src/Pipeline.js.map +1 -1
  37. package/dist-esm/storage-file-datalake/src/StorageClient.js.map +1 -1
  38. package/dist-esm/storage-file-datalake/src/StorageContextClient.js.map +1 -1
  39. package/dist-esm/storage-file-datalake/src/clients.js +25 -29
  40. package/dist-esm/storage-file-datalake/src/clients.js.map +1 -1
  41. package/dist-esm/storage-file-datalake/src/credentials/UserDelegationKeyCredential.js +1 -1
  42. package/dist-esm/storage-file-datalake/src/credentials/UserDelegationKeyCredential.js.map +1 -1
  43. package/dist-esm/storage-file-datalake/src/generated/src/models/parameters.js +1 -1
  44. package/dist-esm/storage-file-datalake/src/generated/src/models/parameters.js.map +1 -1
  45. package/dist-esm/storage-file-datalake/src/generated/src/storageClient.js +2 -2
  46. package/dist-esm/storage-file-datalake/src/generated/src/storageClient.js.map +1 -1
  47. package/dist-esm/storage-file-datalake/src/models.js.map +1 -1
  48. package/dist-esm/storage-file-datalake/src/sas/AccountSASPermissions.js +2 -2
  49. package/dist-esm/storage-file-datalake/src/sas/AccountSASPermissions.js.map +1 -1
  50. package/dist-esm/storage-file-datalake/src/sas/AccountSASResourceTypes.js +1 -1
  51. package/dist-esm/storage-file-datalake/src/sas/AccountSASResourceTypes.js.map +1 -1
  52. package/dist-esm/storage-file-datalake/src/sas/AccountSASSignatureValues.js +1 -1
  53. package/dist-esm/storage-file-datalake/src/sas/AccountSASSignatureValues.js.map +1 -1
  54. package/dist-esm/storage-file-datalake/src/sas/DataLakeSASSignatureValues.js +1 -1
  55. package/dist-esm/storage-file-datalake/src/sas/DataLakeSASSignatureValues.js.map +1 -1
  56. package/dist-esm/storage-file-datalake/src/sas/DirectorySASPermissions.js +1 -1
  57. package/dist-esm/storage-file-datalake/src/sas/DirectorySASPermissions.js.map +1 -1
  58. package/dist-esm/storage-file-datalake/src/sas/FileSystemSASPermissions.js +1 -1
  59. package/dist-esm/storage-file-datalake/src/sas/FileSystemSASPermissions.js.map +1 -1
  60. package/dist-esm/storage-file-datalake/src/sas/SASQueryParameters.js.map +1 -1
  61. package/dist-esm/storage-file-datalake/src/transforms.js.map +1 -1
  62. package/dist-esm/storage-file-datalake/src/utils/BufferScheduler.js.map +1 -1
  63. package/dist-esm/storage-file-datalake/src/utils/DataLakeAclChangeFailedError.js.map +1 -1
  64. package/dist-esm/storage-file-datalake/src/utils/PathClientInternal.js.map +1 -1
  65. package/dist-esm/storage-file-datalake/src/utils/constants.js +2 -2
  66. package/dist-esm/storage-file-datalake/src/utils/constants.js.map +1 -1
  67. package/dist-esm/storage-file-datalake/src/utils/utils.common.js +3 -5
  68. package/dist-esm/storage-file-datalake/src/utils/utils.common.js.map +1 -1
  69. package/package.json +13 -17
  70. package/types/latest/storage-file-datalake.d.ts +88 -88
package/dist/index.js CHANGED
@@ -50,8 +50,8 @@ const logger = logger$1.createClientLogger("storage-file-datalake");
50
50
 
51
51
  // Copyright (c) Microsoft Corporation.
52
52
  // Licensed under the MIT License.
53
- const SDK_VERSION = "12.25.0-beta.1";
54
- const SERVICE_VERSION = "2025-01-05";
53
+ const SDK_VERSION = "12.26.0";
54
+ const SERVICE_VERSION = "2025-05-05";
55
55
  const KB = 1024;
56
56
  const MB = KB * 1024;
57
57
  const DEFAULT_HIGH_LEVEL_CONCURRENCY = 5;
@@ -93,7 +93,6 @@ const ETagAny = "*";
93
93
  const DeletionIdKey = "deletionid";
94
94
  const EncryptionAlgorithmAES25 = "AES256";
95
95
  const PathResultTypeConstants = {
96
- FileResourceType: "file",
97
96
  DirectoryResourceType: "directory",
98
97
  };
99
98
  /// List of ports used for path style addressing.
@@ -2794,7 +2793,7 @@ const timeout = {
2794
2793
  const version = {
2795
2794
  parameterPath: "version",
2796
2795
  mapper: {
2797
- defaultValue: "2025-01-05",
2796
+ defaultValue: "2025-05-05",
2798
2797
  isConstant: true,
2799
2798
  serializedName: "x-ms-version",
2800
2799
  type: {
@@ -4539,7 +4538,7 @@ let StorageClient$1 = class StorageClient extends coreHttpCompat__namespace.Exte
4539
4538
  const defaults = {
4540
4539
  requestContentType: "application/json; charset=utf-8"
4541
4540
  };
4542
- const packageDetails = `azsdk-js-azure-storage-datalake/12.25.0-beta.1`;
4541
+ const packageDetails = `azsdk-js-azure-storage-datalake/12.26.0`;
4543
4542
  const userAgentPrefix = options.userAgentOptions && options.userAgentOptions.userAgentPrefix
4544
4543
  ? `${options.userAgentOptions.userAgentPrefix} ${packageDetails}`
4545
4544
  : `${packageDetails}`;
@@ -4550,7 +4549,7 @@ let StorageClient$1 = class StorageClient extends coreHttpCompat__namespace.Exte
4550
4549
  // Parameter assignments
4551
4550
  this.url = url;
4552
4551
  // Assigning values to Constant parameters
4553
- this.version = options.version || "2025-01-05";
4552
+ this.version = options.version || "2025-05-05";
4554
4553
  this.resource = options.resource || "filesystem";
4555
4554
  this.service = new ServiceImpl(this);
4556
4555
  this.fileSystemOperations = new FileSystemOperationsImpl(this);
@@ -4591,8 +4590,6 @@ class StorageContextClient extends StorageClient$1 {
4591
4590
  }
4592
4591
  }
4593
4592
 
4594
- // Copyright (c) Microsoft Corporation.
4595
- // Licensed under the MIT License.
4596
4593
  /**
4597
4594
  * Reserved URL characters must be properly escaped for Storage services like Blob or File.
4598
4595
  *
@@ -4640,8 +4637,8 @@ class StorageContextClient extends StorageClient$1 {
4640
4637
  *
4641
4638
  * We will apply strategy one, and call encodeURIComponent for these parameters like blobName. Because what customers passes in is a plain name instead of a URL.
4642
4639
  *
4643
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
4644
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-shares--directories--files--and-metadata
4640
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
4641
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-shares--directories--files--and-metadata
4645
4642
  *
4646
4643
  * @param url -
4647
4644
  */
@@ -4655,7 +4652,7 @@ function escapeURLPath(url) {
4655
4652
  }
4656
4653
  function getProxyUriFromDevConnString(connectionString) {
4657
4654
  // Development Connection String
4658
- // https://docs.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string#connect-to-the-emulator-account-using-the-well-known-account-name-and-key
4655
+ // https://learn.microsoft.com/en-us/azure/storage/common/storage-configure-connection-string#connect-to-the-emulator-account-using-the-well-known-account-name-and-key
4659
4656
  let proxyUri = "";
4660
4657
  if (connectionString.search("DevelopmentStorageProxyUri=") !== -1) {
4661
4658
  // CONNECTION_STRING=UseDevelopmentStorage=true;DevelopmentStorageProxyUri=http://myProxyUri
@@ -5292,7 +5289,7 @@ function toBlobCpkInfo(input) {
5292
5289
 
5293
5290
  // This function relies on the Pipeline already being initialized by a storage-blob client
5294
5291
  function getCoreClientOptions(pipeline) {
5295
- const _a = pipeline.options, restOptions = tslib.__rest(_a, ["httpClient"]);
5292
+ const _a = pipeline.options, { httpClient: v1Client } = _a, restOptions = tslib.__rest(_a, ["httpClient"]);
5296
5293
  const httpClient = pipeline._coreHttpClient;
5297
5294
  if (!httpClient) {
5298
5295
  throw new Error("Pipeline not correctly initialized; missing V2 HttpClient");
@@ -5754,7 +5751,7 @@ class BufferScheduler {
5754
5751
  * ONLY AVAILABLE IN NODE.JS RUNTIME.
5755
5752
  *
5756
5753
  * UserDelegationKeyCredential is only used for generation of user delegation SAS.
5757
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-user-delegation-sas
5754
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-user-delegation-sas
5758
5755
  */
5759
5756
  class UserDelegationKeyCredential {
5760
5757
  /**
@@ -6019,7 +6016,7 @@ class FileSystemSASPermissions {
6019
6016
  * order accepted by the service.
6020
6017
  *
6021
6018
  * The order of the characters should be as specified here to ensure correctness.
6022
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
6019
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
6023
6020
  *
6024
6021
  */
6025
6022
  toString() {
@@ -6421,7 +6418,7 @@ class DirectorySASPermissions {
6421
6418
  * order accepted by the service.
6422
6419
  *
6423
6420
  * The order of the characters should be as specified here to ensure correctness.
6424
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
6421
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
6425
6422
  *
6426
6423
  */
6427
6424
  toString() {
@@ -6489,7 +6486,7 @@ function generateDataLakeSASQueryParametersInternal(dataLakeSASSignatureValues,
6489
6486
  }
6490
6487
  }
6491
6488
  // Version 2018-11-09 adds support for the signed resource and signed blob snapshot time fields.
6492
- // https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas#constructing-the-signature-string
6489
+ // https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas#constructing-the-signature-string
6493
6490
  if (version >= "2018-11-09") {
6494
6491
  if (sharedKeyCredential !== undefined) {
6495
6492
  return generateBlobSASQueryParameters20181109(dataLakeSASSignatureValues, sharedKeyCredential);
@@ -7216,8 +7213,6 @@ class DataLakeAclChangeFailedError extends Error {
7216
7213
  const fsStat = util__namespace.promisify(fs__namespace.stat);
7217
7214
  const fsCreateReadStream = fs__namespace.createReadStream;
7218
7215
 
7219
- // Copyright (c) Microsoft Corporation.
7220
- // Licensed under the MIT License.
7221
7216
  /**
7222
7217
  * A DataLakePathClient represents a URL to the Azure Storage path (directory or file).
7223
7218
  */
@@ -7352,7 +7347,7 @@ class DataLakePathClient extends StorageClient {
7352
7347
  /**
7353
7348
  * Create a directory or path.
7354
7349
  *
7355
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
7350
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
7356
7351
  *
7357
7352
  * @param resourceType - Resource type, "directory" or "file".
7358
7353
  * @param options - Optional. Options when creating path.
@@ -7381,7 +7376,7 @@ class DataLakePathClient extends StorageClient {
7381
7376
  /**
7382
7377
  * Create a directory or file. If the resource already exists, it is not changed.
7383
7378
  *
7384
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
7379
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/create
7385
7380
  *
7386
7381
  * @param resourceType - Resource type, "directory" or "file".
7387
7382
  * @param options -
@@ -7419,7 +7414,7 @@ class DataLakePathClient extends StorageClient {
7419
7414
  /**
7420
7415
  * Delete current path (directory or file).
7421
7416
  *
7422
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
7417
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
7423
7418
  *
7424
7419
  * @param recursive - Required and valid only when the resource is a directory. If "true", all paths beneath the directory will be deleted.
7425
7420
  * @param options - Optional. Options when deleting path.
@@ -7453,7 +7448,7 @@ class DataLakePathClient extends StorageClient {
7453
7448
  /**
7454
7449
  * Delete current path (directory or file) if it exists.
7455
7450
  *
7456
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
7451
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/delete
7457
7452
  *
7458
7453
  * @param recursive - Required and valid only when the resource is a directory. If "true", all paths beneath the directory will be deleted.
7459
7454
  * @param options -
@@ -7477,7 +7472,7 @@ class DataLakePathClient extends StorageClient {
7477
7472
  /**
7478
7473
  * Returns the access control data for a path (directory of file).
7479
7474
  *
7480
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties
7475
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/getproperties
7481
7476
  *
7482
7477
  * @param options - Optional. Options when getting file access control.
7483
7478
  */
@@ -7491,7 +7486,7 @@ class DataLakePathClient extends StorageClient {
7491
7486
  /**
7492
7487
  * Set the access control data for a path (directory of file).
7493
7488
  *
7494
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7489
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7495
7490
  *
7496
7491
  * @param acl - The POSIX access control list for the file or directory.
7497
7492
  * @param options - Optional. Options when setting path access control.
@@ -7505,7 +7500,7 @@ class DataLakePathClient extends StorageClient {
7505
7500
  /**
7506
7501
  * Sets the Access Control on a path and sub paths.
7507
7502
  *
7508
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7503
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7509
7504
  *
7510
7505
  * @param acl - The POSIX access control list for the file or directory.
7511
7506
  * @param options - Optional. Options
@@ -7518,7 +7513,7 @@ class DataLakePathClient extends StorageClient {
7518
7513
  /**
7519
7514
  * Modifies the Access Control on a path and sub paths.
7520
7515
  *
7521
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7516
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7522
7517
  *
7523
7518
  * @param acl - The POSIX access control list for the file or directory.
7524
7519
  * @param options - Optional. Options
@@ -7531,7 +7526,7 @@ class DataLakePathClient extends StorageClient {
7531
7526
  /**
7532
7527
  * Removes the Access Control on a path and sub paths.
7533
7528
  *
7534
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7529
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7535
7530
  *
7536
7531
  * @param acl - The POSIX access control list for the file or directory.
7537
7532
  * @param options - Optional. Options
@@ -7544,7 +7539,7 @@ class DataLakePathClient extends StorageClient {
7544
7539
  /**
7545
7540
  * Sets the file permissions on a path.
7546
7541
  *
7547
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7542
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7548
7543
  *
7549
7544
  * @param permissions - The POSIX access permissions for the file owner, the file owning group, and others.
7550
7545
  * @param options - Optional. Options when setting path permissions.
@@ -7564,7 +7559,7 @@ class DataLakePathClient extends StorageClient {
7564
7559
  * the methods of {@link DataLakeFileSystemClient} that list paths using the `includeMetadata` option, which
7565
7560
  * will retain their original casing.
7566
7561
  *
7567
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-properties
7562
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-properties
7568
7563
  *
7569
7564
  * @param options - Optional. Options when getting path properties.
7570
7565
  */
@@ -7579,7 +7574,7 @@ class DataLakePathClient extends StorageClient {
7579
7574
  *
7580
7575
  * If no value provided, or no value provided for the specified blob HTTP headers,
7581
7576
  * these blob HTTP headers without a value will be cleared.
7582
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
7577
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-blob-properties
7583
7578
  *
7584
7579
  * @param httpHeaders -
7585
7580
  * @param options -
@@ -7602,7 +7597,7 @@ class DataLakePathClient extends StorageClient {
7602
7597
  * If no option provided, or no metadata defined in the parameter, the path
7603
7598
  * metadata will be removed.
7604
7599
  *
7605
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
7600
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-blob-metadata
7606
7601
  *
7607
7602
  * @param metadata - Optional. Replace existing metadata with this value.
7608
7603
  * If no value provided the existing metadata will be removed.
@@ -7707,7 +7702,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7707
7702
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
7708
7703
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
7709
7704
  *
7710
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7705
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7711
7706
  *
7712
7707
  * @param options - Optional parameters.
7713
7708
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -7725,7 +7720,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7725
7720
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
7726
7721
  * and parameters passed in.
7727
7722
  *
7728
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7723
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7729
7724
  *
7730
7725
  * @param options - Optional parameters.
7731
7726
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -7741,7 +7736,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7741
7736
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
7742
7737
  * and parameters passed in. The SAS is signed by the input user delegation key.
7743
7738
  *
7744
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7739
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7745
7740
  *
7746
7741
  * @param options - Optional parameters.
7747
7742
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -7757,13 +7752,12 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7757
7752
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
7758
7753
  * and parameters passed in The SAS is signed by the input user delegation key.
7759
7754
  *
7760
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7755
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
7761
7756
  *
7762
7757
  * @param options - Optional parameters.
7763
7758
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
7764
7759
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
7765
7760
  */
7766
- /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options*/
7767
7761
  generateUserDelegationSasStringToSign(options, userDelegationKey) {
7768
7762
  return generateDataLakeSASQueryParametersInternal(Object.assign({ fileSystemName: this.fileSystemName, pathName: this.name, isDirectory: true }, options), userDelegationKey, this.accountName).stringToSign;
7769
7763
  }
@@ -7826,7 +7820,7 @@ class DataLakeFileClient extends DataLakePathClient {
7826
7820
  * * In Node.js, data returns in a Readable stream readableStreamBody
7827
7821
  * * In browsers, data returns in a promise contentAsBlob
7828
7822
  *
7829
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob
7823
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob
7830
7824
  *
7831
7825
  * * Example usage (Node.js):
7832
7826
  *
@@ -7840,7 +7834,7 @@ class DataLakeFileClient extends DataLakePathClient {
7840
7834
  * return new Promise((resolve, reject) => {
7841
7835
  * const chunks = [];
7842
7836
  * readableStream.on("data", (data) => {
7843
- * chunks.push(data instanceof Buffer ? data : Buffer.from(data));
7837
+ * chunks.push(typeof data === "string" ? Buffer.from(data) : data);
7844
7838
  * });
7845
7839
  * readableStream.on("end", () => {
7846
7840
  * resolve(Buffer.concat(chunks));
@@ -7893,7 +7887,7 @@ class DataLakeFileClient extends DataLakePathClient {
7893
7887
  * Uploads data to be appended to a file. Data can only be appended to a file.
7894
7888
  * To apply perviously uploaded data to a file, call flush.
7895
7889
  *
7896
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7890
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/datalakestoragegen2/path/update
7897
7891
  *
7898
7892
  * @param body - Content to be uploaded.
7899
7893
  * @param offset - Append offset in bytes.
@@ -8220,7 +8214,7 @@ class DataLakeFileClient extends DataLakePathClient {
8220
8214
  * return new Promise((resolve, reject) => {
8221
8215
  * const chunks = [];
8222
8216
  * readableStream.on("data", (data) => {
8223
- * chunks.push(data instanceof Buffer ? data : Buffer.from(data));
8217
+ * chunks.push(typeof data === "string" ? Buffer.from(data) : data);
8224
8218
  * });
8225
8219
  * readableStream.on("end", () => {
8226
8220
  * resolve(Buffer.concat(chunks));
@@ -8285,7 +8279,7 @@ class DataLakeFileClient extends DataLakePathClient {
8285
8279
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8286
8280
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8287
8281
  *
8288
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8282
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8289
8283
  *
8290
8284
  * @param options - Optional parameters.
8291
8285
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8305,7 +8299,7 @@ class DataLakeFileClient extends DataLakePathClient {
8305
8299
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8306
8300
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8307
8301
  *
8308
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8302
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8309
8303
  *
8310
8304
  * @param options - Optional parameters.
8311
8305
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8321,7 +8315,7 @@ class DataLakeFileClient extends DataLakePathClient {
8321
8315
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8322
8316
  * and parameters passed in. The SAS is signed by the input user delegation key.
8323
8317
  *
8324
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8318
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8325
8319
  *
8326
8320
  * @param options - Optional parameters.
8327
8321
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -8337,13 +8331,12 @@ class DataLakeFileClient extends DataLakePathClient {
8337
8331
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8338
8332
  * and parameters passed in. The SAS is signed by the input user delegation key.
8339
8333
  *
8340
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8334
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8341
8335
  *
8342
8336
  * @param options - Optional parameters.
8343
8337
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
8344
8338
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
8345
8339
  */
8346
- /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options*/
8347
8340
  generateUserDelegationSasStringToSign(options, userDelegationKey) {
8348
8341
  return generateDataLakeSASQueryParametersInternal(Object.assign({ fileSystemName: this.fileSystemName, pathName: this.name }, options), userDelegationKey, this.accountName).stringToSign;
8349
8342
  }
@@ -8438,7 +8431,7 @@ class DataLakeFileSystemClient extends StorageClient {
8438
8431
  * Creates a new file system under the specified account. If the file system with
8439
8432
  * the same name already exists, the operation fails.
8440
8433
  *
8441
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-container
8434
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-container
8442
8435
  *
8443
8436
  * @param options - Optional. Options when creating file system.
8444
8437
  */
@@ -8451,7 +8444,7 @@ class DataLakeFileSystemClient extends StorageClient {
8451
8444
  * Creates a new file system under the specified account. If the file system with
8452
8445
  * the same name already exists, it is not changed.
8453
8446
  *
8454
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-container
8447
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-container
8455
8448
  *
8456
8449
  * @param options -
8457
8450
  */
@@ -8477,7 +8470,7 @@ class DataLakeFileSystemClient extends StorageClient {
8477
8470
  /**
8478
8471
  * Delete current file system.
8479
8472
  *
8480
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
8473
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-container
8481
8474
  *
8482
8475
  * @param options - Optional. Options when deleting file system.
8483
8476
  */
@@ -8489,7 +8482,7 @@ class DataLakeFileSystemClient extends StorageClient {
8489
8482
  /**
8490
8483
  * Delete current file system if it exists.
8491
8484
  *
8492
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/delete-container
8485
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/delete-container
8493
8486
  *
8494
8487
  * @param options -
8495
8488
  */
@@ -8507,7 +8500,7 @@ class DataLakeFileSystemClient extends StorageClient {
8507
8500
  * the `listFileSystems` method of {@link DataLakeServiceClient} using the `includeMetadata` option, which
8508
8501
  * will retain their original casing.
8509
8502
  *
8510
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-properties
8503
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-container-properties
8511
8504
  *
8512
8505
  * @param options - Optional. Options when getting file system properties.
8513
8506
  */
@@ -8529,7 +8522,7 @@ class DataLakeFileSystemClient extends StorageClient {
8529
8522
  * If no option provided, or no metadata defined in the parameter, the file system
8530
8523
  * metadata will be removed.
8531
8524
  *
8532
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-metadata
8525
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-container-metadata
8533
8526
  *
8534
8527
  * @param metadata - Replace existing metadata with this value.
8535
8528
  * If no value provided the existing metadata will be removed.
@@ -8547,7 +8540,7 @@ class DataLakeFileSystemClient extends StorageClient {
8547
8540
  * WARNING: JavaScript Date will potentially lose precision when parsing startsOn and expiresOn strings.
8548
8541
  * For example, new Date("2018-12-31T03:44:23.8827891Z").toISOString() will get "2018-12-31T03:44:23.882Z".
8549
8542
  *
8550
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-container-acl
8543
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-container-acl
8551
8544
  *
8552
8545
  * @param options - Optional. Options when getting file system access policy.
8553
8546
  */
@@ -8571,7 +8564,7 @@ class DataLakeFileSystemClient extends StorageClient {
8571
8564
  * If no access or containerAcl provided, the existing file system ACL will be
8572
8565
  * removed.
8573
8566
  *
8574
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-container-acl
8567
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-container-acl
8575
8568
  *
8576
8569
  * @param access - Optional. The level of public access to data in the file system.
8577
8570
  * @param fileSystemAcl - Optional. Array of elements each having a unique Id and details of the access policy.
@@ -8649,7 +8642,7 @@ class DataLakeFileSystemClient extends StorageClient {
8649
8642
  * }
8650
8643
  * ```
8651
8644
  *
8652
- * @see https://docs.microsoft.com/rest/api/storageservices/list-blobs
8645
+ * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
8653
8646
  *
8654
8647
  * @param options - Optional. Options when listing paths.
8655
8648
  */
@@ -8779,7 +8772,7 @@ class DataLakeFileSystemClient extends StorageClient {
8779
8772
  * }
8780
8773
  * ```
8781
8774
  *
8782
- * @see https://docs.microsoft.com/rest/api/storageservices/list-blobs
8775
+ * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
8783
8776
  *
8784
8777
  * @param options - Optional. Options when listing deleted paths.
8785
8778
  */
@@ -8851,7 +8844,7 @@ class DataLakeFileSystemClient extends StorageClient {
8851
8844
  /**
8852
8845
  * Restores a soft deleted path.
8853
8846
  *
8854
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/undelete-blob
8847
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/undelete-blob
8855
8848
  *
8856
8849
  * @param deletedPath - Required. The path of the deleted path.
8857
8850
  *
@@ -8876,7 +8869,7 @@ class DataLakeFileSystemClient extends StorageClient {
8876
8869
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8877
8870
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8878
8871
  *
8879
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8872
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8880
8873
  *
8881
8874
  * @param options - Optional parameters.
8882
8875
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8896,7 +8889,7 @@ class DataLakeFileSystemClient extends StorageClient {
8896
8889
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8897
8890
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8898
8891
  *
8899
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8892
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8900
8893
  *
8901
8894
  * @param options - Optional parameters.
8902
8895
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8912,7 +8905,7 @@ class DataLakeFileSystemClient extends StorageClient {
8912
8905
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8913
8906
  * and parameters passed in. The SAS is signed by the input user delegation key.
8914
8907
  *
8915
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8908
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8916
8909
  *
8917
8910
  * @param options - Optional parameters.
8918
8911
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -8928,13 +8921,12 @@ class DataLakeFileSystemClient extends StorageClient {
8928
8921
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8929
8922
  * and parameters passed in. The SAS is signed by the input user delegation key.
8930
8923
  *
8931
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8924
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-a-service-sas
8932
8925
  *
8933
8926
  * @param options - Optional parameters.
8934
8927
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
8935
8928
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
8936
8929
  */
8937
- /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options*/
8938
8930
  generateUserDelegationSasStringToSign(options, userDelegationKey) {
8939
8931
  return generateDataLakeSASQueryParametersInternal(Object.assign({ fileSystemName: this.name }, options), userDelegationKey, this.accountName).stringToSign;
8940
8932
  }
@@ -9032,12 +9024,12 @@ class AccountSASPermissions {
9032
9024
  * Using this method will guarantee the resource types are in
9033
9025
  * an order accepted by the service.
9034
9026
  *
9035
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9027
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9036
9028
  *
9037
9029
  */
9038
9030
  toString() {
9039
9031
  // The order of the characters should be as specified here to ensure correctness:
9040
- // https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9032
+ // https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9041
9033
  // Use a string array instead of string concatenating += operator for performance
9042
9034
  const permissions = [];
9043
9035
  if (this.read) {
@@ -9122,7 +9114,7 @@ class AccountSASResourceTypes {
9122
9114
  /**
9123
9115
  * Converts the given resource types to a string.
9124
9116
  *
9125
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9117
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9126
9118
  *
9127
9119
  */
9128
9120
  toString() {
@@ -9228,7 +9220,7 @@ class AccountSASServices {
9228
9220
  * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual
9229
9221
  * REST request.
9230
9222
  *
9231
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9223
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/constructing-an-account-sas
9232
9224
  *
9233
9225
  * @param accountSASSignatureValues -
9234
9226
  * @param sharedKeyCredential -
@@ -9306,7 +9298,6 @@ class DataLakeServiceClient extends StorageClient {
9306
9298
  * @param options - Optional. Options to configure the HTTP pipeline.
9307
9299
  */
9308
9300
  // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.
9309
- /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
9310
9301
  static fromConnectionString(connectionString,
9311
9302
  // Legacy, no way to fix the eslint error without breaking. Disable the rule for this line.
9312
9303
  /* eslint-disable-next-line @azure/azure-sdk/ts-naming-options */
@@ -9388,7 +9379,7 @@ class DataLakeServiceClient extends StorageClient {
9388
9379
  * accountName
9389
9380
  * ).toString();
9390
9381
  * ```
9391
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-user-delegation-key
9382
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-user-delegation-key
9392
9383
  *
9393
9384
  * @param startsOn - The start time for the user delegation SAS. Must be within 7 days of the current time.
9394
9385
  * @param expiresOn - The end time for the user delegation SAS. Must be within 7 days of the current time.
@@ -9470,7 +9461,7 @@ class DataLakeServiceClient extends StorageClient {
9470
9461
  * }
9471
9462
  * ```
9472
9463
  *
9473
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/list-containers2
9464
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/list-containers2
9474
9465
  *
9475
9466
  * @param options -
9476
9467
  */
@@ -9489,7 +9480,7 @@ class DataLakeServiceClient extends StorageClient {
9489
9480
  * Generates an account Shared Access Signature (SAS) URI based on the client properties
9490
9481
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
9491
9482
  *
9492
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas
9483
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-account-sas
9493
9484
  *
9494
9485
  * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not specified.
9495
9486
  * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -9516,7 +9507,7 @@ class DataLakeServiceClient extends StorageClient {
9516
9507
  * Generates string to sign for an account Shared Access Signature (SAS) based on the client properties
9517
9508
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
9518
9509
  *
9519
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/create-account-sas
9510
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/create-account-sas
9520
9511
  *
9521
9512
  * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not specified.
9522
9513
  * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -9576,7 +9567,7 @@ class DataLakeServiceClient extends StorageClient {
9576
9567
  /**
9577
9568
  * Gets the properties of a storage account’s Blob service endpoint, including properties
9578
9569
  * for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
9579
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/get-blob-service-properties
9570
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/get-blob-service-properties
9580
9571
  *
9581
9572
  * @param options - Options to the Service Get Properties operation.
9582
9573
  * @returns Response data for the Service Get Properties operation.
@@ -9592,7 +9583,7 @@ class DataLakeServiceClient extends StorageClient {
9592
9583
  /**
9593
9584
  * Sets properties for a storage account’s Blob service endpoint, including properties
9594
9585
  * for Storage Analytics, CORS (Cross-Origin Resource Sharing) rules and soft delete settings.
9595
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/set-blob-service-properties
9586
+ * @see https://learn.microsoft.com/en-us/rest/api/storageservices/set-blob-service-properties
9596
9587
  *
9597
9588
  * @param properties -
9598
9589
  * @param options - Options to the Service Set Properties operation.