azure-armrest 0.3.9 → 0.3.10

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 354b862215f326a7caf9baee4c8adf8e522e11e8
-  data.tar.gz: 51709b7ab4402f95fa434a7ec09c3db705f72bde
+  metadata.gz: b9777098a3e4838e748f6da116a2537864c42002
+  data.tar.gz: 3ec9b411092bfb9d6cd5fc24c0aadecd2a0ccbc6
 SHA512:
-  metadata.gz: 1c8a8bc99dd581528d3de37d60cf8dd15465f26a0e5cf3ce466c02c0597f286343bb85087daefe6c02b5c33a08d966569ec143c51ba4f087220189035b1c440f
-  data.tar.gz: 603b2c4b5a88c68e54d87c4bf630a83a6af55727c260615505c00d5b68078f64ac1a3825f461edabcb48dde363200aea89374c13a35edb62924af00c5279ed0b
+  metadata.gz: d67953ce9e556be3f25a410b64899cde8d6294089eca9bc0b3e320ce1e452e2277783a48459ff7250422c487e39898fb1ab9ac471df482ae382fe4d81539156f
+  data.tar.gz: 4b7966bd30284bd34bd16eacb0960bb49ba23ea767db1a9275159c0c1f459dde5ae34d69151c679ec8a83b2df3d8b2b0bfb3a192c23b844ff984b7ab3b4aef7c

data/CHANGES

@@ -1,7 +1,11 @@
+= 0.3.10 - 28-Oct-2016
+* Added the ResourceGroupBasedService#get_associated_resource method. This
+  method will retrieve a service or subservice resource based on an ID string.
+
 = 0.3.9 - 19-Oct-2016
 * The StorageAccount#delete_blob method now returns a ResponseHeaders object
   instead of true.
-# The Configuration.clear_caches method now additionally clears the
+* The Configuration.clear_caches method now additionally clears the
   CacheMethod config store.
 
 = 0.3.8 - 7-Oct-2-16

data/lib/azure/armrest/resource_group_based_service.rb

@@ -2,6 +2,22 @@ module Azure
   module Armrest
     # Base class for services that need to run in a resource group
     class ResourceGroupBasedService < ArmrestService
+      # Used to map service name strings to internal classes
+      SERVICE_NAME_MAP = {
+        'availabilitysets'      => Azure::Armrest::AvailabilitySet,
+        'loadbalancers'         => Azure::Armrest::Network::LoadBalancer,
+        'networkinterfaces'     => Azure::Armrest::Network::NetworkInterface,
+        'networksecuritygroups' => Azure::Armrest::Network::NetworkSecurityGroup,
+        'publicipaddresses'     => Azure::Armrest::Network::IpAddress,
+        'storageaccounts'       => Azure::Armrest::StorageAccount,
+        'virtualnetworks'       => Azure::Armrest::Network::VirtualNetwork,
+        'subnets'               => Azure::Armrest::Network::Subnet,
+        'inboundnatrules'       => Azure::Armrest::Network::InboundNat,
+        'securityrules'         => Azure::Armrest::Network::NetworkSecurityRule,
+        'routes'                => Azure::Armrest::Network::Route,
+        'databases'             => Azure::Armrest::Sql::SqlDatabase,
+      }.freeze
+
       # Create a resource +name+ within the resource group +rgroup+, or the
       # resource group that was specified in the configuration, along with
       # a hash of appropriate +options+.
@@ -73,6 +89,41 @@ module Azure
         filter.empty? ? results : results.select { |obj| filter.all? { |k, v| obj.public_send(k) == v } }
       end
 
+      # This method returns a model object based on an ID string for a Service.
+      #
+      # Example:
+      #
+      #   vms = Azure::Armrest::VirtualMachineService.new(conf)
+      #
+      #   vm = vms.get('your_vm', 'your_group')
+      #   nic_id = vm.properties.network_profile.network_interfaces[0].id
+      #   nic = vm.get_associated_resource(nic_id)
+      #
+      def get_associated_resource(id_string)
+        info = parse_id_string(id_string)
+
+        if info['subservice_name']
+          full_service_name = info['service_name'] + '/' + info['subservice_name']
+          api_version = configuration.provider_default_api_version(info['provider'], full_service_name)
+          api_version ||= configuration.provider_default_api_version(info['provider'], info['service_name'])
+        else
+          api_version = configuration.provider_default_api_version(info['provider'], info['service_name'])
+        end
+
+        api_version ||= configuration.api_version
+        service_name = info['subservice_name'] || info['service_name']
+
+        url = File.join(Azure::Armrest::RESOURCE, id_string) + "?api-version=#{api_version}"
+
+        model_class = SERVICE_NAME_MAP.fetch(service_name.downcase) do
+          raise ArgumentError, "unable to map service name #{service_name} to model"
+        end
+
+        model_class.new(rest_get(url))
+      end
+
+      alias get_by_id get_associated_resource
+
       # Get information about a single resource +name+ within resource group
       # +rgroup+, or the resource group that was set in the configuration.
       #
@@ -120,6 +171,25 @@ module Azure
 
       private
 
+      # Parse the provider and service name out of an ID string.
+      def parse_id_string(id_string)
+        regex = %r{
+          subscriptions/
+          (?<subscription_id>[\w\-]+)?/
+          resourceGroups/
+          (?<resource_group>\w+)?/
+          providers/
+          (?<provider>[\w\.]+)?/
+          (?<service_name>\w+)?/
+          (?<resource_name>\w+)
+          (/(?<subservice_name>\w+)?/(?<subservice_resource_name>\w+))*
+          \z
+        }x
+
+        match = regex.match(id_string)
+        Hash[match.names.zip(match.captures)]
+      end
+
       # Make additional calls and concatenate the results if a continuation URL is found.
       def get_all_results(response)
         results  = Azure::Armrest::ArmrestCollection.create_from_response(response, model_class)

data/lib/azure/armrest/version.rb

@@ -1,5 +1,5 @@
 module Azure
   module Armrest
-    VERSION = '0.3.9'.freeze
+    VERSION = '0.3.10'.freeze
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: azure-armrest
 version: !ruby/object:Gem::Version
-  version: 0.3.9
+  version: 0.3.10
 platform: ruby
 authors:
 - Daniel J. Berger
@@ -11,7 +11,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-10-19 00:00:00.000000000 Z
+date: 2016-10-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: json
@@ -275,7 +275,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.6.4
+rubygems_version: 2.6.7
 signing_key: 
 specification_version: 4
 summary: An interface for ARM/JSON Azure REST API