azure-storage-common2 2.0.8 → 2.0.9

data/lib/azure/storage/common/core/error.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require "azure/core"
+
+module Azure::Storage::Common::Core
+  # Superclass for errors generated from this library, so people can
+  # just rescue this for generic error handling
+  class StorageError < StandardError
+    # attr_reader :description
+    # attr_reader :status_code
+    # attr_reader :type
+
+    # def initialize(description, type, status)
+    #   @type = type
+    #   @status_code = status
+    #   @description = description
+    #   super("#{type} (#{status_code}): #{description}")
+    # end
+  end
+end

data/lib/azure/storage/common/core/filter/exponential_retry_filter.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require "azure/core"
+require "azure/core/http/retry_policy"
+
+module Azure::Storage::Common::Core::Filter
+  class ExponentialRetryPolicyFilter < RetryPolicyFilter
+    def initialize(retry_count = nil, min_retry_interval = nil, max_retry_interval = nil)
+      @retry_count = retry_count || ExponentialRetryPolicyFilter::DEFAULT_RETRY_COUNT
+      @min_retry_interval = min_retry_interval || ExponentialRetryPolicyFilter::DEFAULT_MIN_RETRY_INTERVAL
+      @max_retry_interval = max_retry_interval || ExponentialRetryPolicyFilter::DEFAULT_MAX_RETRY_INTERVAL
+
+      super @retry_count, @min_retry_interval
+    end
+
+    attr_reader :min_retry_interval,
+                :max_retry_interval
+
+    DEFAULT_RETRY_COUNT = 3
+    DEFAULT_MIN_RETRY_INTERVAL = 10
+    DEFAULT_MAX_RETRY_INTERVAL = 90
+
+    # Overrides the base class implementation of call to determine
+    # how the HTTP request should continue retrying
+    #
+    # retry_data - Hash. Stores stateful retry data
+    #
+    # The retry_data is a Hash which can be used to store
+    # stateful data about the request execution context (such as an
+    # incrementing counter, timestamp, etc). The retry_data object
+    # will be the same instance throughout the lifetime of the request
+    def apply_retry_policy(retry_data)
+      # Adjust retry count
+      retry_data[:count] = retry_data[:count] === nil ? 1 : retry_data[:count] + 1
+
+      # Adjust retry interval
+      increment_delta = (@max_retry_interval - @min_retry_interval).fdiv(2**(@retry_count - 1)) * (2**(retry_data[:count] - 1));
+      retry_data[:interval] = retry_data[:interval] === nil ? @min_retry_interval : [@min_retry_interval + increment_delta, @max_retry_interval].min;
+    end
+  end
+end

data/lib/azure/storage/common/core/filter/linear_retry_filter.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require "azure/core"
+require "azure/core/http/retry_policy"
+
+module Azure::Storage::Common::Core::Filter
+  class LinearRetryPolicyFilter < RetryPolicyFilter
+    def initialize(retry_count = nil, retry_interval = nil)
+      @retry_count = retry_count || LinearRetryPolicyFilter::DEFAULT_RETRY_COUNT
+      @retry_interval = retry_interval || LinearRetryPolicyFilter::DEFAULT_RETRY_INTERVAL
+
+      super @retry_count, @retry_interval
+    end
+
+    DEFAULT_RETRY_COUNT = 3
+    DEFAULT_RETRY_INTERVAL = 30
+
+    # Overrides the base class implementation of call to determine
+    # how the HTTP request should continue retrying
+    #
+    # retry_data - Hash. Stores stateful retry data
+    #
+    # The retry_data is a Hash which can be used to store
+    # stateful data about the request execution context (such as an
+    # incrementing counter, timestamp, etc). The retry_data object
+    # will be the same instance throughout the lifetime of the request
+    def apply_retry_policy(retry_data)
+      retry_data[:count] = retry_data[:count] == nil ? 1 : retry_data[:count] + 1
+      retry_data[:interval] = @retry_interval
+    end
+  end
+end

data/lib/azure/storage/common/core/filter/retry_filter.rb

@@ -0,0 +1,300 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+require "azure/core"
+require "azure/core/http/retry_policy"
+
+module Azure::Storage::Common::Core::Filter
+  class RetryPolicyFilter < Azure::Core::Http::RetryPolicy
+    def initialize(retry_count = nil, retry_interval = nil)
+      @retry_count = retry_count
+      @retry_interval = retry_interval
+      @request_options = {}
+
+      super &:should_retry?
+    end
+
+    attr_reader :retry_count,
+                :retry_interval
+
+    # Overrides the base class implementation of call to determine
+    # whether to retry the operation
+    #
+    # response - HttpResponse. The response from the active request
+    # retry_data - Hash. Stores stateful retry data
+    def should_retry?(response, retry_data)
+      # Fill necessary information
+      init_retry_data retry_data
+
+      # Applies the logic when there is subclass overrides it
+      apply_retry_policy retry_data
+
+      # Checks the result and count limit
+      if retry_data[:retryable].nil?
+        retry_data[:retryable] = true
+      else
+        retry_data[:retryable] &&= retry_data[:count] <= @retry_count
+      end
+      return false unless retry_data[:retryable]
+
+      # Checks whether there is a local error
+      # Cannot retry immediately when it returns true, as it need check other errors
+      should_retry_on_local_error? retry_data
+      return false unless should_retry_on_error? response, retry_data
+
+      # Determined that it needs to retry.
+      adjust_retry_request retry_data
+
+      wait_for_retry
+
+      retry_data[:retryable]
+    end
+
+    # Apply the retry policy to determine how the HTTP request should continue retrying
+    #
+    # retry_data - Hash. Stores stateful retry data
+    #
+    # The retry_data is a Hash which can be used to store
+    # stateful data about the request execution context (such as an
+    # incrementing counter, timestamp, etc). The retry_data object
+    # will be the same instance throughout the lifetime of the request
+    #
+    # Alternatively, a subclass could override this method.
+    def apply_retry_policy(retry_data)
+    end
+
+    # Determines if the HTTP request should continue retrying
+    #
+    # retry_data - Hash. Stores stateful retry data
+    #
+    # The retry_data is a Hash which can be used to store
+    # stateful data about the request execution context (such as an
+    # incrementing counter, timestamp, etc). The retry_data object
+    # will be the same instance throughout the lifetime of the request.
+    def should_retry_on_local_error?(retry_data)
+      unless retry_data[:error]
+        retry_data[:retryable] = true;
+        return true
+      end
+
+      error_message = retry_data[:error].inspect
+
+      if error_message.include?("SocketError: Hostname not known")
+        # Retry on local DNS resolving
+        # When uses resolv-replace.rb to replace the libc resolver
+        # Reference:
+        #  https://makandracards.com/ninjaconcept/30815-fixing-socketerror-getaddrinfo-name-or-service-not-known-with-ruby-s-resolv-replace-rb
+        #  http://www.subelsky.com/2014/05/fixing-socketerror-getaddrinfo-name-or.html
+        retry_data[:retryable] = true;
+      elsif error_message.include?("getaddrinfo: Name or service not known")
+        # When uses the default resolver
+        retry_data[:retryable] = true;
+      elsif error_message.downcase.include?("timeout")
+        retry_data[:retryable] = true;
+      elsif error_message.include?("Errno::ECONNRESET")
+        retry_data[:retryable] = true;
+      elsif error_message.include?("Errno::EACCES")
+        retry_data[:retryable] = false;
+      elsif error_message.include?("NOSUPPORT")
+        retry_data[:retryable] = false;
+      end
+
+      retry_data[:retryable]
+    end
+
+    # Determines if the HTTP request should continue retrying
+    #
+    # response - Azure::Core::Http::HttpResponse. The response from the active request
+    # retry_data - Hash. Stores stateful retry data
+    #
+    # The retry_data is a Hash which can be used to store
+    # stateful data about the request execution context (such as an
+    # incrementing counter, timestamp, etc). The retry_data object
+    # will be the same instance throughout the lifetime of the request.
+    def should_retry_on_error?(response, retry_data)
+      response = response || retry_data[:error].http_response if retry_data[:error] && retry_data[:error].respond_to?("http_response")
+      unless response
+        retry_data[:retryable] = false unless retry_data[:error]
+        return retry_data[:retryable]
+      end
+
+      check_location(response, retry_data)
+
+      check_status_code(retry_data)
+
+      retry_data[:retryable]
+    end
+
+    # Adjust the retry parameter and wait for retry
+    def wait_for_retry
+      sleep @retry_interval if @retry_interval > 0
+    end
+
+    # Adjust the retry request
+    #
+    # retry_data - Hash. Stores stateful retry data
+    def adjust_retry_request(retry_data)
+      # Adjust the location first
+      next_location = @request_options[:target_location].nil? ? get_next_location(retry_data) : @request_options[:target_location]
+      retry_data[:current_location] = next_location
+
+      retry_data[:uri] =
+        if next_location == Azure::Storage::Common::StorageLocation::PRIMARY
+          @request_options[:primary_uri]
+        else
+          @request_options[:secondary_uri]
+        end
+
+      # Now is the time to calculate the exact retry interval. ShouldRetry call above already
+      # returned back how long two requests to the same location should be apart from each other.
+      # However, for the reasons explained above, the time spent between the last attempt to
+      # the target location and current time must be subtracted from the total retry interval
+      # that ShouldRetry returned.
+      lastAttemptTime =
+        if retry_data[:current_location] == Azure::Storage::Common::StorageLocation::PRIMARY
+          retry_data[:last_primary_attempt]
+        else
+          retry_data[:last_secondary_attempt]
+        end
+
+      @retry_interval =
+        if lastAttemptTime.nil?
+          0
+        else
+          since_last_attempt = Time.now - lastAttemptTime
+          remainder = retry_data[:interval] - since_last_attempt
+          remainder > 0 ? remainder : 0
+        end
+    end
+
+    # Initialize the retry data
+    #
+    # retry_data - Hash. Stores stateful retry data
+    def init_retry_data(retry_data)
+      @request_options = retry_data[:request_options] unless retry_data[:request_options].nil?
+
+      if retry_data[:current_location].nil?
+        retry_data[:current_location] = Azure::Storage::Common::Service::StorageService.get_location(@request_options[:location_mode], @request_options[:request_location_mode])
+      end
+
+      if retry_data[:current_location] == Azure::Storage::Common::StorageLocation::PRIMARY
+        retry_data[:last_primary_attempt] = Time.now
+      else
+        retry_data[:last_secondary_attempt] = Time.now
+      end
+    end
+
+    # Check the location
+    #
+    # retry_data - Hash. Stores stateful retry data
+    def check_location(response, retry_data)
+      # If a request sent to the secondary location fails with 404 (Not Found), it is possible
+      # that the resource replication is not finished yet. So, in case of 404 only in the secondary
+      # location, the failure should still be retryable.
+      retry_data[:secondary_not_found] = 
+        ((retry_data[:current_location] === Azure::Storage::Common::StorageLocation::SECONDARY) && 
+        response.status_code === 404);
+
+      if retry_data[:secondary_not_found]
+        retry_data[:status_code] = 500
+      else
+        if (response.status_code)
+          retry_data[:status_code] = response.status_code
+        else
+          retry_data[:status_code] = nil
+        end
+      end
+    end
+
+    # Check the status code
+    #
+    # retry_data - Hash. Stores stateful retry data
+    def check_status_code(retry_data)
+      if (retry_data[:status_code] < 400)
+        retry_data[:retryable] = false;
+      # Non-timeout Cases
+      elsif (retry_data[:status_code] != 408)
+        # Always no retry on "not implemented" and "version not supported"
+        if (retry_data[:status_code] == 501 || retry_data[:status_code] == 505)
+          retry_data[:retryable] = false;
+        end
+
+        # When absorb_conditional_errors_on_retry is set (for append blob)
+        if (@request_options[:absorb_conditional_errors_on_retry])
+          if (retry_data[:status_code] == 412)
+            # When appending block with precondition failure and their was a server error before, we ignore the error.
+            if (retry_data[:last_server_error])
+              retry_data[:error] = nil;
+              retry_data[:retryable] = true;
+            else
+              retry_data[:retryable] = false;
+            end
+          elsif (retry_data[:retryable] && retry_data[:status_code] >= 500 && retry_data[:status_code] < 600)
+            # Retry on the server error
+            retry_data[:retryable] = true;
+            retry_data[:last_server_error] = true;
+          end
+        elsif (retry_data[:status_code] < 500)
+          # No retry on the client error
+          retry_data[:retryable] = false;
+        end
+      end
+    end
+
+    # Get retry request destination
+    #
+    # retry_data - Hash. Stores stateful retry data
+    def get_next_location(retry_data)
+      # In case of 404 when trying the secondary location, instead of retrying on the
+      # secondary, further requests should be sent only to the primary location, as it most
+      # probably has a higher chance of succeeding there.
+      if retry_data[:secondary_not_found] && @request_options[:location_mode] != Azure::Storage::Common::LocationMode::SECONDARY_ONLY
+        @request_options[:location_mode] = Azure::Storage::Common::LocationMode::PRIMARY_ONLY;
+        return Azure::Storage::Common::StorageLocation::PRIMARY
+      end
+
+      case @request_options[:location_mode]
+      when Azure::Storage::Common::LocationMode::PRIMARY_ONLY
+        Azure::Storage::Common::StorageLocation::PRIMARY
+      when Azure::Storage::Common::LocationMode::SECONDARY_ONLY
+        Azure::Storage::Common::StorageLocation::SECONDARY
+      else
+        # request_location_mode cannot be SECONDARY_ONLY because it will be blocked at the first time
+        if @request_options[:request_location_mode] == Azure::Storage::Common::RequestLocationMode::PRIMARY_ONLY
+          Azure::Storage::Common::StorageLocation::PRIMARY
+        elsif @request_options[:request_location_mode] == Azure::Storage::Common::RequestLocationMode::SECONDARY_ONLY
+          Azure::Storage::Common::StorageLocation::SECONDARY
+        else
+          if retry_data[:current_location] === Azure::Storage::Common::StorageLocation::PRIMARY
+            Azure::Storage::Common::StorageLocation::SECONDARY
+          else
+            Azure::Storage::Common::StorageLocation::PRIMARY
+          end
+        end
+      end
+    end
+
+  end
+end

data/lib/azure/storage/common/core/http_client.rb

@@ -0,0 +1,82 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+
+module Azure::Storage::Common::Core
+  module HttpClient
+    # Returns the http agent based on uri
+    # @param uri  [URI|String] the base uri (scheme, host, port) of the http endpoint
+    # @return [Net::HTTP] http agent for a given uri
+    def agents(uri)
+      uri = URI(uri) unless uri.is_a? URI
+      key = uri.host
+
+      @agents ||= {}
+      unless @agents.key?(key)
+        @agents[key] = build_http(uri)
+      else
+        reuse_agent!(@agents[key])
+      end
+      @agents[key]
+    end
+
+    # Empties all the http agents
+    def reset_agents!
+      @agents = nil
+    end
+
+    private
+
+      # Empties all information that cannot be reused.
+      def reuse_agent!(agent)
+        agent.params.clear
+        agent.headers.clear
+      end
+
+      def build_http(uri)
+        ssl_options = {}
+        if uri.is_a?(URI) && uri.scheme.downcase == "https"
+          ssl_options[:version] = self.ssl_version if self.ssl_version
+          # min_version and max_version only supported in ruby 2.5
+          ssl_options[:min_version] = self.ssl_min_version if self.ssl_min_version
+          ssl_options[:max_version] = self.ssl_max_version if self.ssl_max_version
+          ssl_options[:ca_file] = self.ca_file if self.ca_file
+          ssl_options[:verify] = true
+        end
+        proxy_options = if ENV["HTTP_PROXY"]
+                          URI::parse(ENV["HTTP_PROXY"])
+                        elsif ENV["HTTPS_PROXY"]
+                          URI::parse(ENV["HTTPS_PROXY"])
+                        end || nil
+        Faraday.new(uri, ssl: ssl_options, proxy: proxy_options) do |conn|
+          conn.response :follow_redirects #use Faraday::FollowRedirects::Middleware
+          conn.adapter :net_http_persistent, pool_size: 5 do |http|
+            # yields Net::HTTP::Persistent
+            http.idle_timeout = 100
+          end
+        end
+      end
+  end
+end

data/lib/azure/storage/common/core/sr.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# The MIT License(MIT)
+
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files(the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and / or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions :
+
+# The above copyright notice and this permission notice shall be included in
+# all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+# THE SOFTWARE.
+#--------------------------------------------------------------------------
+
+
+module Azure::Storage::Common::Core
+  module SR
+    ANONYMOUS_ACCESS_BLOBSERVICE_ONLY = "Anonymous access is only valid for the BlobService."
+    ARGUMENT_NULL_OR_EMPTY = "The argument must not be null or an empty string. Argument name: %s."
+    ARGUMENT_NULL_OR_UNDEFINED = "The argument must not be null or undefined. Argument name: %s."
+    ARGUMENT_OUT_OF_RANGE_ERROR = "The argument is out of range. Argument name: %s, Value passed: %s."
+    BATCH_ONE_PARTITION_KEY = "All entities in the batch must have the same PartitionKey value."
+    BATCH_ONE_RETRIEVE = "If a retrieve operation is part of a batch, it must be the only operation in the batch."
+    BATCH_TOO_LARGE = "Batches must not contain more than 100 operations."
+    BLOB_INVALID_SEQUENCE_NUMBER = "The sequence number may not be specified for an increment operation."
+    BLOB_TYPE_MISMATCH = 'Blob type of the blob reference doesn\'t match blob type of the blob.'
+    CANNOT_CREATE_SAS_WITHOUT_ACCOUNT_KEY = "Cannot create Shared Access Signature unless the Account Name and Key are used to create the ServiceClient."
+    CONTENT_LENGTH_MISMATCH = "An incorrect number of bytes was read from the connection. The connection may have been closed."
+    CONTENT_TYPE_MISSING = "Content-Type response header is missing or invalid."
+    EMPTY_BATCH = "Batch must not be empty."
+    EXCEEDED_SIZE_LIMITATION = "Upload exceeds the size limitation. Max size is %s but the current size is %s"
+    HASH_MISMATCH = "Hash mismatch (integrity check failed), Expected value is %s, retrieved %s."
+    INCORRECT_ENTITY_KEYS = "PartitionKey and RowKey must be specified as strings in the entity object."
+    INVALID_BLOB_LENGTH = "createBlockBlobFromText requires the size of text to be less than 64MB. Please use createBlockBlobFromLocalFile or createBlockBlobFromStream to upload large blobs."
+    INVALID_CONNECTION_STRING = 'Connection strings must be of the form "key1=value1;key2=value2".'
+    INVALID_CONNECTION_STRING_BAD_KEY = 'Connection string contains unrecognized key: "%s"'
+    INVALID_CONNECTION_STRING_DUPLICATE_KEY = 'Connection string contains duplicate key: "%s"'
+    INVALID_CONNECTION_STRING_EMPTY_KEY = "Connection strings must not contain empty keys."
+    INVALID_CLIENT_OPTIONS = "Storage client options are invalid"
+    INVALID_DELETE_SNAPSHOT_OPTION = "The deleteSnapshots option cannot be included when deleting a specific snapshot using the snapshotId option."
+    INVALID_EDM_TYPE = 'The value \'%s\' does not match the type \'%s\'.'
+    INVALID_FILE_LENGTH = "createFileFromText requires the size of text to be less than 4MB. Please use createFileFromLocalFile or createFileFromStream to upload large files."
+    INVALID_FILE_RANGE_FOR_UPDATE = "Range size should be less than 4MB for a file range update operation."
+    INVALID_HEADERS = "Headers are not supported in the 2012-02-12 version."
+    INVALID_MESSAGE_ID = "Message ID cannot be null or undefined for deleteMessage and updateMessage operations."
+    INVALID_PAGE_BLOB_LENGTH = "Page blob length must be multiple of 512."
+    INVALID_PAGE_END_OFFSET = "Page end offset must be multiple of 512."
+    INVALID_PAGE_RANGE_FOR_UPDATE = "Page range size should be less than 4MB for a page update operation."
+    INVALID_PAGE_START_OFFSET = "Page start offset must be multiple of 512."
+    INVALID_POP_RECEIPT = "Pop Receipt cannot be null or undefined for deleteMessage and updateMessage operations."
+    INVALID_PROPERTY_RESOLVER = "The specified property resolver returned an invalid type. %s:{_:%s,$:%s }"
+    INVALID_RANGE_FOR_MD5 = "The requested range should be less than 4MB when contentMD5 is expected from the server"
+    INVALID_SAS_VERSION = "SAS Version ? is invalid. Valid versions include: ?."
+    INVALID_SAS_TOKEN = "The SAS token should not contain api-version."
+    INVALID_SIGNED_IDENTIFIERS = "Signed identifiers need to be an array."
+    INVALID_STREAM_LENGTH = "The length of the provided stream is invalid."
+    INVALID_STRING_ERROR = "Invalid string error."
+    INVALID_TABLE_OPERATION = "Operation not found: %s"
+    INVALID_TEXT_LENGTH = "The length of the provided text is invalid."
+    MAXIMUM_EXECUTION_TIMEOUT_EXCEPTION = "The client could not finish the operation within specified maximum execution timeout."
+    MD5_NOT_PRESENT_ERROR = "MD5 does not exist. If you do not want to force validation, please disable useTransactionalMD5."
+    METADATA_KEY_INVALID = "The key for one of the metadata key-value pairs is null, empty, or whitespace."
+    METADATA_VALUE_INVALID = "The value for one of the metadata key-value pairs is null, empty, or whitespace."
+    NO_CREDENTIALS_PROVIDED = "Credentials must be provided when creating a service client."
+    PRIMARY_ONLY_COMMAND = "This operation can only be executed against the primary storage location."
+    QUERY_OPERATOR_REQUIRES_WHERE = "%s operator needs to be used after where."
+    SECONDARY_ONLY_COMMAND = "This operation can only be executed against the secondary storage location."
+    STORAGE_HOST_LOCATION_REQUIRED = "The host for the storage service must be specified."
+    STORAGE_HOST_MISSING_LOCATION = 'The host for the target storage location is not specified. Please consider changing the request\'s location mode.'
+    TYPE_NOT_SUPPORTED = "Type not supported when sending data to the service: "
+    MAX_BLOB_SIZE_CONDITION_NOT_MEET = "The max blob size condition specified was not met."
+  end
+end