test-oneview 5.18.0

data/lib/oneview-sdk/resource/api500/c7000/server_profile_template.rb

@@ -0,0 +1,108 @@
+# (C) Copyright 2017 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 '../../api300/c7000/server_profile_template'
+
+module OneviewSDK
+  module API500
+    module C7000
+      # Server Profile Template resource implementation on API500 C7000
+      class ServerProfileTemplate < OneviewSDK::API300::C7000::ServerProfileTemplate
+
+        # 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)
+          @data ||= {}
+          # Default values
+          @data['type'] ||= 'ServerProfileTemplateV3'
+          super
+        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 [Boolean] 'boot' Indicates that the server will attempt to boot from this connection.
+        # @option connection_options [String] 'functionType' Type of function required for the connection. Values: Ethernet, FibreChannel, iSCSI.
+        # @option connection_options [Integer] 'id' A unique identifier for this connection. If 0, id is automatically assigned.
+        # @option connection_options [String] 'ipv4' The IP information for a connection. This is only used for iSCSI connections.
+        # @option connection_options [String] 'name' Name of the connection.
+        # @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.
+        def add_connection(network, connection_options = {})
+          connection_options = Hash[connection_options.map { |k, v| [k.to_s, v] }]
+          self['connectionSettings'] = {} unless self['connectionSettings']
+          self['connectionSettings']['connections'] = [] unless self['connectionSettings']['connections']
+          self['connectionSettings']['manageConnections'] = true
+          connection_options['id'] ||= 0
+          connection_options['networkUri'] = network['uri'] if network['uri'] || network.retrieve!
+          self['connectionSettings']['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['connectionSettings']['connections']
+          self['connectionSettings']['connections'].each do |con|
+            desired_connection = self['connectionSettings']['connections'].delete(con) if con['name'] == connection_name
+          end
+          desired_connection
+        end
+
+        # Adds a volume attachment entry with new volume in Server profile template
+        # @param [OneviewSDK::storage_pool] storage_pool Storage Pool Resource to add an attachment
+        # @param [Hash] volume_options Options to create a new Volume.
+        # @option volume_options [String] 'volumeName' The name of the volume.
+        # @option volume_options [String] 'volumeDescription' The description of the storage volume.
+        # @option volume_options [String] 'volumeProvisionType' The provisioning type of the new volume: Thin", "Full", or "Thin Deduplication".
+        # @option volume_options [Integer] 'volumeProvisionedCapacityBytes' The requested provisioned capacity of the storage volume in bytes.
+        # @param [Hash] attachment_options Options of the new attachment
+        # @option attachment_options [String] 'associatedTemplateAttachmentId' Uniquely identifying of a volume attachment in a template.
+        # @option attachment_options [String] 'dataProtectionLevel' Values specific to a StoreVirtual storage.
+        # @option attachment_options [Integer] 'id' The ID of the storage volume attachment.
+        # @option attachment_options [Boolean] 'isBootVolume' Identifies whether the volume will be used as a boot volume.
+        # @option attachment_options [String] 'lun' Logical Unit Number.
+        # @option attachment_options [String] 'lunType' Type of the LUN. Values: Manual or Auto.
+        # @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 = {})
+          raise IncompleteResource, 'Storage Pool not found!' unless storage_pool.retrieve!
+          # Convert symbols keys to string in volume_options and attachment_options
+          volume_options = Hash[volume_options.map { |k, v| [k.to_s, v] }]
+          attachment_options = Hash[attachment_options.map { |k, v| [k.to_s, v] }]
+
+          self['sanStorage'] ||= {}
+          self['sanStorage']['volumeAttachments'] ||= []
+
+          attachment_options['id'] ||= 0
+          attachment_options['volumeStoragePoolUri'] = storage_pool['uri']
+          attachment_options['volumeStorageSystemUri'] = storage_pool['storageSystemUri']
+          attachment_options['volumeName'] = volume_options['name']
+          attachment_options['volumeDescription'] = volume_options['description']
+          attachment_options['volumeProvisionType'] = volume_options['provisioningType']
+          attachment_options['volumeProvisionedCapacityBytes'] = volume_options['size']
+
+          # Defaults
+          attachment_options['volumeUri'] = nil
+          attachment_options['permanent'] ||= true
+          attachment_options['volumeShareable'] = false
+          self['sanStorage']['manageSanStorage'] ||= true
+
+          self['sanStorage']['volumeAttachments'] << attachment_options
+        end
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api500/c7000/storage_pool.rb

@@ -0,0 +1,116 @@
+# (C) Copyright 2017 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 API500
+    module C7000
+      # Storage pool resource implementation for API500 C7000
+      class StoragePool < OneviewSDK::API500::C7000::Resource
+        BASE_URI = '/rest/storage-pools'.freeze
+        UNIQUE_IDENTIFIERS = %w[uri].freeze
+
+        # 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'] ||= 'StoragePoolV3'
+        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 create!(*)
+          unavailable_method
+        end
+
+        # Method is not available
+        # @raise [OneviewSDK::MethodUnavailable] method is not available
+        def delete(*)
+          unavailable_method
+        end
+
+        # Retrieve resource details based on this resource's name or URI.
+        # @note Name or URI must be specified inside the resource
+        # @return [Boolean] Whether or not retrieve was successful
+        def retrieve!
+          return super if @data['uri']
+          unless @data['name'] && @data['storageSystemUri']
+            raise IncompleteResource, 'Must set resource name and storageSystemUri, or uri, before trying to retrieve!'
+          end
+          results = self.class.find_by(@client, name: @data['name'], storageSystemUri: @data['storageSystemUri'])
+          if results.size == 1
+            set_all(results[0].data)
+            return true
+          end
+          false
+        end
+
+        # Check if a resource exists
+        # @note name or uri must be specified inside resource
+        # @return [Boolean] Whether or not resource exists
+        def exists?
+          temp = self.class.new(@client, data)
+          temp.retrieve!
+        end
+
+        # Gets the storage pools that are connected on the specified networks based on the storage system port's expected network connectivity.
+        # @param [OneviewSDK::Client] client The client object for the OneView appliance
+        # @param [Array<Resource>] networks The list of networks with URI to be used as a filter
+        # @return [Array<OneviewSDK::StoragePool>] the list of storage pools
+        def self.reachable(client, networks = [])
+          uri = self::BASE_URI + '/reachable-storage-pools'
+          unless networks.empty?
+            network_uris = networks.map { |item| item['uri'] }
+            uri += "?networks='#{network_uris.join(',')}'"
+          end
+          find_with_pagination(client, uri)
+        end
+
+        # To manage/unmanage a storage pool
+        # @param [Boolean] be_managed Set true to manage or false to unmanage
+        # @note Storage Pool that belongs to Storage System with family StoreVirtual can't be changed to unmanaged
+        def manage(be_managed)
+          if !be_managed && self['family'] == 'StoreVirtual'
+            raise ArgumentError, 'Attempting to unmanage a StoreVirtual pool is not allowed'
+          end
+          self['isManaged'] = be_managed
+          update
+          refresh
+        end
+
+        # To request a refresh of a storage pool
+        def request_refresh
+          self['requestingRefresh'] = true
+          update
+          refresh
+        end
+
+        # Sets the storage system
+        # @param [OneviewSDK::StorageSystem] storage_system
+        # @raise [OneviewSDK::IncompleteResource] if Storage System not found
+        def set_storage_system(storage_system)
+          raise 'Storage System could not be found!' unless storage_system.retrieve!
+          set('storageSystemUri', storage_system['uri'])
+        end
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api500/c7000/storage_system.rb

@@ -0,0 +1,154 @@
+# (C) Copyright 2017 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 '../../api300/c7000/storage_system'
+
+module OneviewSDK
+  module API500
+    module C7000
+      # Storage System resource implementation for API500 C7000
+      class StorageSystem < OneviewSDK::API300::C7000::StorageSystem
+        # deviceSpecificAttributes['serialNumber'] and deviceSpecificAttributes['wwn'] are supported too
+        UNIQUE_IDENTIFIERS = %w[name uri hostname].freeze
+
+        # 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)
+          # Default values:
+          @data ||= {}
+          @data['type'] ||= 'StorageSystemV4'
+          super
+        end
+
+        # Method is unavailable
+        # @raise [OneviewSDK::MethodUnavailable] method is not available
+        def get_managed_ports(*)
+          unavailable_method
+        end
+
+        # Method is unavailable
+        # @raise [OneviewSDK::MethodUnavailable] method is not available
+        def set_refresh_state(*)
+          unavailable_method
+        end
+
+        # Adds the resource to OneView using the current data
+        # @note Calls the refresh method to set additional data
+        # @return [OneviewSDK::StorageSystem] self
+        def add
+          ensure_client
+          temp_old_data = JSON.parse(@data.to_json)
+          credentials = temp_old_data['credentials'] || {}
+          request_body = {
+            'family'   => @data['family'],
+            'hostname' => @data['hostname'],
+            'username' => @data.delete('username') || credentials['username'],
+            'password' => @data.delete('password') || credentials['password']
+          }
+          response = @client.rest_post(self.class::BASE_URI, { 'body' => request_body }, @api_version)
+          response_body = @client.response_handler(response)
+          set_all(response_body)
+
+          managed_domain = temp_old_data['deviceSpecificAttributes']['managedDomain'] rescue nil
+          if self['family'] == 'StoreServ' && managed_domain
+            deep_merge!(temp_old_data)
+            update
+          end
+          self
+        end
+
+        # Set data and save to OneView
+        # @param [Hash] attributes The attributes to add/change for this resource (key-value pairs)
+        # @raise [OneviewSDK::IncompleteResource] if the client or uri is not set
+        # @raise [StandardError] if the resource save fails
+        # @return [Resource] self
+        def update(attributes = {})
+          set_all(attributes)
+          ensure_client && ensure_uri
+          response = @client.rest_put(@data['uri'] + '/?force=true', { 'body' => @data }, @api_version)
+          @client.response_handler(response)
+          self
+        end
+
+        # Delete resource from OneView
+        # @return [true] if resource was deleted successfully
+        def remove
+          ensure_client && ensure_uri
+          response = @client.rest_delete(@data['uri'], { 'If-Match' => @data['eTag'] }, @api_version)
+          @client.response_handler(response)
+          true
+        end
+
+        # Checks if the resource already exists
+        # @return [Boolean] Whether or not resource exists
+        # @raise [OneviewSDK::IncompleteResource] if required attributes are not filled
+        def exists?
+          temp_item = self.class.new(@client, @data.clone)
+          temp_item.retrieve!
+        end
+
+        # Retrieves the resource details based on this resource's unique identifiers
+        # @note one of the UNIQUE_IDENTIFIERS, deviceSpecificAttributes['serialNumber'] or deviceSpecificAttributes['wwn']
+        #     must be specified in the resource
+        # @return [Boolean] Whether or not retrieve was successful
+        # @raise [OneviewSDK::IncompleteResource] if required attributes are not filled
+        def retrieve!
+          data_temp = JSON.parse(@data.to_json)
+          serial_number = data_temp['deviceSpecificAttributes']['serialNumber'] rescue nil
+          wwn = data_temp['deviceSpecificAttributes']['wwn'] rescue nil
+
+          proc_retrieve_temp = proc do |identifier|
+            results = self.class.find_by(@client, identifier)
+            if results.size == 1
+              set_all(results.first.data)
+              return true
+            end
+          end
+          proc_retrieve_temp.call('deviceSpecificAttributes' => { 'serialNumber' => serial_number }) if serial_number
+          proc_retrieve_temp.call('deviceSpecificAttributes' => { 'wwn' => wwn }) if wwn
+
+          super
+        rescue IncompleteResource => e
+          raise e unless serial_number || wwn
+          false
+        end
+
+        # Gets the storage ports that are connected on the specified networks based on the storage system port's expected network connectivity
+        # @param [Array] network Array of networks
+        # @return [Array] Array of reachable storage port
+        def get_reachable_ports(networks = [])
+          ensure_client && ensure_uri
+          uri = @data['uri'] + '/reachable-ports'
+          unless networks.empty?
+            network_uris = ensure_and_get_uris(networks)
+            uri += "?networks='#{network_uris.join(',')}'"
+          end
+          self.class.find_with_pagination(@client, uri)
+        end
+
+        # Gets a list of storage templates.
+        # @return [Array] Array of Storage Template
+        def get_templates
+          ensure_client && ensure_uri
+          self.class.find_with_pagination(@client, @data['uri'] + '/templates')
+        end
+
+        # Refreshes a storage system
+        def request_refresh
+          @data['requestingRefresh'] = true
+          update
+        end
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api500/c7000/switch.rb

@@ -0,0 +1,29 @@
+# (C) Copyright 2017 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 '../../api300/c7000/switch'
+
+module OneviewSDK
+  module API500
+    module C7000
+      # Switch resource implementation for API 500 C7000
+      class Switch < OneviewSDK::API300::C7000::Switch
+
+        # Method is not available
+        # Use {#add_scope}, {#remove_scope}, and {#replace_scopes} instead.
+        # @raise [OneviewSDK::MethodUnavailable] method is not available
+        def set_scope_uris(*)
+          unavailable_method
+        end
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api500/c7000/unmanaged_device.rb

@@ -0,0 +1,22 @@
+# (C) Copyright 2017 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 '../../api300/c7000/unmanaged_device'
+
+module OneviewSDK
+  module API500
+    module C7000
+      # Unmanaged Device resource implementation for API500 C7000
+      class UnmanagedDevice < OneviewSDK::API300::C7000::UnmanagedDevice
+      end
+    end
+  end
+end

data/lib/oneview-sdk/resource/api500/c7000/uplink_set.rb

@@ -0,0 +1,22 @@
+# (C) Copyright 2017 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 '../../api300/c7000/uplink_set'
+
+module OneviewSDK
+  module API500
+    module C7000
+      # Uplink set resource implementation for API500 C7000
+      class UplinkSet < OneviewSDK::API300::C7000::UplinkSet
+      end
+    end
+  end
+end