azure-armrest 0.0.1

data/lib/azure/armrest/availability_set_manager.rb

@@ -0,0 +1,50 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing availability sets.
+    class AvailabilitySetManager < ArmrestManager
+
+      # Create and return a new AvailabilitySetManager (ASM) instance. Most
+      # methods for an ASM instance will return one or more AvailabilitySet
+      # instances.
+      #
+      def initialize(options = {})
+        super
+
+        @base_url += "resourceGroups/#{@resource_group}/"
+        @base_url += "providers/Microsoft.Compute/availabilitySets"
+      end
+
+      # Creates a new availability set.
+      #
+      # TODO: The current documentation doesn't seem to list all the possible
+      # options at this time.
+      #--
+      def create(set_name, options = {})
+        url = @uri + "#{set_name}?api-version=#{api_version}"
+        url
+      end
+
+      alias update create
+
+      # Deletes the +set_name+ availability set.
+      def delete(set_name)
+        url = @uri + "#{set_name}?api-version=#{api_version}"
+        url
+      end
+
+      # Retrieves the options of an availability set.
+      def get(set_name)
+        url = @uri + "#{set_name}?api-version=#{api_version}"
+        url
+      end
+
+      # List availability sets.
+      def list
+        url = @uri + "?api-version=#{api_version}"
+        url
+      end
+    end
+  end
+end

data/lib/azure/armrest/event_manager.rb

@@ -0,0 +1,32 @@
+module Azure
+  module Armrest
+    class EventManager < ArmrestManager
+
+      def initialize(options = {})
+        super
+
+        @base_url += "providers/microsoft.insights/eventtypes/management/values"
+        @base_url += "?api-version=#{@api_version}"
+      end
+
+      # check what data type the event channel is
+
+      def get_rg_events(starttime, endtime, channels, rg_name )
+        @uri += build_filter += " and resourceGroupName eq '#{rg_name}'"
+      end
+
+      def get_resource_events(starttime, endtime, channels, resource_uri )
+        @uri += build_filter += " and resourceUri eq '#{resource_uri}'"
+      end
+
+      def build_filter(starttime, endtime, channels)
+        "$filter=eventTimestamp ge '#{starttime}' and eventTimestamp le '#{endtime}'
+         and eventChannels eq '#{channels}'"
+      end
+
+      def select_properties(property_names)
+        "&$select={property_names}"
+      end
+    end
+  end
+end

data/lib/azure/armrest/storage_account_manager.rb

@@ -0,0 +1,165 @@
+module Azure
+  module Armrest
+    # Class for managing storage accounts.
+    class StorageAccountManager < ArmrestManager
+
+      # Valid account types for the create or update method.
+      VALID_ACCOUNT_TYPES = %w[
+        Standard_LRS
+        Standard_ZRS
+        Standard_GRS
+        Standard_RAGRS
+      ]
+
+      # Creates and returns a new StorageAccountManager (SAM) instance. Most
+      # methods for a SAM instance will return a StorageAccount object.
+      def initialize(options = {})
+        super
+      end
+
+      # Return information for the given storage account name for the
+      # provided +group+. If no group is specified, it will use the
+      # group set in the constructor.
+      #
+      # Example:
+      #
+      #   sam.get('portalvhdstjn1ty0dlc2dg')
+      #   sam.get('portalvhdstjn1ty0dlc2dg', 'Default-Storage-CentralUS')
+      #
+      def get(account_name, group = @resource_group)
+        set_default_subscription
+
+        raise ArgumentError, "must specify resource group" unless group
+
+        @api_version = '2014-06-01'
+        url = build_url(@subscription_id, group, account_name)
+
+        JSON.parse(rest_get(url))
+      end
+
+      # Returns a list of available storage accounts for the given subscription
+      # for the provided +group+, or all resource groups if none is provided.
+      #
+      def list(group = @resource_group)
+        if group
+          @api_version = '2014-06-01'
+          url = build_url(@subscription_id, group)
+          JSON.parse(rest_get(url))['value'].first
+        else
+          array = []
+          threads = []
+
+          resource_groups.each do |group|
+            @api_version = '2014-06-01' # Must be set after resource_groups call
+            url = build_url(@subscription_id, group['name'])
+
+            threads << Thread.new do
+              result = JSON.parse(rest_get(url))['value'].first
+              array << result if result
+            end
+          end
+
+          threads.each(&:join)
+
+          array
+        end
+      end
+
+      # Creates a new storage account, or updates an existing account with the
+      # specified parameters. The possible parameters are:
+      #
+      # - :account_name
+      #   Required. The name of the storage account within the specified
+      #   resource stack. Must be 3-24 alphanumeric lowercase characters.
+      #
+      # - :validating
+      #   Optional. Set to 'nameAvailability' to indicate that the account
+      #   name must be checked for global availability.
+      #
+      # - :location
+      #   Required: One of the Azure geo regions, e.g. 'West US'.
+      #
+      # - :tags
+      #   A hash of tags to describe the resource. You may have a maximum of
+      #   10 tags, and each key has a max size of 128 characters, and each
+      #   value has a max size of 256 characters.
+      #
+      # -:properties
+      #   - :account_type
+      #   - :custom_domains
+      #     - :custom_domain
+      #       - :name
+      #       - :use_subdomain_name
+      #--
+      # PUT
+      #
+      def create(option = {})
+        #account_name = options.fetch(:account_name)
+        #location = options.fetch(:location)
+        validating = options[:validating]
+        #tags = options[:tags]
+
+        url = @uri + "/#{account_name}"
+
+        if validating
+          url += "?validating=nameAvailability"
+        end
+
+        url
+      end
+
+      alias update create
+
+      # Delete the given storage account name.
+      def delete(account_name)
+        url = @uri + "/#{account_name}?api-version=#{api_version}"
+        url
+      end
+
+
+
+      # Returns the primary and secondary access keys for the given
+      # storage account.
+      #--
+      # POST
+      #
+      def list_account_keys(account_name)
+        url = @uri + "/#{account_name}/listKeys?api-version=#{api_version}"
+        url
+      end
+
+      # Regenerates the primary and secondary access keys for the given
+      # storage account.
+      #--
+      # POST
+      def regenerate_storage_account_keys(account_name)
+        url = @uri + "/#{account_name}/regenerateKey?api-version=#{api_version}"
+        url
+      end
+
+      private
+
+      # If no default subscription is set, then use the first one found.
+      def set_default_subscription
+        @subscription_id ||= subscriptions.first['subscriptionId']
+      end
+
+      # Builds a URL based on subscription_id an resource_group and any other
+      # arguments provided, and appends it with the api-version.
+      def build_url(subscription_id, resource_group, *args)
+        url = File.join(
+          Azure::Armrest::COMMON_URI,
+          subscription_id,
+          'resourceGroups',
+          resource_group,
+          'providers',
+          'Microsoft.ClassicStorage',
+          'storageAccounts',
+        )
+
+        url = File.join(url, *args) unless args.empty?
+        url << "?api-version=#{@api_version}"
+      end
+    end
+  end
+end

data/lib/azure/armrest/subnet_manager.rb

@@ -0,0 +1,59 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing subnets
+    class SubnetManager < VirtualNetworkManager
+
+      # Create and return a new SubnetManager instance. Most methods for a
+      # SubnetManager instance will return one or Subnet instances.
+      #
+      def initialize(options = {})
+        super
+
+        @base_url += "/subnets"
+      end
+
+      # Creates a new subnet using the given +options+.
+      #
+      # The possible options are:
+      #
+      #   :name
+      #   :id
+      #   :location
+      #   :tags
+      #   :etag
+      #   :properties
+      #     :provisioning_state
+      #     :address_prefixes
+      #     :dhcp_options
+      #       :dns_servers
+      #     :ip_configurations
+      #--
+      def create(subnet_name, options = {})
+        @uri += "/#{subnet_name}?api-version=#{api_version}"
+      end
+
+      # Deletes the given subnet.
+      def delete(subnet_name)
+        @uri += "/#{subnet_name}?api-version=#{api_version}"
+      end
+
+      # Retrieves information for the given subnet.
+      def get(subnet_name)
+        @uri += "/#{subnet_name}?api-version=#{api_version}"
+      end
+
+      # List available subnets.
+      def list
+        @uri += "?api-version=#{api_version}"
+      end
+
+      # Patch an existing subnet. This is similar to a create/update
+      # but the available options are more limited.
+      def patch(subnet_name, options = {})
+        @uri += "?api-version=#{api_version}"
+      end
+    end
+  end
+end

data/lib/azure/armrest/version.rb

@@ -0,0 +1,5 @@
+module Azure
+  module Armrest
+    VERSION = "0.0.1"
+  end
+end

data/lib/azure/armrest/virtual_machine_extension_manager.rb

@@ -0,0 +1,59 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing virtual machine extensions
+    class VirtualMachineExtensionManager < VirtualMachineManager
+
+      # Creates a new virtual machine extension for +vmname+ with the given
+      # +extension_name+, and the given +options+. Possible options are:
+      #
+      #   :tags - Optional. A list of key value pairs. Max 10 pairs.
+      #   :publisher - Required. Name of extension publisher.
+      #   :type - Required. The type of extension.
+      #   :type_handler_version - Required. Specifies the extension version.
+      #   :settings - Optional. Public configuration that does not require encryption.
+      #   :protected_settings - Optional. Private configuration that is encrypted.
+      #
+      def create(vmname, extension_name, options = {})
+        #publisher = options.fetch(:publisher)
+        #type = options.fetch(:type)
+        #type_handler_version = options.fetch(:type_handler_version)
+
+        url = @uri + "/#{vmname}/extensions/#{extension_name}?#{api_version}"
+        url
+      end
+
+      alias update create
+
+      # Delete the given +extension_name+ for +vmname+.
+      #--
+      # DELETE
+      #
+      def delete(vmname, extension_name)
+        url = @uri + "/#{vmname}/extensions/#{extension_name}?#{api_version}"
+        url
+      end
+
+      # Retrieves the settings of an extension. If the +instance_view+ option
+      # is true, it will retrieve instance view information instead.
+      #--
+      # GET
+      #
+      def get(vmname, instance_view = false)
+        url = @uri + "/#{vmname}/extensions/#{extension_name}?"
+        url += "$expand=instanceView," if instance_view
+        url += "#{api_version}"
+        url
+      end
+
+      # Retrieves a list of extensions on the VM.
+      def list(vmname, instance_view = false)
+        url = @uri + "/#{vmname}/extensions"
+        url += "$expand=instanceView," if instance_view
+        url += "#{api_version}"
+        url
+      end
+    end
+  end
+end

data/lib/azure/armrest/virtual_machine_image_manager.rb

@@ -0,0 +1,135 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Base class for managing virtual machine images
+    class VirtualMachineImageManager < ArmrestManager
+      # The location used in requests when gathering VM image information.
+      attr_accessor :location
+
+      # The provider used in requests when gathering VM image information.
+      attr_reader :provider
+
+      # The publisher used in requests when gathering VM image information.
+      attr_accessor :publisher
+
+      # Create and return a new VirtualMachineImageManager (VMIM) instance.
+      #
+      # This subclass accepts the additional :location, :provider, and
+      # :publisher options as well. The default provider is set to
+      # 'Microsoft.Compute'.
+      #
+      def initialize(options = {})
+        super
+
+        @location  = options[:location]
+        @provider  = options[:provider] || 'Microsoft.Compute'
+        @publisher = options[:publisher]
+
+        # Typically only empty in testing.
+        unless @@providers.empty?
+          @api_version = @@providers[@provider]['locations/publishers']['api_version']
+        end
+      end
+
+      # Set a new provider to use the default for other methods. This may alter
+      # the api_version used for future requests. In practice, only
+      # 'Microsoft.Compute' or 'Microsoft.ClassicCompute' should be used.
+      #
+      def provider=(name)
+        @api_version = @@providers[name]['locations/publishers']['api_version']
+        @provider = name
+      end
+
+      # Return a list of VM image offers from the given +publisher+ and +location+.
+      #
+      # Example:
+      #
+      #   vmim.offers('eastus', 'Canonical')
+      #
+      def offers(location = @location, publisher = @publisher)
+        raise ArgumentError, "No location specified" unless location
+        raise ArgumentError, "No publisher specified" unless publisher
+
+        url = build_url(location, 'publishers', publisher, 'artifacttypes', 'vmimage', 'offers')
+
+        JSON.parse(rest_get(url)).map{ |element| element['name'] }
+      end
+
+      # Return a list of VM image publishers for the given +location+.
+      #
+      # Example:
+      #
+      #   vmim.publishers('eastus')
+      #
+      def publishers(location = @location)
+        raise ArgumentError, "No location specified" unless location
+
+        url = build_url(location, 'publishers')
+
+        JSON.parse(rest_get(url)).map{ |element| element['name'] }
+      end
+
+      # Return a list of VM image skus for the given +offer+, +location+,
+      # and +publisher+.
+      #
+      # Example:
+      #
+      #   vmim.skus('UbuntuServer', 'eastus', 'Canonical')
+      #
+      def skus(offer, location = @location, publisher = @publisher)
+        raise ArgumentError, "No location specified" unless location
+        raise ArgumentError, "No publisher specified" unless publisher
+
+        url = build_url(
+          location, 'publishers', publisher, 'artifacttypes',
+          'vmimage', 'offers', offer, 'skus'
+        )
+
+        JSON.parse(rest_get(url)).map{ |element| element['name'] }
+      end
+
+      # Return a list of VM image versions for the given +sku+, +offer+,
+      # +location+ and +publisher+.
+      #
+      # Example:
+      #
+      #   vmim.versions('14.04.2', 'UbuntuServer', 'eastus', 'Canonical')
+      #
+      #   # sample output
+      #   => ["14.04.201503090", "14.04.201505060", "14.04.201506100", "14.04.201507060"]
+      #
+      def versions(sku, offer, location = @location, publisher = @publisher)
+        raise ArgumentError, "No location specified" unless location
+        raise ArgumentError, "No publisher specified" unless publisher
+
+        url = build_url(
+          location, 'publishers', publisher, 'artifacttypes', 'vmimage',
+          'offers', offer, 'skus', sku, 'versions'
+        )
+
+        JSON.parse(rest_get(url)).map{ |element| element['name'] }
+      end
+
+      private
+
+      # Builds a URL based on subscription_id an resource_group and any other
+      # arguments provided, and appends it with the api_version.
+      #
+      def build_url(location, *args)
+        url = File.join(
+          Azure::Armrest::COMMON_URI,
+          subscription_id,
+          'providers',
+          provider,
+          'locations',
+          location
+        )
+
+        url = File.join(url, *args) unless args.empty?
+        url << "?api-version=#{api_version}"
+      end
+
+    end # VirtualMachineImageManager
+  end # Armrest
+end # Azure