oci 2.0.1 → 2.0.2

data/lib/oci/audit/models/configuration.rb

@@ -0,0 +1,120 @@
+# Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved.
+
+require 'date'
+
+module OCI
+  class Audit::Models::Configuration
+    # The retention period days
+    # @return [Integer]
+    attr_accessor :retention_period_days
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
+
+      if attributes[:'retentionPeriodDays']
+        self.retention_period_days = attributes[:'retentionPeriodDays']
+      end
+
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other_object to be compared
+    def ==(other_object)
+      return true if self.equal?(other_object)
+      self.class == other_object.class &&
+          retention_period_days == other_object.retention_period_days
+    end
+
+    # @see the `==` method
+    # @param [Object] other_object to be compared
+    def eql?(other_object)
+      self == other_object
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [retention_period_days].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map{ |v| OCI::Internal::Util.convert_to_type($1, v) } )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]]))
+        end # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = send(attr)
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value 
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map{ |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      { 
+        :'retention_period_days' => :'retentionPeriodDays'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      { 
+        :'retention_period_days' => :'Integer'
+      }
+    end
+  end
+end

data/lib/oci/audit/models/update_configuration_details.rb

@@ -0,0 +1,120 @@
+# Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved.
+
+require 'date'
+
+module OCI
+  class Audit::Models::UpdateConfigurationDetails
+    # The retention period days
+    # @return [Integer]
+    attr_accessor :retention_period_days
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}){|(k,v), h| h[k.to_sym] = v}
+
+      if attributes[:'retentionPeriodDays']
+        self.retention_period_days = attributes[:'retentionPeriodDays']
+      end
+
+    end
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other_object to be compared
+    def ==(other_object)
+      return true if self.equal?(other_object)
+      self.class == other_object.class &&
+          retention_period_days == other_object.retention_period_days
+    end
+
+    # @see the `==` method
+    # @param [Object] other_object to be compared
+    def eql?(other_object)
+      self == other_object
+    end
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [retention_period_days].hash
+    end
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            self.send("#{key}=", attributes[self.class.attribute_map[key]].map{ |v| OCI::Internal::Util.convert_to_type($1, v) } )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          self.send("#{key}=", OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]]))
+        end # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = send(attr)
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value 
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map{ |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+
+
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      { 
+        :'retention_period_days' => :'retentionPeriodDays'
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      { 
+        :'retention_period_days' => :'Integer'
+      }
+    end
+  end
+end

data/lib/oci/audit/util.rb

@@ -0,0 +1 @@
+# Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved.

data/lib/oci/core/blockstorage_client.rb

@@ -33,7 +33,7 @@ module OCI
       config ||= OCI.config
       config.validate
 
-      signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase, private_key_content: config.key_content)
+      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)
       @api_client = ApiClient.new(config, signer)
 
       region ||= config.region
@@ -301,12 +301,42 @@ module OCI
     #   
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
+    # @option opts [String] :display_name A filter to return only resources that match the given display name exactly.
+    #   
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME
+    #   sort order is case sensitive.
+    #   
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #   
+    #   Allowed values are: TIMECREATED, DISPLAYNAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order
+    #   is case sensitive.
+    #   
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #   
     # @return [Response] A Response object with data of type Array<OCI::Core::Models::VolumeBackup>
     def list_volume_backups(compartment_id, opts = {})
       logger.debug "Calling operation BlockstorageClient#list_volume_backups." if logger
 
       fail "Missing the required parameter 'compartment_id' when calling list_volume_backups." if compartment_id.nil?
 
+      if opts[:'sort_by'] && !['TIMECREATED', 'DISPLAYNAME'].include?(opts[:'sort_by'])
+        fail 'Invalid value for "sort_by", must be one of TIMECREATED, DISPLAYNAME.'
+      end
+
+      if opts[:'sort_order'] && !['ASC', 'DESC'].include?(opts[:'sort_order'])
+        fail 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:'lifecycle_state'] && !OCI::Core::Models::VolumeBackup::LIFECYCLE_STATE_ENUM.include?(opts[:'lifecycle_state'])
+        fail 'Invalid value for "lifecycle_state", must be one of the values in OCI::Core::Models::VolumeBackup::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = "/volumeBackups"
 
       # Query Params
@@ -315,6 +345,10 @@ module OCI
       query_params[:'volumeId'] = opts[:'volume_id'] if opts[:'volume_id']
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'displayName'] = opts[:'display_name'] if opts[:'display_name']
+      query_params[:'sortBy'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sortOrder'] = opts[:'sort_order'] if opts[:'sort_order']
+      query_params[:'lifecycleState'] = opts[:'lifecycle_state'] if opts[:'lifecycle_state']
 
       # Header Params
       header_params = {}
@@ -347,12 +381,42 @@ module OCI
     #   
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
+    # @option opts [String] :display_name A filter to return only resources that match the given display name exactly.
+    #   
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME
+    #   sort order is case sensitive.
+    #   
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #   
+    #   Allowed values are: TIMECREATED, DISPLAYNAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order
+    #   is case sensitive.
+    #   
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #   
     # @return [Response] A Response object with data of type Array<OCI::Core::Models::Volume>
     def list_volumes(compartment_id, opts = {})
       logger.debug "Calling operation BlockstorageClient#list_volumes." if logger
 
       fail "Missing the required parameter 'compartment_id' when calling list_volumes." if compartment_id.nil?
 
+      if opts[:'sort_by'] && !['TIMECREATED', 'DISPLAYNAME'].include?(opts[:'sort_by'])
+        fail 'Invalid value for "sort_by", must be one of TIMECREATED, DISPLAYNAME.'
+      end
+
+      if opts[:'sort_order'] && !['ASC', 'DESC'].include?(opts[:'sort_order'])
+        fail 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:'lifecycle_state'] && !OCI::Core::Models::Volume::LIFECYCLE_STATE_ENUM.include?(opts[:'lifecycle_state'])
+        fail 'Invalid value for "lifecycle_state", must be one of the values in OCI::Core::Models::Volume::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = "/volumes"
 
       # Query Params
@@ -361,6 +425,10 @@ module OCI
       query_params[:'availabilityDomain'] = opts[:'availability_domain'] if opts[:'availability_domain']
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'displayName'] = opts[:'display_name'] if opts[:'display_name']
+      query_params[:'sortBy'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sortOrder'] = opts[:'sort_order'] if opts[:'sort_order']
+      query_params[:'lifecycleState'] = opts[:'lifecycle_state'] if opts[:'lifecycle_state']
 
       # Header Params
       header_params = {}

data/lib/oci/core/compute_client.rb

@@ -33,7 +33,7 @@ module OCI
       config ||= OCI.config
       config.validate
 
-      signer = Signer.new(config.user, config.fingerprint, config.tenancy, config.key_file, pass_phrase: config.pass_phrase, private_key_content: config.key_content)
+      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)
       @api_client = ApiClient.new(config, signer)
 
       region ||= config.region
@@ -193,19 +193,19 @@ module OCI
         :return_type => 'OCI::Core::Models::ConsoleHistory')
     end
 
-    # Creates a boot disk image for the specified instance or imports an exported image from the Oracle Bare Metal Cloud Object Storage Service.
+    # Creates a boot disk image for the specified instance or imports an exported image from the Oracle Cloud Infrastructure Object Storage service.
     # 
     # When creating a new image, you must provide the OCID of the instance you want to use as the basis for the image, and
     # the OCID of the compartment containing that instance. For more information about images,
     # see [Managing Custom Images](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/managingcustomimages.htm).
     # 
-    # When importing an exported image from the Object Storage Service, you specify the source information
+    # When importing an exported image from Object Storage, you specify the source information
     # in {#image_source_details image_source_details}.
     # 
     # When importing an image based on the namespace, bucket name, and object name,
     # use {#image_source_via_object_storage_tuple_details image_source_via_object_storage_tuple_details}.
     # 
-    # When importing an image based on the Object Storage Service URL, use
+    # When importing an image based on the Object Storage URL, use
     # image_source_via_object_storage_uri_details.
     # See [Object Storage URLs](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and [pre-authenticated requests](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
     # for constructing URLs for image import/export.
@@ -488,12 +488,12 @@ module OCI
         :body => post_body)
     end
 
-    # Exports the specified image to the Oracle Bare Metal Cloud Object Storage Service. You can use the Object Storage Service URL,
+    # Exports the specified image to the Oracle Cloud Infrastructure Object Storage service. You can use the Object Storage URL,
     # or the namespace, bucket name, and object name when specifying the location to export to.
     # 
     # For more information about exporting images, see [Image Import/Export](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm).
     # 
-    # To perform an image export, you need write access to the Object Storage Service bucket for the image,
+    # To perform an image export, you need write access to the Object Storage bucket for the image,
     # see [Let Users Write Objects to Object Storage Buckets](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/commonpolicies.htm#Let4).
     # 
     # See [Object Storage URLs](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/imageimportexport.htm#URLs) and [pre-authenticated requests](https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/managingaccess.htm#pre-auth)
@@ -823,6 +823,7 @@ module OCI
     # 
     # @param [String] instance_id The OCID of the instance.
     # @param [String] action The action to perform on the instance.
+    #   Allowed values are: STOP, START, SOFTRESET, RESET
     # @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
@@ -881,7 +882,7 @@ module OCI
     # To get a list of Availability Domains, use the `ListAvailabilityDomains` operation
     # in the Identity and Access Management Service API.
     # 
-    # All Oracle Bare Metal Cloud Services resources, including instances, get an Oracle-assigned,
+    # All Oracle Cloud Infrastructure resources, including instances, get an Oracle-assigned,
     # unique ID called an Oracle Cloud Identifier (OCID).
     # When you create a resource, you can find its OCID in the response. You can
     # also retrieve a resource's OCID by using a List API operation
@@ -951,12 +952,40 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
     # @option opts [String] :instance_id The OCID of the instance.
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME
+    #   sort order is case sensitive.
+    #   
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #   
+    #   Allowed values are: TIMECREATED, DISPLAYNAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order
+    #   is case sensitive.
+    #   
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #   
     # @return [Response] A Response object with data of type Array<OCI::Core::Models::ConsoleHistory>
     def list_console_histories(compartment_id, opts = {})
       logger.debug "Calling operation ComputeClient#list_console_histories." if logger
 
       fail "Missing the required parameter 'compartment_id' when calling list_console_histories." if compartment_id.nil?
 
+      if opts[:'sort_by'] && !['TIMECREATED', 'DISPLAYNAME'].include?(opts[:'sort_by'])
+        fail 'Invalid value for "sort_by", must be one of TIMECREATED, DISPLAYNAME.'
+      end
+
+      if opts[:'sort_order'] && !['ASC', 'DESC'].include?(opts[:'sort_order'])
+        fail 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:'lifecycle_state'] && !OCI::Core::Models::ConsoleHistory::LIFECYCLE_STATE_ENUM.include?(opts[:'lifecycle_state'])
+        fail 'Invalid value for "lifecycle_state", must be one of the values in OCI::Core::Models::ConsoleHistory::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = "/instanceConsoleHistories/"
 
       # Query Params
@@ -966,6 +995,9 @@ module OCI
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'page'] = opts[:'page'] if opts[:'page']
       query_params[:'instanceId'] = opts[:'instance_id'] if opts[:'instance_id']
+      query_params[:'sortBy'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sortOrder'] = opts[:'sort_order'] if opts[:'sort_order']
+      query_params[:'lifecycleState'] = opts[:'lifecycle_state'] if opts[:'lifecycle_state']
 
       # Header Params
       header_params = {}
@@ -984,16 +1016,15 @@ module OCI
         :return_type => 'Array<OCI::Core::Models::ConsoleHistory>')
     end
 
-    # Lists the available images in the specified compartment. For more
+    # Lists the available images in the specified compartment.
+    # If you specify a value for the `sortBy` parameter, Oracle-provided images appear first in the list, followed by custom images.
+    # For more
     # information about images, see
     # [Managing Custom Images](https://docs.us-phoenix-1.oraclecloud.com/Content/Compute/Tasks/managingcustomimages.htm).
     # 
     # @param [String] compartment_id The OCID of the compartment.
     # @param [Hash] opts the optional parameters
-    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it's changeable.
-    #   Avoid entering confidential information.
-    #   
-    #   Example: `My new resource`
+    # @option opts [String] :display_name A filter to return only resources that match the given display name exactly.
     #   
     # @option opts [String] :operating_system The image's operating system.
     #   
@@ -1009,12 +1040,40 @@ module OCI
     #   
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME
+    #   sort order is case sensitive.
+    #   
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #   
+    #   Allowed values are: TIMECREATED, DISPLAYNAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order
+    #   is case sensitive.
+    #   
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #   
     # @return [Response] A Response object with data of type Array<OCI::Core::Models::Image>
     def list_images(compartment_id, opts = {})
       logger.debug "Calling operation ComputeClient#list_images." if logger
 
       fail "Missing the required parameter 'compartment_id' when calling list_images." if compartment_id.nil?
 
+      if opts[:'sort_by'] && !['TIMECREATED', 'DISPLAYNAME'].include?(opts[:'sort_by'])
+        fail 'Invalid value for "sort_by", must be one of TIMECREATED, DISPLAYNAME.'
+      end
+
+      if opts[:'sort_order'] && !['ASC', 'DESC'].include?(opts[:'sort_order'])
+        fail 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:'lifecycle_state'] && !OCI::Core::Models::Image::LIFECYCLE_STATE_ENUM.include?(opts[:'lifecycle_state'])
+        fail 'Invalid value for "lifecycle_state", must be one of the values in OCI::Core::Models::Image::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = "/images/"
 
       # Query Params
@@ -1025,6 +1084,9 @@ module OCI
       query_params[:'operatingSystemVersion'] = opts[:'operating_system_version'] if opts[:'operating_system_version']
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'sortBy'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sortOrder'] = opts[:'sort_order'] if opts[:'sort_order']
+      query_params[:'lifecycleState'] = opts[:'lifecycle_state'] if opts[:'lifecycle_state']
 
       # Header Params
       header_params = {}
@@ -1098,10 +1160,7 @@ module OCI
     #   
     #   Example: `Uocm:PHX-AD-1`
     #   
-    # @option opts [String] :display_name A user-friendly name. Does not have to be unique, and it's changeable.
-    #   Avoid entering confidential information.
-    #   
-    #   Example: `My new resource`
+    # @option opts [String] :display_name A filter to return only resources that match the given display name exactly.
     #   
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #   
@@ -1109,12 +1168,40 @@ module OCI
     #   
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #   
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for DISPLAYNAME is ascending. The DISPLAYNAME
+    #   sort order is case sensitive.
+    #   
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #   
+    #   Allowed values are: TIMECREATED, DISPLAYNAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The DISPLAYNAME sort order
+    #   is case sensitive.
+    #   
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #   
     # @return [Response] A Response object with data of type Array<OCI::Core::Models::Instance>
     def list_instances(compartment_id, opts = {})
       logger.debug "Calling operation ComputeClient#list_instances." if logger
 
       fail "Missing the required parameter 'compartment_id' when calling list_instances." if compartment_id.nil?
 
+      if opts[:'sort_by'] && !['TIMECREATED', 'DISPLAYNAME'].include?(opts[:'sort_by'])
+        fail 'Invalid value for "sort_by", must be one of TIMECREATED, DISPLAYNAME.'
+      end
+
+      if opts[:'sort_order'] && !['ASC', 'DESC'].include?(opts[:'sort_order'])
+        fail 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:'lifecycle_state'] && !OCI::Core::Models::Instance::LIFECYCLE_STATE_ENUM.include?(opts[:'lifecycle_state'])
+        fail 'Invalid value for "lifecycle_state", must be one of the values in OCI::Core::Models::Instance::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = "/instances/"
 
       # Query Params
@@ -1124,6 +1211,9 @@ module OCI
       query_params[:'displayName'] = opts[:'display_name'] if opts[:'display_name']
       query_params[:'limit'] = opts[:'limit'] if opts[:'limit']
       query_params[:'page'] = opts[:'page'] if opts[:'page']
+      query_params[:'sortBy'] = opts[:'sort_by'] if opts[:'sort_by']
+      query_params[:'sortOrder'] = opts[:'sort_order'] if opts[:'sort_order']
+      query_params[:'lifecycleState'] = opts[:'lifecycle_state'] if opts[:'lifecycle_state']
 
       # Header Params
       header_params = {}