@azure/storage-file-datalake 12.25.0 → 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 (47) hide show
  1. package/LICENSE +3 -3
  2. package/README.md +25 -30
  3. package/dist/index.js +63 -64
  4. package/dist/index.js.map +1 -1
  5. package/dist-esm/storage-blob/src/StorageRetryPolicyFactory.js.map +1 -1
  6. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicy.js +2 -2
  7. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicy.js.map +1 -1
  8. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicyV2.js +2 -2
  9. package/dist-esm/storage-blob/src/policies/StorageSharedKeyCredentialPolicyV2.js.map +1 -1
  10. package/dist-esm/storage-blob/src/utils/constants.js +2 -2
  11. package/dist-esm/storage-blob/src/utils/constants.js.map +1 -1
  12. package/dist-esm/storage-blob/src/utils/utils.common.js +3 -3
  13. package/dist-esm/storage-blob/src/utils/utils.common.js.map +1 -1
  14. package/dist-esm/storage-blob/src/utils/utils.node.js +1 -1
  15. package/dist-esm/storage-blob/src/utils/utils.node.js.map +1 -1
  16. package/dist-esm/storage-file-datalake/src/DataLakeFileSystemClient.js +15 -15
  17. package/dist-esm/storage-file-datalake/src/DataLakeFileSystemClient.js.map +1 -1
  18. package/dist-esm/storage-file-datalake/src/DataLakeServiceClient.js +6 -6
  19. package/dist-esm/storage-file-datalake/src/DataLakeServiceClient.js.map +1 -1
  20. package/dist-esm/storage-file-datalake/src/clients.js +25 -25
  21. package/dist-esm/storage-file-datalake/src/clients.js.map +1 -1
  22. package/dist-esm/storage-file-datalake/src/credentials/UserDelegationKeyCredential.js +1 -1
  23. package/dist-esm/storage-file-datalake/src/credentials/UserDelegationKeyCredential.js.map +1 -1
  24. package/dist-esm/storage-file-datalake/src/generated/src/models/parameters.js +1 -1
  25. package/dist-esm/storage-file-datalake/src/generated/src/models/parameters.js.map +1 -1
  26. package/dist-esm/storage-file-datalake/src/generated/src/storageClient.js +2 -2
  27. package/dist-esm/storage-file-datalake/src/generated/src/storageClient.js.map +1 -1
  28. package/dist-esm/storage-file-datalake/src/models.js.map +1 -1
  29. package/dist-esm/storage-file-datalake/src/sas/AccountSASPermissions.js +2 -2
  30. package/dist-esm/storage-file-datalake/src/sas/AccountSASPermissions.js.map +1 -1
  31. package/dist-esm/storage-file-datalake/src/sas/AccountSASResourceTypes.js +1 -1
  32. package/dist-esm/storage-file-datalake/src/sas/AccountSASResourceTypes.js.map +1 -1
  33. package/dist-esm/storage-file-datalake/src/sas/AccountSASSignatureValues.js +1 -1
  34. package/dist-esm/storage-file-datalake/src/sas/AccountSASSignatureValues.js.map +1 -1
  35. package/dist-esm/storage-file-datalake/src/sas/DataLakeSASSignatureValues.js +1 -1
  36. package/dist-esm/storage-file-datalake/src/sas/DataLakeSASSignatureValues.js.map +1 -1
  37. package/dist-esm/storage-file-datalake/src/sas/DirectorySASPermissions.js +1 -1
  38. package/dist-esm/storage-file-datalake/src/sas/DirectorySASPermissions.js.map +1 -1
  39. package/dist-esm/storage-file-datalake/src/sas/FileSystemSASPermissions.js +1 -1
  40. package/dist-esm/storage-file-datalake/src/sas/FileSystemSASPermissions.js.map +1 -1
  41. package/dist-esm/storage-file-datalake/src/sas/SASQueryParameters.js.map +1 -1
  42. package/dist-esm/storage-file-datalake/src/utils/constants.js +2 -2
  43. package/dist-esm/storage-file-datalake/src/utils/constants.js.map +1 -1
  44. package/dist-esm/storage-file-datalake/src/utils/utils.common.js +3 -3
  45. package/dist-esm/storage-file-datalake/src/utils/utils.common.js.map +1 -1
  46. package/package.json +11 -11
  47. package/types/latest/storage-file-datalake.d.ts +69 -69
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";
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`;
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);
@@ -4638,8 +4637,8 @@ class StorageContextClient extends StorageClient$1 {
4638
4637
  *
4639
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.
4640
4639
  *
4641
- * @see https://docs.microsoft.com/en-us/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata
4642
- * @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
4643
4642
  *
4644
4643
  * @param url -
4645
4644
  */
@@ -4653,7 +4652,7 @@ function escapeURLPath(url) {
4653
4652
  }
4654
4653
  function getProxyUriFromDevConnString(connectionString) {
4655
4654
  // Development Connection String
4656
- // 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
4657
4656
  let proxyUri = "";
4658
4657
  if (connectionString.search("DevelopmentStorageProxyUri=") !== -1) {
4659
4658
  // CONNECTION_STRING=UseDevelopmentStorage=true;DevelopmentStorageProxyUri=http://myProxyUri
@@ -5290,7 +5289,7 @@ function toBlobCpkInfo(input) {
5290
5289
 
5291
5290
  // This function relies on the Pipeline already being initialized by a storage-blob client
5292
5291
  function getCoreClientOptions(pipeline) {
5293
- const _a = pipeline.options, restOptions = tslib.__rest(_a, ["httpClient"]);
5292
+ const _a = pipeline.options, { httpClient: v1Client } = _a, restOptions = tslib.__rest(_a, ["httpClient"]);
5294
5293
  const httpClient = pipeline._coreHttpClient;
5295
5294
  if (!httpClient) {
5296
5295
  throw new Error("Pipeline not correctly initialized; missing V2 HttpClient");
@@ -5752,7 +5751,7 @@ class BufferScheduler {
5752
5751
  * ONLY AVAILABLE IN NODE.JS RUNTIME.
5753
5752
  *
5754
5753
  * UserDelegationKeyCredential is only used for generation of user delegation SAS.
5755
- * @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
5756
5755
  */
5757
5756
  class UserDelegationKeyCredential {
5758
5757
  /**
@@ -6017,7 +6016,7 @@ class FileSystemSASPermissions {
6017
6016
  * order accepted by the service.
6018
6017
  *
6019
6018
  * The order of the characters should be as specified here to ensure correctness.
6020
- * @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
6021
6020
  *
6022
6021
  */
6023
6022
  toString() {
@@ -6419,7 +6418,7 @@ class DirectorySASPermissions {
6419
6418
  * order accepted by the service.
6420
6419
  *
6421
6420
  * The order of the characters should be as specified here to ensure correctness.
6422
- * @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
6423
6422
  *
6424
6423
  */
6425
6424
  toString() {
@@ -6487,7 +6486,7 @@ function generateDataLakeSASQueryParametersInternal(dataLakeSASSignatureValues,
6487
6486
  }
6488
6487
  }
6489
6488
  // Version 2018-11-09 adds support for the signed resource and signed blob snapshot time fields.
6490
- // 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
6491
6490
  if (version >= "2018-11-09") {
6492
6491
  if (sharedKeyCredential !== undefined) {
6493
6492
  return generateBlobSASQueryParameters20181109(dataLakeSASSignatureValues, sharedKeyCredential);
@@ -7348,7 +7347,7 @@ class DataLakePathClient extends StorageClient {
7348
7347
  /**
7349
7348
  * Create a directory or path.
7350
7349
  *
7351
- * @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
7352
7351
  *
7353
7352
  * @param resourceType - Resource type, "directory" or "file".
7354
7353
  * @param options - Optional. Options when creating path.
@@ -7377,7 +7376,7 @@ class DataLakePathClient extends StorageClient {
7377
7376
  /**
7378
7377
  * Create a directory or file. If the resource already exists, it is not changed.
7379
7378
  *
7380
- * @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
7381
7380
  *
7382
7381
  * @param resourceType - Resource type, "directory" or "file".
7383
7382
  * @param options -
@@ -7415,7 +7414,7 @@ class DataLakePathClient extends StorageClient {
7415
7414
  /**
7416
7415
  * Delete current path (directory or file).
7417
7416
  *
7418
- * @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
7419
7418
  *
7420
7419
  * @param recursive - Required and valid only when the resource is a directory. If "true", all paths beneath the directory will be deleted.
7421
7420
  * @param options - Optional. Options when deleting path.
@@ -7449,7 +7448,7 @@ class DataLakePathClient extends StorageClient {
7449
7448
  /**
7450
7449
  * Delete current path (directory or file) if it exists.
7451
7450
  *
7452
- * @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
7453
7452
  *
7454
7453
  * @param recursive - Required and valid only when the resource is a directory. If "true", all paths beneath the directory will be deleted.
7455
7454
  * @param options -
@@ -7473,7 +7472,7 @@ class DataLakePathClient extends StorageClient {
7473
7472
  /**
7474
7473
  * Returns the access control data for a path (directory of file).
7475
7474
  *
7476
- * @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
7477
7476
  *
7478
7477
  * @param options - Optional. Options when getting file access control.
7479
7478
  */
@@ -7487,7 +7486,7 @@ class DataLakePathClient extends StorageClient {
7487
7486
  /**
7488
7487
  * Set the access control data for a path (directory of file).
7489
7488
  *
7490
- * @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
7491
7490
  *
7492
7491
  * @param acl - The POSIX access control list for the file or directory.
7493
7492
  * @param options - Optional. Options when setting path access control.
@@ -7501,7 +7500,7 @@ class DataLakePathClient extends StorageClient {
7501
7500
  /**
7502
7501
  * Sets the Access Control on a path and sub paths.
7503
7502
  *
7504
- * @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
7505
7504
  *
7506
7505
  * @param acl - The POSIX access control list for the file or directory.
7507
7506
  * @param options - Optional. Options
@@ -7514,7 +7513,7 @@ class DataLakePathClient extends StorageClient {
7514
7513
  /**
7515
7514
  * Modifies the Access Control on a path and sub paths.
7516
7515
  *
7517
- * @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
7518
7517
  *
7519
7518
  * @param acl - The POSIX access control list for the file or directory.
7520
7519
  * @param options - Optional. Options
@@ -7527,7 +7526,7 @@ class DataLakePathClient extends StorageClient {
7527
7526
  /**
7528
7527
  * Removes the Access Control on a path and sub paths.
7529
7528
  *
7530
- * @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
7531
7530
  *
7532
7531
  * @param acl - The POSIX access control list for the file or directory.
7533
7532
  * @param options - Optional. Options
@@ -7540,7 +7539,7 @@ class DataLakePathClient extends StorageClient {
7540
7539
  /**
7541
7540
  * Sets the file permissions on a path.
7542
7541
  *
7543
- * @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
7544
7543
  *
7545
7544
  * @param permissions - The POSIX access permissions for the file owner, the file owning group, and others.
7546
7545
  * @param options - Optional. Options when setting path permissions.
@@ -7560,7 +7559,7 @@ class DataLakePathClient extends StorageClient {
7560
7559
  * the methods of {@link DataLakeFileSystemClient} that list paths using the `includeMetadata` option, which
7561
7560
  * will retain their original casing.
7562
7561
  *
7563
- * @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
7564
7563
  *
7565
7564
  * @param options - Optional. Options when getting path properties.
7566
7565
  */
@@ -7575,7 +7574,7 @@ class DataLakePathClient extends StorageClient {
7575
7574
  *
7576
7575
  * If no value provided, or no value provided for the specified blob HTTP headers,
7577
7576
  * these blob HTTP headers without a value will be cleared.
7578
- * @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
7579
7578
  *
7580
7579
  * @param httpHeaders -
7581
7580
  * @param options -
@@ -7598,7 +7597,7 @@ class DataLakePathClient extends StorageClient {
7598
7597
  * If no option provided, or no metadata defined in the parameter, the path
7599
7598
  * metadata will be removed.
7600
7599
  *
7601
- * @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
7602
7601
  *
7603
7602
  * @param metadata - Optional. Replace existing metadata with this value.
7604
7603
  * If no value provided the existing metadata will be removed.
@@ -7703,7 +7702,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7703
7702
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
7704
7703
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
7705
7704
  *
7706
- * @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
7707
7706
  *
7708
7707
  * @param options - Optional parameters.
7709
7708
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -7721,7 +7720,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7721
7720
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
7722
7721
  * and parameters passed in.
7723
7722
  *
7724
- * @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
7725
7724
  *
7726
7725
  * @param options - Optional parameters.
7727
7726
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -7737,7 +7736,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7737
7736
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
7738
7737
  * and parameters passed in. The SAS is signed by the input user delegation key.
7739
7738
  *
7740
- * @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
7741
7740
  *
7742
7741
  * @param options - Optional parameters.
7743
7742
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -7753,7 +7752,7 @@ class DataLakeDirectoryClient extends DataLakePathClient {
7753
7752
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
7754
7753
  * and parameters passed in The SAS is signed by the input user delegation key.
7755
7754
  *
7756
- * @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
7757
7756
  *
7758
7757
  * @param options - Optional parameters.
7759
7758
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -7821,7 +7820,7 @@ class DataLakeFileClient extends DataLakePathClient {
7821
7820
  * * In Node.js, data returns in a Readable stream readableStreamBody
7822
7821
  * * In browsers, data returns in a promise contentAsBlob
7823
7822
  *
7824
- * @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
7825
7824
  *
7826
7825
  * * Example usage (Node.js):
7827
7826
  *
@@ -7835,7 +7834,7 @@ class DataLakeFileClient extends DataLakePathClient {
7835
7834
  * return new Promise((resolve, reject) => {
7836
7835
  * const chunks = [];
7837
7836
  * readableStream.on("data", (data) => {
7838
- * chunks.push(data instanceof Buffer ? data : Buffer.from(data));
7837
+ * chunks.push(typeof data === "string" ? Buffer.from(data) : data);
7839
7838
  * });
7840
7839
  * readableStream.on("end", () => {
7841
7840
  * resolve(Buffer.concat(chunks));
@@ -7888,7 +7887,7 @@ class DataLakeFileClient extends DataLakePathClient {
7888
7887
  * Uploads data to be appended to a file. Data can only be appended to a file.
7889
7888
  * To apply perviously uploaded data to a file, call flush.
7890
7889
  *
7891
- * @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
7892
7891
  *
7893
7892
  * @param body - Content to be uploaded.
7894
7893
  * @param offset - Append offset in bytes.
@@ -8215,7 +8214,7 @@ class DataLakeFileClient extends DataLakePathClient {
8215
8214
  * return new Promise((resolve, reject) => {
8216
8215
  * const chunks = [];
8217
8216
  * readableStream.on("data", (data) => {
8218
- * chunks.push(data instanceof Buffer ? data : Buffer.from(data));
8217
+ * chunks.push(typeof data === "string" ? Buffer.from(data) : data);
8219
8218
  * });
8220
8219
  * readableStream.on("end", () => {
8221
8220
  * resolve(Buffer.concat(chunks));
@@ -8280,7 +8279,7 @@ class DataLakeFileClient extends DataLakePathClient {
8280
8279
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8281
8280
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8282
8281
  *
8283
- * @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
8284
8283
  *
8285
8284
  * @param options - Optional parameters.
8286
8285
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8300,7 +8299,7 @@ class DataLakeFileClient extends DataLakePathClient {
8300
8299
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8301
8300
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8302
8301
  *
8303
- * @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
8304
8303
  *
8305
8304
  * @param options - Optional parameters.
8306
8305
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8316,7 +8315,7 @@ class DataLakeFileClient extends DataLakePathClient {
8316
8315
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8317
8316
  * and parameters passed in. The SAS is signed by the input user delegation key.
8318
8317
  *
8319
- * @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
8320
8319
  *
8321
8320
  * @param options - Optional parameters.
8322
8321
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -8332,7 +8331,7 @@ class DataLakeFileClient extends DataLakePathClient {
8332
8331
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8333
8332
  * and parameters passed in. The SAS is signed by the input user delegation key.
8334
8333
  *
8335
- * @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
8336
8335
  *
8337
8336
  * @param options - Optional parameters.
8338
8337
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -8432,7 +8431,7 @@ class DataLakeFileSystemClient extends StorageClient {
8432
8431
  * Creates a new file system under the specified account. If the file system with
8433
8432
  * the same name already exists, the operation fails.
8434
8433
  *
8435
- * @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
8436
8435
  *
8437
8436
  * @param options - Optional. Options when creating file system.
8438
8437
  */
@@ -8445,7 +8444,7 @@ class DataLakeFileSystemClient extends StorageClient {
8445
8444
  * Creates a new file system under the specified account. If the file system with
8446
8445
  * the same name already exists, it is not changed.
8447
8446
  *
8448
- * @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
8449
8448
  *
8450
8449
  * @param options -
8451
8450
  */
@@ -8471,7 +8470,7 @@ class DataLakeFileSystemClient extends StorageClient {
8471
8470
  /**
8472
8471
  * Delete current file system.
8473
8472
  *
8474
- * @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
8475
8474
  *
8476
8475
  * @param options - Optional. Options when deleting file system.
8477
8476
  */
@@ -8483,7 +8482,7 @@ class DataLakeFileSystemClient extends StorageClient {
8483
8482
  /**
8484
8483
  * Delete current file system if it exists.
8485
8484
  *
8486
- * @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
8487
8486
  *
8488
8487
  * @param options -
8489
8488
  */
@@ -8501,7 +8500,7 @@ class DataLakeFileSystemClient extends StorageClient {
8501
8500
  * the `listFileSystems` method of {@link DataLakeServiceClient} using the `includeMetadata` option, which
8502
8501
  * will retain their original casing.
8503
8502
  *
8504
- * @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
8505
8504
  *
8506
8505
  * @param options - Optional. Options when getting file system properties.
8507
8506
  */
@@ -8523,7 +8522,7 @@ class DataLakeFileSystemClient extends StorageClient {
8523
8522
  * If no option provided, or no metadata defined in the parameter, the file system
8524
8523
  * metadata will be removed.
8525
8524
  *
8526
- * @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
8527
8526
  *
8528
8527
  * @param metadata - Replace existing metadata with this value.
8529
8528
  * If no value provided the existing metadata will be removed.
@@ -8541,7 +8540,7 @@ class DataLakeFileSystemClient extends StorageClient {
8541
8540
  * WARNING: JavaScript Date will potentially lose precision when parsing startsOn and expiresOn strings.
8542
8541
  * For example, new Date("2018-12-31T03:44:23.8827891Z").toISOString() will get "2018-12-31T03:44:23.882Z".
8543
8542
  *
8544
- * @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
8545
8544
  *
8546
8545
  * @param options - Optional. Options when getting file system access policy.
8547
8546
  */
@@ -8565,7 +8564,7 @@ class DataLakeFileSystemClient extends StorageClient {
8565
8564
  * If no access or containerAcl provided, the existing file system ACL will be
8566
8565
  * removed.
8567
8566
  *
8568
- * @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
8569
8568
  *
8570
8569
  * @param access - Optional. The level of public access to data in the file system.
8571
8570
  * @param fileSystemAcl - Optional. Array of elements each having a unique Id and details of the access policy.
@@ -8643,7 +8642,7 @@ class DataLakeFileSystemClient extends StorageClient {
8643
8642
  * }
8644
8643
  * ```
8645
8644
  *
8646
- * @see https://docs.microsoft.com/rest/api/storageservices/list-blobs
8645
+ * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
8647
8646
  *
8648
8647
  * @param options - Optional. Options when listing paths.
8649
8648
  */
@@ -8773,7 +8772,7 @@ class DataLakeFileSystemClient extends StorageClient {
8773
8772
  * }
8774
8773
  * ```
8775
8774
  *
8776
- * @see https://docs.microsoft.com/rest/api/storageservices/list-blobs
8775
+ * @see https://learn.microsoft.com/rest/api/storageservices/list-blobs
8777
8776
  *
8778
8777
  * @param options - Optional. Options when listing deleted paths.
8779
8778
  */
@@ -8845,7 +8844,7 @@ class DataLakeFileSystemClient extends StorageClient {
8845
8844
  /**
8846
8845
  * Restores a soft deleted path.
8847
8846
  *
8848
- * @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
8849
8848
  *
8850
8849
  * @param deletedPath - Required. The path of the deleted path.
8851
8850
  *
@@ -8870,7 +8869,7 @@ class DataLakeFileSystemClient extends StorageClient {
8870
8869
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8871
8870
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8872
8871
  *
8873
- * @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
8874
8873
  *
8875
8874
  * @param options - Optional parameters.
8876
8875
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8890,7 +8889,7 @@ class DataLakeFileSystemClient extends StorageClient {
8890
8889
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8891
8890
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
8892
8891
  *
8893
- * @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
8894
8893
  *
8895
8894
  * @param options - Optional parameters.
8896
8895
  * @returns The SAS URI consisting of the URI to the resource represented by this client, followed by the generated SAS token.
@@ -8906,7 +8905,7 @@ class DataLakeFileSystemClient extends StorageClient {
8906
8905
  * Generates a Service Shared Access Signature (SAS) URI based on the client properties
8907
8906
  * and parameters passed in. The SAS is signed by the input user delegation key.
8908
8907
  *
8909
- * @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
8910
8909
  *
8911
8910
  * @param options - Optional parameters.
8912
8911
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -8922,7 +8921,7 @@ class DataLakeFileSystemClient extends StorageClient {
8922
8921
  * Generates string to sign for a Service Shared Access Signature (SAS) URI based on the client properties
8923
8922
  * and parameters passed in. The SAS is signed by the input user delegation key.
8924
8923
  *
8925
- * @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
8926
8925
  *
8927
8926
  * @param options - Optional parameters.
8928
8927
  * @param userDelegationKey - Return value of `blobServiceClient.getUserDelegationKey()`
@@ -9025,12 +9024,12 @@ class AccountSASPermissions {
9025
9024
  * Using this method will guarantee the resource types are in
9026
9025
  * an order accepted by the service.
9027
9026
  *
9028
- * @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
9029
9028
  *
9030
9029
  */
9031
9030
  toString() {
9032
9031
  // The order of the characters should be as specified here to ensure correctness:
9033
- // 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
9034
9033
  // Use a string array instead of string concatenating += operator for performance
9035
9034
  const permissions = [];
9036
9035
  if (this.read) {
@@ -9115,7 +9114,7 @@ class AccountSASResourceTypes {
9115
9114
  /**
9116
9115
  * Converts the given resource types to a string.
9117
9116
  *
9118
- * @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
9119
9118
  *
9120
9119
  */
9121
9120
  toString() {
@@ -9221,7 +9220,7 @@ class AccountSASServices {
9221
9220
  * Generates a {@link SASQueryParameters} object which contains all SAS query parameters needed to make an actual
9222
9221
  * REST request.
9223
9222
  *
9224
- * @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
9225
9224
  *
9226
9225
  * @param accountSASSignatureValues -
9227
9226
  * @param sharedKeyCredential -
@@ -9380,7 +9379,7 @@ class DataLakeServiceClient extends StorageClient {
9380
9379
  * accountName
9381
9380
  * ).toString();
9382
9381
  * ```
9383
- * @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
9384
9383
  *
9385
9384
  * @param startsOn - The start time for the user delegation SAS. Must be within 7 days of the current time.
9386
9385
  * @param expiresOn - The end time for the user delegation SAS. Must be within 7 days of the current time.
@@ -9462,7 +9461,7 @@ class DataLakeServiceClient extends StorageClient {
9462
9461
  * }
9463
9462
  * ```
9464
9463
  *
9465
- * @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
9466
9465
  *
9467
9466
  * @param options -
9468
9467
  */
@@ -9481,7 +9480,7 @@ class DataLakeServiceClient extends StorageClient {
9481
9480
  * Generates an account Shared Access Signature (SAS) URI based on the client properties
9482
9481
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
9483
9482
  *
9484
- * @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
9485
9484
  *
9486
9485
  * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not specified.
9487
9486
  * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -9508,7 +9507,7 @@ class DataLakeServiceClient extends StorageClient {
9508
9507
  * Generates string to sign for an account Shared Access Signature (SAS) based on the client properties
9509
9508
  * and parameters passed in. The SAS is signed by the shared key credential of the client.
9510
9509
  *
9511
- * @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
9512
9511
  *
9513
9512
  * @param expiresOn - Optional. The time at which the shared access signature becomes invalid. Default to an hour later if not specified.
9514
9513
  * @param permissions - Specifies the list of permissions to be associated with the SAS.
@@ -9568,7 +9567,7 @@ class DataLakeServiceClient extends StorageClient {
9568
9567
  /**
9569
9568
  * Gets the properties of a storage account’s Blob service endpoint, including properties
9570
9569
  * for Storage Analytics and CORS (Cross-Origin Resource Sharing) rules.
9571
- * @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
9572
9571
  *
9573
9572
  * @param options - Options to the Service Get Properties operation.
9574
9573
  * @returns Response data for the Service Get Properties operation.
@@ -9584,7 +9583,7 @@ class DataLakeServiceClient extends StorageClient {
9584
9583
  /**
9585
9584
  * Sets properties for a storage account’s Blob service endpoint, including properties
9586
9585
  * for Storage Analytics, CORS (Cross-Origin Resource Sharing) rules and soft delete settings.
9587
- * @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
9588
9587
  *
9589
9588
  * @param properties -
9590
9589
  * @param options - Options to the Service Set Properties operation.