azure-storage-blob 1.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 164a94d802b853605c8079d8fc85c4b351fe62f2
+  data.tar.gz: 2c85d5c20c65fdfe1d6285145cef6e47e0786838
+SHA512:
+  metadata.gz: f92db73e004745a02ea1d9eee04a4fb1f6616bc502aab74ba785e803c5848314a93ab8cd8b33f3a23f905d3d7236890275bb9d3d34cc0f055cb6cbcad237717b
+  data.tar.gz: c26f14cb50c45eb3157100f309b568af460434d34297d87c7ae00c82ec97eeea23c247e6ca6ef6446f844692c03fad88ba6afff803174941ee914c6d4cbd2111

data/blob/lib/azure/storage/blob.rb

@@ -0,0 +1,26 @@
+# 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/storage/blob/autoload"

data/blob/lib/azure/storage/blob/append.rb

@@ -0,0 +1,244 @@
+# 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
+  module Blob
+    # Public: Creates a new append blob. Note that calling create_append_blob to create an append
+    # blob only initializes the blob. To add content to an append blob, call append_blob_blocks method.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:content_type+              - String. Content type for the blob. Will be saved with blob.
+    # * +:content_encoding+          - String. Content encoding for the blob. Will be saved with blob.
+    # * +:content_language+          - String. Content language for the blob. Will be saved with blob.
+    # * +:content_md5+               - String. Content MD5 for the blob. Will be saved with blob.
+    # * +:cache_control+             - String. Cache control for the blob. Will be saved with blob.
+    # * +:content_disposition+       - String. Conveys additional information about how to process the response payload,
+    #                                  and also can be used to attach additional metadata
+    # * +:metadata+                  - Hash. Custom metadata values to store with the blob.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to create a new blob
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to create a new blob
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an active lease,
+    #                                  specify the valid lease ID for this header.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179451.aspx
+    #
+    # Returns a Blob
+    def create_append_blob(container, blob, options = {})
+      query = {}
+      StorageService.with_query query, "timeout", options[:timeout] if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = {}
+
+      # set x-ms-blob-type to AppendBlob
+      StorageService.with_header headers, "x-ms-blob-type", "AppendBlob"
+
+      # ensure content-length is 0
+      StorageService.with_header headers, "Content-Length", 0
+
+      # set the rest of the optional headers
+      StorageService.with_header headers, "x-ms-blob-content-type", options[:content_type]
+      StorageService.with_header headers, "x-ms-blob-content-encoding", options[:content_encoding]
+      StorageService.with_header headers, "x-ms-blob-content-language", options[:content_language]
+      StorageService.with_header headers, "x-ms-blob-content-md5", options[:content_md5]
+      StorageService.with_header headers, "x-ms-blob-cache-control", options[:cache_control]
+      StorageService.with_header headers, "x-ms-blob-content-disposition", options[:content_disposition]
+
+      StorageService.add_metadata_to_headers options[:metadata], headers
+      add_blob_conditional_headers options, headers
+      headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      headers["x-ms-blob-content-type"] = Default::CONTENT_TYPE_VALUE unless headers["x-ms-blob-content-type"]
+
+      # call PutBlob with empty body
+      response = call(:put, uri, nil, headers, options)
+
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+      result.metadata = options[:metadata] if options[:metadata]
+
+      result
+    end
+
+    # Public: Commits a new block of data to the end of an existing append blob.
+    # This operation is permitted only on blobs created with the create_append_blob API.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +content+                    - IO or String. The content of the blob.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:content_md5+               - String. Content MD5 for the request contents.
+    # * +:max_size+                  - Integer. The max length in bytes permitted for the append blob
+    # * +:append_position+           - Integer. A number indicating the byte offset to compare. It will succeed only if the append position is equal to this number
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to append a block only if
+    #                                  the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to append a block only if
+    #                                  the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
+    #                                  the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to append a block only if
+    #                                  the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an
+    #                                  active lease, specify the valid lease ID for this header.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/mt427365.aspx
+    #
+    # Returns a Blob
+    def append_blob_block(container, blob, content, options = {})
+      query = { "comp" => "appendblock" }
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = {}
+      StorageService.with_header headers, "Content-MD5", options[:content_md5]
+      StorageService.with_header headers, "x-ms-lease-id", options[:lease_id]
+      StorageService.with_header headers, "x-ms-blob-condition-maxsize", options[:max_size]
+      StorageService.with_header headers, "x-ms-blob-condition-appendpos", options[:append_position]
+
+      add_blob_conditional_headers options, headers
+      headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+
+      response = call(:put, uri, content, headers, options)
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+
+      result
+    end
+
+    # Public: Creates a new append blob with given content
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +content+                    - IO or String. Content to write.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:content_type+              - String. Content type for the blob. Will be saved with blob.
+    # * +:content_encoding+          - String. Content encoding for the blob. Will be saved with blob.
+    # * +:content_language+          - String. Content language for the blob. Will be saved with blob.
+    # * +:content_md5+               - String. Content MD5 for the blob. Will be saved with blob.
+    # * +:cache_control+             - String. Cache control for the blob. Will be saved with blob.
+    # * +:content_disposition+       - String. Conveys additional information about how to process the response payload,
+    #                                  and also can be used to attach additional metadata
+    # * +:max_size+                  - Integer. The max length in bytes permitted for the append blob.
+    # * +:metadata+                  - Hash. Custom metadata values to store with the blob.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to create a new blob
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to create a new blob
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to create a new blob
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an active lease,
+    #                                  specify the valid lease ID for this header.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179451.aspx
+    #
+    # Returns a Blob
+    def create_append_blob_from_content(container, blob, content, options = {})
+      # Fail fast if content has larger size than max_size
+      max_size = options.delete :max_size
+      if max_size
+        if content.respond_to?(:size) && max_size < content.size
+          raise Azure::Storage::Common::Core::StorageError.new("Given content has exceeded the specified maximum size for the blob.")
+        end
+      end
+      options[:content_type] = get_or_apply_content_type(content, options[:content_type])
+      create_append_blob(container, blob, options)
+      content = StringIO.new(content) if content.is_a? String
+      # initialize the append block options.
+      append_block_options = {}
+      append_block_options[:if_modified_since] = options[:if_modified_since] if options[:if_modified_since]
+      append_block_options[:if_unmodified_since] = options[:if_unmodified_since] if options[:if_unmodified_since]
+      append_block_options[:if_match] = options[:if_match] if options[:if_match]
+      append_block_options[:if_none_match] = options[:if_none_match] if options[:if_none_match]
+      append_block_options[:lease_id] = options[:lease_id] if options[:lease_id]
+      append_block_options[:max_size] = max_size if max_size
+      position = 0
+      while !content.eof?
+        payload = content.read(BlobConstants::DEFAULT_WRITE_BLOCK_SIZE_IN_BYTES)
+        # set the append position to make sure that each append is going to the correct offset.
+        append_block_options[:append_position] = position
+        append_blob_block(container, blob, payload, append_block_options)
+        # calculate the position after the append.
+        position += payload.size
+      end
+
+      get_properties_options = {}
+      get_properties_options[:lease_id] = options[:lease_id] if options[:lease_id]
+
+      # Get the blob properties
+      get_blob_properties(container, blob, get_properties_options)
+    end
+  end
+end

data/blob/lib/azure/storage/blob/autoload.rb

@@ -0,0 +1,47 @@
+# 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 "rubygems"
+require "nokogiri"
+require "base64"
+
+require "azure/storage/common"
+
+module Azure
+  module Storage
+    module Blob
+      autoload :Default,       "azure/storage/blob/default"
+      autoload :Version,       "azure/storage/blob/version"
+      autoload :Blob,          "azure/storage/blob/blob"
+      autoload :Block,         "azure/storage/blob/block"
+      autoload :Page,          "azure/storage/blob/page"
+      autoload :Append,        "azure/storage/blob/append"
+      autoload :Container,     "azure/storage/blob/container"
+      autoload :Serialization, "azure/storage/blob/serialization"
+      autoload :BlobService,   "azure/storage/blob/blob_service"
+    end
+  end
+end

data/blob/lib/azure/storage/blob/blob.rb

@@ -0,0 +1,931 @@
+# 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
+  module Blob
+    include Azure::Storage::Common::Service
+
+    class Blob
+      def initialize
+        @properties = {}
+        @metadata = {}
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :snapshot
+      attr_accessor :properties
+      attr_accessor :metadata
+      attr_accessor :encrypted
+    end
+
+    # Public: Reads or downloads a blob from the system, including its metadata and properties.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:start_range+               - Integer. Position of first byte of first page. (optional)
+    # * +:end_range+                 - Integer. Position of last byte of of last page. (optional)
+    # * +:snapshot+                  - String. An opaque DateTime value that specifies the blob snapshot to
+    #                                  retrieve information from. (optional)
+    # * +:get_content_md5+           - Boolean. Return the MD5 hash for the range. This option only valid if
+    #                                  start_range and end_range are specified. (optional)
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:location_mode+             - LocationMode. Specifies the location mode used to decide
+    #                                  which location the request should be sent to.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to get the blob
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to get the blob
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to get the blob
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to get the blob
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. If this header is specified, the operation will be performed only if both of the
+    #                                  following conditions are met:
+    #                                   - The blob's lease is currently active.
+    #                                   - The lease ID specified in the request matches that of the blob.
+    #                                  If this header is specified and both of these conditions are not met, the request will fail
+    #                                  and the Get Blob operation will fail with status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179440.aspx
+    #
+    # Returns a blob and the blob body
+    def get_blob(container, blob, options = {})
+      query = {}
+      StorageService.with_query query, "snapshot", options[:snapshot]
+      StorageService.with_query query, "timeout", options[:timeout] if options[:timeout]
+
+      options[:request_location_mode] = Azure::Storage::Common::RequestLocationMode::PRIMARY_OR_SECONDARY
+      uri = blob_uri(container, blob, query, options)
+
+      headers = {}
+      options[:start_range] = 0 if options[:end_range] && (not options[:start_range])
+      if options[:start_range]
+        StorageService.with_header headers, "x-ms-range", "bytes=#{options[:start_range]}-#{options[:end_range]}"
+        StorageService.with_header headers, "x-ms-range-get-content-md5", "true" if options[:get_content_md5]
+      end
+      add_blob_conditional_headers options, headers
+      headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+
+      response = call(:get, uri, nil, headers, options)
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob unless result.name
+
+      return result, response.body
+    end
+
+    # Public: Returns all properties and metadata on the blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:snapshot+                  - String. An opaque DateTime value that specifies the blob snapshot to
+    #                                  retrieve information from.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:location_mode+             - LocationMode. Specifies the location mode used to decide
+    #                                  which location the request should be sent to.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to get the blob properties
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to get the blob properties
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to get the blob properties
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to get the blob properties
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. If this header is specified, the operation will be performed only if both of the
+    #                                  following conditions are met:
+    #
+    #                                   - The blob's lease is currently active.
+    #                                   - The lease ID specified in the request matches that of the blob.
+    #
+    #                                  If this header is specified and both of these conditions are not met, the request will fail
+    #                                  and the Get Blob Properties operation will fail with status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179394.aspx
+    #
+    # Returns the blob properties with a Blob instance
+    def get_blob_properties(container, blob, options = {})
+      query = {}
+      StorageService.with_query query, "snapshot", options[:snapshot]
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      headers = {}
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+      end
+      headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+
+      options[:request_location_mode] = Azure::Storage::Common::RequestLocationMode::PRIMARY_OR_SECONDARY
+      uri = blob_uri(container, blob, query, options)
+
+      response = call(:head, uri, nil, headers, options)
+
+      result = Serialization.blob_from_headers(response.headers)
+
+      result.name = blob
+      result.snapshot = options[:snapshot]
+
+      result
+    end
+
+    # Public: Sets system properties defined for a blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:content_type+              - String. Content type for the blob. Will be saved with blob.
+    # * +:content_encoding+          - String. Content encoding for the blob. Will be saved with blob.
+    # * +:content_language+          - String. Content language for the blob. Will be saved with blob.
+    # * +:content_md5+               - String. Content MD5 for the blob. Will be saved with blob.
+    # * +:cache_control+             - String. Cache control for the blob. Will be saved with blob.
+    # * +:content_disposition+       - String. Conveys additional information about how to process the response payload,
+    #                                  and also can be used to attach additional metadata
+    # * +:content_length+            - Integer. Resizes a page blob to the specified size. If the specified
+    #                                  value is less than the current size of the blob, then all pages above
+    #                                  the specified value are cleared. This property cannot be used to change
+    #                                  the size of a block blob. Setting this property for a block blob returns
+    #                                  status code 400 (Bad Request).
+    # * +:sequence_number_action+    - Symbol. This property indicates how the service should modify the sequence
+    #                                  number for the blob. Required if :sequence_number is used. This property
+    #                                  applies to page blobs only.
+    #
+    #                                  Specify one of the following options for this property:
+    #
+    #     * +:max+                       - Sets the sequence number to be the higher of the value included with
+    #                                      the request and the value currently stored for the blob.
+    #     * +:update+                    - Sets the sequence number to the value included with the request.
+    #     * +:increment+                 - Increments the value of the sequence number by 1. If specifying this
+    #                                      option, do not include the sequence_number option; doing so will return
+    #                                      status code 400 (Bad Request).
+    #
+    # * +:sequence_number+           - Integer. This property sets the blob's sequence number. The sequence number is a
+    #                                  user-controlled property that you can use to track requests and manage concurrency
+    #                                  issues. Required if the :sequence_number_action option is set to :max or :update.
+    #                                  This property applies to page blobs only.
+    #
+    #                                  Use this together with the :sequence_number_action to update the blob's sequence
+    #                                  number, either to the specified value or to the higher of the values specified with
+    #                                  the request or currently stored with the blob.
+    #
+    #                                  This header should not be specified if :sequence_number_action is set to :increment;
+    #                                  in this case the service automatically increments the sequence number by one.
+    #
+    #                                  To set the sequence number to a value of your choosing, this property must be specified
+    #                                  together with :sequence_number_action
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to set the blob properties
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to set the blob properties
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an active
+    #                                  lease, specify the valid lease ID for this header.
+    #
+    # Remarks:
+    #
+    # The semantics for updating a blob's properties are as follows:
+    #
+    # * A page blob's sequence number is updated only if the request meets either of the following conditions:
+    #
+    #     * The :sequence_number_action property is set to :max or :update, and a value for :sequence_number is also set.
+    #     * The :sequence_number_action property is set to :increment, indicating that the service should increment
+    #       the sequence number by one.
+    #
+    # * The size of the page blob is modified only if a value for :content_length is specified.
+    #
+    # * If :sequence_number and/or :content_length are the only properties specified, then the other properties of the blob
+    #   will NOT be modified.
+    #
+    # * If any one or more of the following properties are set, then all of these properties are set together. If a value is
+    #   not provided for a given property when at least one of the properties listed below is set, then that property will be
+    #   cleared for the blob.
+    #
+    #     * :cache_control
+    #     * :content_type
+    #     * :content_md5
+    #     * :content_encoding
+    #     * :content_language
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691966.aspx
+    #
+    # Returns nil on success.
+    def set_blob_properties(container, blob, options = {})
+      query = { "comp" => "properties" }
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+      uri = blob_uri(container, blob, query)
+
+      headers = {}
+
+      unless options.empty?
+        StorageService.with_header headers, "x-ms-blob-content-type", options[:content_type]
+        StorageService.with_header headers, "x-ms-blob-content-encoding", options[:content_encoding]
+        StorageService.with_header headers, "x-ms-blob-content-language", options[:content_language]
+        StorageService.with_header headers, "x-ms-blob-content-md5", options[:content_md5]
+        StorageService.with_header headers, "x-ms-blob-cache-control", options[:cache_control]
+        StorageService.with_header headers, "x-ms-blob-content-length", options[:content_length] if options[:content_length]
+        StorageService.with_header headers, "x-ms-blob-content-disposition", options[:content_disposition]
+
+        if options[:sequence_number_action]
+          StorageService.with_header headers, "x-ms-sequence-number-action", options[:sequence_number_action]
+
+          if options[:sequence_number_action].to_s != "increment" && options[:sequence_number]
+            StorageService.with_header headers, "x-ms-blob-sequence-number", options[:sequence_number] 
+          end
+        end
+
+        add_blob_conditional_headers options, headers
+        headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      end
+      call(:put, uri, nil, headers, options)
+      nil
+    end
+
+    # Public: Returns metadata on the blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:snapshot+                  - String. An opaque DateTime value that specifies the blob snapshot to
+    #                                  retrieve information from.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:location_mode+             - LocationMode. Specifies the location mode used to decide
+    #                                  which location the request should be sent to.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to get the blob metadata
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to get the blob metadata
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to get the blob metadata
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to get the blob metadata
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. If this header is specified, the operation will be performed only if both of the
+    #                                  following conditions are met:
+    #
+    #                                   - The blob's lease is currently active.
+    #                                   - The lease ID specified in the request matches that of the blob.
+    #
+    #                                  If this header is specified and both of these conditions are not met, the request will fail
+    #                                  and the Get Blob Metadata operation will fail with status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179350.aspx
+    #
+    # Returns a Blob
+    def get_blob_metadata(container, blob, options = {})
+      query = { "comp" => "metadata" }
+      StorageService.with_query query, "snapshot", options[:snapshot]
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      headers = {}
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+        headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      end
+
+      options[:request_location_mode] = Azure::Storage::Common::RequestLocationMode::PRIMARY_OR_SECONDARY
+      uri = blob_uri(container, blob, query, options)
+      response = call(:get, uri, nil, headers, options)
+      result = Serialization.blob_from_headers(response.headers)
+
+      result.name = blob
+      result.snapshot = options[:snapshot]
+
+      result
+    end
+
+    # Public: Sets metadata headers on the blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +metadata+                   - Hash. The custom metadata.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to set the blob metadata
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to set the blob metadata
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to set the blob metadata
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to set the blob metadata
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an active
+    #                                  lease, specify the valid lease ID for this header.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179414.aspx
+    #
+    # Returns nil on success.
+    def set_blob_metadata(container, blob, metadata, options = {})
+      query = { "comp" => "metadata" }
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = {}
+      StorageService.add_metadata_to_headers metadata, headers
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+        headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      end
+
+      call(:put, uri, nil, headers, options)
+      nil
+    end
+
+    # Public: Establishes an exclusive write lock on a blob. The lock duration can be 15 to 60 seconds, or can be infinite.
+    # To write to a locked blob, a client must provide a lease ID.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:duration+                  - Integer. Default -1. Specifies the duration of the lease, in seconds, or negative one (-1)
+    #                                  for a lease that never expires. A non-infinite lease can be between 15 and 60 seconds. (optional)
+    # * +:proposed_lease_id+         - String. Proposed lease ID, in a GUID string format. The Blob service returns 400 (Invalid request)
+    #                                  if the proposed lease ID is not in the correct format. (optional)
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to acquire the lease
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to acquire the lease
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to acquire the lease
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to acquire the lease
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:origin+                    - String. Optional. Specifies the origin from which the request is issued. The presence of this header results
+    #                                  in cross-origin resource sharing headers on the response.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns a String of the new unique lease id. While the lease is active, you must include the lease ID with any request
+    # to write to the blob, or to renew, change, or release the lease.
+    #
+    def acquire_blob_lease(container, blob, options = {})
+      acquire_lease container, blob, options
+    end
+
+    # Public: Renews the lease. The lease can be renewed if the lease ID specified on the request matches that
+    # associated with the blob. Note that the lease may be renewed even if it has expired as long as the blob
+    # has not been modified or leased again since the expiration of that lease. When you renew a lease, the
+    # lease duration clock resets.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +lease+                      - String. The lease id
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to renew the lease
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to renew the lease
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to renew the lease
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to renew the lease
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:origin+                    - String. Optional. Specifies the origin from which the request is issued. The presence of this header results
+    #                                  in cross-origin resource sharing headers on the response.
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns the renewed lease id
+    def renew_blob_lease(container, blob, lease, options = {})
+      renew_lease container, blob, lease, options
+    end
+
+    # Public: Change the lease ID.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +lease+                      - String. The existing lease id.
+    # * +proposed_lease+             - String. Proposed lease ID, in a GUID string format. The Blob service returns 400 (Invalid request)
+    #                                  if the proposed lease ID is not in the correct format. (optional).
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to change the lease
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to change the lease
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to change the lease
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to change the lease
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:origin+                    - String. Optional. Specifies the origin from which the request is issued. The presence of this header results
+    #                                  in cross-origin resource sharing headers on the response.
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns the changed lease id
+    def change_blob_lease(container, blob, lease, proposed_lease, options = {})
+      change_lease container, blob, lease, proposed_lease, options
+    end
+
+    # Public: Releases the lease. The lease may be released if the lease ID specified on the request matches that
+    # associated with the blob. Releasing the lease allows another client to immediately acquire the lease for
+    # the blob as soon as the release is complete.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +lease+                      - String. The lease id.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to release the lease
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to release the lease
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to release the lease
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to release the lease
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:origin+                    - String. Optional. Specifies the origin from which the request is issued. The presence of this header results
+    #                                  in cross-origin resource sharing headers on the response.
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns nil on success
+    def release_blob_lease(container, blob, lease, options = {})
+      release_lease container, blob, lease, options
+    end
+
+    # Public: Breaks the lease, if the blob has an active lease. Once a lease is broken, it cannot be renewed. Any
+    # authorized request can break the lease; the request is not required to specify a matching lease ID. When a
+    # lease is broken, the lease break period is allowed to elapse, during which time no lease operation except
+    # break and release can be performed on the blob. When a lease is successfully broken, the response indicates
+    # the interval in seconds until a new lease can be acquired.
+    #
+    # A lease that has been broken can also be released, in which case another client may immediately acquire the
+    # lease on the blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:break_period+              - Integer. The proposed duration of seconds that the lease should continue before it is
+    #                                  broken, between 0 and 60 seconds. This break period is only used if it is shorter than
+    #                                  the time remaining on the lease. If longer, the time remaining on the lease is used. A
+    #                                  new lease will not be available before the break period has expired, but the lease may
+    #                                  be held for longer than the break period.
+    #
+    #                                  If this option is not used, a fixed-duration lease breaks after the remaining lease
+    #                                  period elapses, and an infinite lease breaks immediately.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to break the lease
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to break the lease
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to break the lease
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to break the lease
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:origin+                    - String. Optional. Specifies the origin from which the request is issued. The presence of this header results
+    #                                  in cross-origin resource sharing headers on the response.
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns an Integer of the remaining lease time. This value is the approximate time remaining in the lease
+    # period, in seconds. This header is returned only for a successful request to break the lease. If the break
+    # is immediate, 0 is returned.
+    def break_blob_lease(container, blob, options = {})
+      break_lease container, blob, options
+    end
+
+    # Public: Creates a snapshot of a blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:metadata+                  - Hash. Custom metadata values to store with the blob snapshot.
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to create the blob snapshot
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to create the blob snapshot
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. If this header is specified, the operation will be performed only if both of the
+    #                                  following conditions are met:
+    #                                   - The blob's lease is currently active.
+    #                                   - The lease ID specified in the request matches that of the blob.
+    #                                  If this header is specified and both of these conditions are not met, the request will fail
+    #                                  and the Snapshot Blob operation will fail with status code 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691971.aspx
+    #
+    # Returns the snapshot DateTime value
+    def create_blob_snapshot(container, blob, options = {})
+      query = { "comp" => "snapshot" }
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = {}
+      unless options.empty?
+        StorageService.add_metadata_to_headers(options[:metadata], headers)
+        add_blob_conditional_headers(options, headers)
+        headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      end
+
+      response = call(:put, uri, nil, headers, options)
+
+      response.headers["x-ms-snapshot"]
+    end
+
+    # Public: Copies a source blob or file to a destination blob.
+    #
+    # ==== Attributes
+    #
+    # * +destination_container+      - String. The destination container name to copy to.
+    # * +destination_blob+           - String. The destination blob name to copy to.
+    # * +source_uri+                 - String. The source blob or file URI to copy from.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:source_snapshot+            - String. A snapshot id for the source blob
+    # * +:metadata+                   - Hash. Custom metadata values to store with the copy. If this parameter is not
+    #                                   specified, the operation will copy the source blob metadata to the destination
+    #                                   blob. If this parameter is specified, the destination blob is created with the
+    #                                   specified metadata, and metadata is not copied from the source blob.
+    # * +:source_if_modified_since+   - String. A DateTime value. Specify this option to write the page only if the source blob
+    #                                   has been modified since the specified date/time. If the blob has not been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:source_if_unmodified_since+ - String. A DateTime value. Specify this option to write the page only if the source blob
+    #                                   has not been modified since the specified date/time. If the blob has been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:source_if_match+            - String. An ETag value. Specify an ETag value to write the page only if the source blob's
+    #                                   ETag value matches the value specified. If the values do not match, the Blob
+    #                                   service returns status code 412 (Precondition Failed).
+    # * +:source_if_none_match+       - String. An ETag value. Specify an ETag value to write the page only if the source blob's
+    #                                   ETag value does not match the value specified. If the values are identical, the
+    #                                   Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_modified_since+     - String. A DateTime value. Specify this option to write the page only if the destination
+    #                                   blob has been modified since the specified date/time. If the blob has not been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_unmodified_since+   - String. A DateTime value. Specify this option to write the page only if the destination
+    #                                   blob has not been modified since the specified date/time. If the blob has been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_match+              - String. An ETag value. Specify an ETag value to write the page only if the destination
+    #                                   blob's ETag value matches the value specified. If the values do not match, the
+    #                                   Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_none_match+         - String. An ETag value. Specify an ETag value to write the page only if the destination
+    #                                   blob's ETag value does not match the value specified. If the values are
+    #                                   identical, the Blob service returns status code 412 (Precondition Failed).
+    # * +:timeout+                    - Integer. A timeout in seconds.
+    # * +:request_id+                 - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                   in the analytics logs when storage analytics logging is enabled.
+    # * +:lease_id+                   - String. Required if the destination blob has an active lease. The lease ID specified for
+    #                                   this header must match the lease ID of the destination blob. If the request does not include
+    #                                   the lease ID or it is not valid, the operation fails with status code 412 (Precondition Failed).
+    #                                   If this header is specified and the destination blob does not currently have an active lease,
+    #                                   the operation will also fail with status code 412 (Precondition Failed).
+    #                                   In version 2012-02-12 and newer, this value must specify an active, infinite lease for a
+    #                                   leased blob. A finite-duration lease ID fails with 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd894037.aspx
+    #
+    # Returns a tuple of (copy_id, copy_status).
+    #
+    # * +copy_id+                    - String identifier for this copy operation. Use with get_blob or get_blob_properties to check
+    #                                  the status of this copy operation, or pass to abort_copy_blob to abort a pending copy.
+    # * +copy_status+                - String. The state of the copy operation, with these values:
+    #                                    "success" - The copy completed successfully.
+    #                                    "pending" - The copy is in progress.
+    #
+    def copy_blob_from_uri(destination_container, destination_blob, source_uri, options = {})
+      query = {}
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(destination_container, destination_blob, query)
+      headers = {}
+      StorageService.with_header headers, "x-ms-copy-source", source_uri
+
+      unless options.empty?
+        add_blob_conditional_headers options, headers
+        StorageService.add_metadata_to_headers options[:metadata], headers
+        headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+      end
+
+      response = call(:put, uri, nil, headers, options)
+      return response.headers["x-ms-copy-id"], response.headers["x-ms-copy-status"]
+    end
+
+    # Public: Copies a source blob to a destination blob within the same storage account.
+    #
+    # ==== Attributes
+    #
+    # * +destination_container+      - String. The destination container name to copy to.
+    # * +destination_blob+           - String. The destination blob name to copy to.
+    # * +source_container+           - String. The source container name to copy from.
+    # * +source_blob+                - String. The source blob name to copy from.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:source_snapshot+            - String. A snapshot id for the source blob
+    # * +:metadata+                   - Hash. Custom metadata values to store with the copy. If this parameter is not
+    #                                   specified, the operation will copy the source blob metadata to the destination
+    #                                   blob. If this parameter is specified, the destination blob is created with the
+    #                                   specified metadata, and metadata is not copied from the source blob.
+    # * +:source_if_modified_since+   - String. A DateTime value. Specify this option to write the page only if the source blob
+    #                                   has been modified since the specified date/time. If the blob has not been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:source_if_unmodified_since+ - String. A DateTime value. Specify this option to write the page only if the source blob
+    #                                   has not been modified since the specified date/time. If the blob has been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:source_if_match+            - String. An ETag value. Specify an ETag value to write the page only if the source blob's
+    #                                   ETag value matches the value specified. If the values do not match, the Blob
+    #                                   service returns status code 412 (Precondition Failed).
+    # * +:source_if_none_match+       - String. An ETag value. Specify an ETag value to write the page only if the source blob's
+    #                                   ETag value does not match the value specified. If the values are identical, the
+    #                                   Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_modified_since+     - String. A DateTime value. Specify this option to write the page only if the destination
+    #                                   blob has been modified since the specified date/time. If the blob has not been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_unmodified_since+   - String. A DateTime value. Specify this option to write the page only if the destination
+    #                                   blob has not been modified since the specified date/time. If the blob has been
+    #                                   modified, the Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_match+              - String. An ETag value. Specify an ETag value to write the page only if the destination
+    #                                   blob's ETag value matches the value specified. If the values do not match, the
+    #                                   Blob service returns status code 412 (Precondition Failed).
+    # * +:dest_if_none_match+         - String. An ETag value. Specify an ETag value to write the page only if the destination
+    #                                   blob's ETag value does not match the value specified. If the values are
+    #                                   identical, the Blob service returns status code 412 (Precondition Failed).
+    # * +:timeout+                    - Integer. A timeout in seconds.
+    # * +:request_id+                 - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                   in the analytics logs when storage analytics logging is enabled.
+    # * +:lease_id+                   - String. Required if the destination blob has an active lease. The lease ID specified for
+    #                                   this header must match the lease ID of the destination blob. If the request does not include
+    #                                   the lease ID or it is not valid, the operation fails with status code 412 (Precondition Failed).
+    #                                   If this header is specified and the destination blob does not currently have an active lease,
+    #                                   the operation will also fail with status code 412 (Precondition Failed).
+    #                                   In version 2012-02-12 and newer, this value must specify an active, infinite lease for a
+    #                                   leased blob. A finite-duration lease ID fails with 412 (Precondition Failed).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd894037.aspx
+    #
+    # Returns a tuple of (copy_id, copy_status).
+    #
+    # * +copy_id+                    - String identifier for this copy operation. Use with get_blob or get_blob_properties to check
+    #                                  the status of this copy operation, or pass to abort_copy_blob to abort a pending copy.
+    # * +copy_status+                - String. The state of the copy operation, with these values:
+    #                                    "success" - The copy completed successfully.
+    #                                    "pending" - The copy is in progress.
+    #
+    def copy_blob(destination_container, destination_blob, source_container, source_blob, options = {})
+      source_blob_uri = blob_uri(source_container, source_blob, options[:source_snapshot] ? { "snapshot" => options[:source_snapshot] } : {}).to_s
+
+      return copy_blob_from_uri(destination_container, destination_blob, source_blob_uri, options)
+    end
+
+    # Public: Aborts a pending Copy Blob operation and leaves a destination blob with zero length and full metadata.
+    #
+    # ==== Attributes
+    #
+    # * +container+             - String. The destination container name.
+    # * +blob+                  - String. The destination blob name.
+    # * +copy_id+               - String. The copy identifier returned in the copy blob operation.
+    # * +options+               - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:lease_id+             - String. The lease id if the destination blob has an active infinite lease
+    # * +:timeout+              - Integer. A timeout in seconds.
+    # * +:request_id+           - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                             in the analytics logs when storage analytics logging is enabled.
+    #
+    # See https://msdn.microsoft.com/en-us/library/azure/jj159098.aspx
+    #
+    # Returns nil on success
+    def abort_copy_blob(container, blob, copy_id, options = {})
+      query = { "comp" => "copy" }
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+      StorageService.with_query query, "copyid", copy_id
+
+      uri = blob_uri(container, blob, query);
+      headers = {}
+      StorageService.with_header headers, "x-ms-copy-action", "abort";
+
+      unless options.empty?
+        StorageService.with_header headers, "x-ms-lease-id", options[:lease_id]
+      end
+
+      call(:put, uri, nil, headers, options)
+      nil
+    end
+
+    # Public: Deletes a blob or blob snapshot.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container name.
+    # * +blob+                       - String. The blob name.
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:snapshot+                  - String. An opaque DateTime value that specifies the blob snapshot to
+    #                                  retrieve information from. (optional)
+    # * +:delete_snapshots+          - Symbol. Used to specify the scope of the delete operation for snapshots.
+    #                                  This parameter is ignored if a blob does not have snapshots, or if a
+    #                                  snapshot is specified in the snapshot parameter. (optional)
+    #
+    #                                  Possible values include:
+    #                                    * +:only+     - Deletes only the snapshots for the blob, but leaves the blob
+    #                                    * +:include+  - Deletes the blob and all of the snapshots for the blob
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:request_id+                - String. Provides a client-generated, opaque value with a 1 KB character limit that is recorded
+    #                                  in the analytics logs when storage analytics logging is enabled.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to create the blob snapshot
+    #                                  only if the blob has been modified since the specified date/time. If the blob has not been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_unmodified_since+       - String. A DateTime value. Specify this conditional header to create the blob snapshot
+    #                                  only if the blob has not been modified since the specified date/time. If the blob has been modified,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_match+                  - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
+    #                                  only if the blob's ETag value matches the value specified. If the values do not match,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:if_none_match+             - String. An ETag value. Specify an ETag value for this conditional header to create the blob snapshot
+    #                                  only if the blob's ETag value does not match the value specified. If the values are identical,
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # * +:lease_id+                  - String. Required if the blob has an active lease. To perform this operation on a blob with an
+    #                                  active lease, specify the valid lease ID for this header. If a valid lease ID is not specified
+    #                                  on the request, the operation will fail with status code 403 (Forbidden).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179440.aspx
+    #
+    # Returns nil on success
+    def delete_blob(container, blob, options = {})
+      query = {}
+      StorageService.with_query query, "snapshot", options[:snapshot]
+      StorageService.with_query query, "timeout", options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      options[:delete_snapshots] = :include unless options[:delete_snapshots]
+
+      headers = {}
+      StorageService.with_header headers, "x-ms-delete-snapshots", options[:delete_snapshots].to_s if options[:delete_snapshots] && options[:snapshot] == nil
+      add_blob_conditional_headers options, headers
+      headers["x-ms-lease-id"] = options[:lease_id] if options[:lease_id]
+
+      call(:delete, uri, nil, headers, options)
+      nil
+    end
+  end
+end