azure-armrest 0.0.8 → 0.0.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 198f8903222b20b0bbea81928db29aab7436dbae
-  data.tar.gz: 25a4b584d105a275782a32635e69faa78e6d6250
+  metadata.gz: f8b26339221636eee239e6934d67cf0c4ee3bbb9
+  data.tar.gz: 1a6c35bd8f5a4af7ec2bd68d3734978add667981
 SHA512:
-  metadata.gz: d6c3ab976bc6b91665dafccfcfc5e317023c9feddeb61ec580764fe07858d095be9cb8bb8d715c8c4cf53ec589ae76b8cb6657f759152a014f11c729a0f0d11e
-  data.tar.gz: 9023b4532602c882d34282208cf4941b7cf5bd130e641d7da11b3c8fdca5235a075df763454bded12bc389df91ebd21aa0b4185dfa45ca3a2ff2bc2c9b17beb4
+  metadata.gz: 1a130d2af6d31ca1b55b40dbe528103b359022ac7a9b685d4954ea3144f1ec6bbc5be7247aaa9f2e23963819d308d322159f46d3390b74c81caf3ee8c3dec7fc
+  data.tar.gz: fe7a7347b7bd16877848d8125ff496504d2e96822487ba0a70f62fc157798373767b9852ba5b89d3a0314e797803493745c77697b2b373eea86716e6b4086e52

data/CHANGES

@@ -1,3 +1,8 @@
+= 0.0.9 - 17-Dec-2015
+* Added AlertService and EventService classes.
+* Added tables, table_info and table_data methods to the StorageAccount model.
+* Updates to the README.
+
 = 0.0.8 - 10-Nov-2015
 * Added the list_private_images method to the StorageAccountService class.
 * Added the list_all method to the ResourceGroupService class.

data/README.md

@@ -15,6 +15,7 @@ require 'azure/armrest'
 
 # Create a configuration object. All service objects will then use the
 # information you set here.
+#
 # A token will be retrieved based on the information you provided
 
 conf = Azure::Armrest::ArmrestService.configure(
@@ -28,23 +29,19 @@ conf = Azure::Armrest::ArmrestService.configure(
 # You can add other options specific to the service to be created
 vms = Azure::Armrest::VirtualMachineService.new(conf, options)
 
-# Create a virtual machine
-vmm.create_virtual_machine(
-  :name           => 'some_vm',
-  :location       => 'West US',
-  :vm_size        => 'Standard_A1',
-  :computer_name  => 'whatever',
-  :admin_username => 'admin_user',
-  :admin_password => 'adminxxxxxx',
-  :os_disk        => {:name => 'disk_name1', :os_type => 'Linux', :caching => 'read'},
-  :data_disks     => {:name => 'data_disk1', :lun => 0, :caching => 'read'}
-)
+# List all virtual machines for a given resource group:
+vms.list(some_group).each do |vm|
+  puts vm.name
+  puts vm.resource_group
+  puts vm.location
+  puts vm.properties.hardware_profile.vm_size
+end
 ```
 
 ## Subscriptions
 
-If you do not provide a subscription ID to the constructor, then the first
-subscription ID returned from a REST call will be used.
+If you do not provide a subscription ID in your configuration object, then the
+first subscription ID returned from a REST call will be used.
 
 ## Notes
 

data/lib/azure/armrest.rb

@@ -33,9 +33,12 @@ require 'azure/armrest/template_deployment_service'
 require 'azure/armrest/resource_service'
 require 'azure/armrest/resource_group_service'
 require 'azure/armrest/resource_provider_service'
+require 'azure/armrest/insights/alert_service'
+require 'azure/armrest/insights/event_service'
 require 'azure/armrest/network/ip_address_service'
 require 'azure/armrest/network/network_interface_service'
 require 'azure/armrest/network/network_security_group_service'
+require 'azure/armrest/network/network_security_rule_service'
 require 'azure/armrest/network/virtual_network_service'
 require 'azure/armrest/network/subnet_service'
 

data/lib/azure/armrest/insights/alert_service.rb

@@ -0,0 +1,23 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Insights namesspace
+    module Insights
+      # Base class for managing alert rules.
+      class AlertService < ResourceGroupBasedService
+        # The provider used in requests when gathering Alert information.
+        attr_reader :provider
+
+        # Create and return a new AlertService instance.
+        #
+        def initialize(_armrest_configuration, options = {})
+          super
+          @provider = options[:provider] || 'Microsoft.Insights'
+          set_service_api_version(options, 'alertrules')
+          @service_name = 'alertRules'
+        end
+      end # AlertService
+    end # Insights
+  end # Armrest
+end # Azure

data/lib/azure/armrest/insights/event_service.rb

@@ -0,0 +1,76 @@
+# Azure namespace
+module Azure
+  # Armrest namespace
+  module Armrest
+    # Insights namespace
+    module Insights
+
+      # Base class for managing events.
+      class EventService < ArmrestService
+        # The provider used in requests when gathering Event information.
+        attr_reader :provider
+
+        # Create and return a new EventService instance.
+        #
+        def initialize(_armrest_configuration, options = {})
+          super
+          @provider = options[:provider] || 'Microsoft.Insights'
+          set_service_api_version(options, 'eventtypes')
+          @service_name = 'eventTypes'
+        end
+
+        # Returns a list of management events for the current subscription.
+        # The +filter+ option can be used to filter the result set. Additionally,
+        # you may restrict the results to only return certain fields using
+        # the +select+ option. The possible fields for both filtering and selection
+        # are:
+        #
+        # authorization, channels, claims, correlationId, description, eventDataId,
+        # eventName, eventSource, eventTimestamp, httpRequest, level, operationId,
+        # operationName, properties, resourceGroupName, resourceProviderName,
+        # resourceUri, status, submissionTimestamp, subStatus and subscriptionId.
+        #
+        # Example:
+        #
+        #   ies = Azure::Armrest::Insights::EventService.new(conf)
+        #
+        #   date   = (Time.now - 86400).httpdate
+        #   filter = "eventTimestamp ge #{date} and eventChannels eq 'Admin, Operation'"
+        #   select = "resourceGroupName, operationName"
+        #
+        #   ies.list(filter, select).each{ |event|
+        #     p event
+        #   }
+        #
+        def list(filter = nil, select = nil)
+          url = build_url(filter, select)
+          response = rest_get(url)
+          JSON.parse(response.body)['value'].map{ |e| Azure::Armrest::Insights::Event.new(e) }
+        end
+
+        private
+
+        def build_url(filter = nil, select = nil)
+          sub_id = armrest_configuration.subscription_id
+
+          url = File.join(
+            Azure::Armrest::COMMON_URI,
+            sub_id,
+            'providers',
+            @provider,
+            'eventtypes',
+            'management',
+            'values'
+          ) 
+
+          url << "?api-version=#{@api_version}"
+          url << "&$filter=#{filter}" if filter
+          url << "&$select=#{select}" if select
+
+          url
+        end
+      end # EventService
+
+    end # Insights
+  end # Armrest
+end # Azure

data/lib/azure/armrest/model/base_model.rb

@@ -182,10 +182,16 @@ module Azure
     class VirtualMachineImage < BaseModel; end
     class VirtualMachineSize < BaseModel; end
 
+    module Insights
+      class Alert < BaseModel; end
+      class Event < BaseModel; end
+    end
+
     module Network
       class IpAddress < BaseModel; end
       class NetworkInterface < BaseModel; end
       class NetworkSecurityGroup < BaseModel; end
+      class NetworkSecurityRule < NetworkSecurityGroup; end
       class VirtualNetwork < BaseModel; end
       class Subnet < VirtualNetwork; end
     end

data/lib/azure/armrest/model/storage_account.rb

@@ -15,6 +15,10 @@ module Azure
       class BlobServiceStat < BaseModel; end
       class BlobMetadata < BaseModel; end
 
+      # Classes used to wrap table information
+      class Table < BaseModel; end
+      class TableData < BaseModel; end
+
       # The version string used in headers sent as part any internal http
       # request. The default is 2015-02-21.
       attr_accessor :storage_api_version
@@ -24,6 +28,52 @@ module Azure
         @storage_api_version = '2015-02-21'
       end
 
+      # Returns a list of tables for the given storage account +key+. Note
+      # that full metadata is returned.
+      #
+      def tables(key = nil)
+        key ||= properties.key1
+        response = table_response(key, nil, "Tables")
+        JSON.parse(response.body)['value'].map{ |t| Table.new(t) }
+      end
+
+      # Return information about a single table for the given storage
+      # account +key+. If you are looking for the entities within the
+      # table, use the table_data method instead.
+      #
+      def table_info(table, key = nil)
+        key ||= properties.key1
+        response = table_response(key, nil, "Tables('#{table}')")
+        Table.new(response.body)
+      end
+
+      # Returns a list of TableData objects for the given table +name+ using
+      # account +key+. The exact nature of the TableData object depends on the
+      # type of table that it is.
+      #
+      def table_data(name, key = nil, options = {})
+        key ||= properties.key1
+
+        query = ""
+
+        hash = {
+          "$filter=" => options[:filter],
+          "$select=" => options[:select],
+          "$top="    => options[:top]
+        }
+
+        hash.each do |key, value|
+          if query.include?("$")
+            query << "&#{key}#{value}" if value
+          else
+            query << "#{key}#{value}" if value
+          end
+        end
+
+        response = table_response(key, query, name)
+        JSON.parse(response.body)['value'].map{ |t| TableData.new(t) }
+      end
+
       # Return a list of container names for the given storage account +key+.
       # If no key is provided, it is assumed that the StorageAccount object
       # includes the key1 property.
@@ -76,7 +126,7 @@ module Azure
         url = File.join(properties.primary_endpoints.blob, container, blob)
         url += "?snapshot=" + options[:date] if options[:date]
 
-        headers = build_headers(url, key, :verb => 'HEAD')
+        headers = build_headers(url, key, :blob, :verb => 'HEAD')
         response = RestClient.head(url, headers)
 
         BlobProperty.new(response.headers)
@@ -174,7 +224,7 @@ module Azure
 
         options = {'x-ms-copy-source' => src_url, 'If-None-Match' => '*', :verb => 'PUT'}
 
-        headers = build_headers(dst_url, key, options)
+        headers = build_headers(dst_url, key, :blob, options)
 
         # RestClient will set the Content-Type to application/x-www-form-urlencoded.
         # We must override this setting or the request will fail.
@@ -193,7 +243,7 @@ module Azure
         url = File.join(properties.primary_endpoints.blob, container, blob)
         url += "?snapshot=" + options[:date] if options[:date]
 
-        headers = build_headers(url, key, :verb => 'DELETE')
+        headers = build_headers(url, key, :blob, :verb => 'DELETE')
         response = RestClient.delete(url, headers)
 
         true
@@ -206,14 +256,28 @@ module Azure
       #
       def blob_response(key, query, *args)
         url = File.join(properties.primary_endpoints.blob, *args) + "?#{query}"
-        headers = build_headers(url, key)
+        headers = build_headers(url, key, 'blob')
+        RestClient.get(url, headers)
+      end
+
+      # Using the blob primary endpoint as a base, join any arguments to the
+      # the url and submit an http request.
+      def table_response(key, query = nil, *args)
+        url = File.join(properties.primary_endpoints.table, *args)
+
+        headers = build_headers(url, key, 'table')
+        headers['Accept'] = 'application/json;odata=fullmetadata'
+
+        url << "?#{query}" if query # Must happen after headers are built
+
         RestClient.get(url, headers)
       end
 
       # Set the headers needed, including the Authorization header.
       #
-      def build_headers(url, key, additional_headers = {})
+      def build_headers(url, key, sig_type = nil, additional_headers = {})
         sig = Signature.new(url, key)
+        sig_type ||= 'blob'
 
         headers = {
           'x-ms-date'     => Time.now.httpdate,
@@ -222,7 +286,7 @@ module Azure
         }
 
         headers.merge!(additional_headers)
-        headers['Authorization'] = sig.blob_signature(headers)
+        headers['Authorization'] = sig.signature(sig_type, headers)
 
         headers
       end

data/lib/azure/armrest/network/network_security_rule_service.rb

@@ -0,0 +1,47 @@
+module Azure
+  module Armrest
+    module Network
+      # Base class for managing securityRules
+      class NetworkSecurityRuleService < NetworkSecurityGroupService
+        # Creates a new +rule_name+ on +security_group+ using the given +options+.
+        def create(rule_name, security_group, resource_group = armrest_configuration.resource_group, options = {})
+          super(combine(security_group, rule_name), resource_group, options)
+        end
+
+        alias update create
+
+        # Deletes the given +rule_name+ in +security_group+.
+        #
+        def delete(rule_name, security_group, resource_group = armrest_configuration.resource_group)
+          super(combine(security_group, rule_name), resource_group)
+        end
+
+        # Retrieves information for the provided +rule_name+ in +security_group+ for
+        # the current subscription.
+        #
+        def get(rule_name, security_group, resource_group = armrest_configuration.resource_group)
+          super(combine(security_group, rule_name), resource_group)
+        end
+
+        # List available security rules on +security_group+ for the given +resource_group+.
+        #
+        def list(security_group, resource_group = armrest_configuration.resource_group)
+          raise ArgumentError, "must specify resource group" unless resource_group
+          raise ArgumentError, "must specify name of the resource" unless security_group
+
+          url = build_url(resource_group, security_group, 'securityRules')
+          response = rest_get(url)
+          JSON.parse(response)['value'].map{ |hash| model_class.new(hash) }
+        end
+
+        alias list_all list
+
+        private
+
+        def combine(virtual_network, subnet)
+          File.join(virtual_network, 'securityRules', subnet)
+        end
+      end
+    end # Network
+  end # Armrest
+end # Azure

data/lib/azure/armrest/version.rb

@@ -1,5 +1,5 @@
 module Azure
   module Armrest
-    VERSION = "0.0.8"
+    VERSION = "0.0.9"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: azure-armrest
 version: !ruby/object:Gem::Version
-  version: 0.0.8
+  version: 0.0.9
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-11-10 00:00:00.000000000 Z
+date: 2015-12-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -194,11 +194,14 @@ files:
 - lib/azure/armrest/armrest_service.rb
 - lib/azure/armrest/availability_set_service.rb
 - lib/azure/armrest/exception.rb
+- lib/azure/armrest/insights/alert_service.rb
+- lib/azure/armrest/insights/event_service.rb
 - lib/azure/armrest/model/base_model.rb
 - lib/azure/armrest/model/storage_account.rb
 - lib/azure/armrest/network/ip_address_service.rb
 - lib/azure/armrest/network/network_interface_service.rb
 - lib/azure/armrest/network/network_security_group_service.rb
+- lib/azure/armrest/network/network_security_rule_service.rb
 - lib/azure/armrest/network/subnet_service.rb
 - lib/azure/armrest/network/virtual_network_service.rb
 - lib/azure/armrest/resource_group_based_service.rb
@@ -231,7 +234,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.5.0
+rubygems_version: 2.5.1
 signing_key: 
 specification_version: 4
 summary: An interface for ARM/JSON Azure REST API