oneview-sdk 2.2.1 → 3.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: dd1ac219db19a7c03bf16b3df31b5cccf12e22eb
-  data.tar.gz: 0718886cb26a7ce15a2fe826f0b87bb68d79a06c
+  metadata.gz: 55ecd759a6f2a88d204976f9423649527ff616c9
+  data.tar.gz: 0efc8e08440bc9727f33f806e24fcc298372ca7e
 SHA512:
-  metadata.gz: 86766ecbc79b8bc588235fe3a4d9e0517bfbb7ad530a2f86830ab33efa27e057347da245022fd84a3620a20c500fdada9406696a8292643c8affa7dd1f8726a2
-  data.tar.gz: d43154cbc551777fb2e821c16123712d120c1ef4704046b752ebd6bd4c493e8834358813106cd11f0558883ca5512a31d19f1cccb8230eeb80f56ff218a8ef3b
+  metadata.gz: 30dd2a219225da9690450c94fcbbc02b00b89db7bb0e66fb97f10d3579e475e8771ab02452a70f44d1a42c4876aea070845e4a9297cf10ac36cbf9b853865ed6
+  data.tar.gz: 83044fcf64204982bd17adada045197af780f7d73a80d8644d95984a75efea6ad2eaf95784f6a4b374c2aae78d660c6079e7b484e5b40819faaef394defc0d4d

data/CHANGELOG.md

@@ -1,3 +1,53 @@
+# v3.0.0
+### Notes
+ This is the Third major version of the Ruby SDK for HPE OneView. It features a split in the API support, allowing for C7000 and Synergy hardware variants to be used, while maintaining compatibility to older versions. There are some code improvements applied throughout the release, as well as additional endpoints support.
+ This version of this SDK officially supports OneView appliances version 3.00.00 or higher, using the OneView Rest API version 300.
+ Support is provided for C7000 and Synergy enclosure types.
+
+### Major changes
+ 1. Added full support to OneView Rest API version 300 for the hardware variants C7000 and Synergy to the already existing features:
+   - Connection template
+   - Datacenter
+   - Enclosure
+   - Ethernet network
+   - Fabrics
+   - FC network
+   - FCoE network
+   - Firmware bundles
+   - Firmware drivers
+   - Logical downlink
+   - Logical enclosure
+   - Logical interconnect Group
+   - Logical switch
+   - Logical switch group
+   - Managed SANs
+   - Network set
+   - Power devices
+   - Racks
+   - SAN managers
+   - Server hardware
+   - Server hardware type
+   - Server profile
+   - Server profile template
+   - Storage pools
+   - Storage systems
+   - Switches
+   - Volume
+   - Volume template
+ 2. New features added:
+   - Drive Enclosures
+   - Interconnect Link Topology
+   - Internal Link Set
+   - SAS Interconnect
+   - SAS Interconnect Type
+   - SAS Logical Interconnect
+   - SAS Logical Interconnect Group
+   - SAS Logical JBOD Attachments
+   - SAS Logical JBODs
+ 3. Design changes:
+ - Split features into API modules for each hardware variant
+ - Fixed/updated/added CLI commands
+
 #### v2.2.1
  - Fixed issue #88 (firmware bundle file size). Uses multipart-post now
 

data/README.md

@@ -8,7 +8,7 @@ The OneView SDK provides a Ruby library to easily interact with HPE OneView API.
 - Require the gem in your Gemfile:
 
   ```ruby
-  gem 'oneview-sdk'
+  gem 'oneview-sdk', '~> 3.0'
   ```
 
   Then run `$ bundle install`
@@ -28,11 +28,11 @@ client = OneviewSDK::Client.new(
   url: 'https://oneview.example.com',
   user: 'Administrator',              # This is the default
   password: 'secret123',
+  token: 'xxxx...',                   # Set EITHER this or the user & password
   ssl_enabled: true,                  # This is the default and strongly encouraged
   logger: Logger.new(STDOUT),         # This is the default
   log_level: :info,                   # This is the default
-  api_version: 200,                   # Defaults to minimum of (200 and appliance API version)
-  token: 'xxxx...'                    # Set EITHER this or the user & password
+  api_version: 200                    # Defaults to minimum of 200 and appliance's max API version
 )
 ```
 
@@ -72,7 +72,8 @@ Configuration files can also be used to define client configuration (json or yam
 {
   "url": "https://oneview.example.com",
   "user": "Administrator",
-  "password": "secret123"
+  "password": "secret123",
+  "api_version": 200
 }
 ```
 
@@ -83,7 +84,7 @@ config = OneviewSDK::Config.load("full_file_path.json")
 client = OneviewSDK::Client.new(config)
 ```
 
-:lock: Tip: Check the file permissions because the password is stored in clear-text.
+:lock: Tip: Check the file permissions if the password or token is stored in clear-text.
 
 ### Custom logging
 The default logger is a standard logger to STDOUT, but if you want to specify your own, you can.  However, your logger must implement the following methods:
@@ -96,10 +97,55 @@ error(String)
 level=(Symbol, etc.) # The parameter here will be the log_level attribute
 ```
 
+:lock: Tip: When the log_level is set to debug, API request options will be logged (including auth tokens and passwords); be careful to protect secret information.
+
+### OneView API versions and appliance types
+You may notice resource classes being accessed in a few different ways; for example, `OneviewSDK::EthernetNetwork`, `OneviewSDK::API300::EthernetNetwork`, and `OneviewSDK::API300::C7000::EthernetNetwork`. However, each of these accessors may actually be referring to the same class. This is because in order to keep backwards compatibility and make examples a little more simple, there are module methods in place to redirect/resolve the shorthand accessors to their full namespace identifier. In order to automatically complete the full namespace identifier, there are some defaults in place. Here's some example code that should help clear things up (return values are commented behind the code):
+
+```ruby
+require 'oneview-sdk'
+
+# Show defaults:
+OneviewSDK::SUPPORTED_API_VERSIONS      # [200, 300]
+OneviewSDK::DEFAULT_API_VERSION         # 200
+OneviewSDK.api_version                  # 200
+OneviewSDK.api_version_updated?         # false
+
+# Notice the automatic redirection/resolution when we use the shorthand accessor:
+OneviewSDK::EthernetNetwork             # OneviewSDK::API200::EthernetNetwork
+
+# Even this comparison is true:
+OneviewSDK::EthernetNetwork == OneviewSDK::API200::EthernetNetwork  # true
+
+# Now let's set a new API version default:
+OneviewSDK.api_version = 300
+OneviewSDK.api_version                  # 300
+OneviewSDK.api_version_updated?         # true
+
+# The API200 module has only 1 variant, but API300 has 2 (C7000 & Synergy):
+OneviewSDK::API300::SUPPORTED_VARIANTS  # ['C7000', 'Synergy']
+OneviewSDK::API300::DEFAULT_VARIANT     # 'C7000'
+OneviewSDK::API300.variant              # 'C7000'
+OneviewSDK::API300.variant_updated?     # false
+
+# Therefore, there is 1 more namespace level to the real resource class name
+OneviewSDK::EthernetNetwork             # OneviewSDK::API300::C7000::EthernetNetwork
+OneviewSDK::API300::EthernetNetwork     # OneviewSDK::API300::C7000::EthernetNetwork
+
+# Likewise, we can set a new default variant for the API300 module:
+OneviewSDK::API300.variant = 'Synergy'
+OneviewSDK::API300.variant              # 'Synergy'
+OneviewSDK::API300.variant_updated?     # true
+OneviewSDK::EthernetNetwork             # OneviewSDK::API300::Synergy::EthernetNetwork
+OneviewSDK::API300::EthernetNetwork     # OneviewSDK::API300::Synergy::EthernetNetwork
+```
+
+We understand that this can be confusing, so to avoid any confusion or unexpected behavior, we recommend specifying the full namespace identifier in your code. At the very least, set defaults explicitly using `OneviewSDK.api_version = <ver>` and `OneviewSDK::API300.variant = <variant>`, as the defaults may change.
+
 ## Resources
-Each OneView resource is exposed for usage with CRUD-like functionality.
+Each OneView resource is exposed via a Ruby class, enabling CRUD-like functionality (with some exceptions).
 
-For example, once you instantiate a resource object, you can call intuitive methods such as `resource.create`, `resource.udpate` and `resource.delete`. In addition, resources respond to helpful methods such as `.each`, `.eql?(other_resource)`, `.like(other_resource)`, `.retrieve!`, and many others.
+Once you instantiate a resource object, you can call intuitive methods such as `resource.create`, `resource.update` and `resource.delete`. In addition, resources respond to helpful methods such as `.each`, `.eql?(other_resource)`, `.like(other_resource)`, `.retrieve!`, and many others.
 
 Please see the [rubydoc.info](http://www.rubydoc.info/gems/oneview-sdk) documentation for complete usage details and the [examples](examples/) directory for more examples and test-scripts, but here are a few examples to get you started:
 
@@ -125,7 +171,7 @@ end
 ```
 
 The resource's data is stored in its @data attribute.  However, you can access the data directly using a hash-like syntax on the resource object (recommended). `resource['key']` functions a lot like `resource.data['key']`. The difference is that when using the data attribute, you must be cautious to use the correct key type (Hash vs Symbol).
-The direct hash accessor on the resource converts all keys to strings, so `resource[:key]` and `resource['key']` access the same thing: `resource.data['key']`.
+The direct hash accessor on the resource converts first-level keys to strings; so `resource[:key]` and `resource['key']` access the same thing: `resource.data['key']`. We recommend using strings exclusively for keys, as the JSON data returned from OneView requests supports strings but not symbols.
 
 ##### Update a resource
 
@@ -144,17 +190,14 @@ ethernet.update(name: 'newName', vlanId:  1002, purpose: 'General', ethernetNetw
 
 You can use the `==`  or `.eql?` method to compare resource equality, or `.like` to compare just a subset of attributes.
 ```ruby
-ethernet2 = OneviewSDK::EthernetNetwork.new(
-  client, { name: 'OtherVlan', vlanId:  1000, purpose:  'General', smartLink: false, privateNetwork: false }
-)
+ethernet2 = OneviewSDK::EthernetNetwork.new(client, { purpose:  'General' })
 ethernet == ethernet2    # Returns false
 ethernet.eql?(ethernet2) # Returns false
 
 
 # To compare a subset of attributes:
-ethernet3 = OneviewSDK::EthernetNetwork.new(client, { purpose:  'General' })
-ethernet.like?(ethernet3)  # Returns true
-ethernet.like?(name: TestVlan, purpose: 'General')  # Returns true
+ethernet.like?(ethernet2)  # Returns true
+ethernet.like?(name: 'TestVlan', purpose: 'General')  # Returns true
 ```
 
 
@@ -222,7 +265,7 @@ Please refer to the documentation and [code](lib/oneview-sdk/rest.rb) for comple
 ## CLI
 This gem also comes with a command-line interface to make interacting with OneView possible without the need to create a Ruby program or script.
 
-Note: In order to use this, you will need to make sure your ruby `bin` directory is in your path.
+Note: In order to use this, you will need to make sure your Ruby `bin` directory is in your path.
 Run `$ gem environment` to see where the executable paths are for your Ruby installation.
 
 To get started, run `$ oneview-sdk-ruby --help`.
@@ -260,6 +303,9 @@ $ oneview-sdk-ruby search ServerProfiles --filter state:Normal boot.manageBoot:t
 ##### Create or delete resource by file:
 
 ```bash
+# Save resource details to a file (to be used with the create and delete methods below)
+$ oneview-sdk-ruby to_file ServerProfile profile-1 /my-server-profile.json
+
 $ oneview-sdk-ruby create_from_file /my-server-profile.json
 $ oneview-sdk-ruby delete_from_file /my-server-profile.json
 ```

data/Rakefile

@@ -84,7 +84,9 @@ RSpec::Core::RakeTask.new('spec:system:heavy') do |spec|
   spec.rspec_opts << ' --tag system'
 end
 
-RuboCop::RakeTask.new
+RuboCop::RakeTask.new do |task|
+  task.options << '--display-cop-names'
+end
 
 desc 'Runs rubocop and unit tests'
 task :test do
@@ -99,3 +101,39 @@ task 'test:all' do
   Rake::Task['spec:integration'].invoke
   Rake::Task['spec:system'].invoke
 end
+
+desc 'Run rubocop & integration tests for specified path'
+task 'test:path', [:path] do |_t, spec|
+  spec_pattern = spec['path']
+  Rake::Task[:rubocop].invoke
+  Rake::Task['spec:integration'].invoke
+end
+
+desc 'Run rubocop & integration tests for specified model & API. Defaults to model C7000 and API 300.'
+task 'spec:integration:api', [:model, :api] do |_t, spec|
+  args = {}
+  args['model'] = spec['model'] || 'c7000'
+  args['api'] = spec['api'] || 300
+  spec_pattern = "spec/integration/resource/api#{args['api']}/#{args['model']}/**/*_spec.rb"
+  spec_pattern = 'spec/integration/resource/api200/**/*_spec.rb' if args['api'] == 200
+  Rake::Task[:rubocop].invoke
+  Rake::Task['spec:integration'].invoke
+end
+
+desc 'Run rubocop & integration tests for specified API. Defaults to API 300.'
+task 'spec:integration:api_version', [:api] do |_t, spec|
+  args = spec['api'] || 300
+  spec_pattern = "spec/integration/resource/api#{args}/**/**/*_spec.rb"
+  spec_pattern = 'spec/integration/resource/api200/**/*_spec.rb' if args == 200
+  Rake::Task[:rubocop].invoke
+  Rake::Task['spec:integration'].invoke
+end
+
+desc 'Run rubocop & integration deletion tests for specified API. Defaults to API 300'
+task 'spec:integration:delete:api_version', [:api] do |_t, spec|
+  args = spec['api'] || 300
+  spec_pattern = "spec/integration/resource/api#{args}/**/**/*delete_spec.rb"
+  spec_pattern = 'spec/integration/resource/api200/**/*delete_spec.rb' if args == 200
+  Rake::Task[:rubocop].invoke
+  Rake::Task['spec:integration'].invoke
+end

data/lib/oneview-sdk.rb

@@ -1,7 +1,7 @@
-# (C) Copyright 2016 Hewlett Packard Enterprise Development LP
+# (c) Copyright 2016 Hewlett Packard Enterprise Development LP
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
-# You may not use this file except in compliance with 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
@@ -13,9 +13,44 @@ require_relative 'oneview-sdk/version'
 require_relative 'oneview-sdk/exceptions'
 require_relative 'oneview-sdk/client'
 require_relative 'oneview-sdk/resource'
+Dir[File.dirname(__FILE__) + '/oneview-sdk/resource/*.rb'].each { |file| require file }
 require_relative 'oneview-sdk/cli'
 
-# Module for interracting with the HPE OneView API
+# Module for interacting with the HPE OneView API
 module OneviewSDK
   ENV_VARS = %w(ONEVIEWSDK_URL ONEVIEWSDK_USER ONEVIEWSDK_PASSWORD ONEVIEWSDK_TOKEN ONEVIEWSDK_SSL_ENABLED).freeze
+  SUPPORTED_API_VERSIONS = [200, 300].freeze
+  DEFAULT_API_VERSION = 200
+  @api_version = DEFAULT_API_VERSION
+  @api_version_updated = false # Whether or not the API version has been set by the user
+
+  # Get the current API version
+  def self.api_version
+    @api_version
+  end
+
+  # Set the default API version
+  def self.api_version=(version)
+    version = version.to_i rescue version
+    raise "API version #{version} is not supported!" unless SUPPORTED_API_VERSIONS.include?(version)
+    raise "The module for API version #{@api_version} is undefined" unless constants.include?("API#{@api_version}".to_sym)
+    @api_version_updated = true
+    @api_version = version
+  end
+
+  # Has the API version been set by the user?
+  # @return [TrueClass, FalseClass]
+  def self.api_version_updated?
+    @api_version_updated
+  end
+
+  # This method will help redirect to resources within the API module that is currently in use.
+  # It should NOT be called directly. For example, if @@api_version is set to 200, then accessing
+  # OneviewSDK::EthernetNetwork will redirect to OneviewSDK::API200::EthernetNetwork
+  def self.const_missing(const)
+    api_module = OneviewSDK.const_get("API#{@api_version}")
+    api_module.const_get(const)
+  rescue NameError
+    raise NameError, "The #{const} method or resource does not exist for OneView API version #{@api_version}."
+  end
 end

data/lib/oneview-sdk/cli.rb

@@ -15,7 +15,8 @@ require 'yaml'
 require 'highline/import'
 
 module OneviewSDK
-  # cli for oneview-sdk
+  # command-line-interface for oneview-sdk
+  # When you install this gem, this cli should be available to you by running: `$ oneview-sdk-ruby`
   class Cli < Thor
     # Runner class to enable testing
     class Runner
@@ -67,12 +68,13 @@ module OneviewSDK
       desc: 'Log level to use',
       aliases: '-l',
       enum: %w(debug info warn error),
-      default: 'warn'
+      default: :warn
 
     map ['-v', '--version'] => :version
 
 
     desc 'console', 'Open a Ruby console with a connection to OneView'
+    # Open a Ruby console with a connection to OneView
     def console
       client_setup({}, true, true)
       puts "Console Connected to #{@client.url}"
@@ -88,6 +90,7 @@ module OneviewSDK
     end
 
     desc 'version', 'Print gem and OneView appliance versions'
+    # Print gem and OneView appliance versions
     def version
       puts "Gem Version: #{OneviewSDK::VERSION}"
       client_setup({ 'log_level' => :error }, true)
@@ -102,12 +105,13 @@ module OneviewSDK
       enum: %w(json yaml human),
       default: 'human'
     desc 'env', 'Show environment variables for oneview-sdk-ruby'
+    # Show environment variables for oneview-sdk-ruby
     def env
       data = {}
       OneviewSDK::ENV_VARS.each { |k| data[k] = ENV[k] }
       if @options['format'] == 'human'
         data.each do |key, value|
-          value = "'#{value}'" if value && ! %w(true false).include?(value)
+          value = "'#{value}'" if value && !%w(true false).include?(value)
           printf "%-#{data.keys.max_by(&:length).length}s = %s\n", key, value || 'nil'
         end
       else
@@ -116,6 +120,7 @@ module OneviewSDK
     end
 
     desc 'login', 'Attempt authentication and return token'
+    # Attempt authentication and return token
     def login
       client_setup
       puts "Login Successful! Token = #{@client.token}"
@@ -127,6 +132,7 @@ module OneviewSDK
       enum: %w(json yaml human),
       default: 'human'
     desc 'list TYPE', 'List names of resources'
+    # List names of resources
     def list(type)
       resource_class = parse_type(type)
       client_setup
@@ -145,6 +151,7 @@ module OneviewSDK
       desc: 'Comma-seperated list of attributes to show',
       aliases: '-a'
     desc 'show TYPE NAME', 'Show resource details'
+    # Show resource details
     def show(type, name)
       resource_class = parse_type(type)
       client_setup
@@ -175,6 +182,7 @@ module OneviewSDK
       desc: 'Hash of key/value pairs to filter on',
       required: true
     desc 'search TYPE', 'Search for resource by key/value pair(s)'
+    # Search for resource by key/value pair(s)
     def search(type)
       resource_class = parse_type(type)
       client_setup
@@ -213,8 +221,10 @@ module OneviewSDK
     rest_examples << "\n  oneview-sdk-ruby rest PUT rest/fc-networks/<id> -d '{\"linkStabilityTime\": 20, ...}'"
     rest_examples << "\n  oneview-sdk-ruby rest PUT rest/enclosures/<id>/configuration"
     desc 'rest METHOD URI', "Make REST call to the OneView API. Examples:#{rest_examples}"
+    # Make REST call to the OneView API
     def rest(method, uri)
-      client_setup('log_level' => :error)
+      log_level = @options['log_level'] == :warn ? :error : @options['log_level'].to_sym # Default to :error
+      client_setup('log_level' => log_level)
       uri_copy = uri.dup
       uri_copy.prepend('/') unless uri_copy.start_with?('/')
       if @options['data']
@@ -253,6 +263,7 @@ module OneviewSDK
     update_examples =  "\n  oneview-sdk-ruby update FCNetwork FC1 -h linkStabilityTime:20"
     update_examples << "\n  oneview-sdk-ruby update Volume VOL1 -j '{\"shareable\": true}'"
     desc 'update TYPE NAME --[hash|json] <data>', "Update resource by name. Examples:#{update_examples}"
+    # Update resource by name
     def update(type, name)
       resource_class = parse_type(type)
       client_setup
@@ -267,9 +278,8 @@ module OneviewSDK
       fail_nice 'Not Found' if matches.empty?
       resource = matches.first
       begin
-        resource[:uri] = '/rest/storage-volumes/57A22A70-73EC-43C1-91B9-9FABD1E'
         resource.update(data)
-        output 'Updated Successfully!'
+        puts 'Updated Successfully!'
       rescue StandardError => e
         fail_nice "Failed to update #{resource.class.name.split('::').last} '#{name}': #{e}"
       end
@@ -280,16 +290,17 @@ module OneviewSDK
       type: :boolean,
       aliases: '-f'
     desc 'delete TYPE NAME', 'Delete resource by name'
+    # Delete resource by name
     def delete(type, name)
       resource_class = parse_type(type)
       client_setup
       matches = resource_class.find_by(@client, name: name)
-      fail_nice 'Not Found' if matches.empty?
+      fail_nice('Not Found', 2) if matches.empty?
       resource = matches.first
       return unless options['force'] || agree("Delete '#{name}'? [Y/N] ")
       begin
         resource.delete
-        output 'Deleted Successfully!'
+        puts 'Deleted Successfully!'
       rescue StandardError => e
         fail_nice "Failed to delete #{resource.class.name.split('::').last} '#{name}': #{e}"
       end
@@ -300,23 +311,22 @@ module OneviewSDK
       type: :boolean,
       aliases: '-f'
     desc 'delete_from_file FILE_PATH', 'Delete resource defined in file'
+    # Delete resource defined in file
     def delete_from_file(file_path)
       client_setup
       resource = OneviewSDK::Resource.from_file(@client, file_path)
-      fail_nice 'File must define name or uri' unless resource[:name] || resource[:uri]
-      found = resource.retrieve! rescue false
-      found ||= resource.refresh rescue false
-      fail_nice "#{resource.class.name.split('::').last} '#{resource[:name] || resource[:uri]}' Not Found" unless found
-      unless options['force'] || agree("Delete '#{resource[:name]}'? [Y/N] ")
-        puts 'OK, exiting.'
-        return
-      end
+      fail_nice("#{resource.class.name.split('::').last} '#{resource[:name] || resource[:uri]}' Not Found", 2) unless resource.retrieve!
+      return unless options['force'] || agree("Delete '#{resource[:name]}'? [Y/N] ")
       begin
         resource.delete
-        output 'Deleted Successfully!'
+        puts 'Deleted Successfully!'
       rescue StandardError => e
         fail_nice "Failed to delete #{resource.class.name.split('::').last} '#{resource[:name]}': #{e}"
       end
+    rescue IncompleteResource => e
+      fail_nice "Failed to delete #{resource.class.name.split('::').last} '#{resource[:name]}': #{e}"
+    rescue SystemCallError => e # File open errors
+      fail_nice e
     end
 
     method_option :if_missing,
@@ -324,35 +334,68 @@ module OneviewSDK
       type: :boolean,
       aliases: '-i'
     desc 'create_from_file FILE_PATH', 'Create/Update resource defined in file'
+    # Create/Update resource defined in file
     def create_from_file(file_path)
       client_setup
       resource = OneviewSDK::Resource.from_file(@client, file_path)
-      resource[:uri] = nil
-      fail_nice 'File must specify a resource name' unless resource[:name]
-      existing_resource = resource.class.find_by(@client, name: resource[:name]).first
-      if existing_resource
+      fail_nice 'Failed to determine resource type!' if resource.class == OneviewSDK::Resource
+      existing_resource = resource.class.new(@client, resource.data)
+      resource.data.delete('uri')
+      if existing_resource.retrieve!
         if options['if_missing']
-          puts "Skipped: '#{resource[:name]}': #{resource.class.name.split('::').last} already exists."
+          puts "Skipped: #{resource.class.name.split('::').last} '#{resource[:name]}' already exists.\n#{existing_resource[:uri]}"
+          return
+        end
+        if existing_resource.like?(resource.data)
+          puts "Skipped: #{resource.class.name.split('::').last} '#{resource[:name]}' is up to date.\n#{existing_resource[:uri]}"
           return
         end
         begin
-          resource.data.delete('uri')
           existing_resource.update(resource.data)
-          output "Updated Successfully!\n#{resource[:uri]}"
+          puts "Updated Successfully!\n#{existing_resource[:uri]}"
         rescue StandardError => e
           fail_nice "Failed to update #{resource.class.name.split('::').last} '#{resource[:name]}': #{e}"
         end
       else
         begin
           resource.create
-          output "Created Successfully!\n#{resource[:uri]}"
+          puts "Created Successfully!\n#{resource[:uri]}"
         rescue StandardError => e
           fail_nice "Failed to create #{resource.class.name.split('::').last} '#{resource[:name]}': #{e}"
         end
       end
+    rescue IncompleteResource => e
+      fail_nice "Failed to create #{resource.class.name.split('::').last} '#{resource[:name]}': #{e}"
+    rescue SystemCallError => e # File open errors
+      fail_nice e
+    end
+
+    method_option :path,
+      desc: 'File path to save resource in',
+      type: :string,
+      aliases: '-p',
+      required: true
+    method_option :format,
+      desc: 'Output format',
+      aliases: '-f',
+      enum: %w(json yaml),
+      default: 'json'
+    desc 'to_file TYPE NAME', 'Save resource details to file'
+    # Save resource details to file
+    def to_file(type, name)
+      file = File.expand_path(options['path'])
+      resource_class = parse_type(type)
+      client_setup
+      resource = resource_class.find_by(@client, name: name).first
+      fail_nice "#{resource_class.name.split('::').last} '#{name}' not found" unless resource
+      resource.to_file(file, options['format'])
+      puts "Output to #{file}"
+    rescue SystemCallError => e
+      fail_nice "Failed to create file! (You may need to create the necessary directories). Message: #{e}"
     end
 
     desc 'cert check|import|list URL', 'Check, import, or list OneView certs'
+    # Check, import, or list OneView certs
     def cert(type, url = ENV['ONEVIEWSDK_URL'])
       case type.downcase
       when 'check'
@@ -381,9 +424,9 @@ module OneviewSDK
 
     private
 
-    def fail_nice(msg = nil)
+    def fail_nice(msg = nil, exit_code = 1)
       puts "ERROR: #{msg}" if msg
-      exit 1
+      exit exit_code
     end
 
     def client_setup(client_params = {}, quiet = false, throw_errors = false)
@@ -391,6 +434,7 @@ module OneviewSDK
       client_params['ssl_enabled'] = false if @options['ssl_verify'] == false
       client_params['url'] ||= @options['url'] if @options['url']
       client_params['log_level'] ||= @options['log_level'].to_sym if @options['log_level']
+      client_params['api_version'] ||= @options['api_version'].to_i if @options['api_version']
       @client = OneviewSDK::Client.new(client_params)
     rescue StandardError => e
       raise e if throw_errors
@@ -400,14 +444,25 @@ module OneviewSDK
 
     # Get resource class from given string
     def parse_type(type)
+      api_ver = (@options['api_version'] || OneviewSDK.api_version).to_i
+      unless OneviewSDK::SUPPORTED_API_VERSIONS.include?(api_ver)
+        # Find and use the best available match for the desired API version (round down to nearest)
+        valid_api_ver = OneviewSDK::SUPPORTED_API_VERSIONS.select { |x| x <= api_ver }.max || OneviewSDK::SUPPORTED_API_VERSIONS.min
+        puts "WARNING: Module API version #{api_ver} is not supported. Using #{valid_api_ver}"
+        api_ver = valid_api_ver
+      end
+      r = OneviewSDK.resource_named(type, api_ver)
+      r ||= OneviewSDK.resource_named(type) unless api_ver == OneviewSDK.api_version # Try default API version as last resort
+      return r if r
       valid_classes = []
-      OneviewSDK.constants.each do |c|
-        klass = OneviewSDK.const_get(c)
+      api_module = OneviewSDK.const_get("API#{api_ver}")
+      api_module.constants.each do |c|
+        klass = api_module.const_get(c)
         next unless klass.is_a?(Class) && klass < OneviewSDK::Resource
         valid_classes.push(klass.name.split('::').last)
       end
       vc = valid_classes.sort_by!(&:downcase).join("\n  ")
-      OneviewSDK.resource_named(type) || fail_nice("Invalid resource type: '#{type}'.  Valid options are:\n  #{vc}")
+      fail_nice("Invalid resource type: '#{type}'.  Valid options for API version #{api_ver} are:\n  #{vc}")
     end
 
     # Parse options hash from input. Handles chaining and keywords such as true/false & nil