oci 2.16.0 → 2.17.0

data/lib/oci/ai_vision/models/work_request_summary.rb

@@ -0,0 +1,313 @@
+# Copyright (c) 2016, 2022, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+require 'date'
+require 'logger'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # Summary of the status of a work request.
+  class AiVision::Models::WorkRequestSummary
+    OPERATION_TYPE_ENUM = [
+      OPERATION_TYPE_CREATE_PROJECT = 'CREATE_PROJECT'.freeze,
+      OPERATION_TYPE_UPDATE_PROJECT = 'UPDATE_PROJECT'.freeze,
+      OPERATION_TYPE_DELETE_PROJECT = 'DELETE_PROJECT'.freeze,
+      OPERATION_TYPE_MOVE_PROJECT = 'MOVE_PROJECT'.freeze,
+      OPERATION_TYPE_CREATE_MODEL = 'CREATE_MODEL'.freeze,
+      OPERATION_TYPE_UPDATE_MODEL = 'UPDATE_MODEL'.freeze,
+      OPERATION_TYPE_DELETE_MODEL = 'DELETE_MODEL'.freeze,
+      OPERATION_TYPE_MOVE_MODEL = 'MOVE_MODEL'.freeze,
+      OPERATION_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    STATUS_ENUM = [
+      STATUS_ACCEPTED = 'ACCEPTED'.freeze,
+      STATUS_IN_PROGRESS = 'IN_PROGRESS'.freeze,
+      STATUS_WAITING = 'WAITING'.freeze,
+      STATUS_FAILED = 'FAILED'.freeze,
+      STATUS_SUCCEEDED = 'SUCCEEDED'.freeze,
+      STATUS_CANCELING = 'CANCELING'.freeze,
+      STATUS_CANCELED = 'CANCELED'.freeze,
+      STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # **[Required]** Type of the work request.
+    # @return [String]
+    attr_reader :operation_type
+
+    # **[Required]** Status of current work request.
+    # @return [String]
+    attr_reader :status
+
+    # **[Required]** The id of the work request.
+    # @return [String]
+    attr_accessor :id
+
+    # **[Required]** The ocid of the compartment that contains the work request. Work requests should be scoped to
+    # the same compartment as the resource the work request affects. If the work request affects multiple resources,
+    # and those resources are not in the same compartment, it is up to the service team to pick the primary
+    # resource whose compartment should be used.
+    #
+    # @return [String]
+    attr_accessor :compartment_id
+
+    # **[Required]** The resources affected by this work request.
+    # @return [Array<OCI::AiVision::Models::WorkRequestResource>]
+    attr_accessor :resources
+
+    # **[Required]** Percentage of the request completed.
+    # @return [Float]
+    attr_accessor :percent_complete
+
+    # **[Required]** The date and time the request was created, as described in
+    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    #
+    # @return [DateTime]
+    attr_accessor :time_accepted
+
+    # The date and time the request was started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339),
+    # section 14.29.
+    #
+    # @return [DateTime]
+    attr_accessor :time_started
+
+    # The date and time the object was finished, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339).
+    #
+    # @return [DateTime]
+    attr_accessor :time_finished
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'operation_type': :'operationType',
+        'status': :'status',
+        'id': :'id',
+        'compartment_id': :'compartmentId',
+        'resources': :'resources',
+        'percent_complete': :'percentComplete',
+        'time_accepted': :'timeAccepted',
+        'time_started': :'timeStarted',
+        'time_finished': :'timeFinished'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'operation_type': :'String',
+        'status': :'String',
+        'id': :'String',
+        'compartment_id': :'String',
+        'resources': :'Array<OCI::AiVision::Models::WorkRequestResource>',
+        'percent_complete': :'Float',
+        'time_accepted': :'DateTime',
+        'time_started': :'DateTime',
+        'time_finished': :'DateTime'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :operation_type The value to assign to the {#operation_type} property
+    # @option attributes [String] :status The value to assign to the {#status} property
+    # @option attributes [String] :id The value to assign to the {#id} property
+    # @option attributes [String] :compartment_id The value to assign to the {#compartment_id} property
+    # @option attributes [Array<OCI::AiVision::Models::WorkRequestResource>] :resources The value to assign to the {#resources} property
+    # @option attributes [Float] :percent_complete The value to assign to the {#percent_complete} property
+    # @option attributes [DateTime] :time_accepted The value to assign to the {#time_accepted} property
+    # @option attributes [DateTime] :time_started The value to assign to the {#time_started} property
+    # @option attributes [DateTime] :time_finished The value to assign to the {#time_finished} property
+    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 }
+
+      self.operation_type = attributes[:'operationType'] if attributes[:'operationType']
+
+      raise 'You cannot provide both :operationType and :operation_type' if attributes.key?(:'operationType') && attributes.key?(:'operation_type')
+
+      self.operation_type = attributes[:'operation_type'] if attributes[:'operation_type']
+
+      self.status = attributes[:'status'] if attributes[:'status']
+
+      self.id = attributes[:'id'] if attributes[:'id']
+
+      self.compartment_id = attributes[:'compartmentId'] if attributes[:'compartmentId']
+
+      raise 'You cannot provide both :compartmentId and :compartment_id' if attributes.key?(:'compartmentId') && attributes.key?(:'compartment_id')
+
+      self.compartment_id = attributes[:'compartment_id'] if attributes[:'compartment_id']
+
+      self.resources = attributes[:'resources'] if attributes[:'resources']
+
+      self.percent_complete = attributes[:'percentComplete'] if attributes[:'percentComplete']
+
+      raise 'You cannot provide both :percentComplete and :percent_complete' if attributes.key?(:'percentComplete') && attributes.key?(:'percent_complete')
+
+      self.percent_complete = attributes[:'percent_complete'] if attributes[:'percent_complete']
+
+      self.time_accepted = attributes[:'timeAccepted'] if attributes[:'timeAccepted']
+
+      raise 'You cannot provide both :timeAccepted and :time_accepted' if attributes.key?(:'timeAccepted') && attributes.key?(:'time_accepted')
+
+      self.time_accepted = attributes[:'time_accepted'] if attributes[:'time_accepted']
+
+      self.time_started = attributes[:'timeStarted'] if attributes[:'timeStarted']
+
+      raise 'You cannot provide both :timeStarted and :time_started' if attributes.key?(:'timeStarted') && attributes.key?(:'time_started')
+
+      self.time_started = attributes[:'time_started'] if attributes[:'time_started']
+
+      self.time_finished = attributes[:'timeFinished'] if attributes[:'timeFinished']
+
+      raise 'You cannot provide both :timeFinished and :time_finished' if attributes.key?(:'timeFinished') && attributes.key?(:'time_finished')
+
+      self.time_finished = attributes[:'time_finished'] if attributes[:'time_finished']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] operation_type Object to be assigned
+    def operation_type=(operation_type)
+      # rubocop:disable Style/ConditionalAssignment
+      if operation_type && !OPERATION_TYPE_ENUM.include?(operation_type)
+        OCI.logger.debug("Unknown value for 'operation_type' [" + operation_type + "]. Mapping to 'OPERATION_TYPE_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @operation_type = OPERATION_TYPE_UNKNOWN_ENUM_VALUE
+      else
+        @operation_type = operation_type
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] status Object to be assigned
+    def status=(status)
+      # rubocop:disable Style/ConditionalAssignment
+      if status && !STATUS_ENUM.include?(status)
+        OCI.logger.debug("Unknown value for 'status' [" + status + "]. Mapping to 'STATUS_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @status = STATUS_UNKNOWN_ENUM_VALUE
+      else
+        @status = status
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        operation_type == other.operation_type &&
+        status == other.status &&
+        id == other.id &&
+        compartment_id == other.compartment_id &&
+        resources == other.resources &&
+        percent_complete == other.percent_complete &&
+        time_accepted == other.time_accepted &&
+        time_started == other.time_started &&
+        time_finished == other.time_finished
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [operation_type, status, id, compartment_id, resources, percent_complete, time_accepted, time_started, time_finished].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # 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)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            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
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # 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 = public_method(attr).call
+        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
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength

data/lib/oci/ai_vision/models/work_request_summary_collection.rb

@@ -0,0 +1,150 @@
+# Copyright (c) 2016, 2022, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # Results of a workRequest search.
+  class AiVision::Models::WorkRequestSummaryCollection
+    # **[Required]** List of workRequestSummary objects.
+    # @return [Array<OCI::AiVision::Models::WorkRequestSummary>]
+    attr_accessor :items
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'items': :'items'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'items': :'Array<OCI::AiVision::Models::WorkRequestSummary>'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [Array<OCI::AiVision::Models::WorkRequestSummary>] :items The value to assign to the {#items} property
+    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 }
+
+      self.items = attributes[:'items'] if attributes[:'items']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        items == other.items
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [items].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # 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)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            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
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # 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 = public_method(attr).call
+        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
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength

data/lib/oci/ai_vision/util.rb

@@ -0,0 +1,3 @@
+# Copyright (c) 2016, 2022, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+

data/lib/oci/announcements_service/announcement_client.rb

@@ -84,7 +84,7 @@ module OCI
 
       raise 'A region must be specified.' unless @region
 
-      @endpoint = OCI::Regions.get_service_endpoint_for_template(@region, 'https://announcements.{region}.{secondLevelDomain}') + '/20180904'
+      @endpoint = OCI::Regions.get_service_endpoint_for_template(@region, 'https://announcements.{region}.oci.{secondLevelDomain}') + '/20180904'
       logger.info "AnnouncementClient endpoint set to '#{@endpoint} from region #{@region}'." if logger
     end
 
@@ -100,6 +100,8 @@ module OCI
 
     # Gets the details of a specific announcement.
     #
+    # This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.
+    #
     # @param [String] announcement_id The OCID of the announcement.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -157,6 +159,8 @@ module OCI
 
     # Gets information about whether a specific announcement was acknowledged by a user.
     #
+    # This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.
+    #
     # @param [String] announcement_id The OCID of the announcement.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -214,8 +218,9 @@ module OCI
 
     # Gets a list of announcements for the current tenancy.
     #
-    # @param [String] compartment_id The OCID of the compartment. Because announcements are specific to a tenancy, this is the
-    #   OCID of the root compartment.
+    # This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.
+    #
+    # @param [String] compartment_id The OCID of the compartment.
     #
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
@@ -234,6 +239,11 @@ module OCI
     #   Allowed values are: ASC, DESC
     # @option opts [DateTime] :time_one_earliest_time The boundary for the earliest `timeOneValue` date on announcements that you want to see.
     # @option opts [DateTime] :time_one_latest_time The boundary for the latest `timeOneValue` date on announcements that you want to see.
+    # @option opts [String] :environment_name A filter to return only announcements that match a specific environment name.
+    # @option opts [String] :service A filter to return only announcements affecting a specific service.
+    # @option opts [String] :platform_type A filter to return only announcements affecting a specific platform.
+    #   Allowed values are: IAAS, SAAS
+    # @option opts [Array<String>] :exclude_announcement_types Exclude The type of announcement.
     # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about
     #   a particular request, please provide the complete request ID.
     #
@@ -256,6 +266,10 @@ module OCI
         raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
       end
 
+      if opts[:platform_type] && !%w[IAAS SAAS].include?(opts[:platform_type])
+        raise 'Invalid value for "platform_type", must be one of IAAS, SAAS.'
+      end
+
       path = '/announcements'
       operation_signing_strategy = :standard
 
@@ -272,6 +286,10 @@ module OCI
       query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
       query_params[:timeOneEarliestTime] = opts[:time_one_earliest_time] if opts[:time_one_earliest_time]
       query_params[:timeOneLatestTime] = opts[:time_one_latest_time] if opts[:time_one_latest_time]
+      query_params[:environmentName] = opts[:environment_name] if opts[:environment_name]
+      query_params[:service] = opts[:service] if opts[:service]
+      query_params[:platformType] = opts[:platform_type] if opts[:platform_type]
+      query_params[:excludeAnnouncementTypes] = OCI::ApiClient.build_collection_params(opts[:exclude_announcement_types], :multi) if opts[:exclude_announcement_types] && !opts[:exclude_announcement_types].empty?
 
       # Header Params
       header_params = {}
@@ -308,6 +326,8 @@ module OCI
 
     # Updates the status of the specified announcement with regard to whether it has been marked as read.
     #
+    # This call is subject to an Announcements limit that applies to the total number of requests across all read or write operations. Announcements might throttle this call to reject an otherwise valid request when the total rate of operations exceeds 20 requests per second for a given user. The service might also throttle this call to reject an otherwise valid request when the total rate of operations exceeds 100 requests per second for a given tenancy.
+    #
     # @param [String] announcement_id The OCID of the announcement.
     # @param [OCI::AnnouncementsService::Models::AnnouncementUserStatusDetails] status_details The information to use to update the announcement's read status.
     # @param [Hash] opts the optional parameters
@@ -317,7 +337,7 @@ module OCI
     # @option opts [String] :opc_request_id The unique Oracle-assigned identifier for the request. If you need to contact Oracle about
     #   a particular request, please provide the complete request ID.
     #
-    # @return [Response] A Response object with data of type nil
+    # @return [Response] A Response object with data of type {OCI::AnnouncementsService::Models::AnnouncementUserStatusDetails AnnouncementUserStatusDetails}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/announcementsservice/update_announcement_user_status.rb.html) to see an example of how to use update_announcement_user_status API.
     def update_announcement_user_status(announcement_id, status_details, opts = {})
       logger.debug 'Calling operation AnnouncementClient#update_announcement_user_status.' if logger
@@ -352,7 +372,8 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body
+          body: post_body,
+          return_type: 'OCI::AnnouncementsService::Models::AnnouncementUserStatusDetails'
         )
       end
       # rubocop:enable Metrics/BlockLength