azure-storage 0.10.0.preview

data/lib/azure/storage/client.rb

@@ -0,0 +1,185 @@
+#-------------------------------------------------------------------------
+# # 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/core/http_client'
+
+require 'azure/storage/core'
+require 'azure/storage/core/client_options'
+
+require 'azure/storage/blob/blob_service'
+require 'azure/storage/table/table_service'
+require 'azure/storage/queue/queue_service'
+
+module Azure::Storage
+  class Client
+    include Azure::Storage::Configurable
+    include Azure::Storage::ClientOptions
+    include Azure::Core::HttpClient
+
+    # Public: Creates an instance of [Azure::Storage::Client]
+    #
+    # ==== Attributes
+    #
+    # * +options+    - Hash. Optional parameters.
+    #
+    # ==== Options
+    #
+    # Accepted key/value pairs in options parameter are:
+    #
+    # * +:use_development_storage+        - TrueClass. Whether to use storage emulator.
+    # * +:development_storage_proxy_uri+  - String. Used with +:use_development_storage+ if emulator is hosted other than localhost.
+    # * +:storage_account_name+           - String. The name of the storage account.
+    # * +:storage_access_key+             - Base64 String. The access key of the storage account.
+    # * +:storage_sas_token+              - String. The signed access signiture for the storage account or one of its service.
+    # * +:storage_blob_host+              - String. Specified Blob serivce endpoint or hostname
+    # * +:storage_table_host+             - String. Specified Table serivce endpoint or hostname
+    # * +:storage_queue_host+             - String. Specified Queue serivce endpoint or hostname
+    # * +:storage_dns_suffix+             - String. The suffix of a regional Storage Serivce, to
+    # * +:default_endpoints_protocol+     - String. http or https
+    # * +:use_path_style_uri+             - String. Whether use path style URI for specified endpoints
+    # * +:ca_file+                        - String. File path of the CA file if having issue with SSL
+    #
+    # The valid set of options inlcude:
+    # * Storage Emulator: +:use_development_storage+ required, +:development_storage_proxy_uri+ optionally
+    # * Storage account name and key: +:storage_account_name+ and +:storage_access_key+ required, set +:storage_dns_suffix+ necessarily
+    # * Storage account name and SAS token: +:storage_account_name+ and +:storage_sas_token+ required, set +:storage_dns_suffix+ necessarily
+    # * Specified hosts and SAS token: At least one of the service host and SAS token. It's up to user to ensure the SAS token is suitable for the serivce
+    # * Anonymous Blob: only +:storage_blob_host+, if it is to only access blobs within a container
+    #
+    # Additional notes:
+    # * Specified hosts can be set when use account name with access key or sas token
+    # * +:default_endpoints_protocol+ can be set if the scheme is not specified in hosts
+    # * Storage emulator always use path style URI
+    # * +:ca_file+ is independent.
+    #
+    # When empty options are given, it will try to read settings from Environment Variables. Refer to [Azure::Storage::ClientOptions.env_vars_mapping] for the mapping relationship
+    #
+    # @return [Azure::Storage::Client]
+    def initialize(options = {})
+      reset!(options)
+    end
+
+    # Azure Blob service client configured from this Azure Storage client instance
+    # @return [Azure::Storage::Blob::BlobService]
+    def blobClient(options = {})
+      @blobClient ||= Azure::Storage::Blob::BlobService.new(default_client(options))
+    end
+
+    # Azure Queue service client configured from this Azure Storage client instance
+    # @return [Azure::Storage::Queue::QueueService]
+    def queueClient(options = {})
+      @queueClient ||= Azure::Storage::Queue::QueueService.new(default_client(options))
+    end
+
+    # Azure Table service client configured from this Azure Storage client instance
+    # @return [Azure::Storage::Table::TableService]
+    def tableClient(options = {})
+      @tableClient ||= Azure::Storage::Table::TableService.new(default_client(options))
+    end
+
+    class << self
+
+      # Public: Creates an instance of [Azure::Storage::Client]
+      #
+      # ==== Attributes
+      #
+      # * +options+    - Hash. Optional parameters.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      #
+      # * +:use_development_storage+        - TrueClass. Whether to use storage emulator.
+      # * +:development_storage_proxy_uri+  - String. Used with +:use_development_storage+ if emulator is hosted other than localhost.
+      # * +:storage_account_name+           - String. The name of the storage account.
+      # * +:storage_access_key+             - Base64 String. The access key of the storage account.
+      # * +:storage_sas_token+              - String. The signed access signiture for the storage account or one of its service.
+      # * +:storage_blob_host+              - String. Specified Blob serivce endpoint or hostname
+      # * +:storage_table_host+             - String. Specified Table serivce endpoint or hostname
+      # * +:storage_queue_host+             - String. Specified Queue serivce endpoint or hostname
+      # * +:storage_dns_suffix+             - String. The suffix of a regional Storage Serivce, to
+      # * +:default_endpoints_protocol+     - String. http or https
+      # * +:use_path_style_uri+             - String. Whether use path style URI for specified endpoints
+      # * +:ca_file+                        - String. File path of the CA file if having issue with SSL
+      #
+      # The valid set of options inlcude:
+      # * Storage Emulator: +:use_development_storage+ required, +:development_storage_proxy_uri+ optionally
+      # * Storage account name and key: +:storage_account_name+ and +:storage_access_key+ required, set +:storage_dns_suffix+ necessarily
+      # * Storage account name and SAS token: +:storage_account_name+ and +:storage_sas_token+ required, set +:storage_dns_suffix+ necessarily
+      # * Specified hosts and SAS token: At least one of the service host and SAS token. It's up to user to ensure the SAS token is suitable for the serivce
+      # * Anonymous Blob: only +:storage_blob_host+, if it is to only access blobs within a container
+      #
+      # Additional notes:
+      # * Specified hosts can be set when use account name with access key or sas token
+      # * +:default_endpoints_protocol+ can be set if the scheme is not specified in hosts
+      # * Storage emulator always use path style URI
+      # * +:ca_file+ is independent.
+      #
+      # When empty options are given, it will try to read settings from Environment Variables. Refer to [Azure::Storage::ClientOptions.env_vars_mapping] for the mapping relationship
+      #
+      # @return [Azure::Storage::Client]
+      def create(options={})
+        Client.new(options)
+      end
+
+      # Public: Creates an instance of [Azure::Storage::Client] with Storage Emulator
+      #
+      # ==== Attributes
+      #
+      # * +proxy_uri+    - String. Used with +:use_development_storage+ if emulator is hosted other than localhost.
+      #
+      # @return [Azure::Storage::Client]
+      def create_development(proxy_uri=nil)
+        proxy_uri ||= StorageServiceClientConstants::DEV_STORE_URI
+        create(:use_development_storage => true, :development_storage_proxy_uri => proxy_uri)
+      end
+
+
+      # Public: Creates an instance of [Azure::Storage::Client] from Environment Variables
+      #
+      # @return [Azure::Storage::Client]
+      def create_from_env
+        create
+      end
+
+      # Public: Creates an instance of [Azure::Storage::Client] from Environment Variables
+      #
+      # ==== Attributes
+      #
+      # * +connection_string+    - String. Please refer to https://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/.
+      #
+      # @return [Azure::Storage::Client]
+      def create_from_connection_string(connection_string)
+        Client.new(connection_string)
+      end
+    end
+
+    private
+
+    def default_client(opts)
+      {client: self}.merge(opts || {})
+    end
+
+  end
+end

data/lib/azure/storage/configurable.rb

@@ -0,0 +1,137 @@
+#-------------------------------------------------------------------------
+# # 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
+  # The Azure::Storage::Configurable module provides basic configuration for Azure storage activities.
+  module Configurable
+
+    # @!attribute [w] storage_access_key
+    #   @return [String] Azure Storage access key.
+    # @!attribute storage_account_name
+    #   @return [String] Azure Storage account name.
+    # @!attribute storage_connection_string
+    #   @return [String] Azure Storage connection string.
+    # @!attribute storage_blob_host
+    #   @return [String] Set the host for the Blob service. Only set this if you want
+    #     something custom (like, for example, to point this to a LocalStorage
+    #     emulator). This should be the complete host, including http:// at the
+    #     start. When using the emulator, make sure to include your account name at
+    #     the end.
+    # @!attribute storage_table_host
+    #   @return [String] Set the host for the Table service. Only set this if you want
+    #     something custom (like, for example, to point this to a LocalStorage
+    #     emulator). This should be the complete host, including http:// at the
+    #     start. When using the emulator, make sure to include your account name at
+    #     the end.
+    # @!attribute storage_queue_host
+    #   @return [String] Set the host for the Queue service. Only set this if you want
+    #     something custom (like, for example, to point this to a LocalStorage
+    #     emulator). This should be the complete host, including http:// at the
+    #     start. When using the emulator, make sure to include your account name at
+    #     the end.
+
+    attr_accessor :storage_access_key,
+                  :storage_account_name,
+                  :storage_connection_string
+
+    attr_writer :storage_table_host,
+                :storage_blob_host,
+                :storage_queue_host
+
+    class << self
+      # List of configurable keys for {Azure::Client}
+      # @return [Array] of option keys
+      def keys
+        @keys ||= [
+          :storage_access_key,
+          :storage_account_name,
+          :storage_connection_string,
+          :storage_table_host,
+          :storage_blob_host,
+          :storage_queue_host
+        ]
+      end
+    end
+
+    # Set configuration options using a block
+    def configure
+      yield self
+    end
+
+    # Reset configuration options to default values
+    def reset_config!(options = {})
+      Azure::Storage::Configurable.keys.each do |key|
+        value = if self == Azure::Storage
+                  Azure::Storage::Default.options[key]
+                else
+                  Azure::Storage.send(key)
+                end
+        instance_variable_set(:"@#{key}", options.fetch(key, value))
+      end
+      self.send(:reset_agents!) if self.respond_to?(:reset_agents!)
+      self
+    end
+
+    alias setup reset_config!
+    
+    # Storage queue host
+    # @return [String]
+    def storage_queue_host
+      @storage_queue_host || default_host(:queue)
+    end
+
+    # Storage blob host
+    # @return [String]
+    def storage_blob_host
+      @storage_blob_host || default_host(:blob)
+    end
+
+    # Storage table host
+    # @return [String]
+    def storage_table_host
+      @storage_table_host || default_host(:table)
+    end
+    
+    # Storage file host
+    # @return [String]
+    def storage_file_host
+      @storage_file_host || default_host(:file)
+    end
+
+    def config
+      self
+    end
+
+    private
+
+    def default_host(service)
+      "https://#{storage_account_name}.#{service}.core.windows.net"
+    end
+
+    def options
+      Hash[Azure::Storage::Configurable.keys.map { |key| [key, instance_variable_get(:"@#{key}")] }]
+    end
+
+  end
+end

data/lib/azure/storage/core.rb

@@ -0,0 +1,33 @@
+#-------------------------------------------------------------------------
+# # 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
+  module Storage
+  end
+end
+
+require 'azure/storage/core/error'
+require 'azure/storage/core/constants'
+require 'azure/storage/core/sr'
+require 'azure/storage/core/utility'

data/lib/azure/storage/core/auth/shared_access_signature.rb

@@ -0,0 +1,27 @@
+#-------------------------------------------------------------------------
+# # 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/core/auth/shared_access_signature_generator'
+require 'azure/storage/core/auth/shared_access_signature_signer'

data/lib/azure/storage/core/auth/shared_access_signature_generator.rb

@@ -0,0 +1,194 @@
+#-------------------------------------------------------------------------
+# # 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/core'
+require 'azure/storage/core/client_options_error'
+require 'azure/storage/core/auth/signer'
+require 'time'
+require 'uri'
+
+# @see https://msdn.microsoft.com/library/azure/dn140255.aspx for more information on construction
+module Azure::Storage
+  module Auth
+    class SharedAccessSignature
+
+      DEFAULTS = {
+        permissions: 'r',
+        version: Azure::Storage::Default::STG_VERSION
+      }
+
+      KEY_MAPPINGS = {
+        version:              :sv,
+        permissions:          :sp,
+        start:                :st,
+        expiry:               :se,
+        identifier:           :si
+      }
+
+      BLOB_KEY_MAPPINGS = {
+        resource:             :sr,
+        cache_control:        :rscc,
+        content_disposition:  :rscd,
+        content_encoding:     :rsce,
+        content_language:     :rscl,
+        content_type:         :rsct
+      }
+
+      TABLE_KEY_MAPPINGS = {
+        tablename:            :tn,
+        startpk:              :spk,
+        endpk:                :epk,
+        startrk:              :srk,
+        endrk:                :erk
+      }
+
+      OPTIONAL_QUERY_PARAMS = [:sp, :si, :rscc, :rscd, :rsce, :rscl, :rsct, :spk, :srk, :epk, :erk]
+
+      attr :account_name
+
+      # Public: Initialize the SharedAccessSignature generator
+      #
+      # @param account_name [String] The account name. Defaults to the one in the global configuration.
+      # @param access_key [String]   The access_key encoded in Base64. Defaults to the one in the global configuration.
+      def initialize(account_name=Azure::Storage.storage_account_name, access_key=Azure::Storage.storage_access_key)
+        @account_name = account_name
+        @signer = Azure::Core::Auth::Signer.new(access_key)
+      end
+
+      # Shared Access Signature for the given path and options
+      # @param path     [String] Path of the URI
+      # @param options  [Hash]
+      #
+      # ==== Options
+      #
+      # * +:permissions+  - String. Combination of 'r','w','d','l' (container only) in this order. Default 'r'
+      # * +:start+        - String. UTC Date/Time in ISO8601 format. Optional.
+      # * +:expiry+       - String. UTC Date/Time in ISO8601 format. Optional. Default now + 30 minutes.
+      # * +:identifier+   - String. Identifier for stored access policy. Optional
+      #
+      # Below options for Blob only
+      # * +:resource+            - String. Resource type, either 'b' (blob) or 'c' (container). Default 'b'
+      # * +:cache_control+       - String. Response header override. Optional.
+      # * +:content_disposition+ - String. Response header override. Optional.
+      # * +:content_encoding+    - String. Response header override. Optional.
+      # * +:content_language+    - String. Response header override. Optional.
+      # * +:content_type+        - String. Response header override. Optional.
+      #
+      # Below options for table only
+      # * +:startpk+             - String. The start partition key of a specified partition key range. Optional but startpk must accompany startrk.
+      # * +:endpk+               - String. The end partition key of a specified partition key range. Optional but endpk must accompany endrk.
+      # * +:startrk+             - String. The start row key of a specified row key range. Optional.
+      # * +:endrk+               - String. The end row key of a specified row key range. Optional.
+      def generate(path, options={})
+        service_type = options[:service_type] || Azure::Storage::ServiceType::BLOB
+        options.delete(:service_type) if options.key?(:service_type)
+
+        options[:expiry] ||= (Time.now + 60*30).utc.iso8601
+
+        raise InvalidOptionsError,"SAS version cannot be set" if options[:version]
+
+        defs = DEFAULTS
+        valid_mappings = KEY_MAPPINGS
+        if service_type == Azure::Storage::ServiceType::BLOB
+          defs.merge!(resource: 'b')
+          valid_mappings.merge!(BLOB_KEY_MAPPINGS)
+        elsif service_type == Azure::Storage::ServiceType::TABLE
+          defs.merge!(tablename: path)
+          valid_mappings.merge!(TABLE_KEY_MAPPINGS)
+        end
+
+        invalid_options = options.reject { |k,v| valid_mappings.key?(k) }
+        raise InvalidOptionsError,"invalid options #{invalid_options} provided for SAS token generate" if invalid_options.length > 0
+
+        options.merge!(defs)
+
+        # Order is significant
+        # The newlines from empty strings here are required
+        signable_string =
+        [
+          options[:permissions],
+          options[:start],
+          options[:expiry],
+          "/#{service_type}/#{account_name}#{path.start_with?('/') ? '' : '/'}#{path}",
+          options[:identifier],
+          options[:version],
+          options[:cache_control],
+          options[:content_disposition],
+          options[:content_encoding],
+          options[:content_language],
+          options[:content_type]
+        ].join("\n")
+
+        query_hash = Hash[options.map { |k, v| [KEY_MAPPINGS[k], v] }]
+        .reject { |k, v| OPTIONAL_QUERY_PARAMS.include?(k) && v.to_s == '' }
+        .merge( sig: @signer.sign(signable_string) )
+
+        sas_params = URI.encode_www_form(query_hash)
+      end
+
+      # A customised URI reflecting options for the resource signed with Shared Access Signature
+      # @param uri      [URI] uri to resource including query options
+      # @param options  [Hash]
+      #
+      # ==== Options
+      #
+      # * +:permissions+  - String. Combination of 'r','w','d','l' (container only) in this order. Default 'r'
+      # * +:start+        - String. UTC Date/Time in ISO8601 format. Optional.
+      # * +:expiry+       - String. UTC Date/Time in ISO8601 format. Optional. Default now + 30 minutes.
+      # * +:identifier+   - String. Identifier for stored access policy. Optional
+      #
+      # Below options for Blob only
+      # * +:resource+            - String. Resource type, either 'b' (blob) or 'c' (container). Default 'b'
+      # * +:cache_control+       - String. Response header override. Optional.
+      # * +:content_disposition+ - String. Response header override. Optional.
+      # * +:content_encoding+    - String. Response header override. Optional.
+      # * +:content_language+    - String. Response header override. Optional.
+      # * +:content_type+        - String. Response header override. Optional.
+      #
+      # Below options for table only
+      # * +:tablename+           - String. Table name for SAS
+      # * +:startpk+             - String. The start partition key of a specified partition key range. Optional but startpk must accompany startrk.
+      # * +:endpk+               - String. The end partition key of a specified partition key range. Optional but endpk must accompany endrk.
+      # * +:startrk+             - String. The start row key of a specified row key range. Optional.
+      # * +:endrk+               - String. The end row key of a specified row key range. Optional.
+      def sign_uri(uri, options)
+        parsed_query = CGI::parse(uri.query || '').inject({}){|memo,(k,v)| memo[k.to_sym] = v; memo}
+
+        if parsed_query.has_key?(:restype)
+          options[:resource] = parsed_query[:restype].first == 'container' ? 'c' : 'b'
+        end
+
+        if options[:service_type] == nil
+          host_splits = uri.host.split('.')
+          options[:service_type] = host_splits[1] if host_splits.length > 1 && host_splits[0] == account_name
+        end
+
+        sas_params = generate(uri.path, options)
+
+        URI.parse(uri.to_s + (uri.query.nil? ? '?' : '&') + sas_params)
+      end
+
+    end
+  end
+end