oci 2.5.10 → 2.9.0

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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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'
 

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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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'
 

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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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'
 
@@ -15,10 +16,22 @@ module OCI
     # @return [String]
     attr_accessor :namespace
 
+    # Resource group that you want to use as a filter. The specified resource group must exist in the definition of the posted metric. Only one resource group can be applied per metric.
+    # A valid resourceGroup value starts with an alphabetical character and includes only alphanumeric characters, periods (.), underscores (_), hyphens (-), and dollar signs ($).
+    # Avoid entering confidential information.
+    #
+    # Example: `frontend-fleet`
+    #
+    # @return [String]
+    attr_accessor :resource_group
+
     # **[Required]** The Monitoring Query Language (MQL) expression to use when searching for metric data points to
     # 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.
@@ -63,6 +76,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'namespace': :'namespace',
+        'resource_group': :'resourceGroup',
         'query': :'query',
         'start_time': :'startTime',
         'end_time': :'endTime',
@@ -76,6 +90,7 @@ module OCI
       {
         # rubocop:disable Style/SymbolLiteral
         'namespace': :'String',
+        'resource_group': :'String',
         'query': :'String',
         'start_time': :'DateTime',
         'end_time': :'DateTime',
@@ -91,6 +106,7 @@ module OCI
     # Initializes the object
     # @param [Hash] attributes Model attributes in the form of hash
     # @option attributes [String] :namespace The value to assign to the {#namespace} property
+    # @option attributes [String] :resource_group The value to assign to the {#resource_group} property
     # @option attributes [String] :query The value to assign to the {#query} property
     # @option attributes [DateTime] :start_time The value to assign to the {#start_time} property
     # @option attributes [DateTime] :end_time The value to assign to the {#end_time} property
@@ -103,6 +119,12 @@ module OCI
 
       self.namespace = attributes[:'namespace'] if attributes[:'namespace']
 
+      self.resource_group = attributes[:'resourceGroup'] if attributes[:'resourceGroup']
+
+      raise 'You cannot provide both :resourceGroup and :resource_group' if attributes.key?(:'resourceGroup') && attributes.key?(:'resource_group')
+
+      self.resource_group = attributes[:'resource_group'] if attributes[:'resource_group']
+
       self.query = attributes[:'query'] if attributes[:'query']
 
       self.start_time = attributes[:'startTime'] if attributes[:'startTime']
@@ -132,6 +154,7 @@ module OCI
 
       self.class == other.class &&
         namespace == other.namespace &&
+        resource_group == other.resource_group &&
         query == other.query &&
         start_time == other.start_time &&
         end_time == other.end_time &&
@@ -151,7 +174,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [namespace, query, start_time, end_time, resolution].hash
+      [namespace, resource_group, query, start_time, end_time, resolution].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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'

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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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'
 
@@ -48,6 +49,15 @@ module OCI
     # @return [String]
     attr_accessor :namespace
 
+    # Resource group that you want to use as a filter. The alarm retrieves metric data associated with the specified resource group only. Only one resource group can be applied per metric.
+    # A valid resourceGroup value starts with an alphabetical character and includes only alphanumeric characters, periods (.), underscores (_), hyphens (-), and dollar signs ($).
+    # Avoid entering confidential information.
+    #
+    # Example: `frontend-fleet`
+    #
+    # @return [String]
+    attr_accessor :resource_group
+
     # The Monitoring Query Language (MQL) expression to evaluate for the alarm. The Alarms feature of
     # the Monitoring service interprets results for each returned time series as Boolean values,
     # where zero represents false and a non-zero value represents true. A true value means that the trigger
@@ -83,17 +93,18 @@ module OCI
     attr_accessor :resolution
 
     # The period of time that the condition defined in the alarm must persist before the alarm state
-    # changes from \"OK\" to \"FIRING\" or vice versa. For example, a value of 5 minutes means that the
+    # changes from \"OK\" to \"FIRING\". For example, a value of 5 minutes means that the
     # alarm must persist in breaching the condition for five minutes before the alarm updates its
-    # state to \"FIRING\"; likewise, the alarm must persist in not breaching the condition for five
-    # minutes before the alarm updates its state to \"OK.\"
+    # state to \"FIRING\".
     #
     # The duration is specified as a string in ISO 8601 format (`PT10M` for ten minutes or `PT1H`
     # for one hour). Minimum: PT1M. Maximum: PT1H. Default: PT1M.
     #
     # Under the default value of PT1M, the first evaluation that breaches the alarm updates the
-    # state to \"FIRING\" and the first evaluation that does not breach the alarm updates the state
-    # to \"OK\".
+    # state to \"FIRING\".
+    #
+    # The alarm updates its status to \"OK\" when the breaching condition has been clear for
+    # the most recent minute.
     #
     # Example: `PT5M`
     #
@@ -116,9 +127,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
@@ -167,6 +179,7 @@ module OCI
         'metric_compartment_id': :'metricCompartmentId',
         'metric_compartment_id_in_subtree': :'metricCompartmentIdInSubtree',
         'namespace': :'namespace',
+        'resource_group': :'resourceGroup',
         'query': :'query',
         'resolution': :'resolution',
         'pending_duration': :'pendingDuration',
@@ -191,6 +204,7 @@ module OCI
         'metric_compartment_id': :'String',
         'metric_compartment_id_in_subtree': :'BOOLEAN',
         'namespace': :'String',
+        'resource_group': :'String',
         'query': :'String',
         'resolution': :'String',
         'pending_duration': :'String',
@@ -217,6 +231,7 @@ module OCI
     # @option attributes [String] :metric_compartment_id The value to assign to the {#metric_compartment_id} property
     # @option attributes [BOOLEAN] :metric_compartment_id_in_subtree The value to assign to the {#metric_compartment_id_in_subtree} property
     # @option attributes [String] :namespace The value to assign to the {#namespace} property
+    # @option attributes [String] :resource_group The value to assign to the {#resource_group} property
     # @option attributes [String] :query The value to assign to the {#query} property
     # @option attributes [String] :resolution The value to assign to the {#resolution} property
     # @option attributes [String] :pending_duration The value to assign to the {#pending_duration} property
@@ -260,6 +275,12 @@ module OCI
 
       self.namespace = attributes[:'namespace'] if attributes[:'namespace']
 
+      self.resource_group = attributes[:'resourceGroup'] if attributes[:'resourceGroup']
+
+      raise 'You cannot provide both :resourceGroup and :resource_group' if attributes.key?(:'resourceGroup') && attributes.key?(:'resource_group')
+
+      self.resource_group = attributes[:'resource_group'] if attributes[:'resource_group']
+
       self.query = attributes[:'query'] if attributes[:'query']
 
       self.resolution = attributes[:'resolution'] if attributes[:'resolution']
@@ -319,6 +340,7 @@ module OCI
         metric_compartment_id == other.metric_compartment_id &&
         metric_compartment_id_in_subtree == other.metric_compartment_id_in_subtree &&
         namespace == other.namespace &&
+        resource_group == other.resource_group &&
         query == other.query &&
         resolution == other.resolution &&
         pending_duration == other.pending_duration &&
@@ -345,7 +367,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [display_name, compartment_id, metric_compartment_id, metric_compartment_id_in_subtree, namespace, query, resolution, pending_duration, severity, body, destinations, repeat_notification_duration, suppression, is_enabled, freeform_tags, defined_tags].hash
+      [display_name, compartment_id, metric_compartment_id, metric_compartment_id_in_subtree, namespace, resource_group, query, resolution, pending_duration, severity, body, destinations, repeat_notification_duration, suppression, is_enabled, freeform_tags, defined_tags].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/monitoring/monitoring.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 module OCI
   module Monitoring
@@ -16,6 +17,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

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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 'uri'
 require 'logger'
@@ -6,6 +7,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.
@@ -51,16 +53,14 @@ module OCI
     #   apply across all operations. This can be overridden on a per-operation basis. The default retry configuration value is `nil`, which means that an operation
     #   will not perform any retries
     def initialize(config: nil, region: nil, endpoint: nil, signer: nil, proxy_settings: nil, retry_config: nil)
-      # If the signer is an InstancePrincipalsSecurityTokenSigner and no config was supplied (which is valid for instance principals)
+      # If the signer is an InstancePrincipalsSecurityTokenSigner or SecurityTokenSigner and no config was supplied (they are self-sufficient signers)
       # then create a dummy config to pass to the ApiClient constructor. If customers wish to create a client which uses instance principals
       # and has config (either populated programmatically or loaded from a file), they must construct that config themselves and then
       # pass it to this constructor.
       #
       # If there is no signer (or the signer is not an instance principals signer) and no config was supplied, this is not valid
       # so try and load the config from the default file.
-      config ||= OCI.config unless signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
-      config ||= OCI::Config.new if signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
-      config.validate unless signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
+      config = OCI::Config.validate_and_build_config_with_signer(config, signer)
 
       if signer.nil?
         signer = OCI::Signer.new(
@@ -95,7 +95,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 +109,85 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @param [OCI::Monitoring::Models::CreateAlarmDetails] create_alarm_details Document for creating an alarm.
     # @param [Hash] opts the optional parameters
@@ -173,12 +251,21 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @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 +287,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 +317,11 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -286,6 +379,11 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -305,7 +403,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 +474,18 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @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 +496,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 +590,18 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @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 +618,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 +700,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: 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::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 +721,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 +786,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 +858,21 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @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 +894,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 +925,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 +998,11 @@ 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).
+    #
+    # This call is subject to a Monitoring limit that applies to the total number of requests across all alarm operations.
+    # Monitoring might throttle this call to reject an otherwise valid request when the total rate of alarm operations exceeds 10 requests,
+    # or transactions, per second (TPS) for a given tenancy.
     #
     # @param [String] alarm_id The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of an alarm.
     #
@@ -865,6 +1010,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 +1036,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