azure-storage 0.10.0.preview

data/lib/azure/storage/core/utility.rb

@@ -0,0 +1,254 @@
+#-------------------------------------------------------------------------
+# # 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 'ipaddr'
+require 'azure/storage/core/error'
+
+if RUBY_VERSION.to_f < 2.0
+  begin
+    require 'Win32/Console/ANSI' if RUBY_PLATFORM =~ /win32|mingw32/
+  rescue LoadError
+    puts 'WARNING: Output will look weird on Windows unless'\
+         ' you install the "win32console" gem.'
+  end
+end
+
+module Azure
+  module Error
+    # Azure Error
+    class Error <  Azure::Core::Error
+      attr_reader :description
+      attr_reader :status_code
+      attr_reader :type
+
+      def initialize(type, status, description)
+        @type = type
+        @status_code = status
+        @description = description
+        super("#{type} (#{status_code}): #{description}")
+      end
+    end
+  end
+
+  module Core
+    module Utility
+      def random_string(str = 'azure', no_of_char = 5)
+        str + (0...no_of_char).map { ('a'..'z').to_a[rand(26)] }.join
+      end
+
+      def xml_content(xml, key, default = '')
+        content = default
+        node = xml.at_css(key)
+        content = node.text if node
+        content
+      end
+
+      def locate_file(name)
+        if File.exist? name
+          name
+        elsif File.exist?(File.join(ENV['HOME'], name))
+          File.join(ENV['HOME'], name)
+        else
+          Azure::Loggerx.error_with_exit "Unable to find #{name} file  "
+        end
+      end
+
+      def export_der(cert, key, pass = nil, name = nil)
+        pkcs12 = OpenSSL::PKCS12.create(pass, name, key, cert)
+        Base64.encode64(pkcs12.to_der)
+      rescue Exception => e
+        puts e.message
+        abort
+      end
+
+      def export_fingerprint(certificate)
+        Digest::SHA1.hexdigest(certificate.to_der)
+      end
+
+      def enable_winrm?(winrm_transport)
+        (!winrm_transport.nil? && (winrm_transport.select { |x| x.downcase == 'http' || x.downcase == 'https' }.size > 0))
+      end
+
+      def get_certificate(private_key_file)
+        rsa = OpenSSL::PKey.read File.read(private_key_file)
+        cert = OpenSSL::X509::Certificate.new
+        cert.version = 2
+        cert.serial = 0
+        name = OpenSSL::X509::Name.new([['CN', 'Azure Management Certificate']])
+        cert.subject = cert.issuer = name
+        cert.not_before = Time.now
+        cert.not_after = cert.not_before + (60*60*24*365)
+        cert.public_key = rsa.public_key
+        cert.sign(rsa, OpenSSL::Digest::SHA1.new)
+        cert
+      end
+
+      def initialize_external_logger(logger)
+        Loggerx.initialize_external_logger(logger)
+      end
+    end
+
+    # Logger
+    module Logger
+      class << self
+        attr_accessor :logger
+
+        def info(msg)
+          if logger.nil?
+            puts msg.bold.white
+          else
+            logger.info(msg)
+          end
+        end
+
+        def error_with_exit(msg)
+          if logger.nil?
+            puts msg.bold.red
+          else
+            logger.error(msg)
+          end
+
+          raise msg.bold.red
+        end
+
+        def warn(msg)
+          if logger.nil?
+            puts msg.yellow
+          else
+            logger.warn(msg)
+          end
+
+          msg
+        end
+
+        def error(msg)
+          if logger.nil?
+            puts msg.bold.red
+          else
+            logger.error(msg)
+          end
+
+          msg
+        end
+
+        def exception_message(msg)
+          if logger.nil?
+            puts msg.bold.red
+          else
+            logger.warn(msg)
+          end
+
+          raise msg.bold.red
+        end
+
+        def success(msg)
+          msg_with_new_line = msg + "\n"
+          if logger.nil?
+            print msg_with_new_line.green
+          else
+            logger.info(msg)
+          end
+        end
+
+        def initialize_external_logger(logger)
+          @logger = logger
+        end
+      end
+    end
+  end
+end
+
+class String
+  { reset:  0,
+    bold:  1,
+    dark:  2,
+    underline:  4,
+    blink:  5,
+    orange:  6,
+    negative:  7,
+    black: 30,
+    red: 31,
+    green: 32,
+    yellow: 33,
+    blue: 34,
+    magenta: 35,
+    cyan: 36,
+    white: 37,
+  }.each do |key, value|
+    define_method key do
+      "\e[#{value}m" + self + "\e[0m"
+    end
+  end
+end
+
+# Code validate private/public IP acceptable ranges.
+class IPAddr
+  PRIVATE_RANGES = [
+    IPAddr.new('10.0.0.0/8'),
+    IPAddr.new('172.16.0.0/12'),
+    IPAddr.new('192.168.0.0/16')
+  ]
+
+  def private?
+    return false unless self.ipv4?
+    PRIVATE_RANGES.each do |ipr|
+      return true if ipr.include?(self)
+    end
+    false
+  end
+
+  def public?
+    !private?
+  end
+
+  class << self
+    def validate_ip_and_prefix(ip, cidr)
+      if cidr.to_s.empty?
+        raise "Cidr is missing for IP '#{ip}'."
+      elsif valid?(ip)
+        raise "Ip address '#{ip}' is invalid."
+      elsif !IPAddr.new(ip).private?
+        raise "Ip Address #{ip} must be private."
+      end
+    end
+
+    def validate_address_space(ip)
+      if ip.split('/').size != 2
+        raise "Cidr is invalid for IP #{ip}."
+      elsif valid?(ip)
+        raise "Address space '#{ip}' is invalid."
+      end
+    end
+
+    def address_prefix(ip, cidr)
+      ip + '/' + cidr.to_s
+    end
+
+    def valid?(ip)
+      (IPAddr.new(ip) rescue nil).nil?
+    end
+  end
+end
+
+Azure::Loggerx = Azure::Core::Logger

data/lib/azure/storage/queue/message.rb

@@ -0,0 +1,39 @@
+#-------------------------------------------------------------------------
+# # 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 Queue
+    class Message
+      def initialize
+        yield self if block_given?
+      end
+      attr_accessor :id
+      attr_accessor :insertion_time
+      attr_accessor :expiration_time
+      attr_accessor :dequeue_count
+      attr_accessor :message_text
+      attr_accessor :time_next_visible
+      attr_accessor :pop_receipt
+    end
+  end
+end

data/lib/azure/storage/queue/queue.rb

@@ -0,0 +1,37 @@
+#-------------------------------------------------------------------------
+# # 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 Queue
+    class Queue
+
+      def initialize
+        @metadata = {}
+        yield self if block_given?
+      end
+
+      attr_accessor :name
+      attr_accessor :metadata
+    end
+  end
+end

data/lib/azure/storage/queue/queue_service.rb

@@ -0,0 +1,580 @@
+#-------------------------------------------------------------------------
+# # 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/service/storage_service'
+require 'azure/storage/queue/serialization'
+
+module Azure::Storage
+  module Queue
+    include Azure::Storage::Service
+    class QueueService < StorageService
+
+      def initialize(options = {})
+        super(nil, nil, options)
+        @host = @client.storage_queue_host
+      end
+
+      # Public: Get a list of Queues from the server
+      #
+      # ==== Attributes
+      #
+      # * +options+    - Hash. Optional parameters.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:prefix+      - String. Filters the results to return only containers 
+      #   whose name begins with the specified prefix. (optional)
+      # * +:marker+      - String. An identifier the specifies the portion of the 
+      #   list to be returned. This value comes from the property
+      #   Azure::Service::EnumerationResults.continuation_token when there 
+      #   are more containers 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 containers 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 container metadata.
+      #   (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 queue 
+      # 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/dd179466 
+      #
+      # 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_queues(options={})
+        query = { }
+        query["prefix"] = options[:prefix] if options[:prefix]
+        query["marker"] = options[:marker] if options[:marker]
+        query["maxresults"] = options[:max_results].to_s if options[:max_results]
+        query["include"] = "metadata" if options[:metadata] == true
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = collection_uri(query)
+        response = call(:get, uri)
+
+        Serialization.queue_enumeration_results_from_xml(response.body)
+      end
+
+      # Public: Clears all messages from the queue.
+      # 
+      # If a queue contains a large number of messages, Clear Messages may time out 
+      # before all messages have been deleted. In this case the Queue service will 
+      # return status code 500 (Internal Server Error), with the additional error 
+      # code OperationTimedOut. If the operation times out, the client should 
+      # continue to retry Clear Messages until it succeeds, to ensure that all 
+      # messages have been deleted.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+ - String. The name of the queue.
+      # * +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/dd179454
+      # 
+      # Returns nil on success
+      def clear_messages(queue_name, options={})
+        query = { }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+        uri = messages_uri(queue_name, query)
+        call(:delete, uri)
+        nil
+      end
+    
+      # Public: Creates a new queue under the storage account.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+     - String. The queue name.
+      # * +options+        - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:metadata+      - Hash. A hash of user defined metadata.
+      # * +:timeout+       - Integer. A timeout in seconds.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/dd179342
+      #
+      # Returns nil on success
+      def create_queue(queue_name, options={})
+        query = { }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = queue_uri(queue_name, query)
+
+        headers = { }
+        Service::StorageService.add_metadata_to_headers(options[:metadata] || {}, headers) if options[:metadata]
+
+        call(:put, uri, nil, headers)
+        nil
+      end
+
+      # Public: Deletes a queue.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+     - String. The queue name.
+      # * +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/dd179436
+      #
+      # Returns nil on success
+      def delete_queue(queue_name, options={})
+        query = { }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = queue_uri(queue_name, query)
+
+        call(:delete, uri)
+        nil
+      end
+
+      # Public: Returns queue properties, including user-defined metadata.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+     - String. The queue name.
+      # * +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/dd179384
+      #
+      # Returns a tuple of (approximate_message_count, metadata)
+      # * approximate_messages_count  - Integer. The approximate number of messages in the queue. This number is not
+      #   lower than the actual number of messages in the queue, but could be higher.
+      # * metadata                    - Hash. The queue metadata (Default: {})
+      #
+      def get_queue_metadata(queue_name, options={})
+        query = { "comp" => "metadata" }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = queue_uri(queue_name, query)
+
+        response = call(:get, uri)
+
+        approximate_messages_count = response.headers["x-ms-approximate-messages-count"]
+        metadata = Serialization.metadata_from_headers(response.headers)
+
+        return approximate_messages_count.to_i, metadata
+      end
+
+      # Public: Sets user-defined metadata on the queue. To delete queue metadata, call 
+      # this API with an empty hash in the metadata parameter.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+ - String. The queue name.
+      # * +metadata+   - Hash. A hash of user defined metadata
+      # * +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/dd179348
+      #
+      # Returns nil on success
+      def set_queue_metadata(queue_name, metadata, options={})
+        query = { "comp" => "metadata" }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = queue_uri(queue_name, query)
+
+        headers ={}
+        Service::StorageService.add_metadata_to_headers(metadata || {}, headers)
+
+        call(:put, uri, nil, headers)
+        nil
+      end
+
+      # Public: Gets the access control list (ACL) for the queue.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+ - String. The queue name.
+      # * +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/jj159101
+      #
+      # Returns a list of Azure::Storage::Entity::SignedIdentifier instances
+      def get_queue_acl(queue_name, options={})
+        query = { "comp" => "acl" }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        response = call(:get, queue_uri(queue_name, query))
+
+        signed_identifiers = []
+        signed_identifiers = Serialization.signed_identifiers_from_xml(response.body) unless response.body == nil or response.body.length < 1
+        signed_identifiers
+      end
+
+      # Public: Sets the access control list (ACL) for the queue.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+ - String. The queue name.
+      # * +options+    - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:signed_identifiers+  - Array. A list of Azure::Storage::Entity::SignedIdentifier instances 
+      # * +:timeout+             - Integer. A timeout in seconds.
+      # 
+      # See http://msdn.microsoft.com/en-us/library/azure/jj159099
+      #
+      # Returns nil on success
+      def set_queue_acl(queue_name, options={})
+        query = { "comp" => "acl" }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri =queue_uri(queue_name, query)
+        body = nil
+        body = Serialization.signed_identifiers_to_xml(options[:signed_identifiers]) if options[:signed_identifiers] && options[:signed_identifiers].length > 0
+
+        call(:put, uri, body, {})
+        nil
+      end
+
+      # Public: Adds a message to the queue and optionally sets a visibility timeout for the message.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+   - String. The queue name.
+      # * +message_text+ - String. The message contents. Note that the message content must be in a format that may be encoded with UTF-8.
+      # * +options+      - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:visibility_timeout+     - Integer. Specifies the new visibility timeout value, in seconds, relative to server 
+      #   time. The new value must be larger than or equal to 0, and cannot be larger than 7 
+      #   days. The visibility timeout of a message cannot be set to a value later than the 
+      #   expiry time. :visibility_timeout should be set to a value smaller than the 
+      #   time-to-live value. If not specified, the default value is 0.
+      # * +:message_ttl+            - Integer. Specifies the time-to-live interval for the message, in seconds. The maximum 
+      #   time-to-live allowed is 7 days. If not specified, the default time-to-live is 7 days.
+      # * +:encode+                 - Boolean. If set to true, the message will be base64 encoded.
+      # * +:timeout+                - Integer. A timeout in seconds.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/dd179346
+      #
+      # Returns nil on success
+      def create_message(queue_name, message_text, options={})
+        query = { }
+
+        unless options.empty?
+          query["visibilitytimeout"] = options[:visibility_timeout] if options[:visibility_timeout]
+          query["messagettl"] = options[:message_ttl] if options[:message_ttl]
+          query["timeout"] = options[:timeout].to_s if options[:timeout]
+        end
+
+        uri = messages_uri(queue_name, query)
+        body = Serialization.message_to_xml(message_text, options[:encode])
+
+        call(:post, uri, body, {})
+        nil
+      end
+
+      # Public: Deletes a specified message from the queue.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+   - String. The queue name.
+      # * +message_id+   - String. The id of the message.
+      # * +pop_receipt+  - String. The valid pop receipt value returned from an earlier call to the Get Messages or 
+      #   Update Message operation.
+      # * +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/dd179347
+      #
+      # Returns nil on success
+      #
+      # Remarks:
+      #
+      # When a message is successfully deleted, it is immediately marked for deletion and is no longer accessible to 
+      # clients. The message is later removed from the queue during garbage collection.
+      # 
+      # After a client retrieves a message with the Get Messages operation, the client is expected to process and 
+      # delete the message. To delete the message, you must have two items of data returned in the response body of 
+      # the Get Messages operation:
+      # 
+      # * The message ID, an opaque GUID value that identifies the message in the queue.
+      # 
+      # * A valid pop receipt, an opaque value that indicates that the message has been retrieved.
+      # 
+      # The message ID is returned from the previous Get Messages operation. The pop receipt is returned from the most 
+      # recent Get Messages or Update Message operation. In order for the Delete Message operation to succeed, the pop 
+      # receipt specified on the request must match the pop receipt returned from the Get Messages or Update Message 
+      # operation.
+      # 
+      # Pop receipts remain valid until one of the following events occurs:
+      #
+      # * The message has expired.
+      #
+      # * The message has been deleted using the last pop receipt received either from Get Messages or Update Message. 
+      # 
+      # * The invisibility time has elapsed and the message has been dequeued by a Get Messages request. When the 
+      # invisibility time elapses, the message becomes visible again. If it is retrieved by another Get Messages 
+      # request, the returned pop receipt can be used to delete or update the message.
+      # 
+      # * The message has been updated with a new visibility timeout. When the message is updated, a new pop receipt 
+      # will be returned.
+      # 
+      # If the message has already been deleted when Delete Message is called, the Queue service returns status code 
+      # 404 (Not Found).
+      # 
+      # If a message with a matching pop receipt is not found, the service returns status code 400 (Bad Request), with 
+      # additional error information indicating that the cause of the failure was a mismatched pop receipt.
+      #
+      def delete_message(queue_name, message_id, pop_receipt, options={})
+        query = { "popreceipt" => pop_receipt }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = message_uri(queue_name, message_id, query)
+
+        call(:delete, uri)
+        nil
+      end
+
+      # Public: Retrieves one or more messages from the front of the queue, without changing the message visibility.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+   - String. The queue name.
+      # * +options+      - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:number_of_messages+ - Integer. How many messages to return. (optional, Default: 1)
+      # * +:decode+             - Boolean. Boolean value indicating if the message should be base64 decoded.
+      # * +:timeout+            - Integer. A timeout in seconds.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/dd179472
+      #
+      # Returns a list of Azure::Storage::Entity::Queue::Message instances
+      def peek_messages(queue_name, options={})
+        number_of_messages=1
+        number_of_messages = options[:number_of_messages] if options[:number_of_messages]
+
+        query = { "peekonly" => "true", "numofmessages"=> number_of_messages.to_s }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = messages_uri(queue_name, query)
+        response = call(:get, uri)
+
+        messages = Serialization.queue_messages_from_xml(response.body, options[:decode])
+        messages
+      end
+
+      # Public: Retrieves one or more messages from the front of the queue.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+          - String. The queue name.
+      # * +visibility_timeout+  - Integer. The new visibility timeout value, in seconds, relative to server time.
+      # * +options+             - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:number_of_messages+ - Integer. How many messages to return. (optional, Default: 1)
+      # * +:timeout+            - Integer. A timeout in seconds.
+      # * +:decode+             - Boolean. Boolean value indicating if the message should be base64 decoded.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/dd179474
+      #
+      # Returns a list of Azure::Storage::Entity::Queue::Message instances
+      def list_messages(queue_name, visibility_timeout, options={})
+        number_of_messages=1
+        number_of_messages = options[:number_of_messages] if options[:number_of_messages]
+
+        query = { "visibilitytimeout" => visibility_timeout.to_s, "numofmessages"=> number_of_messages.to_s }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = messages_uri(queue_name, query)
+        response = call(:get, uri)
+
+        messages = Serialization.queue_messages_from_xml(response.body, options[:decode])
+        messages
+      end
+
+      # Public: Adds a message to the queue and optionally sets a visibility timeout for the message.
+      # 
+      # ==== Attributes
+      #
+      # * +queue_name+         - String. The queue name.
+      # * +message_id+         - String. The id of the message.
+      # * +pop_receipt+        - String. The valid pop receipt value returned from an earlier call to the Get Messages or 
+      #   update Message operation.
+      # * +message_text+       - String. The message contents. Note that the message content must be in a format that may 
+      #   be encoded with UTF-8.
+      # * +visibility_timeout+ - Integer. The new visibility timeout value, in seconds, relative to server time.
+      # * +options+            - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:encode+                 - Boolean. If set to true, the message will be base64 encoded.
+      # * +:timeout+           - Integer. A timeout in seconds.
+      #
+      # See http://msdn.microsoft.com/en-us/library/azure/hh452234
+      #
+      # Returns a tuple of (pop_receipt, time_next_visible)
+      # * pop_receipt        - String. The pop receipt of the queue message.
+      # * time_next_visible  - String. A UTC date/time value that represents when the message will be visible on the queue.
+      #
+      # Remarks:
+      #
+      # An Update Message operation will fail if the specified message does not exist in the queue, or if the 
+      # specified pop receipt does not match the message.
+      # 
+      # A pop receipt is returned by the Get Messages operation or the Update Message operation. Pop receipts 
+      # remain valid until one of the following events occurs:
+      # 
+      # * The message has expired.
+      # 
+      # * The message has been deleted using the last pop receipt received either from Get Messages or 
+      # Update Message. 
+      # 
+      # * The invisibility time has elapsed and the message has been dequeued by a Get Messages request. When 
+      # the invisibility time elapses, the message becomes visible again. If it is retrieved by another 
+      # Get Messages request, the returned pop receipt can be used to delete or update the message.
+      # 
+      # * The message has been updated with a new visibility timeout. When the message is updated, a new pop 
+      # receipt will be returned.
+      # 
+      # The Update Message operation can be used to continually extend the invisibility of a queue message. This 
+      # functionality can be useful if you want a worker role to "lease" a queue message. For example, if a worker 
+      # role calls Get Messages and recognizes that it needs more time to process a message, it can continually 
+      # extend the message's invisibility until it is processed. If the worker role were to fail during processing, 
+      # eventually the message would become visible again and another worker role could process it.
+      #
+      def update_message(queue_name, message_id, pop_receipt, message_text, visibility_timeout, options={})
+        query = { "visibilitytimeout" => visibility_timeout.to_s, "popreceipt" => pop_receipt }
+        query["timeout"] = options[:timeout].to_s if options[:timeout]
+
+        uri = message_uri(queue_name, message_id, query)
+        body = Serialization.message_to_xml(message_text, options[:encode])
+
+        response = call(:put, uri, body, {})
+        new_pop_receipt = response.headers["x-ms-popreceipt"]
+        time_next_visible = response.headers["x-ms-time-next-visible"]
+        return new_pop_receipt, time_next_visible
+      end
+
+      # Protected: Generate the URI for the collection of queues.
+      #
+      # ==== Attributes
+      #
+      # * +query+      - A Hash of query parameters (default: {}).
+      #
+      # Returns a URI.
+      protected
+      def collection_uri(query={})
+        query.update({:comp => 'list', :include => 'metadata'})
+        generate_uri("", query)
+      end
+
+      # Protected: Generate the URI for a given queue.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+ - The name of the queue.
+      # * +query+      - A Hash of query parameters (default: {}).
+      #
+      # Returns a URI.
+      protected
+      def queue_uri(queue_name, query={})
+        return queue_name if queue_name.kind_of? ::URI
+        generate_uri(queue_name, query)
+      end
+
+      # Protected: Generate the messages URI for the given queue.
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+ - The name of the queue.
+      # * +query+      - A Hash of query parameters (default: {}).
+      #
+      # Returns a URI.
+      protected
+      def messages_uri(queue_name, query={})
+        generate_uri("#{queue_name}/messages", query)
+      end
+
+      # Protected: Generate the URI for a given message
+      #
+      # ==== Attributes
+      #
+      # * +queue_name+ - The name of the queue.
+      # * +message_id+ - The id of the message.
+      # * +query+      - A Hash of query parameters (default: {}).
+      #
+      # Returns a URI.
+      protected
+      def message_uri(queue_name, message_id, query={})
+        generate_uri("#{queue_name}/messages/#{message_id}", query)
+      end
+    end
+  end
+end
+
+Azure::Storage::QueueService = Azure::Storage::Queue::QueueService