azure-plus 0.6.5

data/lib/azure/storage_management/storage_account.rb

@@ -0,0 +1,40 @@
+#-------------------------------------------------------------------------
+# Copyright 2013 Microsoft Open Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+module Azure
+  module StorageManagement
+    # Represents a Windows Azure storage account
+    class StorageAccount
+      def initialize
+        yield self if block_given?
+      end
+      attr_accessor :url
+      attr_accessor :name
+      attr_accessor :description
+      attr_accessor :location
+      attr_accessor :affinity_group
+      attr_accessor :label
+      attr_accessor :status
+      attr_accessor :endpoints
+      attr_accessor :geo_replication_enabled
+      attr_accessor :geo_primary_region
+      attr_accessor :status_of_primary
+      attr_accessor :last_geo_failover_time
+      attr_accessor :geo_secondary_region
+      attr_accessor :status_of_secondary
+      attr_accessor :creation_time
+      attr_accessor :extended_properties
+    end
+  end
+end

data/lib/azure/storage_management/storage_management_service.rb

@@ -0,0 +1,166 @@
+#-------------------------------------------------------------------------
+# Copyright 2013 Microsoft Open Technologies, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require 'azure/storage_management/serialization'
+
+module Azure
+  module StorageManagement
+    # Provides Storage Management API
+    class StorageManagementService < BaseManagementService
+      def initialize
+        super()
+      end
+      # Public: Gets a list of storage accounts available under the
+      # current subscription.
+      #
+      # Returns an array of Azure::StorageManagement::StorageAccount objects
+      def list_storage_accounts
+        request_path = '/services/storageservices'
+        request = ManagementHttpRequest.new(:get, request_path, nil)
+        response = request.call
+        Serialization.storage_services_from_xml(response)
+      end
+
+      # Public: Checks to see if the specified storage account is available
+      #
+      # ==== Attributes
+      #
+      # * +name+       - String. Storage account name.
+      #
+      # Returns: A boolean value indicating whether the storage account exists.
+      # If true, the storage account exists. If false, the storage account
+      # does not exist.
+      def get_storage_account(name)
+        return false if name.nil?
+        flag = false
+        storage_accounts = list_storage_accounts
+        storage_accounts.each do |storage|
+          if storage.name == name
+            flag = true
+            break
+          end
+        end
+        flag
+      end
+
+      # Public: Gets the properties of the storage account specified.
+      #
+      # ==== Attributes
+      #
+      # * +name+  - String. The name of the storage account. Required.
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/ee460802.aspx
+      #
+      # Returns the storage account
+      def get_storage_account_properties(name)
+        request_path = "/services/storageservices/#{name}"
+        request = ManagementHttpRequest.new(:get, request_path, nil)
+        response = request.call
+        Serialization.storage_services_from_xml(response).first
+      end
+
+      # Public: Create a new storage account in Windows Azure.
+      #
+      # ==== Attributes
+      #
+      # * +name+          - String. The name of the storage service.
+      # * +options+       - Hash. Optional parameters.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:label+  - String. The label for this storage account. The name will
+      # be used as label if none specified. (optional)
+      # * +:location+  - String. The location where the storage
+      # service will be created. Reqruied if no affinity_group_name specified.
+      # * +:description+         - String. A description for the storage
+      # service. (optional)
+      # * +:affinity_group_name+  - String. The name of an existing affinity group
+      # in the specified subscription. Required if no location specified.
+      # * +:geo_replication_enabled+ - String. A flag indicating wheter to
+      # turn Geo replication on or off. Values other than 'true'/'false'
+      # will result in an error from the REST API. (optional)
+      # * +:extended_properties+      - Hash. Key/Value pairs of extended
+      # properties to add to the storage account. The key is used as the
+      # property name and the value as its value. (optional)
+      #
+      # Returns None
+      def create_storage_account(name, options = {})
+        raise 'Name not specified' if !name || name.class != String || name.empty?
+        if get_storage_account(name)
+          Loggerx.warn "Storage Account #{name} already exists. Skipped..."
+        else
+          Loggerx.info "Creating Storage Account #{name}."
+          body = Serialization.storage_services_to_xml(name, options)
+          request_path = '/services/storageservices'
+          request = ManagementHttpRequest.new(:post, request_path, body)
+          request.call
+        end
+      end
+
+      # Public: Updates an existing storage account in Windows Azure
+      #
+      # ==== Attributes
+      #
+      # * +name+          - String. The name of the storage service.
+      # * +options+       - Hash. Optional parameters.
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +:label+ - String. A label for the storage service. Required if no
+      # description is provided. If both label and description are
+      # provided, only the label will get updated.
+      # * +:description+ - String. A description for the storage service.
+      # Required if no label is provided. If both label and description are
+      # provided, only the label will get updated.
+      # * +:geo_replication_enabled+ - Boolean (TrueClass/FalseClass). Boolean
+      # flag indicating wheter to turn Geo replication on or off. (optional)
+      # * +:extended_properties+      - Hash. Key/Value pairs of extended
+      # properties to add to the storage account. The key is used as the
+      # property name and the value as its value. (optional)
+      #
+      # Returns None
+      # Fails with RuntimeError if invalid options specified
+      def update_storage_account(name, options = {})
+        if get_storage_account name
+          Loggerx.info "Account '#{name}' exists, updating..."
+          body = Serialization.storage_update_to_xml options
+          request_path = "/services/storageservices/#{name}"
+          request = ManagementHttpRequest.new(:put, request_path, body)
+          request.call
+        else
+          Loggerx.warn "Storage Account '#{name}' does not exist. Skipped..."
+        end
+      end
+
+      # Public: Deletes the specified storage account of given subscription id
+      # from Windows Azure.
+      #
+      # ==== Attributes
+      #
+      # * +name+       - String. Storage account name.
+      #
+      # Returns:  None
+      def delete_storage_account(name)
+        Loggerx.info "Deleting Storage Account #{name}."
+        request_path = "/services/storageservices/#{name}"
+        request = ManagementHttpRequest.new(:delete, request_path)
+        request.call
+      rescue Exception => e
+        e.message
+      end
+    end
+  end
+end

data/lib/azure/table/auth/shared_key.rb

@@ -0,0 +1,92 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "cgi"
+
+require "azure/core/configuration"
+require "azure/core/auth/signer"
+
+module Azure
+  module Table
+    module Auth
+      class SharedKey < Azure::Core::Auth::Signer
+        # The account name
+        attr :account_name
+
+        # Public: Initialize the Signer.
+        #
+        # account_name - The account name. Defaults to the one in the
+        #                global configuration.
+        # access_key   - The access_key encoded in Base64. Defaults to the
+        #                one in the global configuration.
+        def initialize(account_name=Azure.config.storage_account_name, access_key=Azure.config.storage_access_key)
+          @account_name = account_name
+          super(access_key)
+        end
+
+        # Public: The name of the strategy.
+        #
+        # Returns a String.
+        def name
+          "SharedKey"
+        end
+
+        # Public: Generate a request signature.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a Base64 String signed with HMAC.
+        def sign(method, uri, headers)
+          signature = super(signable_string(method, uri, headers))
+          return "#{account_name}:#{signature}"
+        end
+
+        # Generate the string to sign.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a plain text string.
+        def signable_string(method, uri, headers)
+          [
+            method.to_s.upcase,
+            headers.fetch("Content-MD5", ""),
+            headers.fetch("Content-Type", ""),
+            headers.fetch("Date") { headers.fetch("x-ms-date") },
+            canonicalized_resource(uri)
+          ].join("\n")
+        end
+
+        # Calculate the Canonicalized Resource string for a request.
+        #
+        # uri - The request's URI.
+        #
+        # Returns a String with the canonicalized resource.
+        def canonicalized_resource(uri)
+          resource = "/%s%s" % [account_name, uri.path]
+
+          comp = CGI.parse(uri.query.to_s).fetch("comp", nil)
+          if (comp)
+            resource = [resource, "comp=" + comp[0]].join("?")
+          end
+
+          resource
+        end
+      end
+    end
+  end
+end

data/lib/azure/table/auth/shared_key_lite.rb

@@ -0,0 +1,44 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require "azure/table/auth/shared_key"
+
+module Azure
+  module Table
+    module Auth
+      class SharedKeyLite < SharedKey
+        # Public: The name of the strategy.
+        #
+        # Returns a String.
+        def name
+          "SharedKeyLite"
+        end
+
+        # Generate the string to sign.
+        #
+        # verb       - The HTTP request method.
+        # uri        - The URI of the request we're signing.
+        # headers    - A Hash of HTTP request headers.
+        #
+        # Returns a plain text string.
+        def signable_string(method, uri, headers)
+          [
+            headers.fetch("Date") { headers.fetch("x-ms-date") },
+            canonicalized_resource(uri)
+          ].join("\n")
+        end
+      end
+    end
+  end
+end

data/lib/azure/table/batch.rb

@@ -0,0 +1,330 @@
+#-------------------------------------------------------------------------
+# # Copyright (c) Microsoft and contributors. All rights reserved.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#--------------------------------------------------------------------------
+require 'uuid'
+
+require 'azure/table/serialization'
+require 'azure/table/table_service'
+require 'azure/table/batch_response'
+require 'azure/core/http/http_error'
+
+module Azure
+  module Table
+    # Represents a batch of table operations.
+    # 
+    # Example usage (block syntax):
+    #
+    # results = Batch.new "table", "partition" do
+    #      insert "row1", {"meta"=>"data"}
+    #      insert "row2", {"meta"=>"data"}
+    #    end.execute
+    #
+    # which is equivalent to (fluent syntax):
+    #
+    # results = Batch.new("table", "partition")
+    #           .insert("row1", {"meta"=>"data"})
+    #           .insert("row2", {"meta"=>"data"})
+    #           .execute
+    #
+    # which is equivalent to (as class): 
+    # 
+    # svc = TableSerice.new 
+    #
+    # batch = Batch.new "table", "partition"
+    # batch.insert "row1", {"meta"=>"data"}
+    # batch.insert "row2", {"meta"=>"data"}
+    #
+    # results = svc.execute_batch batch
+    #
+    class Batch
+      def initialize(table, partition, &block)
+        @table = table
+        @partition = partition
+        @operations = []
+        @entity_keys = []
+        @table_service = Azure::Table::TableService.new
+        uuid = UUID.new
+        @batch_id = "batch_" + uuid.generate
+        @changeset_id = "changeset_" + uuid.generate
+
+        self.instance_eval(&block) if block_given?
+      end
+
+      private
+      attr_reader :table
+      attr_reader :partition
+      attr_reader :table_service
+
+      attr_accessor :operations
+      attr_accessor :entity_keys
+      attr_accessor :changeset_id
+
+      public
+      attr_accessor :batch_id
+
+      protected
+      def execute
+        @table_service.execute_batch(self)
+      end
+
+      protected
+      class ResponseWrapper
+        def initialize(hash)
+          @hash = hash
+        end
+
+        def uri 
+          @hash[:uri]
+        end
+        
+        def status_code
+          @hash[:status_code].to_i
+        end
+
+        def body
+          @hash[:body]
+        end
+      end
+
+      protected
+      def add_operation(method, uri, body=nil, headers=nil)
+        op = {
+          :method => method, 
+          :uri => uri, 
+          :body => body, 
+          :headers => headers
+        }
+        operations.push op
+      end
+
+      protected
+      def check_entity_key(key)
+        raise ArgumentError, "Only allowed to perform a single operation per entity, and there is already a operation registered in this batch for the key: #{key}." if entity_keys.include? key
+        entity_keys.push key
+      end
+
+      public
+      def parse_response(response)
+        responses = BatchResponse.parse response.body
+        new_responses = []
+
+        (0..responses.length-1).each { |index|
+          operation = operations[index]
+          response = responses[index]
+
+          if response[:status_code].to_i > 299
+            # failed
+            error = Azure::Core::Http::HTTPError.new(ResponseWrapper.new(response.merge({:uri=>operation[:uri]})))
+            error.description = response[:message] if (error.description || '').strip == ''
+            raise error
+          else
+            # success
+            case operation[:method]
+            when :post
+              # entity from body
+              result = Azure::Table::Serialization.hash_from_entry_xml(response[:body])
+
+              entity = Azure::Table::Entity.new
+              entity.table = table
+              entity.updated = result[:updated]
+              entity.etag = response[:headers]["etag"] || result[:etag]
+              entity.properties = result[:properties]
+
+              new_responses.push entity
+            when :put, :merge
+             # etag from headers
+              new_responses.push response[:headers]["etag"]
+            when :delete
+              # true 
+              new_responses.push nil
+            end
+          end
+        }
+
+        new_responses
+      end
+
+      public
+      def to_body
+        body = ""
+        body.define_singleton_method(:add_line) do |a| self << (a||nil) + "\n" end
+
+        body.add_line "--#{batch_id}"
+        body.add_line "Content-Type: multipart/mixed; boundary=#{changeset_id}"
+        body.add_line ""
+
+        content_id = 1
+        operations.each { |op|
+          body.add_line "--#{changeset_id}"
+          body.add_line "Content-Type: application/http"
+          body.add_line "Content-Transfer-Encoding: binary"
+          body.add_line ""
+          body.add_line "#{op[:method].to_s.upcase} #{op[:uri]} HTTP/1.1"
+          body.add_line "Content-ID: #{content_id}"
+
+          if op[:headers]
+            op[:headers].each { |k,v|
+                body.add_line "#{k}: #{v}"
+              }
+          end
+          
+          if op[:body]
+            body.add_line "Content-Type: application/atom+xml;type=entry"
+            body.add_line "Content-Length: #{op[:body].bytesize.to_s}"
+            body.add_line ""
+            body.add_line op[:body]
+          else
+            body.add_line ""
+          end 
+
+          content_id += 1
+        }
+        body.add_line "--#{changeset_id}--"
+        body.add_line "--#{batch_id}--"
+      end
+
+      # Public: Inserts new entity to the table.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+       - String. The row key
+      # * +entity_values+ - Hash. A hash of the name/value pairs for the entity. 
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/dd179433
+      public
+      def insert(row_key, entity_values)
+        check_entity_key(row_key)
+
+        body = Azure::Table::Serialization.hash_to_entry_xml({ 
+            "PartitionKey" => partition, 
+            "RowKey" => row_key
+          }.merge(entity_values) ).to_xml
+
+        add_operation(:post, @table_service.entities_uri(table), body)
+        self
+      end
+
+      # Public: Updates an existing entity in a table. The Update Entity operation replaces 
+      # the entire entity and can be used to remove properties.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+       - String. The row key
+      # * +entity_values+ - Hash. A hash of the name/value pairs for the entity. 
+      # * +options+       - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * :if_match              - String. A matching condition which is required for update (optional, Default="*")
+      # * :create_if_not_exists  - Boolean. If true, and partition_key and row_key do not reference and existing entity, 
+      #   that entity will be inserted. If false, the operation will fail. (optional, Default=false)
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/dd179427
+      public
+      def update(row_key, entity_values, options={})
+        check_entity_key(row_key)
+
+        uri = @table_service.entities_uri(table, partition, row_key)
+
+        headers = {}
+        headers["If-Match"] = options[:if_match] || "*" unless options[:create_if_not_exists]
+
+        body = Azure::Table::Serialization.hash_to_entry_xml(entity_values).to_xml
+
+        add_operation(:put, uri, body, headers)
+        self
+      end
+      
+      # Public: Updates an existing entity by updating the entity's properties. This operation
+      # does not replace the existing entity, as the update_entity operation does.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+         - String. The row key
+      # * +entity_values+   - Hash. A hash of the name/value pairs for the entity. 
+      # * +options+         - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +if_match+              - String. A matching condition which is required for update (optional, Default="*")
+      # * +create_if_not_exists+  - Boolean. If true, and partition_key and row_key do not reference and existing entity, 
+      #   that entity will be inserted. If false, the operation will fail. (optional, Default=false)
+      # 
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/dd179392
+      public
+      def merge(row_key, entity_values, options={})
+        check_entity_key(row_key)
+
+        uri = @table_service.entities_uri(table, partition, row_key)
+
+        headers = {}
+        headers["If-Match"] = options[:if_match] || "*" unless options[:create_if_not_exists]
+
+        body = Azure::Table::Serialization.hash_to_entry_xml(entity_values).to_xml
+
+        add_operation(:merge, uri, body, headers)
+        self
+      end
+
+      # Public: Inserts or updates an existing entity within a table by merging new property values into the entity.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+               - String. The row key
+      # * +entity_values+         - Hash. A hash of the name/value pairs for the entity.
+      # 
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/hh452241
+      public
+      def insert_or_merge(row_key, entity_values)
+        merge(row_key, entity_values, { :create_if_not_exists => true })
+        self
+      end
+
+      # Public: Inserts or updates a new entity into a table.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+               - String. The row key
+      # * +entity_values+         - Hash. A hash of the name/value pairs for the entity. 
+      # 
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/hh452242
+      public
+      def insert_or_replace(row_key, entity_values)
+        update(row_key, entity_values, { :create_if_not_exists => true })
+        self
+      end
+
+      # Public: Deletes an existing entity in the table.
+      #
+      # ==== Attributes
+      #
+      # * +row_key+       - String. The row key
+      # * +options+       - Hash. Optional parameters. 
+      #
+      # ==== Options
+      #
+      # Accepted key/value pairs in options parameter are:
+      # * +if_match+      - String. A matching condition which is required for update (optional, Default="*")
+      #
+      # See http://msdn.microsoft.com/en-us/library/windowsazure/dd135727
+      public
+      def delete(row_key, options={})
+        add_operation(:delete, @table_service.entities_uri(table, partition, row_key), nil, {"If-Match"=> options[:if_match] || "*"})
+        self
+      end
+    end
+  end
+end