Storage/STG99 Made error message for invalid x-ms-version more user-friendly (#6613)

* add invalid version erorr message support

* Update find logic

Author: microzchang

sdk/storage/azure-storage-blobs/test/ut/block_blob_client_test.cpp

@@ -2264,4 +2264,20 @@ namespace Azure { namespace Storage { namespace Test {
     blobProperties = versionClient.GetProperties().Value;
     EXPECT_TRUE(blobProperties.HasLegalHold);
   }
+
+  TEST_F(BlockBlobClientTest, InvalidVersionMessage_LIVEONLY_)
+  {
+    Blobs::BlobClientOptions options;
+    options.ApiVersion = "3015-11-11";
+    auto blobClient = GetBlockBlobClientForTest(LowercaseRandomString(), options);
+    try
+    {
+      blobClient.Download();
+    }
+    catch (const StorageException& e)
+    {
+      EXPECT_EQ(e.ErrorCode, _internal::InvalidHeaderValueErrorCode);
+      EXPECT_EQ(e.Message, _internal::InvalidVersionHeaderMessage);
+    }
+  }
 }}} // namespace Azure::Storage::Test

sdk/storage/azure-storage-common/inc/azure/storage/common/internal/constants.hpp

@@ -21,6 +21,11 @@ namespace Azure { namespace Storage { namespace _internal {
   constexpr static const char* HttpHeaderContentType = "content-type";
   constexpr static const char* HttpHeaderContentLength = "content-length";
   constexpr static const char* HttpHeaderContentRange = "content-range";
+  constexpr static const char* InvalidHeaderValueErrorCode = "InvalidHeaderValue";
+  constexpr static const char* InvalidVersionHeaderMessage
+      = "The provided service version is not enabled on this storage account.  Please see "
+        "https://learn.microsoft.com/rest/api/storageservices/"
+        "versioning-for-the-azure-storage-services for additional information.";
 
   constexpr int ReliableStreamRetryCount = 3;
 }}} // namespace Azure::Storage::_internal

sdk/storage/azure-storage-common/src/storage_exception.cpp

@@ -147,6 +147,14 @@ namespace Azure { namespace Storage {
       errorCode = response->GetHeaders().at("x-ms-error-code");
     }
 
+    // Optimize error messages
+    const auto headerName = additionalInformation.find("HeaderName");
+    if (errorCode == _internal::InvalidHeaderValueErrorCode
+        && headerName != additionalInformation.end() && headerName->second == "x-ms-version")
+    {
+      message = _internal::InvalidVersionHeaderMessage;
+    }
+
     StorageException result = StorageException(
         std::to_string(static_cast<std::underlying_type<Azure::Core::Http::HttpStatusCode>::type>(
             httpStatusCode))