oci 2.0.9 → 2.1.0

data/lib/oci/email/email_client.rb

@@ -31,7 +31,9 @@ module OCI
     # @param [OCI::BaseSigner] signer A signer implementation which can be used by this client. If this is not provided then
     #   a signer will be constructed via the provided config. One use case of this parameter is instance principals authentication,
     #   so that the instance principals signer can be provided to the client
-    def initialize(config:nil, region:nil, signer:nil)
+    # @param [OCI::ApiClientProxySettings] proxy_settings If your environment requires you to use a proxy server for outgoing HTTP requests
+    #   the details for the proxy can be provided in this parameter
+    def initialize(config: nil, region: nil, signer: nil, proxy_settings: nil)
       # If the signer is an InstancePrincipalsSecurityTokenSigner and no config was supplied (which is valid for instance principals)
       # then create a dummy config to pass to the ApiClient constructor. If customers wish to create a client which uses instance principals
       # and has config (either populated programmatically or loaded from a file), they must construct that config themselves and then
@@ -47,7 +49,7 @@ module OCI
         signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase, private_key_content: config.key_content, signing_strategy: Signer::STANDARD)
       end
 
-      @api_client = ApiClient.new(config, signer)
+      @api_client = ApiClient.new(config, signer, proxy_settings: proxy_settings)
 
       region ||= config.region
       region ||= signer.region if signer.respond_to?(:region)
@@ -57,8 +59,8 @@ module OCI
     # Set the region that will be used to determine the service endpoint.
     # This will usually correspond to a value in {OCI::Regions::REGION_ENUM},
     # but may be an arbitrary string.
-    def region=(r)
-      @region = r
+    def region=(new_region)
+      @region = new_region
 
       raise 'A region must be specified.' unless @region
 
@@ -146,6 +148,7 @@ module OCI
       logger.debug "Calling operation EmailClient#delete_sender." if logger
 
       raise "Missing the required parameter 'sender_id' when calling delete_sender." if sender_id.nil?
+      raise "Parameter value for 'sender_id' must not be blank" if OCI::Internal::Util::blank_string?(sender_id)
 
       path = "/senders/{senderId}".sub('{senderId}', sender_id.to_s)
 
@@ -178,6 +181,7 @@ module OCI
       logger.debug "Calling operation EmailClient#delete_suppression." if logger
 
       raise "Missing the required parameter 'suppression_id' when calling delete_suppression." if suppression_id.nil?
+      raise "Parameter value for 'suppression_id' must not be blank" if OCI::Internal::Util::blank_string?(suppression_id)
 
       path = "/suppressions/{suppressionId}".sub('{suppressionId}', suppression_id.to_s)
 
@@ -208,6 +212,7 @@ module OCI
       logger.debug "Calling operation EmailClient#get_sender." if logger
 
       raise "Missing the required parameter 'sender_id' when calling get_sender." if sender_id.nil?
+      raise "Parameter value for 'sender_id' must not be blank" if OCI::Internal::Util::blank_string?(sender_id)
 
       path = "/senders/{senderId}".sub('{senderId}', sender_id.to_s)
 
@@ -241,6 +246,7 @@ module OCI
       logger.debug "Calling operation EmailClient#get_suppression." if logger
 
       raise "Missing the required parameter 'suppression_id' when calling get_suppression." if suppression_id.nil?
+      raise "Parameter value for 'suppression_id' must not be blank" if OCI::Internal::Util::blank_string?(suppression_id)
 
       path = "/suppressions/{suppressionId}".sub('{suppressionId}', suppression_id.to_s)
 

data/lib/oci/errors.rb

@@ -2,19 +2,25 @@
 
 module OCI
   module Errors
-    # The base error for all requests that return error responses from the service.
-    class ServiceError < StandardError
-      # HTTP status code (such as 200 or 404)
-      #
-      # @return [Integer]
-      attr_reader :status_code
-
-      # A service-specific error code
+    # Represents an error which was generated somewhere during the process of making a HTTP request to an
+    # OCI service. This error contains the raw request and also exposes some convenience properties such
+    # as the opc-request-id for the request. This error makes no guarantee or inference about whether the
+    # error was generated based on a response from an OCI service, whether there was a network issue etc.
+    #
+    # When used directly, the {#cause} of the error should be inspected for the original error which resulted
+    # in this one being thrown.
+    #
+    # Subclasses, such as {OCI::Errors::ServiceError} and {OCI::Errors::NetworkError}, may have stronger
+    # definitions around what circumstances caused the error to be thrown.
+    class HttpRequestBasedError < StandardError
+      # The request which was made
       #
-      # @return [String]
-      attr_reader :service_code
+      # @return [Net::HTTPRequest]
+      attr_reader :request_made
 
-      # The request ID, taken from the opc-request-id header.
+      # The request ID from the opc-request-id header. This could be the request ID returned from the service
+      # or, if there was no opc-request-id in the response, it will be the opc-request-id set client-side by the
+      # caller or the SDK (if there was no explicit caller-provided opc-request-id)
       #
       # @return [String]
       attr_reader :request_id
@@ -24,18 +30,40 @@ module OCI
       # @return [String]
       attr_reader :message
 
-      def initialize(status_code, service_code, request_id, message)
+      def initialize(message: nil, request_made: nil)
         # We need to mask the message attribute here as otherwise we use StandardError's
         # implementation, which calls to_s and so referencing "message" in our to_s in
-        # this class would go into an infinite loop
+        # this class (and subclasses) would go into an infinite loop
+        @message = message
+
+        @request_made = request_made
+        @request_id = @request_made['opc-request-id'] unless @request_made.nil?
+      end
 
+      def to_s
+        "{ 'message': '#{message}', 'opc-request-id': '#{request_id}' }"
+      end
+    end
+
+    # The base error for all requests that return error responses from the service.
+    class ServiceError < HttpRequestBasedError
+      # HTTP status code (such as 200 or 404)
+      #
+      # @return [Integer]
+      attr_reader :status_code
+
+      # A service-specific error code
+      #
+      # @return [String]
+      attr_reader :service_code
+
+      def initialize(status_code, service_code, request_id, message, request_made: nil)
         @message = if message.nil? || message.strip.empty?
                      "The service returned error code #{status_code}"
                    else
                      message.strip
                    end
-
-        super @message
+        super(message: @message, request_made: request_made)
 
         @status_code = status_code
         @service_code = service_code
@@ -48,14 +76,82 @@ module OCI
       end
     end
 
-    # The base error for all network issues (that is, requests that do not reach the server)
-    class NetworkError < StandardError
+    # The base error for issues which are likely to be network related, rather than an application
+    # issue. This is defined as:
+    #
+    #   * Requests which were sent from the SDK but the outcome was not a response from an OCI service. Further examples of include:
+    #     * Gateway timeouts
+    #     * Read or connection timeouts
+    #     * Any {Errno} exception which was generated by making the request
+    #   * Requests which resulted in a HTTP 408 (timeout)
+    #
+    # The {#cause} of this error can be inspected to see if there was an original error which resulted in this one being thrown.
+    class NetworkError < HttpRequestBasedError
       # Error code, which is mapped to Net::HTTPResponse's code.to_i or 0 if the issue was reported by an exception.
+      #
+      # @return [Integer]
       attr_reader :code
 
-      def initialize(message, code)
-        super message
+      # The response received for the request, if any
+      #
+      # @return [Net::HTTPResponse]
+      attr_reader :response_received
+
+      def initialize(message, code, request_made: nil, response_received: nil)
+        super(message: message, request_made: request_made)
         @code = code
+        @response_received = response_received
+
+        # If we have a request ID from the response then use that, otherwise just take the one from the
+        # request (the superclass constructor sets the opc-request-id from the request by default)
+        response_req_id = @response_received['opc-request-id'] unless @response_received.nil?
+        @request_id = response_req_id unless response_req_id.nil?
+      end
+
+      def to_s
+        response_body = response_received.body unless response_received.nil?
+
+        "{ 'message': '#{message}', 'status': #{code}, " \
+        "'opc-request-id': '#{request_id}', 'response-body': '#{response_body}' }"
+      end
+    end
+
+    # The base error for issues related to parsing the response received from the service. The {#response_body}
+    # can be inspected for the data which failed to parse and the {#cause} of this error can be inspected for the
+    # underlying parsing error which occurred
+    class ResponseParsingError < HttpRequestBasedError
+      # The response received for the request, and whose body we failed to parse
+      #
+      # @return [Net::HTTPResponse]
+      attr_reader :response_received
+
+      def initialize(message: 'Failed to parse response', request_made:, response_received:)
+        raise 'A message must be provided' if message.nil? || message.strip.empty?
+        raise 'The request made must be provided' if request_made.nil?
+        raise 'The response received must be provided' if response_received.nil?
+
+        super(message: message, request_made: request_made)
+        @response_received = response_received
+        @request_id = @response_received['opc-request-id'] unless @response_received['opc-request-id'].nil?
+      end
+
+      # The response body which we failed to parse
+      #
+      # @return [String]
+      def response_body
+        response_received.body
+      end
+
+      # The status code of the response (e.g. 200)
+      #
+      # @return [Integer]
+      def status_code
+        response_received.code.to_i
+      end
+
+      def to_s
+        "{ 'message': '#{message}', 'status': #{status_code}, " \
+        "'opc-request-id': '#{request_id}', 'response-body': '#{response_body}' }"
       end
     end
 

data/lib/oci/file_storage/file_storage_client.rb

@@ -31,7 +31,9 @@ module OCI
     # @param [OCI::BaseSigner] signer A signer implementation which can be used by this client. If this is not provided then
     #   a signer will be constructed via the provided config. One use case of this parameter is instance principals authentication,
     #   so that the instance principals signer can be provided to the client
-    def initialize(config:nil, region:nil, signer:nil)
+    # @param [OCI::ApiClientProxySettings] proxy_settings If your environment requires you to use a proxy server for outgoing HTTP requests
+    #   the details for the proxy can be provided in this parameter
+    def initialize(config: nil, region: nil, signer: nil, proxy_settings: nil)
       # If the signer is an InstancePrincipalsSecurityTokenSigner and no config was supplied (which is valid for instance principals)
       # then create a dummy config to pass to the ApiClient constructor. If customers wish to create a client which uses instance principals
       # and has config (either populated programmatically or loaded from a file), they must construct that config themselves and then
@@ -47,7 +49,7 @@ module OCI
         signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase, private_key_content: config.key_content, signing_strategy: Signer::STANDARD)
       end
 
-      @api_client = ApiClient.new(config, signer)
+      @api_client = ApiClient.new(config, signer, proxy_settings: proxy_settings)
 
       region ||= config.region
       region ||= signer.region if signer.respond_to?(:region)
@@ -57,8 +59,8 @@ module OCI
     # Set the region that will be used to determine the service endpoint.
     # This will usually correspond to a value in {OCI::Regions::REGION_ENUM},
     # but may be an arbitrary string.
-    def region=(r)
-      @region = r
+    def region=(new_region)
+      @region = new_region
 
       raise 'A region must be specified.' unless @region
 
@@ -298,6 +300,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#delete_export." if logger
 
       raise "Missing the required parameter 'export_id' when calling delete_export." if export_id.nil?
+      raise "Parameter value for 'export_id' must not be blank" if OCI::Internal::Util::blank_string?(export_id)
 
       path = "/exports/{exportId}".sub('{exportId}', export_id.to_s)
 
@@ -338,6 +341,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#delete_file_system." if logger
 
       raise "Missing the required parameter 'file_system_id' when calling delete_file_system." if file_system_id.nil?
+      raise "Parameter value for 'file_system_id' must not be blank" if OCI::Internal::Util::blank_string?(file_system_id)
 
       path = "/fileSystems/{fileSystemId}".sub('{fileSystemId}', file_system_id.to_s)
 
@@ -377,6 +381,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#delete_mount_target." if logger
 
       raise "Missing the required parameter 'mount_target_id' when calling delete_mount_target." if mount_target_id.nil?
+      raise "Parameter value for 'mount_target_id' must not be blank" if OCI::Internal::Util::blank_string?(mount_target_id)
 
       path = "/mountTargets/{mountTargetId}".sub('{mountTargetId}', mount_target_id.to_s)
 
@@ -415,6 +420,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#delete_snapshot." if logger
 
       raise "Missing the required parameter 'snapshot_id' when calling delete_snapshot." if snapshot_id.nil?
+      raise "Parameter value for 'snapshot_id' must not be blank" if OCI::Internal::Util::blank_string?(snapshot_id)
 
       path = "/snapshots/{snapshotId}".sub('{snapshotId}', snapshot_id.to_s)
 
@@ -446,6 +452,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#get_export." if logger
 
       raise "Missing the required parameter 'export_id' when calling get_export." if export_id.nil?
+      raise "Parameter value for 'export_id' must not be blank" if OCI::Internal::Util::blank_string?(export_id)
 
       path = "/exports/{exportId}".sub('{exportId}', export_id.to_s)
 
@@ -477,6 +484,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#get_export_set." if logger
 
       raise "Missing the required parameter 'export_set_id' when calling get_export_set." if export_set_id.nil?
+      raise "Parameter value for 'export_set_id' must not be blank" if OCI::Internal::Util::blank_string?(export_set_id)
 
       path = "/exportSets/{exportSetId}".sub('{exportSetId}', export_set_id.to_s)
 
@@ -508,6 +516,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#get_file_system." if logger
 
       raise "Missing the required parameter 'file_system_id' when calling get_file_system." if file_system_id.nil?
+      raise "Parameter value for 'file_system_id' must not be blank" if OCI::Internal::Util::blank_string?(file_system_id)
 
       path = "/fileSystems/{fileSystemId}".sub('{fileSystemId}', file_system_id.to_s)
 
@@ -539,6 +548,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#get_mount_target." if logger
 
       raise "Missing the required parameter 'mount_target_id' when calling get_mount_target." if mount_target_id.nil?
+      raise "Parameter value for 'mount_target_id' must not be blank" if OCI::Internal::Util::blank_string?(mount_target_id)
 
       path = "/mountTargets/{mountTargetId}".sub('{mountTargetId}', mount_target_id.to_s)
 
@@ -570,6 +580,7 @@ module OCI
       logger.debug "Calling operation FileStorageClient#get_snapshot." if logger
 
       raise "Missing the required parameter 'snapshot_id' when calling get_snapshot." if snapshot_id.nil?
+      raise "Parameter value for 'snapshot_id' must not be blank" if OCI::Internal::Util::blank_string?(snapshot_id)
 
       path = "/snapshots/{snapshotId}".sub('{snapshotId}', snapshot_id.to_s)
 
@@ -1008,6 +1019,7 @@ module OCI
 
       raise "Missing the required parameter 'export_set_id' when calling update_export_set." if export_set_id.nil?
       raise "Missing the required parameter 'update_export_set_details' when calling update_export_set." if update_export_set_details.nil?
+      raise "Parameter value for 'export_set_id' must not be blank" if OCI::Internal::Util::blank_string?(export_set_id)
 
       path = "/exportSets/{exportSetId}".sub('{exportSetId}', export_set_id.to_s)
 
@@ -1050,6 +1062,7 @@ module OCI
 
       raise "Missing the required parameter 'file_system_id' when calling update_file_system." if file_system_id.nil?
       raise "Missing the required parameter 'update_file_system_details' when calling update_file_system." if update_file_system_details.nil?
+      raise "Parameter value for 'file_system_id' must not be blank" if OCI::Internal::Util::blank_string?(file_system_id)
 
       path = "/fileSystems/{fileSystemId}".sub('{fileSystemId}', file_system_id.to_s)
 
@@ -1090,6 +1103,7 @@ module OCI
 
       raise "Missing the required parameter 'mount_target_id' when calling update_mount_target." if mount_target_id.nil?
       raise "Missing the required parameter 'update_mount_target_details' when calling update_mount_target." if update_mount_target_details.nil?
+      raise "Parameter value for 'mount_target_id' must not be blank" if OCI::Internal::Util::blank_string?(mount_target_id)
 
       path = "/mountTargets/{mountTargetId}".sub('{mountTargetId}', mount_target_id.to_s)
 

data/lib/oci/global_context.rb

@@ -14,7 +14,7 @@ module OCI
   end
 
   # Set the global Config
-  def self.config=(c)
-    @config = c
+  def self.config=(config)
+    @config = config
   end
 end

data/lib/oci/identity/identity_client.rb

@@ -31,7 +31,9 @@ module OCI
     # @param [OCI::BaseSigner] signer A signer implementation which can be used by this client. If this is not provided then
     #   a signer will be constructed via the provided config. One use case of this parameter is instance principals authentication,
     #   so that the instance principals signer can be provided to the client
-    def initialize(config:nil, region:nil, signer:nil)
+    # @param [OCI::ApiClientProxySettings] proxy_settings If your environment requires you to use a proxy server for outgoing HTTP requests
+    #   the details for the proxy can be provided in this parameter
+    def initialize(config: nil, region: nil, signer: nil, proxy_settings: nil)
       # If the signer is an InstancePrincipalsSecurityTokenSigner and no config was supplied (which is valid for instance principals)
       # then create a dummy config to pass to the ApiClient constructor. If customers wish to create a client which uses instance principals
       # and has config (either populated programmatically or loaded from a file), they must construct that config themselves and then
@@ -47,7 +49,7 @@ module OCI
         signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase, private_key_content: config.key_content)
       end
 
-      @api_client = ApiClient.new(config, signer)
+      @api_client = ApiClient.new(config, signer, proxy_settings: proxy_settings)
 
       region ||= config.region
       region ||= signer.region if signer.respond_to?(:region)
@@ -57,8 +59,8 @@ module OCI
     # Set the region that will be used to determine the service endpoint.
     # This will usually correspond to a value in {OCI::Regions::REGION_ENUM},
     # but may be an arbitrary string.
-    def region=(r)
-      @region = r
+    def region=(new_region)
+      @region = new_region
 
       raise 'A region must be specified.' unless @region
 
@@ -198,6 +200,7 @@ module OCI
 
       raise "Missing the required parameter 'create_customer_secret_key_details' when calling create_customer_secret_key." if create_customer_secret_key_details.nil?
       raise "Missing the required parameter 'user_id' when calling create_customer_secret_key." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/customerSecretKeys/".sub('{userId}', user_id.to_s)
 
@@ -411,6 +414,7 @@ module OCI
 
       raise "Missing the required parameter 'create_idp_group_mapping_details' when calling create_idp_group_mapping." if create_idp_group_mapping_details.nil?
       raise "Missing the required parameter 'identity_provider_id' when calling create_idp_group_mapping." if identity_provider_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
 
       path = "/identityProviders/{identityProviderId}/groupMappings/".sub('{identityProviderId}', identity_provider_id.to_s)
 
@@ -460,6 +464,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#create_or_reset_ui_password." if logger
 
       raise "Missing the required parameter 'user_id' when calling create_or_reset_ui_password." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/uiPassword".sub('{userId}', user_id.to_s)
 
@@ -556,6 +561,7 @@ module OCI
 
       raise "Missing the required parameter 'create_region_subscription_details' when calling create_region_subscription." if create_region_subscription_details.nil?
       raise "Missing the required parameter 'tenancy_id' when calling create_region_subscription." if tenancy_id.nil?
+      raise "Parameter value for 'tenancy_id' must not be blank" if OCI::Internal::Util::blank_string?(tenancy_id)
 
       path = "/tenancies/{tenancyId}/regionSubscriptions".sub('{tenancyId}', tenancy_id.to_s)
 
@@ -600,6 +606,7 @@ module OCI
 
       raise "Missing the required parameter 'create_smtp_credential_details' when calling create_smtp_credential." if create_smtp_credential_details.nil?
       raise "Missing the required parameter 'user_id' when calling create_smtp_credential." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/smtpCredentials/".sub('{userId}', user_id.to_s)
 
@@ -650,6 +657,7 @@ module OCI
 
       raise "Missing the required parameter 'create_swift_password_details' when calling create_swift_password." if create_swift_password_details.nil?
       raise "Missing the required parameter 'user_id' when calling create_swift_password." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/swiftPasswords/".sub('{userId}', user_id.to_s)
 
@@ -703,6 +711,7 @@ module OCI
 
       raise "Missing the required parameter 'tag_namespace_id' when calling create_tag." if tag_namespace_id.nil?
       raise "Missing the required parameter 'create_tag_details' when calling create_tag." if create_tag_details.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
 
       path = "/tagNamespaces/{tagNamespaceId}/tags".sub('{tagNamespaceId}', tag_namespace_id.to_s)
 
@@ -875,6 +884,8 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling delete_api_key." if user_id.nil?
       raise "Missing the required parameter 'fingerprint' when calling delete_api_key." if fingerprint.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'fingerprint' must not be blank" if OCI::Internal::Util::blank_string?(fingerprint)
 
       path = "/users/{userId}/apiKeys/{fingerprint}".sub('{userId}', user_id.to_s).sub('{fingerprint}', fingerprint.to_s)
 
@@ -913,6 +924,8 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling delete_customer_secret_key." if user_id.nil?
       raise "Missing the required parameter 'customer_secret_key_id' when calling delete_customer_secret_key." if customer_secret_key_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'customer_secret_key_id' must not be blank" if OCI::Internal::Util::blank_string?(customer_secret_key_id)
 
       path = "/users/{userId}/customerSecretKeys/{customerSecretKeyId}".sub('{userId}', user_id.to_s).sub('{customerSecretKeyId}', customer_secret_key_id.to_s)
 
@@ -949,6 +962,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#delete_dynamic_group." if logger
 
       raise "Missing the required parameter 'dynamic_group_id' when calling delete_dynamic_group." if dynamic_group_id.nil?
+      raise "Parameter value for 'dynamic_group_id' must not be blank" if OCI::Internal::Util::blank_string?(dynamic_group_id)
 
       path = "/dynamicGroups/{dynamicGroupId}".sub('{dynamicGroupId}', dynamic_group_id.to_s)
 
@@ -985,6 +999,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#delete_group." if logger
 
       raise "Missing the required parameter 'group_id' when calling delete_group." if group_id.nil?
+      raise "Parameter value for 'group_id' must not be blank" if OCI::Internal::Util::blank_string?(group_id)
 
       path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
 
@@ -1022,6 +1037,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#delete_identity_provider." if logger
 
       raise "Missing the required parameter 'identity_provider_id' when calling delete_identity_provider." if identity_provider_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
 
       path = "/identityProviders/{identityProviderId}".sub('{identityProviderId}', identity_provider_id.to_s)
 
@@ -1059,6 +1075,8 @@ module OCI
 
       raise "Missing the required parameter 'identity_provider_id' when calling delete_idp_group_mapping." if identity_provider_id.nil?
       raise "Missing the required parameter 'mapping_id' when calling delete_idp_group_mapping." if mapping_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
+      raise "Parameter value for 'mapping_id' must not be blank" if OCI::Internal::Util::blank_string?(mapping_id)
 
       path = "/identityProviders/{identityProviderId}/groupMappings/{mappingId}".sub('{identityProviderId}', identity_provider_id.to_s).sub('{mappingId}', mapping_id.to_s)
 
@@ -1094,6 +1112,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#delete_policy." if logger
 
       raise "Missing the required parameter 'policy_id' when calling delete_policy." if policy_id.nil?
+      raise "Parameter value for 'policy_id' must not be blank" if OCI::Internal::Util::blank_string?(policy_id)
 
       path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
 
@@ -1132,6 +1151,8 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling delete_smtp_credential." if user_id.nil?
       raise "Missing the required parameter 'smtp_credential_id' when calling delete_smtp_credential." if smtp_credential_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'smtp_credential_id' must not be blank" if OCI::Internal::Util::blank_string?(smtp_credential_id)
 
       path = "/users/{userId}/smtpCredentials/{smtpCredentialId}".sub('{userId}', user_id.to_s).sub('{smtpCredentialId}', smtp_credential_id.to_s)
 
@@ -1170,6 +1191,8 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling delete_swift_password." if user_id.nil?
       raise "Missing the required parameter 'swift_password_id' when calling delete_swift_password." if swift_password_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'swift_password_id' must not be blank" if OCI::Internal::Util::blank_string?(swift_password_id)
 
       path = "/users/{userId}/swiftPasswords/{swiftPasswordId}".sub('{userId}', user_id.to_s).sub('{swiftPasswordId}', swift_password_id.to_s)
 
@@ -1205,6 +1228,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#delete_user." if logger
 
       raise "Missing the required parameter 'user_id' when calling delete_user." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}".sub('{userId}', user_id.to_s)
 
@@ -1244,6 +1268,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_compartment." if logger
 
       raise "Missing the required parameter 'compartment_id' when calling get_compartment." if compartment_id.nil?
+      raise "Parameter value for 'compartment_id' must not be blank" if OCI::Internal::Util::blank_string?(compartment_id)
 
       path = "/compartments/{compartmentId}".sub('{compartmentId}', compartment_id.to_s)
 
@@ -1276,6 +1301,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_dynamic_group." if logger
 
       raise "Missing the required parameter 'dynamic_group_id' when calling get_dynamic_group." if dynamic_group_id.nil?
+      raise "Parameter value for 'dynamic_group_id' must not be blank" if OCI::Internal::Util::blank_string?(dynamic_group_id)
 
       path = "/dynamicGroups/{dynamicGroupId}".sub('{dynamicGroupId}', dynamic_group_id.to_s)
 
@@ -1312,6 +1338,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_group." if logger
 
       raise "Missing the required parameter 'group_id' when calling get_group." if group_id.nil?
+      raise "Parameter value for 'group_id' must not be blank" if OCI::Internal::Util::blank_string?(group_id)
 
       path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
 
@@ -1343,6 +1370,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_identity_provider." if logger
 
       raise "Missing the required parameter 'identity_provider_id' when calling get_identity_provider." if identity_provider_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
 
       path = "/identityProviders/{identityProviderId}".sub('{identityProviderId}', identity_provider_id.to_s)
 
@@ -1376,6 +1404,8 @@ module OCI
 
       raise "Missing the required parameter 'identity_provider_id' when calling get_idp_group_mapping." if identity_provider_id.nil?
       raise "Missing the required parameter 'mapping_id' when calling get_idp_group_mapping." if mapping_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
+      raise "Parameter value for 'mapping_id' must not be blank" if OCI::Internal::Util::blank_string?(mapping_id)
 
       path = "/identityProviders/{identityProviderId}/groupMappings/{mappingId}".sub('{identityProviderId}', identity_provider_id.to_s).sub('{mappingId}', mapping_id.to_s)
 
@@ -1407,6 +1437,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_policy." if logger
 
       raise "Missing the required parameter 'policy_id' when calling get_policy." if policy_id.nil?
+      raise "Parameter value for 'policy_id' must not be blank" if OCI::Internal::Util::blank_string?(policy_id)
 
       path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
 
@@ -1442,6 +1473,8 @@ module OCI
 
       raise "Missing the required parameter 'tag_namespace_id' when calling get_tag." if tag_namespace_id.nil?
       raise "Missing the required parameter 'tag_name' when calling get_tag." if tag_name.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
+      raise "Parameter value for 'tag_name' must not be blank" if OCI::Internal::Util::blank_string?(tag_name)
 
       path = "/tagNamespaces/{tagNamespaceId}/tags/{tagName}".sub('{tagNamespaceId}', tag_namespace_id.to_s).sub('{tagName}', tag_name.to_s)
 
@@ -1475,6 +1508,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_tag_namespace." if logger
 
       raise "Missing the required parameter 'tag_namespace_id' when calling get_tag_namespace." if tag_namespace_id.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
 
       path = "/tagNamespaces/{tagNamespaceId}".sub('{tagNamespaceId}', tag_namespace_id.to_s)
 
@@ -1506,6 +1540,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_tenancy." if logger
 
       raise "Missing the required parameter 'tenancy_id' when calling get_tenancy." if tenancy_id.nil?
+      raise "Parameter value for 'tenancy_id' must not be blank" if OCI::Internal::Util::blank_string?(tenancy_id)
 
       path = "/tenancies/{tenancyId}".sub('{tenancyId}', tenancy_id.to_s)
 
@@ -1537,6 +1572,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_user." if logger
 
       raise "Missing the required parameter 'user_id' when calling get_user." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}".sub('{userId}', user_id.to_s)
 
@@ -1568,6 +1604,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#get_user_group_membership." if logger
 
       raise "Missing the required parameter 'user_group_membership_id' when calling get_user_group_membership." if user_group_membership_id.nil?
+      raise "Parameter value for 'user_group_membership_id' must not be blank" if OCI::Internal::Util::blank_string?(user_group_membership_id)
 
       path = "/userGroupMemberships/{userGroupMembershipId}".sub('{userGroupMembershipId}', user_group_membership_id.to_s)
 
@@ -1603,6 +1640,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_api_keys." if logger
 
       raise "Missing the required parameter 'user_id' when calling list_api_keys." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/apiKeys/".sub('{userId}', user_id.to_s)
 
@@ -1714,6 +1752,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_customer_secret_keys." if logger
 
       raise "Missing the required parameter 'user_id' when calling list_customer_secret_keys." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/customerSecretKeys/".sub('{userId}', user_id.to_s)
 
@@ -1884,6 +1923,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_idp_group_mappings." if logger
 
       raise "Missing the required parameter 'identity_provider_id' when calling list_idp_group_mappings." if identity_provider_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
 
       path = "/identityProviders/{identityProviderId}/groupMappings/".sub('{identityProviderId}', identity_provider_id.to_s)
 
@@ -1961,6 +2001,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_region_subscriptions." if logger
 
       raise "Missing the required parameter 'tenancy_id' when calling list_region_subscriptions." if tenancy_id.nil?
+      raise "Parameter value for 'tenancy_id' must not be blank" if OCI::Internal::Util::blank_string?(tenancy_id)
 
       path = "/tenancies/{tenancyId}/regionSubscriptions".sub('{tenancyId}', tenancy_id.to_s)
 
@@ -2023,6 +2064,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_smtp_credentials." if logger
 
       raise "Missing the required parameter 'user_id' when calling list_smtp_credentials." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/smtpCredentials/".sub('{userId}', user_id.to_s)
 
@@ -2056,6 +2098,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_swift_passwords." if logger
 
       raise "Missing the required parameter 'user_id' when calling list_swift_passwords." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/swiftPasswords/".sub('{userId}', user_id.to_s)
 
@@ -2137,6 +2180,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#list_tags." if logger
 
       raise "Missing the required parameter 'tag_namespace_id' when calling list_tags." if tag_namespace_id.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
 
       path = "/tagNamespaces/{tagNamespaceId}/tags".sub('{tagNamespaceId}', tag_namespace_id.to_s)
 
@@ -2269,6 +2313,7 @@ module OCI
       logger.debug "Calling operation IdentityClient#remove_user_from_group." if logger
 
       raise "Missing the required parameter 'user_group_membership_id' when calling remove_user_from_group." if user_group_membership_id.nil?
+      raise "Parameter value for 'user_group_membership_id' must not be blank" if OCI::Internal::Util::blank_string?(user_group_membership_id)
 
       path = "/userGroupMemberships/{userGroupMembershipId}".sub('{userGroupMembershipId}', user_group_membership_id.to_s)
 
@@ -2306,6 +2351,7 @@ module OCI
 
       raise "Missing the required parameter 'compartment_id' when calling update_compartment." if compartment_id.nil?
       raise "Missing the required parameter 'update_compartment_details' when calling update_compartment." if update_compartment_details.nil?
+      raise "Parameter value for 'compartment_id' must not be blank" if OCI::Internal::Util::blank_string?(compartment_id)
 
       path = "/compartments/{compartmentId}".sub('{compartmentId}', compartment_id.to_s)
 
@@ -2347,6 +2393,8 @@ module OCI
       raise "Missing the required parameter 'user_id' when calling update_customer_secret_key." if user_id.nil?
       raise "Missing the required parameter 'customer_secret_key_id' when calling update_customer_secret_key." if customer_secret_key_id.nil?
       raise "Missing the required parameter 'update_customer_secret_key_details' when calling update_customer_secret_key." if update_customer_secret_key_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'customer_secret_key_id' must not be blank" if OCI::Internal::Util::blank_string?(customer_secret_key_id)
 
       path = "/users/{userId}/customerSecretKeys/{customerSecretKeyId}".sub('{userId}', user_id.to_s).sub('{customerSecretKeyId}', customer_secret_key_id.to_s)
 
@@ -2385,6 +2433,7 @@ module OCI
 
       raise "Missing the required parameter 'dynamic_group_id' when calling update_dynamic_group." if dynamic_group_id.nil?
       raise "Missing the required parameter 'update_dynamic_group_details' when calling update_dynamic_group." if update_dynamic_group_details.nil?
+      raise "Parameter value for 'dynamic_group_id' must not be blank" if OCI::Internal::Util::blank_string?(dynamic_group_id)
 
       path = "/dynamicGroups/{dynamicGroupId}".sub('{dynamicGroupId}', dynamic_group_id.to_s)
 
@@ -2423,6 +2472,7 @@ module OCI
 
       raise "Missing the required parameter 'group_id' when calling update_group." if group_id.nil?
       raise "Missing the required parameter 'update_group_details' when calling update_group." if update_group_details.nil?
+      raise "Parameter value for 'group_id' must not be blank" if OCI::Internal::Util::blank_string?(group_id)
 
       path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
 
@@ -2461,6 +2511,7 @@ module OCI
 
       raise "Missing the required parameter 'identity_provider_id' when calling update_identity_provider." if identity_provider_id.nil?
       raise "Missing the required parameter 'update_identity_provider_details' when calling update_identity_provider." if update_identity_provider_details.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
 
       path = "/identityProviders/{identityProviderId}".sub('{identityProviderId}', identity_provider_id.to_s)
 
@@ -2501,6 +2552,8 @@ module OCI
       raise "Missing the required parameter 'identity_provider_id' when calling update_idp_group_mapping." if identity_provider_id.nil?
       raise "Missing the required parameter 'mapping_id' when calling update_idp_group_mapping." if mapping_id.nil?
       raise "Missing the required parameter 'update_idp_group_mapping_details' when calling update_idp_group_mapping." if update_idp_group_mapping_details.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util::blank_string?(identity_provider_id)
+      raise "Parameter value for 'mapping_id' must not be blank" if OCI::Internal::Util::blank_string?(mapping_id)
 
       path = "/identityProviders/{identityProviderId}/groupMappings/{mappingId}".sub('{identityProviderId}', identity_provider_id.to_s).sub('{mappingId}', mapping_id.to_s)
 
@@ -2542,6 +2595,7 @@ module OCI
 
       raise "Missing the required parameter 'policy_id' when calling update_policy." if policy_id.nil?
       raise "Missing the required parameter 'update_policy_details' when calling update_policy." if update_policy_details.nil?
+      raise "Parameter value for 'policy_id' must not be blank" if OCI::Internal::Util::blank_string?(policy_id)
 
       path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
 
@@ -2583,6 +2637,8 @@ module OCI
       raise "Missing the required parameter 'user_id' when calling update_smtp_credential." if user_id.nil?
       raise "Missing the required parameter 'smtp_credential_id' when calling update_smtp_credential." if smtp_credential_id.nil?
       raise "Missing the required parameter 'update_smtp_credential_details' when calling update_smtp_credential." if update_smtp_credential_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'smtp_credential_id' must not be blank" if OCI::Internal::Util::blank_string?(smtp_credential_id)
 
       path = "/users/{userId}/smtpCredentials/{smtpCredentialId}".sub('{userId}', user_id.to_s).sub('{smtpCredentialId}', smtp_credential_id.to_s)
 
@@ -2624,6 +2680,8 @@ module OCI
       raise "Missing the required parameter 'user_id' when calling update_swift_password." if user_id.nil?
       raise "Missing the required parameter 'swift_password_id' when calling update_swift_password." if swift_password_id.nil?
       raise "Missing the required parameter 'update_swift_password_details' when calling update_swift_password." if update_swift_password_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
+      raise "Parameter value for 'swift_password_id' must not be blank" if OCI::Internal::Util::blank_string?(swift_password_id)
 
       path = "/users/{userId}/swiftPasswords/{swiftPasswordId}".sub('{userId}', user_id.to_s).sub('{swiftPasswordId}', swift_password_id.to_s)
 
@@ -2663,6 +2721,8 @@ module OCI
       raise "Missing the required parameter 'tag_namespace_id' when calling update_tag." if tag_namespace_id.nil?
       raise "Missing the required parameter 'tag_name' when calling update_tag." if tag_name.nil?
       raise "Missing the required parameter 'update_tag_details' when calling update_tag." if update_tag_details.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
+      raise "Parameter value for 'tag_name' must not be blank" if OCI::Internal::Util::blank_string?(tag_name)
 
       path = "/tagNamespaces/{tagNamespaceId}/tags/{tagName}".sub('{tagNamespaceId}', tag_namespace_id.to_s).sub('{tagName}', tag_name.to_s)
 
@@ -2706,6 +2766,7 @@ module OCI
 
       raise "Missing the required parameter 'tag_namespace_id' when calling update_tag_namespace." if tag_namespace_id.nil?
       raise "Missing the required parameter 'update_tag_namespace_details' when calling update_tag_namespace." if update_tag_namespace_details.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util::blank_string?(tag_namespace_id)
 
       path = "/tagNamespaces/{tagNamespaceId}".sub('{tagNamespaceId}', tag_namespace_id.to_s)
 
@@ -2743,6 +2804,7 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling update_user." if user_id.nil?
       raise "Missing the required parameter 'update_user_details' when calling update_user." if update_user_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}".sub('{userId}', user_id.to_s)
 
@@ -2782,6 +2844,7 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling update_user_state." if user_id.nil?
       raise "Missing the required parameter 'update_state_details' when calling update_user_state." if update_state_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/state/".sub('{userId}', user_id.to_s)
 
@@ -2837,6 +2900,7 @@ module OCI
 
       raise "Missing the required parameter 'user_id' when calling upload_api_key." if user_id.nil?
       raise "Missing the required parameter 'create_api_key_details' when calling upload_api_key." if create_api_key_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util::blank_string?(user_id)
 
       path = "/users/{userId}/apiKeys/".sub('{userId}', user_id.to_s)