azure-storage-blob 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 3e3941be4da83f43257cf6fbac2a635079749dcf
-  data.tar.gz: 638399581dd8f938067caa056be80c9d23e81a58
+SHA256:
+  metadata.gz: 17ffe6e32cdb3b54c9af1f1d42cfca19c907279cb143b28e4c0348ea4d7a55b3
+  data.tar.gz: 7334b27de90a31bb7dd80d1ac8be7896c7df98f6138523d55943df9bf8b7cdb6
 SHA512:
-  metadata.gz: 6556378bcdf790fab6a944bd8c5fbf530e23b61f86ec41f8652b0f53a219ebfb4b5a97399035fdcebccbc00ad22f59b56346628a28cc3a5355d82b1fc18aa3ae
-  data.tar.gz: 33a830df775c9b64403e8e06f63f4d331bd14cbfefddb6e320c76efa0b2a3f4b9eb45f10d2886d088aca5898b065d38d25a2ac62fe97c8e12c8bff8d26b73d61
+  metadata.gz: 9b493606e1d9a99ed179257aab510a8ae64f77feb44a95c3d4c821c8f1f881b51351141a29f5bc147f1e042104d0d2b34d2aa699041b68526477b0f9c0dde886
+  data.tar.gz: 4ab005444bb1c6e2e5923731b97eb20ad8f98b72066bbd70248e9649b16277a3a7728379e8b2ccfc58f258e27ce401c6c8366ba333c21e3d44defe2edaeab637

data/lib/azure/storage/blob.rb

@@ -1,26 +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"
+# 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/lib/azure/storage/blob/append.rb

@@ -1,244 +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
+# 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