oci 2.5.10 → 2.5.11

data/lib/oci/monitoring/models/list_metrics_details.rb

@@ -5,8 +5,8 @@ require 'date'
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # The request details for retrieving metric definitions. Specify optional properties to filter the returned results.
-  # Use an asterisk (\"\\*\") as a wildcard character, placed anywhere in the string.
-  # For example, to search for all metrics with names that begin with \"disk\", specify \"name\" as \"disk\\*\".
+  # Use an asterisk (*) as a wildcard character, placed anywhere in the string.
+  # For example, to search for all metrics with names that begin with \"disk\", specify \"name\" as \"disk*\".
   # If no properties are specified, then all metric definitions within the request scope are returned.
   #
   class Monitoring::Models::ListMetricsDetails
@@ -45,8 +45,8 @@ module OCI
     # Group metrics by these fields in the response. For example, to list all metric namespaces available
     # in a compartment, groupBy the \"namespace\" field.
     #
-    # Example - group by namespace and resource:
-    # `[ \"namespace\", \"resourceId\" ]`
+    # Example - group by namespace:
+    # `[ \"namespace\" ]`
     #
     # @return [Array<String>]
     attr_accessor :group_by

data/lib/oci/monitoring/models/metric_data.rb

@@ -7,6 +7,19 @@ module OCI
   # The set of aggregated data returned for a metric.
   # For information about metrics, see [Metrics Overview](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#MetricsOverview).
   #
+  # Limits information for returned data follows.
+  #
+  # * Data points: 100,000.
+  # * Metric streams* within data points: 2,000.
+  # * Time range returned for 1-hour resolution: 90 days.
+  # * Time range returned for 5-minute resolution: 30 days.
+  # * Time range returned for any other resolution: 7 days.
+  #
+  # *A metric stream is an individual set of aggregated data for a metric, typically specific to a single resource.
+  # Metric streams cannot be aggregated across metric groups.
+  # A metric group is the combination of a given metric, metric namespace, and tenancy for the purpose of determining limits.
+  # For more information about metric-related concepts, see [Monitoring Concepts](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#concepts).
+  #
   class Monitoring::Models::MetricData
     # **[Required]** The reference provided in a metric definition to indicate the source service or
     # application that emitted the metric.
@@ -56,6 +69,7 @@ module OCI
     attr_accessor :resolution
 
     # **[Required]** The list of timestamp-value pairs returned for the specified request. Metric values are rolled up to the start time specified in the request.
+    # For important limits information related to data points, see MetricData Reference at the top of this page.
     #
     # @return [Array<OCI::Monitoring::Models::AggregatedDatapoint>]
     attr_accessor :aggregated_datapoints

data/lib/oci/monitoring/models/metric_data_details.rb

@@ -24,7 +24,7 @@ module OCI
 
     # **[Required]** The name of the metric.
     #
-    # A valid name value starts with an alphabetical character and includes only alphanumeric characters, dots, underscores, hyphens, and dollar signs.
+    # A valid name value starts with an alphabetical character and includes only alphanumeric characters, dots, underscores, hyphens, and dollar signs. The `oci_` prefix is reserved.
     # Avoid entering confidential information.
     #
     # Example: `my_app.success_rate`
@@ -32,9 +32,10 @@ module OCI
     # @return [String]
     attr_accessor :name
 
-    # Qualifiers provided in a metric definition. Available dimensions vary by metric namespace.
-    #
-    # Each dimension takes the form of a key-value pair. A valid dimension key includes only printable ASCII, excluding periods (.) and spaces. A valid dimension value includes only Unicode characters.
+    # **[Required]** Qualifiers provided in a metric definition. Available dimensions vary by metric namespace.
+    # Each dimension takes the form of a key-value pair.
+    # A valid dimension key includes only printable ASCII, excluding periods (.) and spaces. The character limit for a dimension key is 256.
+    # A valid dimension value includes only Unicode characters. The character limit for a dimension value is 256.
     # Empty strings are not allowed for keys or values. Avoid entering confidential information.
     #
     # Example: `\"resourceId\": \"ocid1.instance.region1.phx.exampleuniqueID\"`
@@ -43,6 +44,7 @@ module OCI
     attr_accessor :dimensions
 
     # Properties describing metrics. These are not part of the unique fields identifying the metric.
+    # Each metadata item takes the form of a key-value pair. The character limit for a metadata key is 256. The character limit for a metadata value is 256.
     #
     # Example: `\"unit\": \"bytes\"`
     #

data/lib/oci/monitoring/models/summarize_metrics_data_details.rb

@@ -19,6 +19,9 @@ module OCI
     # aggregate. The query must specify a metric, statistic, and interval. Supported values for
     # interval: `1m`-`60m` (also `1h`). You can optionally specify dimensions and grouping functions.
     # Supported grouping functions: `grouping()`, `groupBy()`.
+    #
+    # Construct your query to avoid exceeding limits on returned data. See {MetricData}.
+    #
     # For details about Monitoring Query Language (MQL), see
     # [Monitoring Query Language (MQL) Reference](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Reference/mql.htm).
     # For available dimensions, review the metric definition for the supported service.

data/lib/oci/monitoring/models/update_alarm_details.rb

@@ -116,9 +116,10 @@ module OCI
     # @return [String]
     attr_accessor :body
 
-    # An array of [OCIDs](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) to which the notifications for
-    # this alarm will be delivered. An example destination is an OCID for a topic managed by the
-    # Oracle Cloud Infrastructure Notification service.
+    # A list of destinations to which the notifications for this alarm will be delivered.
+    # Each destination is represented by an [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) related to the supported destination service.
+    # For example, a destination using the Notifications service is represented by a topic OCID.
+    # Supported destination services: Notifications Service. Limit: One destination per supported destination service.
     #
     # @return [Array<String>]
     attr_accessor :destinations

data/lib/oci/monitoring/monitoring.rb

@@ -16,6 +16,7 @@ require 'oci/monitoring/models/alarm_history_collection'
 require 'oci/monitoring/models/alarm_history_entry'
 require 'oci/monitoring/models/alarm_status_summary'
 require 'oci/monitoring/models/alarm_summary'
+require 'oci/monitoring/models/change_alarm_compartment_details'
 require 'oci/monitoring/models/create_alarm_details'
 require 'oci/monitoring/models/datapoint'
 require 'oci/monitoring/models/failed_metric_record'

data/lib/oci/monitoring/monitoring_client.rb

@@ -6,6 +6,7 @@ require 'logger'
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # Use the Monitoring API to manage metric queries and alarms for assessing the health, capacity, and performance of your cloud resources.
+  # Endpoints vary by operation. For PostMetric, use the `telemetry-ingestion` endpoints; for all other operations, use the `telemetry` endpoints.
   # For information about monitoring, see [Monitoring Overview](/iaas/Content/Monitoring/Concepts/monitoringoverview.htm).
   class Monitoring::MonitoringClient
     # Client used to make HTTP requests.
@@ -95,7 +96,7 @@ module OCI
 
       raise 'A region must be specified.' unless @region
 
-      @endpoint = OCI::Regions.get_service_endpoint(@region, :MonitoringClient) + '/20180401'
+      @endpoint = OCI::Regions.get_service_endpoint_for_template(@region, 'https://telemetry.{region}.{secondLevelDomain}') + '/20180401'
       logger.info "MonitoringClient endpoint set to '#{@endpoint} from region #{@region}'." if logger
     end
 
@@ -109,7 +110,83 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Moves an alarm into a different compartment within the same tenancy.
+    #
+    # For information about moving resources between compartments, see [Moving Resources Between Compartments](https://docs.cloud.oracle.com/iaas/Content/Identity/Tasks/managingcompartments.htm#moveRes).
+    #
+    # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
+    #
+    # @param [OCI::Monitoring::Models::ChangeAlarmCompartmentDetails] change_alarm_compartment_details The configuration details for moving an alarm.
+    # @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
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @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.
+    #
+    # @option opts [String] :opc_request_id Customer part of the request identifier token. If you need to contact Oracle about a particular
+    #   request, please provide the complete request ID.
+    #
+    # @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. For example, if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   might be rejected.
+    #
+    # @return [Response] A Response object with data of type nil
+    def change_alarm_compartment(alarm_id, change_alarm_compartment_details, opts = {})
+      logger.debug 'Calling operation MonitoringClient#change_alarm_compartment.' if logger
+
+      raise "Missing the required parameter 'alarm_id' when calling change_alarm_compartment." if alarm_id.nil?
+      raise "Missing the required parameter 'change_alarm_compartment_details' when calling change_alarm_compartment." if change_alarm_compartment_details.nil?
+      raise "Parameter value for 'alarm_id' must not be blank" if OCI::Internal::Util.blank_string?(alarm_id)
+
+      path = '/alarms/{alarmId}/actions/changeCompartment'.sub('{alarmId}', alarm_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # 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]
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(change_alarm_compartment_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'MonitoringClient#change_alarm_compartment') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Creates a new alarm in the specified compartment.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [OCI::Monitoring::Models::CreateAlarmDetails] create_alarm_details Document for creating an alarm.
     # @param [Hash] opts the optional parameters
@@ -173,12 +250,19 @@ module OCI
 
 
     # Deletes the specified alarm.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
     # @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
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @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.
+    #
     # @option opts [String] :opc_request_id Customer part of the request identifier token. If you need to contact Oracle about a particular
     #   request, please provide the complete request ID.
     #
@@ -200,6 +284,7 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
       header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       # rubocop:enable Style/NegatedIf
 
@@ -229,6 +314,9 @@ module OCI
 
 
     # Gets the specified alarm.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -286,6 +374,9 @@ module OCI
 
 
     # Get the history of the specified alarm.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -305,7 +396,6 @@ module OCI
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
-    #   1 is the minimum, 1000 is the maximum.
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Default: 1000
@@ -377,11 +467,16 @@ module OCI
 
 
     # Lists the alarms for the specified compartment.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the
     #   resources monitored by the metric that you are searching for. Use tenancyId to search in
     #   the root compartment.
     #
+    #   Example: `ocid1.compartment.oc1..exampleuniqueID`
+    #
     # @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
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -392,7 +487,6 @@ module OCI
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
-    #   1 is the minimum, 1000 is the maximum.
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Default: 1000
@@ -487,11 +581,16 @@ module OCI
 
 
     # List the status of each alarm in the specified compartment.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the
     #   resources monitored by the metric that you are searching for. Use tenancyId to search in
     #   the root compartment.
     #
+    #   Example: `ocid1.compartment.oc1..exampleuniqueID`
+    #
     # @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
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
@@ -508,7 +607,6 @@ module OCI
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
-    #   1 is the minimum, 1000 is the maximum.
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Default: 1000
@@ -591,11 +689,16 @@ module OCI
 
     # Returns metric definitions that match the criteria specified in the request. Compartment OCID required.
     # For information about metrics, see [Metrics Overview](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#MetricsOverview).
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the
     #   resources monitored by the metric that you are searching for. Use tenancyId to search in
     #   the root compartment.
     #
+    #   Example: `ocid1.compartment.oc1..exampleuniqueID`
+    #
     # @param [OCI::Monitoring::Models::ListMetricsDetails] list_metrics_details The dimensions used to filter metrics.
     # @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
@@ -607,7 +710,6 @@ module OCI
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
-    #   1 is the minimum, 1000 is the maximum.
     #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Default: 1000
@@ -673,6 +775,18 @@ module OCI
 
     # Publishes raw metric data points to the Monitoring service.
     # For more information about publishing metrics, see [Publishing Custom Metrics](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/publishingcustommetrics.htm).
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Per-call limits information follows.
+    #
+    # * Dimensions per metric group*. Maximum: 20. Minimum: 1.
+    # * Unique metric streams*. Maximum: 50.
+    # * Transactions Per Second (TPS) per-tenancy limit for this operation: 50.
+    #
+    # *A metric group is the combination of a given metric, metric namespace, and tenancy for the purpose of determining limits.
+    # A dimension is a qualifier provided in a metric definition.
+    # A metric stream is an individual set of aggregated data for a metric, typically specific to a resource.
+    # For more information about metric-related concepts, see [Monitoring Concepts](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#concepts).
     #
     # The endpoints for this operation differ from other Monitoring operations. Replace the string `telemetry` with `telemetry-ingestion` in the endpoint, as in the following example:
     #
@@ -733,12 +847,19 @@ module OCI
 
 
     # Removes any existing suppression for the specified alarm.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
     # @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
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @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.
+    #
     # @option opts [String] :opc_request_id Customer part of the request identifier token. If you need to contact Oracle about a particular
     #   request, please provide the complete request ID.
     #
@@ -760,6 +881,7 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
       header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       # rubocop:enable Style/NegatedIf
 
@@ -790,11 +912,16 @@ module OCI
 
     # Returns aggregated data that match the criteria specified in the request. Compartment OCID required.
     # For information on metric queries, see [Building Metric Queries](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/buildingqueries.htm).
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 10.
     #
     # @param [String] compartment_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment containing the
     #   resources monitored by the metric that you are searching for. Use tenancyId to search in
     #   the root compartment.
     #
+    #   Example: `ocid1.compartment.oc1..exampleuniqueID`
+    #
     # @param [OCI::Monitoring::Models::SummarizeMetricsDataDetails] summarize_metrics_data_details The dimensions used to filter for metrics.
     # @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
@@ -858,6 +985,9 @@ module OCI
 
 
     # Updates the specified alarm.
+    # For important limits information, see [Limits on Monitoring](https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#Limits).
+    #
+    # Transactions Per Second (TPS) per-tenancy limit for this operation: 1.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -865,6 +995,10 @@ module OCI
     # @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
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @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.
+    #
     # @option opts [String] :opc_request_id Customer part of the request identifier token. If you need to contact Oracle about a particular
     #   request, please provide the complete request ID.
     #
@@ -887,6 +1021,7 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
       header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       # rubocop:enable Style/NegatedIf
 

data/lib/oci/ons/models/backoff_retry_policy.rb

@@ -13,11 +13,11 @@ module OCI
       POLICY_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The maximum retry duration in milliseconds.
+    # **[Required]** The maximum retry duration in milliseconds. Default value is `7200000` (2 hours).
     # @return [Integer]
     attr_accessor :max_retry_duration
 
-    # **[Required]** The type of delivery policy. Default value: EXPONENTIAL.
+    # **[Required]** The type of delivery policy.
     #
     # @return [String]
     attr_reader :policy_type

data/lib/oci/ons/models/change_compartment_details.rb

@@ -0,0 +1,156 @@
+# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # The configuration details for the move operation.
+  #
+  class Ons::Models::ChangeCompartmentDetails
+    # **[Required]** The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of the compartment to move the specified topic
+    # or subscription to.
+    #
+    # @return [String]
+    attr_accessor :compartment_id
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'compartment_id': :'compartmentId'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'compartment_id': :'String'
+        # 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] :compartment_id The value to assign to the {#compartment_id} 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.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']
+    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 &&
+        compartment_id == other.compartment_id
+    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
+      [compartment_id].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