vipruby 0.1.4 → 0.1.6.1

data/lib/vipruby/objects/host.rb

@@ -0,0 +1,234 @@
+require 'rest-client'
+require 'json'
+
+# The Following Host calls will get Host information for all tenants
+module ViprHost
+
+    # generate JSON for Host POST
+    #
+    # @param host_type [String] Type of Host. Required Param.
+    # @param ip_or_dns [String] IP Address or FQDN of the host to add. Required Param.
+    # @param name [String] Arbitrary name given to the host. Required Param
+    # @param port [String] Port for connecting to the specfic host. Will be autogenerated if not specified by the {#add_host} method
+    # @param user_name [String] User Name to connect to this host. 
+    # @param password [String] Password for the Username to connect to this host. 
+    # @param use_ssl [String] True or False
+    # @param discoverable [String] True or False for searching initators after being added.
+    #
+    # @return [JSON] The JSON object for the POST operation
+    def generate_host_post_json(host_type, ip_or_dns, name, port, user_name, password, use_ssl, discoverable)
+        payload = {
+            type: host_type,
+            host_name: ip_or_dns,
+            name: name,
+            port_number: port,
+            user_name: user_name,
+            password: password,
+            use_ssl: use_ssl,
+            discoverable: discoverable
+        }.to_json
+
+        return payload
+    end
+      
+    # generate JSON for Initators POST
+    #
+    # @param protocol [String] Type of protocol. Required Param
+    # @param initiator_node [String] Node string. Required Param
+    # @param initiator_port [Array] Ports should be passed as an array. Every port will be added into another array for the entire JSON object
+    #
+    # @return [ARRAY] JSON objects will be put into an Array
+    def generate_initiators_json(protocol, initiator_node, initiator_port)
+        initiator_json = []
+        initiator_port.each do |initiator|
+            initiator_json << 
+            {
+                protocol: protocol,
+                initiator_node: initiator_node,
+                initiator_port: initiator
+            }.to_json
+        end
+        return initiator_json
+    end
+
+    # Add a host to ViPR
+    #
+    # @param host_type [String] Type of Host. "Windows", "Linux", or, "HPUX". Required Param
+    # @param ip_or_dns [String] IP Address or FQDN of host. Required Param
+    # @param name [String] Arbitrary Name only necesary and identifiable by ViPR. Required Param.
+    # @param user_name [String] User Name to connect to the host. Required Param
+    # @param password [String] Password for the User Name to connect to the host. Required Param
+    # @param port [String] Port to connect to the host. Optional Param. Defaults will be used if no param is passed
+    # @param use_ssl [String] Whether SSL is used. Trur or False. Optional Param
+    # @param discoverable [String] True or False. Initators and Nodes will be discovered after being added. By default this is true
+    #
+    # @return [JSON] returns host information
+    #
+    # @example
+    #   vipr.add_host('Windows', 'windowshost.mydomain.org', 'WindowsHOST' 'DOMAIN\user', 'userpw')
+    #   vipr.add_host('Windows', 'windowshost.mydomain.org', 'WindowsHOST' 'DOMAIN\user', 'userpw', '453', 'true', 'true')
+    #   vipr.add_host('Linux', 'linuxhost.mydomain.org', 'LinuxHOST' 'DOMAIN\user', 'userpw')
+    def add_host(host_type=nil, ip_or_dns=nil, name=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, discoverable=nil, auth=nil, cert=nil)
+        check_host_post(host_type, ip_or_dns, name, user_name, password)
+        host_type = host_type.split('_').collect(&:capitalize).join
+
+        if host_type == "Windows" 
+            use_ssl.nil? ? use_ssl = false : use_ssl
+            if use_ssl == true
+                port.nil? ? port = '5986' : port
+            else
+                port.nil? ? port = '5985' : port
+            end
+            discoverable.nil? ? discoverable = true : discoverable
+            user_name.nil? ? user_name = "admin" : user_name
+            password.nil? ? password = "#1Password" : password
+        elsif host_type == "Linux"
+            use_ssl.nil? ? use_ssl = false : use_ssl
+            port.nil? ? port = '22' : port = port
+            discoverable.nil? ? discoverable = true : discoverable
+            user_name.nil? ? user_name = "admin" : user_name
+            password.nil? ? password = "#1Password" : password
+        elsif host_type == "Hpux"
+            host_type = "HPUX"
+        end
+        rest_post(generate_host_post_json(host_type, ip_or_dns, name, port, user_name, password, use_ssl, discoverable), "#{@base_url}/tenants/#{@tenant_uid}/hosts", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    # Add an initiator to a host in ViPR
+    #
+    # @param host_id [String] The Host UID. Required Param.
+    # @param protocol [String] The protocol type. iSCSI or FC. Required
+    # @param initiator_port [String] Initator Port as a string. Required
+    # @param initiator_node [Array] Initator Nodes must be passed in as strings in an array. Required.
+    #
+    # @example
+    #   x = vipr.get_all_hosts['id'][0]
+    #   vipr.add_host_initiator(x, 'FC', '10:13:27:65:60:38:68:BE', ['10:13:27:65:60:38:68:BD','10:13:27:65:60:38:68:BC'])
+    def add_host_initiator(host_id=nil, protocol=nil, initiator_port=nil, initiator_node=nil, auth=nil, cert=nil)
+        check_host_get(host_id)
+        check_host_post_initiator(protocol, initiator_port)
+
+        protocol = protocol.upcase
+        if protocol == "ISCSI"
+            protocol = "iSCSI"
+        end
+        initiator_payload_array = generate_initiators_json(protocol, initiator_node, initiator_port)
+        initiator_payload_array.each do |i|
+            rest_post(i, "#{@base_url}/compute/hosts/#{host_id}/initiators", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+        end
+    end
+  
+    # Get all Host objects in ViPR
+    #
+    # @return [JSON] returns a JSON collection of all hosts in ViPR for a particular tenant
+    # 
+    # @example
+    #    vipr.get_all_hosts
+    def get_all_hosts(auth=nil, cert=nil)
+        rest_get("#{@base_url}/tenants/#{@tenant_uid}/hosts", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+  
+    # Get an individual host's details in ViPR
+    #
+    # @param host_id [STRING] ID of host to get information. Required Param
+    #
+    # @return [Hash] the object converted into Hash format and can be parsed with object[0] or object['id'] notation
+    # 
+    # @example
+    #   x = vipr.get_all_hosts['id'][0]
+    #   vipr.get_host(x)
+    def get_host(host_id=nil, auth=nil, cert=nil)
+        check_host_get(host_id)
+        rest_get("#{@base_url}/compute/hosts/#{host_id}", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+  
+    # Deactive and Remove a Host from ViPR
+    #
+    # @param host_id [STRING] ID of host to get information. Required Param
+    #
+    # @return [JSON] returns information from POST for removing Host object
+    #
+    # @example
+    #   x = vipr.get_all_hosts['id'][0]
+    #   vipr.deactivate_host(x)
+    def deactivate_host(host_id=nil, auth=nil, cert=nil)
+        check_host_get(host_id)
+        rest_post(nil, "#{@base_url}/compute/hosts/#{host_id}/deactivate", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+  
+    # Determine if a host already exists in ViPR
+    #
+    # @param hostname [STRING] The name of the host to search for. Requires full name and not partials
+    #
+    # @return [BOOLEAN] returns TRUE/FALSE 
+    #
+    # @example
+    #   vipr.host_exists?('windowslab.mydomain.com')
+    def host_exists?(hostname, auth=nil, cert=nil)
+        hostname = hostname.downcase
+        host_array = []
+        hosts = get_all_hosts
+        hosts.each do |key, value|
+          value.each do |k|
+            host_array << k['name'].to_s.downcase
+          end
+        end
+       host_array.include?(hostname) 
+    end
+  
+    # Find and return query results for a host in ViPR
+    #
+    # @param search_param [STRING] Value to search host for. This will work with partials
+    #
+    # @return [JSON] returns search results
+    #
+    # @example
+    #   vipr.find_host_object('host1')
+    def find_host_object(search_param, auth=nil, cert=nil)
+      rest_get("#{@base_url}/compute/hosts/search?name=#{search_param}", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    private
+    # Error Handling method to check for Missing Host Post params. If the pass fails, an error exception is raised
+    #
+    # @param host_type [String] Requires the string of the host type. 
+    # @param ip_or_dns [String] Requires the string of the IP Address or FQDN. 
+    # @param name [String] Requires the string of the Arbitrary name for ViPR. 
+    # @param user_name [String] Requires the string of the User Name for access. 
+    # @param password [String] Requires the string of the Password of the User Name for access
+    #
+    # @return [Boolean] True if pass, false if it fails
+    #
+    # @private
+    def check_host_post(host_type, ip_or_dns, name, user_name, password)
+      if host_type == nil || ip_or_dns == nil || name == nil
+          raise "Missing a Required param (host_type, ip_or_dns, name)"
+      end
+    end
+
+    # Error Handling method to check for Missing Host ID param. If the pass fails, an error exception is raised
+    #
+    # @param host_id [String] Requires the string of the vcenter uid
+    # @return [Boolean] True if pass, false if it fails
+    #
+    # @private
+    def check_host_get(host_id)
+      if host_id == nil
+          raise "Missing the Required param (host_id). Find the host_id by using the get_all_hosts method."
+      end
+    end
+
+    # Error Handling method to check for Initiator params. If the pass fails, an error exception is raised
+    #
+    # @param protocol [String] Requires the string of the Port
+    # @param initiator_port [String] Requires the string of the initiator_port
+    # @return [Boolean] True if pass, false if it fails
+    #
+    # @private
+    def check_host_post_initiator(protocol, initiator_port)
+      if protocol== nil || initiator_port == nil
+          raise "Missing the Required param (protocol or initiator_port)."
+      end
+    end
+
+end

data/lib/vipruby/objects/storagesystem.rb

@@ -0,0 +1,278 @@
+require 'rest-client'
+require 'json'
+
+# The Following Storage System calls will add Storage Systems for all tenants. these commands can only be ran as the root/default tenant
+module ViprStorageSystem
+	# JSON Structure for creating the payload for Storage Providers
+	#
+	# @param name [String] Name of the Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+	# @param interface_type [String] Interface type of the Storage Provider. This generated automatically based on the method call for types of storage providers. This is a required string.
+	# @param ip_or_dns [String] IP Address or FQDN of the Storage Provider. This is a required string.
+  	# @param port [String] Port of the Storage Provider. This is a required string. This generated automatically based on the method call for types of storage providers. This is a required string. This can be modified based depending upon the storage system method call
+  	# @param user_name [String] User Name that will be used for authenticating against the Storage Provider. This is a required string. If a User Name is not provided, then 'admin' is used
+  	# @param password [String] Password for the user_name that will be used for authenticating against the Storage Provider. This is a required string. If a Password is not provided, then '#1Password' is used
+  	# @param use_ssl [Boolean] Specify true or false for communicating to the Storage Provider. This is a required string, and will default to false unless 'true' is specified
+  	# 
+  	# @return [JSON] The JSON structure for the post operation
+	def storage_provider_payload(name, interface_type, ip_or_dns, port, user_name, password, use_ssl)
+		payload = {
+	    	name: name,
+	    	interface_type: interface_type,
+	    	ip_address: ip_or_dns,
+	    	port_number: port,
+	    	user_name: user_name.nil? ? 'admin' : user_name,
+	    	password: password.nil? ? '#1Password' : password,
+	    	use_ssl: use_ssl.nil? ? false : use_ssl
+	    }.to_json
+
+	    return payload
+	end
+
+	# JSON Structure for creating the payload for Storage Providers
+	#
+	# @param name [String] Name of the Storage System. This name is arbitrary and only exists within ViPR. This is a required string.
+  	# @param system_type [String] Interface type of the Storage System. This generated automatically based on the method call for types of storage providers. This is a required string.
+  	# @param ip_or_dns [String] IP Address or FQDN of the Storage System. This is a required string.
+  	# @param port [String] Port of the Storage System. This is a required string. This generated automatically based on the method call for types of storage providers. This is a required string. This can be modified based depending upon the storage system method call
+  	# @param user_name [String] User Name that will be used for authenticating against the Storage System. This is a required string. If a User Name is not provided, then 'admin' is used
+  	# @param password [String] Password for the user_name that will be used for authenticating against the Storage System. This is a required string. If a Password is not provided, then '#1Password' is used
+  	# @param smis_provider_ip [String] IP Address or FQDN of the SMI-S Provider for the Storage System. This is a required string. Only used for {#add_emc_file} method
+  	# @param smis_port_number [String] Port Number of the SMI-S Provider for the Storage System. This is a required string, and will default to '5988' unless something else is specified. Only used for {#add_emc_file} method
+  	# @param smis_user_name [String] User Name that will be used for authenticating against the SMI-S Provider to the Storage System. This is a required string, and will default to 'admin' unless something else is specified. Only used for {#add_emc_file} method
+  	# @param smis_password [String] Password that will be used for authenticating against the SMI-S Provider to the Storage System. This is a required string, and will default to '#1Password' unless something else is specified. Only used for {#add_emc_file} method
+  	# @param smis_use_ssl [Boolean] Specify true or false for communicating to the Storage System. This is a required string, and will default to false unless true is passed. Only used for {#add_emc_file} method
+  	#
+  	# @return [JSON] The JSON structure for the post operation
+	def storage_system_payload(name, system_type, ip_or_dns, port, user_name, password, smis_provider_ip=nil, smis_port_number=nil, smis_user_name=nil, smis_password=nil, smis_use_ssl=nil)
+		if smis_provider_ip == nil
+			payload = {
+		    	name: name,
+		    	system_type: system_type,
+		    	ip_address: ip_or_dns,
+		    	port_number: port,
+		    	user_name: user_name.nil? ? 'admin' : user_name,
+		    	password: password.nil? ? '#1Password' : password,
+		    }.to_json
+	    else
+	    	payload = {
+	      		name: name,
+	      		system_type: system_type,
+	      		ip_address: ip_or_dns,
+	      		port_number: port,
+	      		user_name: user_name.nil? ? 'admin' : user_name,
+	      		password: password.nil? ? '#1Password' : password,
+	     		smis_provider_ip: smis_provider_ip,
+			    smis_port_number: smis_port_number.nil? ? '5988' : smis_port_number,
+			    smis_user_name: smis_user_name.nil? ? 'admin' : smis_user_name,
+			    smis_password: smis_password.nil? ? '#1Password' : smis_password,
+			    smis_use_ssl: smis_use_ssl.nil? ? false : smis_use_ssl
+			 }.to_json
+		end
+
+	    return payload
+	end
+
+	# Add EMC VMAX and VNX Block Storage System
+	# @note For supported versions, see the EMC ViPR Support Matrix on the EMC Community Network (community.emc.com)
+	#
+	# @param name [String] Name of the EMC Block Device. This name is arbitrary and only exists within ViPR. This is a required string.
+	# @param ip_or_dns [String] FQDN or IP Address of the EMC Block Device to add. This is a required string.
+	# @param user_name [String] User Name that will be used for authenticating against the EMC Block Device. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+	# @param password [String] Password that will be used for authenticating against the EMC Block Device. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+	# @param port [String] Port that will be used for communicating with the EMC Block Device. This is an optional string. If no parameter is passed, then '5989' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+	# @param use_ssl [String] SSL setting for communicating with the EMC Block Device. This is an optional string. If no parameter is passed, then 'false' is used.
+	#
+	# @return [Hash] The resulted post operation
+	#
+	# @example Add EMC VMAX and VNX Block Storage System
+	#   vipr.add_emc_block('vnx01', 'vnx01.mydomain.com')
+	#   vipr.add_emc_block('vnx02', 'vnx02.mydomain.com', 'sysadmin', 'sysadmin')
+	#   vipr.add_emc_block('vnx03', 'vnx03.mydomain.com', 'sysadmin', 'sysadmin', '8093', 'true')
+	def add_emc_block(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, auth=nil, cert=nil)
+		check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '5989' : port = port
+	    rest_post(storage_provider_payload(name, 'smis', ip_or_dns, port, user_name, password, use_ssl), "#{@base_url}/vdc/storage-providers", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+	end
+
+	# Add Hitachi Storage Systems
+	# @note For supported versions, see the EMC ViPR Support Matrix on the EMC Community Network (community.emc.com).
+	# 	Hitachi HiCommand Device Manager is required to use HDS storage with ViPR.
+	# 	You need to obtain the following information to configure and add the Hitachi HiCommand Device manager to ViPR:
+	# 	(1) A host or virtual machine for HiCommand Device manager setup
+	# 	(2) HiCommand Device Manager license, host address, credentials, and host port (default is 2001)
+	#
+	# @param name [String] Name of the Hitachi Device. This name is arbitrary and only exists within ViPR. This is a required string.
+	# @param ip_or_dns [String] FQDN or IP Address of the Hitachi Device to add. This is a required string.
+	# @param user_name [String] User Name that will be used for authenticating against the Hitachi Device. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+	# @param password [String] Password that will be used for authenticating against the Hitachi Device. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+	# @param port [String] Port that will be used for communicating with the Hitachi Device. This is an optional string. If no parameter is passed, then '2001' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+	# @param use_ssl [String] SSL setting for communicating with the Hitachi Device. This is an optional string. If no parameter is passed, then 'false' is used.
+	#
+	# @return [Hash] The resulted post operation
+	#
+	# @example Add Hitachi Storage System
+	#   vipr.add_hitachi('hitachi01', 'hitachi01.mydomain.com')
+	#   vipr.add_hitachi('hitachi02', 'hitachi02.mydomain.com', 'sysadmin', 'sysadmin')
+	#   vipr.add_hitachi('hitachi03', 'hitachi03.mydomain.com', 'sysadmin', 'sysadmin', '8093', 'true')
+    def add_hitachi(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, auth=nil, cert=nil)
+    	check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '2001' : port = port
+	    rest_post(storage_provider_payload(name, 'hicommand', ip_or_dns, port, user_name, password, use_ssl), "#{@base_url}/vdc/storage-providers", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+	# Add VPLEX Storage Systems
+	# @note ViPR supports VPLEX in a Local or Metro configuration. VPLEX Geo configurations are not supported. 
+	#
+	# @param name [String] Name of the VPLEX Device. This name is arbitrary and only exists within ViPR. This is a required string.
+	# @param ip_or_dns [String] FQDN or IP Address of the VPLEX Device to add. This is a required string.
+	# @param user_name [String] User Name that will be used for authenticating against the VPLEX Device. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+	# @param password [String] Password that will be used for authenticating against the VPLEX Device. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+	# @param port [String] Port that will be used for communicating with the VPLEX Device. This is an optional string. If no parameter is passed, then '443' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+	# @param use_ssl [String] SSL setting for communicating with the VPLEX Device. This is an optional string. If no parameter is passed, then 'false' is used.
+	#
+	# @return [Hash] The resulted post operation
+	#
+	# @example Add VPLEX Storage System
+	#   vipr.add_vplex('VPLEX01', 'VPLEX01.mydomain.com')
+	#   vipr.add_vplex('VPLEX02', 'VPLEX02.mydomain.com', 'sysadmin', 'sysadmin')
+	#   vipr.add_vplex('VPLEX03', 'VPLEX03.mydomain.com', 'sysadmin', 'sysadmin', '8093', 'true')
+    def add_vplex(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, auth=nil, cert=nil)
+        check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '443' : port = port
+	    rest_post(storage_provider_payload(name, 'vplex', ip_or_dns, port, user_name, password, use_ssl), "#{@base_url}/vdc/storage-providers", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+	# Add ScaleIO Storage Systems
+	# @note Supported versions: ScaleIO 1.21.0.20 or later. 
+	# 	Preconfiguration requirements:
+	# 	(1) Protection domains are defined.
+	# 	(2) All storage pools are defined. 
+	# 
+	# @param name [String] Name of the ScaleIO Storage System. This name is arbitrary and only exists within ViPR. This is a required string.
+	# @param ip_or_dns [String] FQDN or IP Address of the ScaleIO Storage System to add. This is a required string.
+	# @param user_name [String] User Name that will be used for authenticating against the ScaleIO Storage System. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+	# @param password [String] Password that will be used for authenticating against the ScaleIO Storage System. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+	# @param port [String] Port that will be used for communicating with the ScaleIO Storage System. This is an optional string. If no parameter is passed, then '22' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+	# @param use_ssl [String] SSL setting for communicating with the ScaleIO Storage System. This is an optional string. If no parameter is passed, then 'false' is used.
+	#
+	# @return [Hash] The resulted post operation
+	#
+	# @example Add ScaleIO Storage System
+	#   vipr.add_scaleio('scaleio01', 'scaleio01.mydomain.com')
+	#   vipr.add_scaleio('scaleio02', 'scaleio02.mydomain.com', 'sysadmin', 'sysadmin')
+	#   vipr.add_scaleio('scaleio03', 'scaleio03.mydomain.com', 'sysadmin', 'sysadmin', '8093', 'true')
+    def add_scaleio(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, auth=nil, cert=nil)
+        check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '22' : port = port
+	    rest_post(storage_provider_payload(name, 'scaleio', ip_or_dns, port, user_name, password, use_ssl), "#{@base_url}/vdc/storage-providers", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    # Add Third Party Block Storage Provider
+    # @note ViPR uses the OpenStack Block Storage (Cinder) Service to add third-party block storage systems to ViPR. 
+    # 	For supported versions, see the EMC ViPR Support Matrix available on the EMC Community Network (community.emc.com).
+    #
+    # @param name [String] Name of the Third Party Block Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+    # @param ip_or_dns [String] FQDN or IP Address of the Third Party Block Storage Provider to add. This is a required string.
+    # @param user_name [String] User Name that will be used for authenticating against the Third Party Block Storage Provider. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+    # @param password [String] Password that will be used for authenticating against the Third Party Block Storage Provider. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+    # @param port [String] Port that will be used for communicating with the Third Party Block Storage Provider. This is an optional string. If no parameter is passed, then '22' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+    # @param use_ssl [String] SSL setting for communicating with the Third Party Block Storage Provider. This is an optional string. If no parameter is passed, then 'false' is used.
+    #
+    # @return [Hash] The resulted post operation
+    #
+    # @example Add Third Party Block Storage Provider
+    #   vipr.add_third_party_block('cinder01', 'cinder01.mydomain.com')
+    #   vipr.add_third_party_block('cinder01', 'cinder01.mydomain.com', 'sysadmin', 'sysadmin')
+    #   vipr.add_third_party_block('cinder01', 'cinder01.mydomain.com', 'sysadmin', 'sysadmin', '8093', 'true')
+    def add_third_party_block(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, use_ssl=nil, auth=nil, cert=nil)
+        check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '22' : port = port
+	    rest_post(storage_provider_payload(name, 'cinder', ip_or_dns, port, user_name, password, use_ssl), "#{@base_url}/vdc/storage-providers", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    # Add Isilon Storage Provider
+    # @note Supported Protocol: NFS, CIFS (Snapshot restore is not supported for Isilon storage systems.).
+    # 	Port (default is 8080) 
+    #
+    # @param name [String] Name of the Isilon Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+    # @param ip_or_dns [String] FQDN or IP Address of the Isilon Storage Provider to add. This is a required string.
+    # @param user_name [String] User Name that will be used for authenticating against the Isilon Storage Provider. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+    # @param password [String] Password that will be used for authenticating against the Isilon Storage Provider. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+    # @param port [String] Port that will be used for communicating with the Isilon Storage Provider. This is an optional string. If no parameter is passed, then '8080' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+    #
+    # @return [Hash] The resulted post operation
+    #
+    # @example Add Isilon Storage Provider
+    #   vipr.add_isilon('isilon01', 'isilon01.mydomain.com')
+    #   vipr.add_isilon('isilon01', 'isilon01.mydomain.com', 'sysadmin', 'sysadmin')
+    #   vipr.add_isilon('isilon01', 'isilon01.mydomain.com', 'sysadmin', 'sysadmin', '8093')
+    def add_isilon(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, auth=nil, cert=nil)
+        check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '8080' : port = port
+	    rest_post(storage_system_payload(name, 'isilon', ip_or_dns, port, user_name, password), "#{@base_url}/vdc/storage-systems", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    # Add EMC VNX for File Storage Provider
+    # @note VNX File Control Station default port is 443. VNX File Onboard Storage Provider default port is 5988
+    #
+    # @param name [String] Name of the EMC VNX for File Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+    # @param ip_or_dns [String] FQDN or IP Address of the EMC VNX for File Storage Provider to add. This is a required string.
+    # @param user_name [String] User Name that will be used for authenticating against the EMC VNX for File Storage Provider. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+    # @param password [String] Password that will be used for authenticating against the EMC VNX for File Storage Provider. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+    # @param port [String] Port that will be used for communicating with the EMC VNX for File Storage Provider. This is an optional string. If no parameter is passed, then '443' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+    # @param smis_provider_ip [String] IP Address for the SMI-S Communicator for the EMC VNX for File Storage Provider. This is a required string.
+    # @param smis_user_name [String] User Name for the SMI-S Communicator for the EMC VNX for File Storage Provider. This is an optional string. If no parameter is passed, then 'admin' is used.
+    # @param smis_password [String] Password for the user_name for the SMI-S Communicator for the EMC VNX for File Storage Provider.  This is an optional string. If no parameter is passed, then '#1Password' is used.
+    # @param smis_port_number [String] Port Number for the SMI-S Communicator for the EMC VNX for File Storage Provider.  This is an optional string. If no parameter is passed, then '5988' is used.
+    # @param smis_use_ssl [String] SSL setting for communicating with the SMI-S Communicator for the EMC VNX for File Storage Provider.  This is an optional string. If no parameter is passed, then 'false' is used.
+    #
+    # @return [Hash] The resulted post operation
+    #
+    # @example Add EMC VNX for File Storage Provider
+    #   vipr.add_emc_file('vnx01', 'vnx01.mydomain.com', 'sysadmin', 'sysadmin', nil, 'smi_s_ip', 'smi_s_un', 'smi_s_pw')
+    #   vipr.add_emc_file('vnx01', 'vnx01.mydomain.com', 'sysadmin', 'sysadmin', '1067', 'smi_s_ip', 'smi_s_un', 'smi_s_pw', '1068', 'true')
+    def add_emc_file(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, smis_provider_ip=nil, smis_user_name=nil, smis_password=nil, smis_port_number=nil, smis_use_ssl=nil, auth=nil, cert=nil)
+    	check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '443' : port = port
+		smis_port_number.nil? ? smis_port_number = '5988' : smis_port_number = smis_port_number
+	    rest_post(storage_system_payload(name, 'vnxfile', ip_or_dns, port, user_name, password, smis_provider_ip, smis_port_number, smis_user_name, smis_password, smis_use_ssl), "#{@base_url}/vdc/storage-systems", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+    # Add NetApp Storage Provider
+    # @note Supported Protocol: NFS, CIFS
+    # 	For supported versions, see the EMC ViPR Support Matrix available on the EMC Community Network (community.emc.com).
+    #
+    # @param name [String] Name of the NetApp Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+    # @param ip_or_dns [String] FQDN or IP Address of the NetApp Storage Provider to add. This is a required string.
+    # @param user_name [String] User Name that will be used for authenticating against the NetApp Storage Provider. This is an optional string. If no parameter is passed, then 'admin' is used. If you wish to specify a different password, port, or use_ssl param set this to nil
+    # @param password [String] Password that will be used for authenticating against the NetApp Storage Provider. This is an optional string. If no parameter is passed, then '#1Password' is used. If you wish to specify a different username, port, or use_ssl param set this to nil
+    # @param port [String] Port that will be used for communicating with the NetApp Storage Provider. This is an optional string. If no parameter is passed, then '443' is used. If you wish to specify a different user_name, password, or use_ssl param set this to nil
+    #
+    # @return [Hash] The resulted post operation
+    #
+    # @example Add NetApp Storage Provider
+    #   vipr.netapp('netapp01', 'netapp01.mydomain.com')
+    #   vipr.netapp('netapp01', 'netapp01.mydomain.com', 'sysadmin', 'sysadmin')
+    #   vipr.netapp('netapp01', 'netapp01.mydomain.com', 'sysadmin', 'sysadmin', '8093')
+    def add_netapp(name=nil, ip_or_dns=nil, user_name=nil, password=nil, port=nil, auth=nil, cert=nil)
+    	check_storage_provider_payload(name, ip_or_dns)
+		port.nil? ? port = '443' : port = port
+	    rest_post(storage_system_payload(name, 'netapp', ip_or_dns, port, user_name, password), "#{@base_url}/vdc/storage-systems", auth.nil? ? @auth_token : auth, cert.nil? ? @verify_cert : cert)
+    end
+
+
+ 	private
+
+ 	# Error Handling method to check for Missing Param. If the pass fails, an error exception is raised
+ 	#
+ 	# @param name [String] Name of the Storage Provider. This name is arbitrary and only exists within ViPR. This is a required string.
+ 	# @param ip_or_dns [String] FQDN or IP Address of the Storage Provider to add. This is a required string.
+ 	#
+ 	# @return [Boolean] True if passes. If fails, raise exception
+    def check_storage_provider_payload(name=nil, ip_or_dns=nil)
+      if name == nil || ip_or_dns == nil
+          raise "Missing Param 'name' or 'ip_or_dns'"
+      end
+    end
+
+end