Storage/STG93 Add Rename Support to List Ranges (Azure#5266)

* add rename support

* reset swagger url

* update

Author: microzchang

sdk/storage/assets.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "cpp",
   "TagPrefix": "cpp/storage",
-  "Tag": "cpp/storage_d89dcd9127"
+  "Tag": "cpp/storage_9093786628"
 }

sdk/storage/azure-storage-files-shares/inc/azure/storage/files/shares/rest_client.hpp

@@ -31,7 +31,7 @@ namespace Azure { namespace Storage { namespace Files { namespace Shares {
     /**
      * The version used for the operations to Azure storage services.
      */
-    constexpr static const char* ApiVersion = "2024-02-04";
+    constexpr static const char* ApiVersion = "2024-05-04";
   } // namespace _detail
   namespace Models {
     /**
@@ -2570,6 +2570,7 @@ namespace Azure { namespace Storage { namespace Files { namespace Shares {
         Nullable<std::string> LeaseId;
         Nullable<bool> AllowTrailingDot;
         Nullable<Models::ShareTokenIntent> FileRequestIntent;
+        Nullable<bool> SupportRename;
       };
       static Response<Models::GetFileRangeListResult> GetRangeList(
           Core::Http::_internal::HttpPipeline& pipeline,

sdk/storage/azure-storage-files-shares/inc/azure/storage/files/shares/share_options.hpp

@@ -791,6 +791,15 @@ namespace Azure { namespace Storage { namespace Files { namespace Shares {
      * The operation will only succeed if the access condition is met.
      */
     LeaseAccessConditions AccessConditions;
+
+    /**
+     * This header is allowed only when PreviousSnapshot query parameter is set.
+     * Determines whether the changed ranges for a file that has been renamed or moved between the
+     * target snapshot (or the live file) and the previous snapshot should be listed. If the value
+     * is true, the valid changed ranges for the file will be returned. If the value is false, the
+     * operation will result in a failure with 409 (Conflict) response.
+     */
+    Azure::Nullable<bool> SupportRename;
   };
 
   /**

sdk/storage/azure-storage-files-shares/src/rest_client.cpp

@@ -669,6 +669,7 @@ namespace Azure { namespace Storage { namespace Files { namespace Shares {
     protocolLayerOptions.LeaseId = options.AccessConditions.LeaseId;
     protocolLayerOptions.AllowTrailingDot = m_allowTrailingDot;
     protocolLayerOptions.FileRequestIntent = m_shareTokenIntent;
+    protocolLayerOptions.SupportRename = options.SupportRename;
     return _detail::FileClient::GetRangeList(
         *m_pipeline, m_shareFileUrl, protocolLayerOptions, context);
   }

sdk/storage/azure-storage-files-shares/src/share_file_client.cpp

@@ -9,7 +9,7 @@ package-name: azure-storage-files-shares
 namespace: Azure::Storage::Files::Shares
 output-folder: generated
 clear-output-folder: true
-input-file: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/storage/data-plane/Microsoft.FileStorage/preview/2024-02-04/file.json
+input-file: https://raw.githubusercontent.com/Azure/azure-rest-api-specs/main/specification/storage/data-plane/Microsoft.FileStorage/preview/2024-05-04/file.json
 ```
 
 ## ModelFour Options
@@ -79,12 +79,12 @@ directive:
           "name": "ApiVersion",
           "modelAsString": false
           },
-        "enum": ["2024-02-04"]
+        "enum": ["2024-05-04"]
       };
   - from: swagger-document
     where: $.parameters
     transform: >
-      $.ApiVersionParameter.enum[0] = "2024-02-04";
+      $.ApiVersionParameter.enum[0] = "2024-05-04";
 ```
 
 ### Rename Operations

sdk/storage/azure-storage-files-shares/swagger/README.md

@@ -901,6 +901,43 @@ namespace Azure { namespace Storage { namespace Test {
     }
   }
 
+  TEST_F(FileShareFileClientTest, GetRangeListDiffWithRename_PLAYBACKONLY_)
+  {
+    size_t rangeSize = 128;
+    std::vector<uint8_t> rangeContent = RandomBuffer(rangeSize);
+    auto memBodyStream = Core::IO::MemoryBodyStream(rangeContent);
+    std::string sourceFileName = RandomString();
+    std::string destFileName = RandomString();
+
+    auto fileClient = m_shareClient->GetRootDirectoryClient().GetFileClient(sourceFileName);
+    fileClient.Create(rangeSize);
+
+    EXPECT_NO_THROW(fileClient.UploadRange(0, memBodyStream));
+
+    auto snapshot = m_shareClient->CreateSnapshot().Value.Snapshot;
+    EXPECT_NO_THROW(fileClient.ClearRange(64, 64));
+
+    fileClient
+        = m_shareClient->GetRootDirectoryClient().RenameFile(sourceFileName, destFileName).Value;
+
+    Files::Shares::GetFileRangeListOptions options;
+    options.Range = Core::Http::HttpRange();
+    options.Range.Value().Offset = 64;
+    options.Range.Value().Length = 64;
+    Files::Shares::Models::GetFileRangeListResult result;
+
+    // SupportRename == true
+    options.SupportRename = true;
+    EXPECT_NO_THROW(result = fileClient.GetRangeListDiff(snapshot, options).Value);
+    EXPECT_EQ(1U, result.Ranges.size());
+    EXPECT_EQ(64, result.Ranges[0].Offset);
+    EXPECT_TRUE(result.Ranges[0].Length.HasValue());
+
+    // SupportRename == false
+    options.SupportRename = false;
+    EXPECT_THROW(fileClient.GetRangeListDiff(snapshot, options), StorageException);
+  }
+
   TEST_F(FileShareFileClientTest, PreviousRangeWithSnapshot)
   {
     size_t fileSize = 1024 * 10;