azure-storage 0.10.0.preview

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

@@ -0,0 +1,264 @@
+#-------------------------------------------------------------------------
+# # 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
+    # Represents a Block as part of a BlockList 
+    # The type should be one of :uncommitted, :committed or :latest
+    class Block
+      
+      def initialize
+        @type = :latest
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :size
+      attr_accessor :type
+    end
+    
+    # Public: Creates a new block blob or updates the content of an existing block blob.
+    #
+    # Updating an existing block blob overwrites any existing metadata on the blob
+    # Partial updates are not supported with create_block_blob the content of the
+    # existing blob is overwritten with the content of the new blob. To perform a
+    # partial update of the content of a block blob, use the create_block_list
+    # method.
+    #
+    # Note that the default content type is application/octet-stream.
+    #
+    # ==== 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:
+    # * +:transactional_md5+         - String. An MD5 hash of the blob content. This hash is used to verify the integrity of the blob during transport. 
+    #                                  When this header is specified, the storage service checks the hash that has arrived with the one that was sent. 
+    #                                  If the two hashes do not match, the operation will fail with error code 400 (Bad Request).
+    # * +: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.
+    # * +: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).
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179451.aspx
+    #
+    # Returns a Blob
+    def create_block_blob(container, blob, content, options={})
+      query = { }
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = StorageService.service_properties_headers
+
+      # set x-ms-blob-type to BlockBlob
+      StorageService.with_header headers, 'x-ms-blob-type', 'BlockBlob'
+
+      # set the rest of the optional headers
+      StorageService.with_header headers, 'Content-MD5', options[:transactional_md5]
+      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
+
+      # call PutBlob with empty body
+      response = call(:put, uri, content, headers)
+
+      result = Serialization.blob_from_headers(response.headers)
+      result.name = blob
+
+      result
+    end
+    
+    # Public: Creates a new block to be committed as part of a block blob.
+    #
+    # ==== Attributes
+    #
+    # * +container+   - String. The container name.
+    # * +blob+        - String. The blob name.
+    # * +block_id+    - String. The block id. Note: this should be the raw block id, not Base64 encoded.
+    # * +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.
+    # * +:timeout+               - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd135726.aspx
+    #
+    # Returns response of the operation
+    def put_blob_block(container, blob, block_id, content, options={})
+      query = { 'comp' => 'block'}
+      StorageService.with_query query, 'blockid', Base64.strict_encode64(block_id)
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = StorageService.service_properties_headers
+      StorageService.with_header headers, 'Content-MD5', options[:content_md5]
+
+      response = call(:put, uri, content, headers)
+      response.headers['Content-MD5']
+    end
+
+    # Public: Commits existing blob blocks to a blob.
+    #
+    # This method writes a blob by specifying the list of block IDs that make up the
+    # blob. In order to be written as part of a blob, a block must have been
+    # successfully written to the server in a prior put_blob_block method.
+    #
+    # You can call Put Block List to update a blob by uploading only those blocks
+    # that have changed, then committing the new and existing blocks together.
+    # You can do this by specifying whether to commit a block from the committed
+    # block list or from the uncommitted block list, or to commit the most recently
+    # uploaded version of the block, whichever list it may belong to.
+    #
+    # ==== Attributes
+    #
+    # * +container+   - String. The container name.
+    # * +blob+        - String. The blob name.
+    # * +block_list+  - Array. A ordered list of lists in the following format:
+    #   [ ["block_id1", :committed], ["block_id2", :uncommitted], ["block_id3"], ["block_id4", :committed]... ]
+    #   The first element of the inner list is the block_id, the second is optional
+    #   and can be either :committed or :uncommitted to indicate in which group of blocks
+    #   the id should be looked for. If it is omitted, the latest of either group will be used.
+    # * +options+     - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:transactional_md5+         - String. Content MD5 for the request contents (not the blob contents!)
+    # * +: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.
+    #
+    # This operation also supports the use of conditional headers to commit the block list if a specified condition is met.
+    # For more information, see https://msdn.microsoft.com/en-us/library/azure/dd179371.aspx
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179467.aspx 
+    #
+    # Returns nil on success
+    def commit_blob_blocks(container, blob, block_list, options={})
+      query = { 'comp' => 'blocklist'}
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      headers = StorageService.service_properties_headers
+      unless options.empty?
+        StorageService.with_header headers, 'Content-MD5', options[:transactional_md5]
+        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)
+      end
+
+      body = Serialization.block_list_to_xml(block_list)
+      call(:put, uri, body, headers)
+      nil
+    end
+
+    # Public: Retrieves the list of blocks that have been uploaded as part of a block blob.
+    #
+    # There are two block lists maintained for a blob:
+    # 1) Committed Block List: The list of blocks that have been successfully
+    #    committed to a given blob with commitBlobBlocks.
+    # 2) Uncommitted Block List: The list of blocks that have been uploaded for a 
+    #    blob using Put Block (REST API), but that have not yet been committed. 
+    #    These blocks are stored in Microsoft Azure in association with a blob, but do
+    #    not yet form part of 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:
+    # * +:blocklist_type+ - Symbol. One of :all, :committed, :uncommitted. Defaults to :all (optional)
+    # * +:snapshot+       - String. An opaque DateTime value that specifies the blob snapshot to
+    #   retrieve information from. (optional)
+    # * +:timeout+        - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179400.aspx
+    #
+    # Returns a list of Azure::Storage::Entity::Blob::Block instances
+    def list_blob_blocks(container, blob, options={})
+
+      options[:blocklist_type] = options[:blocklist_type] || :all
+
+      query = { 'comp' => 'blocklist'}
+      StorageService.with_query query, 'snapshot', options[:snapshot]
+      StorageService.with_query query, 'blocklisttype', options[:blocklist_type].to_s if options[:blocklist_type]
+      StorageService.with_query query, 'timeout', options[:timeout].to_s if options[:timeout]
+
+      uri = blob_uri(container, blob, query)
+
+      response = call(:get, uri)
+
+      Serialization.block_list_from_xml(response.body)
+    end
+  end
+end

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

@@ -0,0 +1,552 @@
+#-------------------------------------------------------------------------
+# # 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/serialization'
+
+module Azure::Storage::Blob
+  module Container
+    include Azure::Storage::Service
+    
+    class Container
+      def initialize
+        @properties = {}
+        @metadata = {}
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :properties
+      attr_accessor :metadata
+      attr_accessor :public_access_level
+    end
+    
+    # Public: Create a new container
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container.
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:metadata+            - Hash. User defined metadata for the container (optional).
+    # * +:public_access_level+ - String. One of "container" or "blob" (optional).
+    # * +:timeout+             - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179468.aspx
+    #
+    # Returns a Container
+    def create_container(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Scheme + path
+      uri = container_uri(name, query)
+
+      # Headers
+      headers = StorageService.service_properties_headers
+      StorageService.add_metadata_to_headers(options[:metadata], headers) if options[:metadata]
+      headers['x-ms-blob-public-access'] = options[:public_access_level].to_s if options[:public_access_level]
+
+      # Call
+      response = call(:put, uri, nil, headers)
+
+      # result
+      container = Serialization.container_from_headers(response.headers)
+      container.name = name
+      container.metadata = options[:metadata]
+      container
+    end
+              
+    # Public: Returns all properties and metadata on the container.
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+      - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179370.aspx
+    #
+    # Returns a Container
+    def get_container_properties(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      response = call(:get, container_uri(name, query))
+
+      # result
+      container = Serialization.container_from_headers(response.headers)
+      container.name = name
+      container
+    end
+    
+    # Public: Returns only user-defined metadata for the specified container.
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+      - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691976.aspx
+    #
+    # Returns a Container
+    def get_container_metadata(name, options={})
+      # Query
+      query = { 'comp' => 'metadata' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      response = call(:get, container_uri(name, query))
+
+      # result
+      container = Serialization.container_from_headers(response.headers)
+      container.name = name
+      container
+    end
+    
+    # Public: Sets custom metadata for the container.
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container
+    # * +metadata+      - Hash. A Hash of the metadata values
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+      - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179362.aspx
+    #
+    # Returns nil on success
+    def set_container_metadata(name, metadata, options={})
+      # Query
+      query = { 'comp' => 'metadata' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Headers
+      headers = StorageService.service_properties_headers
+      StorageService.add_metadata_to_headers(metadata, headers) if metadata
+
+      # Call
+      call(:put, container_uri(name, query), nil, headers)
+      
+      # Result
+      nil
+    end
+    
+    # Public: Gets the access control list (ACL) and any container-level access policies
+    # for the container.
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+      - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179469.aspx
+    #
+    # Returns a tuple of (container, signed_identifiers)
+    #   container           - A Azure::Storage::Entity::Blob::Container instance
+    #   signed_identifiers  - A list of Azure::Storage::Entity::SignedIdentifier instances
+    #
+    def get_container_acl(name, options={})
+      # Query
+      query = { 'comp' => 'acl' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+      
+      # Call
+      response = call(:get, container_uri(name, query))
+
+      # Result
+      container = Serialization.container_from_headers(response.headers)
+      container.name = name
+
+      signed_identifiers = nil
+      signed_identifiers = Serialization.signed_identifiers_from_xml(response.body) if response.body != nil && response.body.length > 0
+
+      return container, signed_identifiers
+    end
+
+    # Public: Sets the ACL and any container-level access policies for the container.
+    #
+    # ==== Attributes
+    #
+    # * +name+                         - String. The name of the container
+    # * +public_access_level+          - String. The container public access level
+    # * +options+                      - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:signed_identifiers+          - Array. A list of Azure::Storage::Entity::SignedIdentifier instances (optional)
+    # * +:timeout+                     - Integer. A timeout in seconds.
+    # 
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179391.aspx
+    #
+    # Returns a tuple of (container, signed_identifiers)
+    # * +container+                    - A Azure::Storage::Entity::Blob::Container instance
+    # * +signed_identifiers+           - A list of Azure::Storage::Entity::SignedIdentifier instances
+    #
+    def set_container_acl(name, public_access_level, options={})
+      # Query
+      query = { 'comp' => 'acl' }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Scheme + path
+      uri = container_uri(name, query)
+
+      # Headers + body
+      headers = StorageService.service_properties_headers
+      headers['x-ms-blob-public-access'] = public_access_level if public_access_level && public_access_level.to_s.length > 0
+
+      signed_identifiers = nil
+      signed_identifiers = options[:signed_identifiers] if options[:signed_identifiers]
+
+      body = nil
+      body = Serialization.signed_identifiers_to_xml(signed_identifiers) if signed_identifiers
+
+      # Call
+      response = call(:put, uri, body, headers)
+
+      # Result
+      container = Serialization.container_from_headers(response.headers)
+      container.name = name
+      container.public_access_level = public_access_level
+
+      return container, signed_identifiers || []
+    end
+    
+    # Public: Deletes a container.
+    #
+    # ==== Attributes
+    #
+    # * +name+          - String. The name of the container.
+    # * +options+       - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+      - Integer. A timeout in seconds.
+    #
+    # See http://msdn.microsoft.com/en-us/library/azure/dd179408.aspx
+    #
+    # Returns nil on success
+    def delete_container(name, options={})
+      # Query
+      query = { }
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      # Call
+      call(:delete, container_uri(name, query))
+      
+      # result
+      nil
+    end
+    
+    # Public: Establishes an exclusive write lock on a container. The lock duration can be 15 to 60 seconds, or can be infinite.
+    # To write to a locked container, a client must provide a lease ID.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container 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.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to acquire the lease
+    #                                  only if the container has been modified since the specified date/time. If the container 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 container has not been modified since the specified date/time. If the container 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 container'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 container's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    #
+    # 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, or to renew, change, or release the lease.
+    #
+    def acquire_container_lease(container, options={})
+      acquire_lease container, nil, options
+    end
+
+    # Public: Renews the lease. The lease can be renewed if the lease ID specified on the request matches that
+    # associated with the container. Note that the lease may be renewed even if it has expired as long as the container
+    # 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.
+    # * +lease+                      - String. The lease id
+    # * +options+                    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:timeout+                   - Integer. A timeout in seconds.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to renew the lease
+    #                                  only if the container has been modified since the specified date/time. If the container 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 container has not been modified since the specified date/time. If the container 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 container'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 container's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns the renewed lease id
+    def renew_container_lease(container, lease, options={})
+      renew_lease container, nil, lease, options
+    end
+    
+    # Public: Change the lease ID.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container 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.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to change the lease
+    #                                  only if the container has been modified since the specified date/time. If the container 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 container has not been modified since the specified date/time. If the container 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 container'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 container's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns the changed lease id
+    def change_container_lease(container, lease, proposed_lease, options={})
+      change_lease container, nil, 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 container. Releasing the lease allows another client to immediately acquire the lease for
+    # the container as soon as the release is complete.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container 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.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to release the lease
+    #                                  only if the container has been modified since the specified date/time. If the container 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 container has not been modified since the specified date/time. If the container 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 container'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 container's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # See http://msdn.microsoft.com/en-us/library/azure/ee691972.aspx
+    #
+    # Returns nil on success
+    def release_container_lease(container, lease, options={})
+      release_lease container, nil, lease, options
+    end
+
+    # Public: Breaks the lease, if the container 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 container. 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 container.
+    #
+    # ==== Attributes
+    #
+    # * +container+                  - String. The container 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.
+    # * +:if_modified_since+         - String. A DateTime value. Specify this conditional header to break the lease
+    #                                  only if the container has been modified since the specified date/time. If the container 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 container has not been modified since the specified date/time. If the container 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 container'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 container's ETag value does not match the value specified. If the values are identical, 
+    #                                  the Blob service returns status code 412 (Precondition Failed).
+    # 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_container_lease(container, options={})
+      break_lease container, nil, options
+    end
+    
+    # Public: Get a list of Blobs from the server
+    #
+    # ==== Attributes
+    #
+    # * +name+              - String. The name of the container to list blobs for.
+    # * +options+           - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    # * +:prefix+           - String. Filters the results to return only blobs
+    #                         whose name begins with the specified prefix. (optional)
+    # * +:delimiter+        - String. When the request includes this parameter, the operation
+    #                         returns a BlobPrefix element in the response body that acts as a
+    #                         placeholder for all blobs whose names begin with the same substring
+    #                         up to the appearance of the delimiter character. The delimiter may
+    #                         be a single character or a string.
+    # * +:marker+           - String. An identifier that specifies the portion of the
+    #                         list to be returned. This value comes from the property
+    #                         Azure::Service::EnumerationResults.continuation_token when
+    #                         there are more blobs available than were returned. The
+    #                         marker value may then be used here to request the next set
+    #                         of list items. (optional)
+    # * +:max_results+      - Integer. Specifies the maximum number of blobs to return.
+    #                         If max_results is not specified, or is a value greater than
+    #                         5,000, the server will return up to 5,000 items. If it is set
+    #                         to a value less than or equal to zero, the server will return
+    #                         status code 400 (Bad Request). (optional)
+    # * +:metadata+         - Boolean. Specifies whether or not to return the blob metadata.
+    #                         (optional, Default=false)
+    # * +:snapshots+        - Boolean. Specifies that snapshots should be included in the
+    #                         enumeration. Snapshots are listed from oldest to newest in the
+    #                         response. (optional, Default=false)
+    # * +:uncomittedblobs+  - Boolean. Specifies that blobs for which blocks have been uploaded,
+    #                         but which have not been committed using put_block_list, be included
+    #                         in the response. (optional, Default=false)
+    # * +:copy+             - Boolean. Specifies that metadata related to any current or previous
+    #                         copy_blob operation should be included in the response.
+    #                         (optional, Default=false)
+    # * +:timeout+          - Integer. A timeout in seconds.
+    #
+    # NOTE: Metadata requested with the :metadata parameter must have been stored in
+    # accordance with the naming restrictions imposed by the 2009-09-19 version of the Blob
+    # service. Beginning with that version, all metadata names must adhere to the naming
+    # conventions for C# identifiers.
+    #
+    # See: http://msdn.microsoft.com/en-us/library/azure/dd135734.aspx
+    #
+    # Any metadata with invalid names which were previously stored, will be returned with the
+    # key "x-ms-invalid-name" in the metadata hash. This may contain multiple values and be an
+    # Array (vs a String if it only contains a single value).
+    #
+    # Returns an Azure::Service::EnumerationResults
+    def list_blobs(name, options={})
+      # Query
+      query = { 'comp' => 'list' }
+      query['prefix'] = options[:prefix].gsub(/\\/, '/') if options[:prefix]
+      query['delimiter'] = options[:delimiter] if options[:delimiter]
+      query['marker'] = options[:marker] if options[:marker]
+      query['maxresults'] = options[:max_results].to_s if options[:max_results]
+      query['timeout'] = options[:timeout].to_s if options[:timeout]
+
+      included_datasets = []
+      included_datasets.push('metadata') if options[:metadata] == true
+      included_datasets.push('snapshots') if options[:snapshots] == true
+      included_datasets.push('uncommittedblobs') if options[:uncommittedblobs] == true
+      included_datasets.push('copy') if options[:copy] == true
+
+      query['include'] = included_datasets.join ',' if included_datasets.length > 0
+
+      # Scheme + path
+      uri = container_uri(name, query)
+      
+      # Call
+      response = call(:get, uri)
+      
+      # Result
+      Serialization.blob_enumeration_results_from_xml(response.body)
+    end
+
+  end
+end