oneview-sdk 2.2.1 → 3.0.0

data/lib/oneview-sdk/resource/api200/server_hardware.rb

@@ -0,0 +1,244 @@
+# (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 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_relative 'resource'
+
+module OneviewSDK
+  module API200
+    # Server hardware resource implementation
+    class ServerHardware < Resource
+      BASE_URI = '/rest/server-hardware'.freeze
+      UNIQUE_IDENTIFIERS = %w(name uri serialNumber virtualSerialNumber serverProfileUri).freeze
+
+      # Remove resource from OneView
+      # @return [true] if resource was removed successfully
+      alias remove delete
+
+      # Create a resource object, associate it with a client, and set its properties.
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash] params The options for this resource (key-value pairs)
+      # @param [Integer] api_ver The api version to use when interracting with this resource.
+      def initialize(client, params = {}, api_ver = nil)
+        super
+        # Default values
+        @data['type'] ||= 'server-hardware-4'
+      end
+
+      # Retrieve resource details based on this resource's name or URI.
+      # @note one of the UNIQUE_IDENTIFIERS must be specified in the resource
+      # @return [Boolean] Whether or not retrieve was successful
+      def retrieve!
+        hostname = @data['hostname'] || @data['mpHostInfo']['mpHostName'] rescue nil
+        if hostname
+          results = self.class.find_by(@client, 'mpHostInfo' => { 'mpHostName' => hostname })
+          if results.size == 1
+            set_all(results[0].data)
+            return true
+          end
+        end
+        super
+      rescue IncompleteResource => e
+        raise e unless hostname
+        false
+      end
+
+      # Check if a resource exists
+      # @note one of the UNIQUE_IDENTIFIERS must be specified in the resource
+      # @return [Boolean] Whether or not resource exists
+      def exists?
+        hostname = @data['hostname'] || @data['mpHostInfo']['mpHostName'] rescue nil
+        return true if hostname && self.class.find_by(@client, 'mpHostInfo' => { 'mpHostName' => hostname }).size == 1
+        super
+      rescue IncompleteResource => e
+        raise e unless hostname
+        false
+      end
+
+      # Method is not available
+      # @raise [OneviewSDK::MethodUnavailable] method is not available
+      def create
+        unavailable_method
+      end
+
+      # Method is not available
+      # @raise [OneviewSDK::MethodUnavailable] method is not available
+      def delete
+        unavailable_method
+      end
+
+      # Adds the resource on OneView using the current data
+      # @raise [OneviewSDK::IncompleteResource] if the client is not set or required attributes are missing
+      # @return [OneviewSDK::ServerHardware] self
+      def add
+        ensure_client
+        required_attributes = %w(hostname username password licensingIntent)
+        required_attributes.each { |k| raise IncompleteResource, "Missing required attribute: '#{k}'" unless @data.key?(k) }
+
+        optional_attrs = %w(configurationState force restore)
+        temp_data = @data.select { |k, _v| required_attributes.include?(k) || optional_attrs.include?(k) }
+        response = @client.rest_post(self.class::BASE_URI, { 'body' => temp_data }, @api_version)
+        body = @client.response_handler(response)
+        set_all(body)
+        %w(username password hostname).each { |k| @data.delete(k) } # These are no longer needed
+        self
+      end
+
+      # Method is not available
+      # @raise [OneviewSDK::MethodUnavailable] method is not available
+      def update(*)
+        unavailable_method
+      end
+
+      # Power on the server hardware
+      # @param [Boolean] force Use 'PressAndHold' action?
+      # @return [Boolean] Returns whether or not the server was powered on
+      def power_on(force = false)
+        set_power_state('on', force)
+      end
+
+      # Power off the server hardware
+      # @param [Boolean] force Use 'PressAndHold' action?
+      # @return [Boolean] Returns whether or not the server was powered off
+      def power_off(force = false)
+        set_power_state('off', force)
+      end
+
+      # Gets a list of BIOS/UEFI values on the physical server
+      # @return [Hash] List with BIOS/UEFI settings
+      def get_bios
+        response = @client.rest_get(@data['uri'] + '/bios')
+        @client.response_handler(response)
+      end
+
+      # Gets a url to the iLO web interface
+      # @return [Hash] url
+      def get_ilo_sso_url
+        response = @client.rest_get(@data['uri'] + '/iloSsoUrl')
+        @client.response_handler(response)
+      end
+
+      # Gets a Single Sign-On session for the Java Applet console
+      # @return [Hash] url
+      def get_java_remote_sso_url
+        response = @client.rest_get(@data['uri'] + '/javaRemoteConsoleUrl')
+        @client.response_handler(response)
+      end
+
+      # Gets a url to the iLO web interface
+      # @return [Hash] url
+      def get_remote_console_url
+        response = @client.rest_get(@data['uri'] + '/remoteConsoleUrl')
+        @client.response_handler(response)
+      end
+
+      # Refreshes the enclosure along with all of its components
+      # @param [String] state NotRefreshing, RefreshFailed, RefreshPending, Refreshing
+      # @param [Hash] options  Optional force fields for refreshing the enclosure
+      def set_refresh_state(state, options = {})
+        ensure_client && ensure_uri
+        s = state.to_s rescue state
+        requestBody = {
+          'body' => {
+            refreshState: s
+          }
+        }
+        requestBody['body'].merge(options)
+        response = @client.rest_put(@data['uri'] + '/refreshState', requestBody, @api_version)
+        new_data = @client.response_handler(response)
+        set_all(new_data)
+      end
+
+      # Updates the iLO firmware on a physical server to a minimum iLO firmware required by OneView
+      def update_ilo_firmware
+        response = @client.rest_put(@data['uri'] + '/mpFirmwareVersion')
+        @client.response_handler(response)
+      end
+
+      # Gets the settings that describe the environmental configuration
+      def environmental_configuration
+        ensure_client && ensure_uri
+        response = @client.rest_get(@data['uri'] + '/environmentalConfiguration', @api_version)
+        @client.response_handler(response)
+      end
+
+      # Retrieves historical utilization
+      # @param [Hash] queryParameters query parameters (ie :startDate, :endDate, :fields, :view, etc.)
+      # @option queryParameters [Array] :fields
+      # @option queryParameters [Time, Date, String] :startDate
+      # @option queryParameters [Time, Date, String] :endDate
+      def utilization(queryParameters = {})
+        ensure_client && ensure_uri
+        uri = "#{@data['uri']}/utilization?"
+
+        queryParameters[:endDate]   = convert_time(queryParameters[:endDate])
+        queryParameters[:startDate] = convert_time(queryParameters[:startDate])
+
+        queryParameters.each do |key, value|
+          next if value.nil?
+          uri += case key.to_sym
+                 when :fields
+                   "fields=#{value.join(',')}"
+                 when :startDate, :endDate
+                   "filter=#{key}=#{value}"
+                 else
+                   "#{key}=#{value}"
+                 end
+          uri += '&'
+        end
+        uri.chop! # Get rid of trailing '&' or '?'
+        response = @client.rest_get(uri, @api_version)
+        @client.response_handler(response)
+      end
+
+      private
+
+      # Converts Date, Time, or String objects to iso8601 string
+      def convert_time(t)
+        case t
+        when nil then nil
+        when Date then t.to_time.utc.iso8601(3)
+        when Time then t.utc.iso8601(3)
+        when String then Time.parse(t).utc.iso8601(3)
+        else raise InvalidResource, "Invalid time format '#{t.class}'. Valid options are Time, Date, or String"
+        end
+      rescue StandardError => e
+        raise InvalidResource, "Failed to parse time value '#{t}'. #{e.message}"
+      end
+
+      # Set power state. Takes into consideration the current state and does the right thing
+      def set_power_state(state, force)
+        refresh
+        return true if @data['powerState'].downcase == state
+        @logger.debug "Powering #{state} server hardware '#{@data['name']}'. Current state: '#{@data['powerState']}'"
+
+        action = 'PressAndHold' if force
+        action ||= case @data['powerState'].downcase
+                   when 'poweringon', 'poweringoff' # Wait
+                     sleep 5
+                     return set_power_state(state, force)
+                   when 'resetting'
+                     if state == 'on' # Wait
+                       sleep 5
+                       return set_power_state(state, force)
+                     end
+                     'PressAndHold'
+                   when 'unknown' then state == 'on' ? 'ColdBoot' : 'PressAndHold'
+                   else 'MomentaryPress'
+                   end
+        options = { 'body' => { powerState: state.capitalize, powerControl: action } }
+        response = @client.rest_put("#{@data['uri']}/powerState", options)
+        body = @client.response_handler(response)
+        set_all(body)
+        true
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api200/server_hardware_type.rb

@@ -0,0 +1,61 @@
+# (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 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_relative 'resource'
+
+module OneviewSDK
+  module API200
+    # Server hardware type resource implementation
+    class ServerHardwareType < Resource
+      BASE_URI = '/rest/server-hardware-types'.freeze
+
+      # Remove resource from OneView
+      # @return [true] if resource was removed successfully
+      alias remove delete
+
+      # Create a resource object, associate it with a client, and set its properties.
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash] params The options for this resource (key-value pairs)
+      # @param [Integer] api_ver The api version to use when interracting with this resource.
+      def initialize(client, params = {}, api_ver = nil)
+        super
+        # Default values
+        @data['type'] ||= 'server-hardware-type-4'
+      end
+
+      # Method is not available
+      # @raise [OneviewSDK::MethodUnavailable] method is not available
+      def create
+        unavailable_method
+      end
+
+      # Method is not available
+      # @raise [OneviewSDK::MethodUnavailable] method is not available
+      def delete
+        unavailable_method
+      end
+
+      # Update resource attributes
+      # @param [Hash] attributes attributes to be updated
+      # @option attributes [String] :name server hardware type name
+      # @option attributes [String] :description server hardware type description
+      # @return [OneviewSDK::ServerHardwareType] self
+      def update(attributes = {})
+        set_all(attributes)
+        ensure_client && ensure_uri
+        data = @data.select { |k, _v| %w(name description).include?(k) }
+        response = @client.rest_put(@data['uri'], { 'body' => data }, @api_version)
+        @client.response_handler(response)
+        self
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api200/server_profile.rb

@@ -0,0 +1,385 @@
+# (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 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_relative 'resource'
+
+module OneviewSDK
+  module API200
+    # Server profile resource implementation
+    class ServerProfile < Resource
+      BASE_URI = '/rest/server-profiles'.freeze
+      UNIQUE_IDENTIFIERS = %w(name uri associatedServer serialNumber serverHardwareUri).freeze
+
+      def initialize(client, params = {}, api_ver = nil)
+        super
+        # Default values
+        @data['type'] ||= 'ServerProfileV5'
+      end
+
+      # Sets the Server Hardware for the resource
+      # @param [OneviewSDK::ServerHardware] server_hardware Server Hardware resource
+      def set_server_hardware(server_hardware)
+        self['serverHardwareUri'] = server_hardware['uri'] if server_hardware['uri'] || server_hardware.retrieve!
+        raise "Resource #{server_hardware['name']} could not be found!" unless server_hardware['uri']
+      end
+
+      # Sets the Server Hardware Type for the resource
+      # @param [OneviewSDK::ServerHardwareType] server_hardware_type Type of the desired Server Hardware
+      def set_server_hardware_type(server_hardware_type)
+        self['serverHardwareTypeUri'] = server_hardware_type['uri'] if server_hardware_type['uri'] || server_hardware_type.retrieve!
+        raise "Resource #{server_hardware_type['name']} could not be found!" unless server_hardware_type['uri']
+      end
+
+      # Sets the Enclosure Group for the resource
+      # @param [OneviewSDK::EnclosureGroup] enclosure_group Enclosure Group that the Server is a member
+      def set_enclosure_group(enclosure_group)
+        self['enclosureGroupUri'] = enclosure_group['uri'] if enclosure_group['uri'] || enclosure_group.retrieve!
+        raise "Resource #{enclosure_group['name']} could not be found!" unless enclosure_group['uri']
+      end
+
+      # Sets the Enclosure Group for the resource
+      # @param [OneviewSDK::Enclosure] enclosure Enclosure that the Server is a member
+      def set_enclosure(enclosure)
+        self['enclosureUri'] = enclosure['uri'] if enclosure['uri'] || enclosure.retrieve!
+        raise "Resource #{enclosure['name']} could not be found!" unless enclosure['uri']
+      end
+
+      # Gets the preview of manual and automatic updates required to make the server profile consistent with its template.
+      # @return [Hash] Hash containing the required information
+      def get_compliance_preview
+        ensure_client & ensure_uri
+        response = @client.rest_get("#{self['uri']}/compliance-preview")
+        @client.response_handler(response)
+      end
+
+      # Retrieves the error or status messages associated with the specified profile.
+      # @return [Hash] Hash containing the required information
+      def get_messages
+        ensure_client & ensure_uri
+        response = @client.rest_get("#{self['uri']}/messages")
+        @client.response_handler(response)
+      end
+
+      # Transforms an existing profile by supplying a new server hardware type and/or enclosure group.
+      #   A profile will be returned with a new configuration based on the capabilities of the supplied
+      #   server hardware type and/or enclosure group. All deployed connections will have their port assignment
+      #   set to 'Auto'. Re-selection of the server hardware may also be required. The new profile can subsequently
+      #   be used for the PUT https://{appl}/rest/server- profiles/{id} API but is not guaranteed to pass
+      #   validation. Any incompatibilities will be flagged when the transformed server profile is submitted.
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [OneviewSDK::ServerHardware] 'server_hardware' The server hardware associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      # @return [Hash] Hash containing the required information
+      def get_transformation(query = nil)
+        ensure_client & ensure_uri
+        query_uri = OneviewSDK::Resource.build_query(query) if query
+        response = @client.rest_get("#{self['uri']}/transformation#{query_uri}")
+        @client.response_handler(response)
+      end
+
+      # Updates the server profile from the server profile template.
+      def update_from_template
+        ensure_client & ensure_uri
+        patch_operation = { 'op' => 'replace', 'path' => '/templateCompliance', 'value' => 'Compliant' }
+        patch_options = {
+          'If-Match' => self['eTag'],
+          'body' => [patch_operation]
+        }
+        response = @client.rest_patch(self['uri'], patch_options)
+        @client.response_handler(response)
+      end
+
+      # @!group Helpers
+
+      # Gets attached ServerHardware for the profile
+      # @return [OneviewSDK::ServerHardware] if hardware is attached
+      # @return [nil] if no hardware is attached
+      def get_server_hardware
+        return nil unless self['serverHardwareUri']
+        sh = OneviewSDK::ServerHardware.new(@client, uri: self['serverHardwareUri'])
+        sh.retrieve!
+        sh
+      end
+
+      # Gets all the available Ethernet and FC Networks, and Network Sets
+      # @return [Hash]
+      #   A hash containing the lists of Ethernet Networks and FC Networks
+      def get_available_networks
+        query = { enclosure_group_uri: @data['enclosureGroupUri'], server_hardware_type_uri: @data['serverHardwareTypeUri'] }
+        self.class.get_available_networks(@client, query)
+      end
+
+      # Gets available server hardware
+      # @return [Array<OneviewSDK::ServerHardware>] Array of ServerHardware resources that matches this
+      #   profile's server hardware type and enclosure group and who's state is 'NoProfileApplied'
+      def get_available_hardware
+        ensure_client
+        raise IncompleteResource, 'Must set @data[\'serverHardwareTypeUri\']' unless @data['serverHardwareTypeUri']
+        raise IncompleteResource, 'Must set @data[\'enclosureGroupUri\']' unless @data['enclosureGroupUri']
+        params = {
+          state: 'NoProfileApplied',
+          serverHardwareTypeUri: @data['serverHardwareTypeUri'],
+          serverGroupUri: @data['enclosureGroupUri']
+        }
+        OneviewSDK::ServerHardware.find_by(@client, params)
+      rescue StandardError => e
+        raise IncompleteResource, "Failed to get available hardware. Message: #{e.message}"
+      end
+
+      # Adds a connection entry to Server profile template
+      # @param [OneviewSDK::EthernetNetwork,OneviewSDK::FCNetwork] network Network associated with the connection
+      # @param [Hash<String,String>] connection_options Hash containing the configuration of the connection
+      # @option connection_options [Integer] 'allocatedMbps' The transmit throughput (mbps) currently allocated to
+      #   this connection. When Fibre Channel connections are set to Auto for requested bandwidth, the value can be set to -2000
+      #   to indicate that the actual value is unknown until OneView is able to negotiate the actual speed.
+      # @option connection_options [Integer] 'allocatedVFs' The number of virtual functions allocated to this connection. This value will be null.
+      # @option connection_options [Hash] 'boot' indicates that the server will attempt to boot from this connection.
+      #   This object can only be specified if "boot.manageBoot" is set to 'true'
+      # @option connection_options [String] 'deploymentStatus' The deployment status of the connection.
+      #   The value can be 'Undefined', 'Reserved', or 'Deployed'.
+      # @option connection_options [String] 'functionType' Type of function required for the connection.
+      #   functionType cannot be modified after the connection is created.
+      # @option connection_options [String] 'mac' The MAC address that is currently programmed on the FlexNic.
+      # @option connection_options [String] 'macType' Specifies the type of MAC address to be programmed into the IO Devices.
+      #   The value can be 'Virtual', 'Physical' or 'UserDefined'.
+      # @option connection_options [String] 'maximumMbps' Maximum transmit throughput (mbps) allowed on this connection.
+      #   The value is limited by the maximum throughput of the network link and maximumBandwidth of the selected network (networkUri).
+      #   For Fibre Channel connections, the value is limited to the same value as the allocatedMbps.
+      # @option connection_options [String] 'name' A string used to identify the respective connection.
+      #   The connection name is case insensitive, limited to 63 characters and must be unique within the profile.
+      # @option connection_options [String] 'portId' Identifies the port (FlexNIC) used for this connection.
+      # @option connection_options [String] 'requestedMbps' The transmit throughput (mbps) that should be allocated to this connection.
+      # @option connection_options [String] 'requestedVFs' This value can be "Auto" or 0.
+      # @option connection_options [String] 'wwnn' The node WWN address that is currently programmed on the FlexNic.
+      # @option connection_options [String] 'wwpn' The port WWN address that is currently programmed on the FlexNic.
+      # @option connection_options [String] 'wwpnType' Specifies the type of WWN address to be porgrammed on the FlexNIC.
+      #   The value can be 'Virtual', 'Physical' or 'UserDefined'.
+      def add_connection(network, connection_options = {})
+        self['connections'] = [] unless self['connections']
+        connection_options['id'] = 0 # Letting OneView treat the ID registering
+        connection_options['networkUri'] = network['uri'] if network['uri'] || network.retrieve!
+        self['connections'] << connection_options
+      end
+
+      # Removes a connection entry in Server profile template
+      # @param [String] connection_name Name of the connection
+      # @return Returns the connection hash if found, otherwise returns nil
+      def remove_connection(connection_name)
+        desired_connection = nil
+        return desired_connection unless self['connections']
+        self['connections'].each do |con|
+          desired_connection = self['connections'].delete(con) if con['name'] == connection_name
+        end
+        desired_connection
+      end
+
+      # Adds volume attachment entry with associated Volume in Server profile
+      # @param [OneviewSDK::Volume] volume Volume Resource to add an attachment
+      # @param [Hash] attachment_options Options of the new attachment
+      # @option attachment_options [Fixnum] 'id' The ID of the attached storage volume. Do not use it if you want it to be created automatically.
+      # @option attachment_options [String] 'lun' The logical unit number.
+      # @option attachment_options [String] 'lunType' The logical unit number type: Auto or Manual.
+      # @option attachment_options [Boolean] 'permanent' Required. If true, indicates that the volume will persist when the profile is deleted.
+      #   If false, then the volume will be deleted when the profile is deleted.
+      # @option attachment_options [Array] 'storagePaths' A list of host-to-target path associations.
+      # @return Returns the connection hash if found, otherwise returns nil
+      def add_volume_attachment(volume, attachment_options = {})
+        self['sanStorage'] ||= {}
+        self['sanStorage']['volumeAttachments'] ||= []
+        attachment_options['id'] ||= 0
+
+        volume.retrieve! unless volume['uri'] || volume['storagePoolUri'] || volume['storageSystemUri']
+        attachment_options['volumeUri'] = volume['uri']
+        attachment_options['volumeStoragePoolUri'] = volume['storagePoolUri']
+        attachment_options['volumeStorageSystemUri'] = volume['storageSystemUri']
+
+        self['sanStorage']['volumeAttachments'] << attachment_options
+      end
+
+      # Adds volume attachment entry and creates a new Volume associated in the Server profile
+      # @param [OneviewSDK::Volume] volume Volume Resource to add an attachment
+      # @param [Hash] volume_options Options to create a new Volume.
+      #   Please refer to OneviewSDK::Volume documentation for the data necessary to create a new Volume.
+      # @param [Hash] attachment_options Options of the new attachment
+      # @option attachment_options [Fixnum] 'id' The ID of the attached storage volume. Do not use it if you want it to be created automatically.
+      # @option attachment_options [String] 'lun' The logical unit number.
+      # @option attachment_options [String] 'lunType' The logical unit number type: Auto or Manual.
+      # @option attachment_options [Boolean] 'permanent' Required. If true, indicates that the volume will persist when the profile is deleted.
+      #   If false, then the volume will be deleted when the profile is deleted.
+      # @option attachment_options [Array] 'storagePaths' A list of host-to-target path associations.
+      # @return Returns the connection hash if found, otherwise returns nil
+      def create_volume_with_attachment(storage_pool, volume_options, attachment_options = {})
+        self['sanStorage'] ||= {}
+        self['sanStorage']['volumeAttachments'] ||= []
+        attachment_options['id'] ||= 0
+        # Removing provisioningParameters and adding them to the top level hash
+        provision_param = volume_options.delete('provisioningParameters') || volume_options.delete(:provisioningParameters)
+        provision_param.each do |k, v|
+          volume_options[k] = v
+        end
+        # Each provisioningParameter has the prefix 'volume' attached to its name in the original options
+        # Also, it needs to respect the lower camel case
+        volume_options.each do |k, v|
+          attachment_options["volume#{k.to_s[0].capitalize}#{k.to_s[1, k.to_s.length - 1]}"] = v
+        end
+
+        attachment_options['volumeStoragePoolUri'] = storage_pool['uri'] if storage_pool['uri'] || storage_pool.retrieve!
+
+        # Since the volume is being created in this method, it needs to be nil
+        attachment_options['volumeUri'] = nil
+        attachment_options['volumeStorageSystemUri'] = nil
+
+        # volumeProvisionedCapacityBytes is not following the same pattern in Volume
+        attachment_options['volumeProvisionedCapacityBytes'] ||= attachment_options.delete('volumeRequestedCapacity')
+
+        # Defaults
+        attachment_options['permanent'] ||= true
+        attachment_options['lunType'] ||= 'Auto'
+        attachment_options['lun'] ||= nil
+        attachment_options['storagePaths'] ||= []
+
+        self['sanStorage']['volumeAttachments'] << attachment_options
+      end
+
+      # Removes a volume attachment entry in the Server profile
+      # @param [Fixnum] id ID number of the attachment entry
+      # @return Returns the volume hash if found, otherwise returns nil
+      def remove_volume_attachment(id)
+        self['sanStorage'] ||= {}
+        self['sanStorage']['volumeAttachments'] ||= []
+        return if self['sanStorage'].empty? || self['sanStorage']['volumeAttachments'].empty?
+
+        volume_attachment = nil
+        self['sanStorage']['volumeAttachments'].each do |entry|
+          volume_attachment = self['sanStorage']['volumeAttachments'].delete(entry) if entry['id'] == id
+        end
+        volume_attachment
+      end
+
+      # Sets the Firmware Driver for the server profile
+      # @param [OneviewSDK::FirmwareDriver] firmware Firmware Driver to be associated with the resource
+      # @param [Hash<String,Object>] firmware_options Firmware Driver options
+      # @option firmware_options [Boolean] 'manageFirmware' Indicates that the server firmware is configured using the server profile.
+      #   Value can be 'true' or 'false'.
+      # @option firmware_options [Boolean] 'forceInstallFirmware' Force installation of firmware even if same or newer version is installed.
+      #   Downgrading the firmware can result in the installation of unsupported firmware and cause server hardware to cease operation.
+      #   Value can be 'true' or 'false'.
+      # @option firmware_options [String] 'firmwareInstallType' Specifies the way a Service Pack for ProLiant (SPP) is installed.
+      #   This field is used if the 'manageFirmware' field is true.
+      #   Values are 'FirmwareAndOSDrivers', 'FirmwareOnly', and 'FirmwareOnlyOfflineMode'.
+      def set_firmware_driver(firmware, firmware_options = {})
+        firmware_options['firmwareBaselineUri'] = firmware['uri'] if firmware['uri'] || firmware.retrieve!
+        self['firmware'] = firmware_options
+      end
+
+      # @!endgroup
+
+      # Gets all the available ethernet and fc networks, and network sets
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [String] 'function_type' The FunctionType (Ethernet or FibreChannel) to filter the list of networks returned
+      # @option query [OneviewSDK::ServerHardware] 'server_hardware' The server hardware associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      # @option query [String] 'view' Name of a predefined view to return a specific subset of the attributes of the resource or collection
+      # @return [Hash]
+      #   A hash containing the lists of Ethernet and FC Networks, and Network Sets
+      #   Options:
+      #     * [String] 'ethernetNetworks' The list of Ethernet Networks
+      #     * [String] 'fcNetworks' The list of FC Networks
+      #     * [String] 'networkSets' The list of Networks Sets
+      def self.get_available_networks(client, query)
+        query_uri = build_query(query) if query
+        response = client.rest_get("#{BASE_URI}/available-networks#{query_uri}")
+        body = client.response_handler(response)
+        body.select { |k, _v| %w(ethernetNetworks networkSets fcNetworks).include?(k) }
+      end
+
+      # Gets the available servers based on the query parameters
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [OneviewSDK::ServerProfile] 'server_profile' The server profile associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      # @return [Hash] Hash containing all the available server information
+      def self.get_available_servers(client, query = nil)
+        if query
+          query_uri = build_query(query)
+          # profileUri attribute is not following the standards in OneView
+          query_uri.sub!('serverProfileUri', 'profileUri')
+        end
+        response = client.rest_get("#{BASE_URI}/available-servers#{query_uri}")
+        client.response_handler(response)
+      end
+
+      # Gets the available storage systems based on the query parameters
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      # @option query [OneviewSDK::StorageSystem] 'storage_system' The Storage System the resources are associated with
+      def self.get_available_storage_system(client, query = nil)
+        # For storage_system the query requires the ID instead the URI
+        if query && query['storage_system']
+          query['storage_system'].retrieve! unless query['storage_system']['uri']
+          query['storage_system_id'] = query['storage_system']['uri'].split('/').last
+          query.delete('storage_system')
+        end
+        query_uri = build_query(query) if query
+        response = client.rest_get("#{BASE_URI}/available-storage-system#{query_uri}")
+        client.response_handler(response)
+      end
+
+      # Gets the available storage systems based on the query parameters
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' The enclosure group associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      # @option query [Array<String>] 'filter' A general filter/query string to narrow the list of items returned.
+      #   The default is no filter - all resources are returned.
+      # @option query [Integer] 'start' The first item to return, using 0-based indexing.
+      #   If not specified, the default is 0 - start with the first available item.
+      # @option query [Integer] 'count' The sort order of the returned data set.
+      #   By default, the sort order is based on create time, with the oldest entry first.
+      # @option query [String] 'sort' The number of resources to return. A count of -1 requests all the items.
+      def self.get_available_storage_systems(client, query = nil)
+        query_uri = build_query(query) if query
+        response = client.rest_get("#{BASE_URI}/available-storage-systems#{query_uri}")
+        client.response_handler(response)
+      end
+
+      # Get the available targets based on the query parameters
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [OneviewSDK::ServerProfile] 'server_profile' The server profile associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      def self.get_available_targets(client, query = nil)
+        query_uri = build_query(query) if query
+        response = client.rest_get("#{BASE_URI}/available-targets#{query_uri}")
+        client.response_handler(response)
+      end
+
+      # Gets all the available ethernet and fc networks
+      # @param [OneviewSDK::Client] client The client object for the OneView appliance
+      # @param [Hash<String,Object>] query Query parameters
+      # @option query [OneviewSDK::EnclosureGroup] 'enclosure_group' Enclosure Group associated with the resource
+      # @option query [OneviewSDK::ServerHardware] 'server_hardware' The server hardware associated with the resource
+      # @option query [OneviewSDK::ServerHardwareType] 'server_hardware_type' The server hardware type associated with the resource
+      def self.get_profile_ports(client, query = nil)
+        query_uri = build_query(query) if query
+        response = client.rest_get("#{BASE_URI}/profile-ports#{query_uri}")
+        client.response_handler(response)
+      end
+    end
+  end
+end