oraclebmc 1.1.1

data/lib/oraclebmc/identity/identity_client.rb

@@ -0,0 +1,1462 @@
+# Copyright (c) 2016 Oracle and/or its affiliates. All rights reserved.
+
+require "uri"
+require "logger"
+
+module OracleBMC
+
+  class Identity::IdentityClient
+
+    # Client used to make HTTP requests.
+    # @return [OracleBMC::ApiClient]
+    attr_reader :api_client
+
+    # Fully qualified endpoint URL
+    # @return [String]
+    attr_reader :endpoint
+
+    # The region, which will usually correspond to a value in {OracleBMC::Regions::REGION_ENUM}.
+    # @return [String]
+    attr_accessor :region
+
+    # Creates a new IdentityClient.
+    # If a config is not specified, then the global OracleBMC.config will be used.
+    #
+    # A region must be specified in either the config or the region parameter. If specified
+    # in both, then the region parameter will be used.
+    #
+    # @param [Config] config A Config object.
+    # @param [String] region A region used to determine the service endpoint. This will usually
+    #   correspond to a value in {OracleBMC::Regions::REGION_ENUM}, but may be an arbitrary string.
+    #
+    def initialize(config:nil, region:nil)
+      config ||= OracleBMC.config
+      signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase)
+      @api_client = ApiClient.new(config, signer)
+
+      region ||= config.region
+      self.region = region
+    end
+
+    # Set the region that will be used to determine the service endpoint.
+    # This will usually correspond to a value in {OracleBMC::Regions::REGION_ENUM},
+    # but may be an arbitrary string.
+    def region=(r)
+      @region = r
+
+      fail 'A region must be specified.' unless @region
+
+      if not OracleBMC::Regions.valid_region? region
+        logger.info "Unknown region '#{@region}', falling back to default endpoint format." if logger
+      end
+
+      @endpoint = OracleBMC::Regions.get_service_endpoint(@region, :IdentityClient) + '/20160918'
+      logger.info "IdentityClient endpoint set to '#{endpoint}'." if logger
+    end
+
+    # @return [Logger] The logger for this client. May be nil.
+    def logger
+      @api_client.config.logger
+    end
+
+
+    # Adds the specified user to the specified group and returns a `UserGroupMembership` object with its own OCID.
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # @param [AddUserToGroupDetails] add_user_to_group_details Request object for adding a user to a group.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::UserGroupMembership
+    def add_user_to_group(add_user_to_group_details, opts = {})
+      logger.debug "Calling operation IdentityClient#add_user_to_group." if logger
+
+      fail "Missing the required parameter 'add_user_to_group_details' when calling add_user_to_group." if add_user_to_group_details.nil?
+
+      path = "/userGroupMemberships/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(add_user_to_group_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::UserGroupMembership')
+    end
+
+    # Creates a new compartment in your tenancy.
+    # 
+    # **Important:** Compartments cannot be renamed or deleted.
+    # 
+    # You must specify your tenancy's OCID as the compartment ID in the request object. Remember that the tenancy
+    # is simply the root compartment. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm).
+    # 
+    # You must also specify a *name* for the compartment, which must be unique across all compartments in
+    # your tenancy and cannot be changed. You can use this name or the OCID when writing policies that apply
+    # to the compartment. For more information about policies, see
+    # [How Policies Work](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policies.htm).
+    # 
+    # You must also specify a *description* for the compartment (although it can be an empty string). It does
+    # not have to be unique, and you can change it anytime with 
+    # {#update_compartment update_compartment}.
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # @param [CreateCompartmentDetails] create_compartment_details Request object for creating a new compartment.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Compartment
+    def create_compartment(create_compartment_details, opts = {})
+      logger.debug "Calling operation IdentityClient#create_compartment." if logger
+
+      fail "Missing the required parameter 'create_compartment_details' when calling create_compartment." if create_compartment_details.nil?
+
+      path = "/compartments/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_compartment_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Compartment')
+    end
+
+    # Creates a new group in your tenancy. 
+    # 
+    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
+    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies) 
+    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically 
+    # reside within compartments inside the tenancy. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm).
+    # 
+    # You must also specify a *name* for the group, which must be unique across all groups in your tenancy and
+    # cannot be changed. You can use this name or the OCID when writing policies that apply to the group. For more
+    # information about policies, see [How Policies Work](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policies.htm).
+    # 
+    # You must also specify a *description* for the group (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with {#update_group update_group}.
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # After creating the group, you need to put users in it and write policies for it.
+    # See {#add_user_to_group add_user_to_group} and 
+    # {#create_policy create_policy}.
+    # 
+    # @param [CreateGroupDetails] create_group_details Request object for creating a new group.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Group
+    def create_group(create_group_details, opts = {})
+      logger.debug "Calling operation IdentityClient#create_group." if logger
+
+      fail "Missing the required parameter 'create_group_details' when calling create_group." if create_group_details.nil?
+
+      path = "/groups/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_group_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Group')
+    end
+
+    # Creates a new Console one-time password for the specified user. For more information about user
+    # credentials, see [User Credentials](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/usercredentials.htm).
+    # 
+    # Use this operation after creating a new user, or if a user forgets their password. The new one-time
+    # password is returned to you in the response, and you must securely deliver it to the user. They'll
+    # be prompted to change this password the next time they sign in to the Console. If they don't change
+    # it within 7 days, the password will expire and you'll need to create a new one-time password for the
+    # user. 
+    # 
+    # **Note:** The user's Console login is the unique name you specified when you created the user
+    # (see {#create_user create_user}).
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::UIPassword
+    def create_or_reset_ui_password(user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#create_or_reset_ui_password." if logger
+
+      fail "Missing the required parameter 'user_id' when calling create_or_reset_ui_password." if user_id.nil?
+
+      path = "/users/{userId}/uiPassword".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::UIPassword')
+    end
+
+    # Creates a new policy in the specified compartment (either the tenancy or another of your compartments).
+    # If you're new to policies, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+    # 
+    # You must specify a *name* for the policy, which must be unique across all policies in your tenancy
+    # and cannot be changed.
+    # 
+    # You must also specify a *description* for the policy (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with {#update_policy update_policy}.
+    # 
+    # You must specify one or more policy statements in the statements array. For information about writing
+    # policies, see [How Policies Work](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policies.htm) and 
+    # [Common Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/commonpolicies.htm).
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # New policies take effect typically within 10 seconds.
+    # 
+    # @param [CreatePolicyDetails] create_policy_details Request object for creating a new policy.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Policy
+    def create_policy(create_policy_details, opts = {})
+      logger.debug "Calling operation IdentityClient#create_policy." if logger
+
+      fail "Missing the required parameter 'create_policy_details' when calling create_policy." if create_policy_details.nil?
+
+      path = "/policies/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_policy_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Policy')
+    end
+
+    # Creates a new Swift password for the specified user. For information about what Swift passwords are for, see
+    # [Managing User Credentials](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/managingcredentials.htm).
+    # 
+    # You must specify a *description* for the Swift password (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with 
+    # {#update_swift_password update_swift_password}.
+    # 
+    # Every user has permission to create a Swift password for *their own user ID*. An administrator in your organization
+    # does not need to write a policy to give users this ability. To compare, administrators who have permission to the
+    # tenancy can use this operation to create a Swift password for any user, including themselves.
+    # 
+    # @param [CreateSwiftPasswordDetails] create_swift_password_details Request object for creating a new swift password.
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::SwiftPassword
+    def create_swift_password(create_swift_password_details, user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#create_swift_password." if logger
+
+      fail "Missing the required parameter 'create_swift_password_details' when calling create_swift_password." if create_swift_password_details.nil?
+      fail "Missing the required parameter 'user_id' when calling create_swift_password." if user_id.nil?
+
+      path = "/users/{userId}/swiftPasswords/".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_swift_password_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::SwiftPassword')
+    end
+
+    # Creates a new user in your tenancy. For conceptual information about users, your tenancy, and other
+    # IAM Service components, see [Overview of the IAM Service](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/overview.htm).
+    # 
+    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the
+    # tenancy is simply the root compartment). Notice that IAM resources (users, groups, compartments, and 
+    # some policies) reside within the tenancy itself, unlike cloud resources such as compute instances, 
+    # which typically reside within compartments inside the tenancy. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm).
+    # 
+    # You must also specify a *name* for the user, which must be unique across all users in your tenancy
+    # and cannot be changed. Allowed characters: No spaces. Only letters, numerals, hyphens, periods, 
+    # underscores, +, and @. If you specify a name that's already in use, you'll get a 409 error.
+    # This name will be the user's login to the Console. You might want to pick a
+    # name that your company's own identity system (e.g., Active Directory, LDAP, etc.) already uses.
+    # If you delete a user and then create a new user with the same name, they'll be considered different
+    # users because they have different OCIDs.
+    # 
+    # You must also specify a *description* for the user (although it can be an empty string).
+    # It does not have to be unique, and you can change it anytime with 
+    # {#update_user update_user}. You can use the field to provide the user's 
+    # full name, a description, a nickname, or other information to generally identify the user.
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before 
+    # using the object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # A new user has no permissions until you place the user in one or more groups (see
+    # {#add_user_to_group add_user_to_group}). If the user needs to 
+    # access the Console, you need to provide the user a password (see 
+    # {#create_or_reset_ui_password create_or_reset_ui_password}).
+    # If the user needs to access the Oracle Bare Metal Cloud Services REST API, you need to upload a
+    # public API signing key for that user (see 
+    # [Required Keys and OCIDs](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm) and also 
+    # {#upload_api_key upload_api_key}).
+    # 
+    # **Important:** Make sure to inform the new user which compartment(s) they have access to. 
+    # 
+    # @param [CreateUserDetails] create_user_details Request object for creating a new user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::User
+    def create_user(create_user_details, opts = {})
+      logger.debug "Calling operation IdentityClient#create_user." if logger
+
+      fail "Missing the required parameter 'create_user_details' when calling create_user." if create_user_details.nil?
+
+      path = "/users/"
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_user_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::User')
+    end
+
+    # Deletes the specified API signing key for the specified user.
+    # 
+    # Every user has permission to use this operation to delete a key for *their own user ID*. An
+    # administrator in your organization does not need to write a policy to give users this ability.
+    # To compare, administrators who have permission to the tenancy can use this operation to delete
+    # a key for any user, including themselves.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [String] fingerprint The key's fingerprint.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def delete_api_key(user_id, fingerprint, opts = {})
+      logger.debug "Calling operation IdentityClient#delete_api_key." if logger
+
+      fail "Missing the required parameter 'user_id' when calling delete_api_key." if user_id.nil?
+      fail "Missing the required parameter 'fingerprint' when calling delete_api_key." if fingerprint.nil?
+
+      path = "/users/{userId}/apiKeys/{fingerprint}".sub('{userId}', user_id.to_s).sub('{fingerprint}', fingerprint.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Deletes the specified group. The group must be empty.
+    # 
+    # @param [String] group_id The OCID of the group.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def delete_group(group_id, opts = {})
+      logger.debug "Calling operation IdentityClient#delete_group." if logger
+
+      fail "Missing the required parameter 'group_id' when calling delete_group." if group_id.nil?
+
+      path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Deletes the specified policy. The deletion takes effect typically within 10 seconds.
+    # @param [String] policy_id The OCID of the policy.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def delete_policy(policy_id, opts = {})
+      logger.debug "Calling operation IdentityClient#delete_policy." if logger
+
+      fail "Missing the required parameter 'policy_id' when calling delete_policy." if policy_id.nil?
+
+      path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Deletes the specified Swift password for the specified user.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [String] swift_password_id The OCID of the Swift password.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def delete_swift_password(user_id, swift_password_id, opts = {})
+      logger.debug "Calling operation IdentityClient#delete_swift_password." if logger
+
+      fail "Missing the required parameter 'user_id' when calling delete_swift_password." if user_id.nil?
+      fail "Missing the required parameter 'swift_password_id' when calling delete_swift_password." if swift_password_id.nil?
+
+      path = "/users/{userId}/swiftPasswords/{swiftPasswordId}".sub('{userId}', user_id.to_s).sub('{swiftPasswordId}', swift_password_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Deletes the specified user. The user must not be in any groups.
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def delete_user(user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#delete_user." if logger
+
+      fail "Missing the required parameter 'user_id' when calling delete_user." if user_id.nil?
+
+      path = "/users/{userId}".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Gets the specified compartment's information.
+    # 
+    # This operation does not return a list of all the resources inside the compartment. There is no single
+    # API operation that does that. Compartments can contain multiple types of resources (instances, block
+    # storage volumes, etc.). To find out what's in a compartment, you must call the \"List\" operation for
+    # each resource type and specify the compartment's OCID as a query parameter in the request. For example,
+    # call the {#list_instances list_instances} operation in the Cloud Compute 
+    # Service or the {#list_volumes list_volumes} operation in Cloud Block Storage.
+    # 
+    # @param [String] compartment_id The OCID of the compartment.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Compartment
+    def get_compartment(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#get_compartment." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling get_compartment." if compartment_id.nil?
+
+      path = "/compartments/{compartmentId}".sub('{compartmentId}', compartment_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Compartment')
+    end
+
+    # Gets the specified group's information.
+    # 
+    # This operation does not return a list of all the users in the group. To do that, use
+    # {#list_user_group_memberships list_user_group_memberships} and 
+    # provide the group's OCID as a query parameter in the request.
+    # 
+    # @param [String] group_id The OCID of the group.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Group
+    def get_group(group_id, opts = {})
+      logger.debug "Calling operation IdentityClient#get_group." if logger
+
+      fail "Missing the required parameter 'group_id' when calling get_group." if group_id.nil?
+
+      path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Group')
+    end
+
+    # Gets the specified policy's information.
+    # @param [String] policy_id The OCID of the policy.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Policy
+    def get_policy(policy_id, opts = {})
+      logger.debug "Calling operation IdentityClient#get_policy." if logger
+
+      fail "Missing the required parameter 'policy_id' when calling get_policy." if policy_id.nil?
+
+      path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Policy')
+    end
+
+    # Gets the specified user's information.
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::User
+    def get_user(user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#get_user." if logger
+
+      fail "Missing the required parameter 'user_id' when calling get_user." if user_id.nil?
+
+      path = "/users/{userId}".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::User')
+    end
+
+    # Gets the specified UserGroupMembership's information.
+    # @param [String] user_group_membership_id The OCID of the userGroupMembership.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::UserGroupMembership
+    def get_user_group_membership(user_group_membership_id, opts = {})
+      logger.debug "Calling operation IdentityClient#get_user_group_membership." if logger
+
+      fail "Missing the required parameter 'user_group_membership_id' when calling get_user_group_membership." if user_group_membership_id.nil?
+
+      path = "/userGroupMemberships/{userGroupMembershipId}".sub('{userGroupMembershipId}', user_group_membership_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::UserGroupMembership')
+    end
+
+    # Lists the API signing keys for the specified user. A user can have a maximum of three keys.
+    # 
+    # Every user has permission to use this API call for *their own user ID*.  An administrator in your
+    # organization does not need to write a policy to give users this ability.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::ApiKey>
+    def list_api_keys(user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_api_keys." if logger
+
+      fail "Missing the required parameter 'user_id' when calling list_api_keys." if user_id.nil?
+
+      path = "/users/{userId}/apiKeys/".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::ApiKey>')
+    end
+
+    # Lists the Availability Domains in your tenancy. Specify the OCID of either the tenancy or another
+    # of your compartments as the value for the compartment ID (remember that the tenancy is simply the root compartment).
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five).
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::AvailabilityDomain>
+    def list_availability_domains(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_availability_domains." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_availability_domains." if compartment_id.nil?
+
+      path = "/availabilityDomains/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::AvailabilityDomain>')
+    end
+
+    # Lists the compartments in your tenancy. You must specify your tenancy's OCID as the value
+    # for the compartment ID (remember that the tenancy is simply the root compartment).
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five).
+    # 
+    # To use this and other API operations, you must be authorized in an IAM policy. If you're not authorized, 
+    # talk to an administrator. If you're an administrator who needs to write policies to give users access, see 
+    # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    #   
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    #   
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::Compartment>
+    def list_compartments(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_compartments." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_compartments." if compartment_id.nil?
+
+      path = "/compartments/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+      query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::Compartment>')
+    end
+
+    # Lists the groups in your tenancy. You must specify your tenancy's OCID as the value for
+    # the compartment ID (remember that the tenancy is simply the root compartment).
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five).
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    #   
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    #   
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::Group>
+    def list_groups(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_groups." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_groups." if compartment_id.nil?
+
+      path = "/groups/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+      query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::Group>')
+    end
+
+    # Lists the policies in the specified compartment (either the tenancy or another of your compartments). 
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five).
+    # 
+    # To determine which policies apply to a particular group or compartment, you must view the individual
+    # statements inside all your policies. There isn't a way to automatically obtain that information via the API.
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    #   
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    #   
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::Policy>
+    def list_policies(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_policies." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_policies." if compartment_id.nil?
+
+      path = "/policies/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+      query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::Policy>')
+    end
+
+    # Lists the Swift passwords for the specified user. The returned object contains the password's OCID, but not
+    # the password itself. The actual password is returned only upon creation. 
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [Hash] opts the optional parameters
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::SwiftPassword>
+    def list_swift_passwords(user_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_swift_passwords." if logger
+
+      fail "Missing the required parameter 'user_id' when calling list_swift_passwords." if user_id.nil?
+
+      path = "/users/{userId}/swiftPasswords/".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::SwiftPassword>')
+    end
+
+    # Lists the `UserGroupMembership` objects in your tenancy. You must specify your tenancy's OCID
+    # as the value for the compartment ID
+    # (see [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five)).
+    # You must also then filter the list in one of these ways:
+    # 
+    # - You can limit the results to just the memberships for a given user by specifying a `userId`.
+    # - Similarly, you can limit the results to just the memberships for a given group by specifying a `groupId`.
+    # - You can set both the `userId` and `groupId` to determine if the specified user is in the specified group.
+    # If the answer is no, the response is an empty list.
+    # 
+    # To use this and other API operations, you must be authorized in an IAM policy. If you're not authorized, 
+    # talk to an administrator. If you're an administrator who needs to write policies to give users access, see 
+    # [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :user_id The OCID of the user.
+    # @option opts [String] :group_id The OCID of the group.
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    #   
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    #   
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::UserGroupMembership>
+    def list_user_group_memberships(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_user_group_memberships." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_user_group_memberships." if compartment_id.nil?
+
+      path = "/userGroupMemberships/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+      query_params[:'userId'] = opts[:'user_id'] if opts[:'user_id']
+      query_params[:'groupId'] = opts[:'group_id'] if opts[:'group_id']
+      query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::UserGroupMembership>')
+    end
+
+    # Lists the users in your tenancy. You must specify your tenancy's OCID as the value for the
+    # compartment ID (remember that the tenancy is simply the root compartment).
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/apisigningkey.htm#five).
+    # 
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #   
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \&quot;List\&quot; call.
+    #   
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \&quot;List\&quot; call.
+    #   
+    # @return [Response] A Response object with data of type Array<OracleBMC::Identity::Models::User>
+    def list_users(compartment_id, opts = {})
+      logger.debug "Calling operation IdentityClient#list_users." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling list_users." if compartment_id.nil?
+
+      path = "/users/"
+
+      # Query Params
+      query_params = {}
+      query_params[:'compartmentId'] = compartment_id
+      query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :GET,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'Array<OracleBMC::Identity::Models::User>')
+    end
+
+    # Removes a user from a group by deleting the corresponding `UserGroupMembership`.
+    # @param [String] user_group_membership_id The OCID of the userGroupMembership.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type nil
+    def remove_user_from_group(user_group_membership_id, opts = {})
+      logger.debug "Calling operation IdentityClient#remove_user_from_group." if logger
+
+      fail "Missing the required parameter 'user_group_membership_id' when calling remove_user_from_group." if user_group_membership_id.nil?
+
+      path = "/userGroupMemberships/{userGroupMembershipId}".sub('{userGroupMembershipId}', user_group_membership_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = nil
+
+      return @api_client.call_api(
+        :DELETE,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body)
+    end
+
+    # Updates the specified compartment's description.
+    # @param [String] compartment_id The OCID of the compartment.
+    # @param [UpdateCompartmentDetails] update_compartment_details Request object for updating a compartment.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Compartment
+    def update_compartment(compartment_id, update_compartment_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_compartment." if logger
+
+      fail "Missing the required parameter 'compartment_id' when calling update_compartment." if compartment_id.nil?
+      fail "Missing the required parameter 'update_compartment_details' when calling update_compartment." if update_compartment_details.nil?
+
+      path = "/compartments/{compartmentId}".sub('{compartmentId}', compartment_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_compartment_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Compartment')
+    end
+
+    # Updates the specified group.
+    # @param [String] group_id The OCID of the group.
+    # @param [UpdateGroupDetails] update_group_details Request object for updating a group.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Group
+    def update_group(group_id, update_group_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_group." if logger
+
+      fail "Missing the required parameter 'group_id' when calling update_group." if group_id.nil?
+      fail "Missing the required parameter 'update_group_details' when calling update_group." if update_group_details.nil?
+
+      path = "/groups/{groupId}".sub('{groupId}', group_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_group_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Group')
+    end
+
+    # Updates the specified policy. You can update the description or the policy statements themselves.
+    # 
+    # Policy changes take effect typically within 10 seconds.
+    # 
+    # @param [String] policy_id The OCID of the policy.
+    # @param [UpdatePolicyDetails] update_policy_details Request object for updating a policy.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::Policy
+    def update_policy(policy_id, update_policy_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_policy." if logger
+
+      fail "Missing the required parameter 'policy_id' when calling update_policy." if policy_id.nil?
+      fail "Missing the required parameter 'update_policy_details' when calling update_policy." if update_policy_details.nil?
+
+      path = "/policies/{policyId}".sub('{policyId}', policy_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_policy_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::Policy')
+    end
+
+    # Updates the specified Swift password's description.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [String] swift_password_id The OCID of the Swift password.
+    # @param [UpdateSwiftPasswordDetails] update_swift_password_details Request object for updating a Swift password.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::SwiftPassword
+    def update_swift_password(user_id, swift_password_id, update_swift_password_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_swift_password." if logger
+
+      fail "Missing the required parameter 'user_id' when calling update_swift_password." if user_id.nil?
+      fail "Missing the required parameter 'swift_password_id' when calling update_swift_password." if swift_password_id.nil?
+      fail "Missing the required parameter 'update_swift_password_details' when calling update_swift_password." if update_swift_password_details.nil?
+
+      path = "/users/{userId}/swiftPasswords/{swiftPasswordId}".sub('{userId}', user_id.to_s).sub('{swiftPasswordId}', swift_password_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_swift_password_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::SwiftPassword')
+    end
+
+    # Updates the description of the specified user.
+    # @param [String] user_id The OCID of the user.
+    # @param [UpdateUserDetails] update_user_details Request object for updating a user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::User
+    def update_user(user_id, update_user_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_user." if logger
+
+      fail "Missing the required parameter 'user_id' when calling update_user." if user_id.nil?
+      fail "Missing the required parameter 'update_user_details' when calling update_user." if update_user_details.nil?
+
+      path = "/users/{userId}".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_user_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::User')
+    end
+
+    # Updates the state of the specified user.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [UpdateStateDetails] update_state_details Request object for updating a user state.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :if_match For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource&#39;s current etag value.
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::User
+    def update_user_state(user_id, update_state_details, opts = {})
+      logger.debug "Calling operation IdentityClient#update_user_state." if logger
+
+      fail "Missing the required parameter 'user_id' when calling update_user_state." if user_id.nil?
+      fail "Missing the required parameter 'update_state_details' when calling update_user_state." if update_state_details.nil?
+
+      path = "/users/{userId}/state/".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:'if_match'] if opts[:'if_match']
+
+      post_body = @api_client.object_to_http_body(update_state_details)
+
+      return @api_client.call_api(
+        :PUT,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::User')
+    end
+
+    # Uploads an API signing key for the specified user.  
+    # 
+    # Every user has permission to use this operation to upload a key for *their own user ID*. An
+    # administrator in your organization does not need to write a policy to give users this ability.
+    # To compare, administrators who have permission to the tenancy can use this operation to upload a
+    # key for any user, including themselves.
+    # 
+    # **Important:** Even though you have permission to upload an API key, you might not yet
+    # have permission to do much else. If you try calling an operation unrelated to your own credential
+    # management (e.g., `ListUsers`, `LaunchInstance`) and receive an \"unauthorized\" error,
+    # check with an administrator to confirm which IAM Service group(s) you're in and what access
+    # you have. Also confirm you're working in the correct compartment. 
+    # 
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using
+    # the object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # 
+    # @param [String] user_id The OCID of the user.
+    # @param [CreateApiKeyDetails] create_api_key_details Request object for uploading an API key for a user.
+    # @param [Hash] opts the optional parameters
+    # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #   
+    # @return [Response] A Response object with data of type OracleBMC::Identity::Models::ApiKey
+    def upload_api_key(user_id, create_api_key_details, opts = {})
+      logger.debug "Calling operation IdentityClient#upload_api_key." if logger
+
+      fail "Missing the required parameter 'user_id' when calling upload_api_key." if user_id.nil?
+      fail "Missing the required parameter 'create_api_key_details' when calling upload_api_key." if create_api_key_details.nil?
+
+      path = "/users/{userId}/apiKeys/".sub('{userId}', user_id.to_s)
+
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params['accept'] = 'application/json'
+      header_params['content-type'] = 'application/json'
+      header_params[:'opc-retry-token'] = opts[:'opc_retry_token'] if opts[:'opc_retry_token']
+
+      post_body = @api_client.object_to_http_body(create_api_key_details)
+
+      return @api_client.call_api(
+        :POST,
+        path,
+        endpoint,
+        :header_params => header_params,
+        :query_params => query_params,
+        :body => post_body,
+        :return_type => 'OracleBMC::Identity::Models::ApiKey')
+    end
+  end
+end