oci 2.118.2__py3-none-any.whl → 2.119.0__py3-none-any.whl

oci/monitoring/monitoring_client.py

@@ -23,7 +23,7 @@ missing = Sentinel("Missing")
 class MonitoringClient(object):
     """
     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.
+    Endpoints vary by operation. For PostMetricData, use the `telemetry-ingestion` endpoints; for all other operations, use the `telemetry` endpoints.
     For more information, see
     [the Monitoring documentation](/iaas/Content/Monitoring/home.htm).
     """
@@ -168,7 +168,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/change_alarm_compartment.py.html>`__ to see an example of how to use change_alarm_compartment API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/change_alarm_compartment.py.html>`__ to see an example of how to use change_alarm_compartment API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']
@@ -288,7 +288,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/create_alarm.py.html>`__ to see an example of how to use create_alarm API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/create_alarm.py.html>`__ to see an example of how to use create_alarm API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -350,6 +350,112 @@ class MonitoringClient(object):
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
+    def create_alarm_suppression(self, create_alarm_suppression_details, **kwargs):
+        """
+        Creates a dimension-specific suppression for an alarm.
+
+        For important limits information, see
+        `Limits on Monitoring`__.
+
+        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.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
+
+
+        :param oci.monitoring.models.CreateAlarmSuppressionDetails create_alarm_suppression_details: (required)
+            The details of the alarm suppression to be created
+
+        :param str opc_request_id: (optional)
+            Customer part of the request identifier token. If you need to contact Oracle about a particular
+            request, please provide the complete request ID.
+
+        :param str opc_retry_token: (optional)
+            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.
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmSuppression`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/create_alarm_suppression.py.html>`__ to see an example of how to use create_alarm_suppression API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = []
+        resource_path = "/alarmSuppressions"
+        method = "POST"
+        operation_name = "create_alarm_suppression"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmSuppression/CreateAlarmSuppression"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "opc_retry_token"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"create_alarm_suppression got unknown kwargs: {extra_kwargs!r}")
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing),
+            "opc-retry-token": kwargs.get("opc_retry_token", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_retry_token_if_needed(header_params)
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                header_params=header_params,
+                body=create_alarm_suppression_details,
+                response_type="AlarmSuppression",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                header_params=header_params,
+                body=create_alarm_suppression_details,
+                response_type="AlarmSuppression",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def delete_alarm(self, alarm_id, **kwargs):
         """
         Deletes the specified alarm.
@@ -396,7 +502,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/delete_alarm.py.html>`__ to see an example of how to use delete_alarm API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/delete_alarm.py.html>`__ to see an example of how to use delete_alarm API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']
@@ -415,7 +521,380 @@ class MonitoringClient(object):
         extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
         if extra_kwargs:
             raise ValueError(
-                f"delete_alarm got unknown kwargs: {extra_kwargs!r}")
+                f"delete_alarm got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "alarmId": alarm_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "if-match": kwargs.get("if_match", missing),
+            "opc-request-id": kwargs.get("opc_request_id", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
+    def delete_alarm_suppression(self, alarm_suppression_id, **kwargs):
+        """
+        Deletes the specified alarm suppression.
+
+        For important limits information, see
+        `Limits on Monitoring`__.
+
+        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.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
+
+
+        :param str alarm_suppression_id: (required)
+            The `OCID`__ of the alarm suppression.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Customer part of the request identifier token. If you need to contact Oracle about a particular
+            request, please provide the complete request ID.
+
+        :param str if_match: (optional)
+            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.
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type None
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/delete_alarm_suppression.py.html>`__ to see an example of how to use delete_alarm_suppression API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['alarmSuppressionId']
+        resource_path = "/alarmSuppressions/{alarmSuppressionId}"
+        method = "DELETE"
+        operation_name = "delete_alarm_suppression"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmSuppression/DeleteAlarmSuppression"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "if_match"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"delete_alarm_suppression got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "alarmSuppressionId": alarm_suppression_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing),
+            "if-match": kwargs.get("if_match", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
+    def get_alarm(self, alarm_id, **kwargs):
+        """
+        Gets the specified alarm.
+        For more information, see
+        `Getting an Alarm`__.
+        For important limits information, see
+        `Limits on Monitoring`__.
+
+        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.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/get-alarm.htm
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
+
+
+        :param str alarm_id: (required)
+            The `OCID`__ of an alarm.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Customer part of the request identifier token. If you need to contact Oracle about a particular
+            request, please provide the complete request ID.
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.Alarm`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/get_alarm.py.html>`__ to see an example of how to use get_alarm API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['alarmId']
+        resource_path = "/alarms/{alarmId}"
+        method = "GET"
+        operation_name = "get_alarm"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/Alarm/GetAlarm"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"get_alarm got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "alarmId": alarm_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                response_type="Alarm",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                header_params=header_params,
+                response_type="Alarm",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
+    def get_alarm_history(self, alarm_id, **kwargs):
+        """
+        Get the history of the specified alarm.
+        For more information, see
+        `Getting History of an Alarm`__.
+        For important limits information, see
+        `Limits on Monitoring`__.
+
+        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.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/get-alarm-history.htm
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
+
+
+        :param str alarm_id: (required)
+            The `OCID`__ of an alarm.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Customer part of the request identifier token. If you need to contact Oracle about a particular
+            request, please provide the complete request ID.
+
+        :param str alarm_historytype: (optional)
+            The type of history entries to retrieve. State history (STATE_HISTORY) or state transition history (STATE_TRANSITION_HISTORY).
+            If not specified, entries of both types are retrieved.
+
+            Example: `STATE_HISTORY`
+
+            Allowed values are: "STATE_HISTORY", "STATE_TRANSITION_HISTORY"
+
+        :param str page: (optional)
+            For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call.
+            For important details about how pagination works, see
+            `List Pagination`__.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
+
+        :param int limit: (optional)
+            For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
+            For important details about how pagination works, see
+            `List Pagination`__.
+
+            Default: 1000
+
+            Example: 500
+
+            __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
+
+        :param datetime timestamp_greater_than_or_equal_to: (optional)
+            A filter to return only alarm history entries with timestamps occurring on or after the specified date and time. Format defined by RFC3339.
+
+            Example: `2023-01-01T01:00:00.789Z`
+
+        :param datetime timestamp_less_than: (optional)
+            A filter to return only alarm history entries with timestamps occurring before the specified date and time. Format defined by RFC3339.
+
+            Example: `2023-01-02T01:00:00.789Z`
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmHistoryCollection`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/get_alarm_history.py.html>`__ to see an example of how to use get_alarm_history API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['alarmId']
+        resource_path = "/alarms/{alarmId}/history"
+        method = "GET"
+        operation_name = "get_alarm_history"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmHistoryCollection/GetAlarmHistory"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "alarm_historytype",
+            "page",
+            "limit",
+            "timestamp_greater_than_or_equal_to",
+            "timestamp_less_than"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"get_alarm_history got unknown kwargs: {extra_kwargs!r}")
 
         path_params = {
             "alarmId": alarm_id
@@ -427,10 +906,25 @@ class MonitoringClient(object):
             if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
                 raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
 
+        if 'alarm_historytype' in kwargs:
+            alarm_historytype_allowed_values = ["STATE_HISTORY", "STATE_TRANSITION_HISTORY"]
+            if kwargs['alarm_historytype'] not in alarm_historytype_allowed_values:
+                raise ValueError(
+                    f"Invalid value for `alarm_historytype`, must be one of { alarm_historytype_allowed_values }"
+                )
+
+        query_params = {
+            "alarmHistorytype": kwargs.get("alarm_historytype", missing),
+            "page": kwargs.get("page", missing),
+            "limit": kwargs.get("limit", missing),
+            "timestampGreaterThanOrEqualTo": kwargs.get("timestamp_greater_than_or_equal_to", missing),
+            "timestampLessThan": kwargs.get("timestamp_less_than", missing)
+        }
+        query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
+
         header_params = {
             "accept": "application/json",
             "content-type": "application/json",
-            "if-match": kwargs.get("if_match", missing),
             "opc-request-id": kwargs.get("opc_request_id", missing)
         }
         header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
@@ -449,7 +943,9 @@ class MonitoringClient(object):
                 resource_path=resource_path,
                 method=method,
                 path_params=path_params,
+                query_params=query_params,
                 header_params=header_params,
+                response_type="AlarmHistoryCollection",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -459,17 +955,18 @@ class MonitoringClient(object):
                 resource_path=resource_path,
                 method=method,
                 path_params=path_params,
+                query_params=query_params,
                 header_params=header_params,
+                response_type="AlarmHistoryCollection",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
-    def get_alarm(self, alarm_id, **kwargs):
+    def get_alarm_suppression(self, alarm_suppression_id, **kwargs):
         """
-        Gets the specified alarm.
-        For more information, see
-        `Getting an Alarm`__.
+        Gets the specified alarm suppression.
+
         For important limits information, see
         `Limits on Monitoring`__.
 
@@ -477,12 +974,11 @@ class MonitoringClient(object):
         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.
 
-        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/get-alarm.htm
         __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
 
 
-        :param str alarm_id: (required)
-            The `OCID`__ of an alarm.
+        :param str alarm_suppression_id: (required)
+            The `OCID`__ of the alarm suppression.
 
             __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
@@ -502,18 +998,18 @@ class MonitoringClient(object):
             allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
             By default, the response will not allow control characters in strings
 
-        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.Alarm`
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmSuppression`
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/get_alarm.py.html>`__ to see an example of how to use get_alarm API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/get_alarm_suppression.py.html>`__ to see an example of how to use get_alarm_suppression API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
-        required_arguments = ['alarmId']
-        resource_path = "/alarms/{alarmId}"
+        required_arguments = ['alarmSuppressionId']
+        resource_path = "/alarmSuppressions/{alarmSuppressionId}"
         method = "GET"
-        operation_name = "get_alarm"
-        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/Alarm/GetAlarm"
+        operation_name = "get_alarm_suppression"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmSuppression/GetAlarmSuppression"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
@@ -524,10 +1020,10 @@ class MonitoringClient(object):
         extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
         if extra_kwargs:
             raise ValueError(
-                f"get_alarm got unknown kwargs: {extra_kwargs!r}")
+                f"get_alarm_suppression got unknown kwargs: {extra_kwargs!r}")
 
         path_params = {
-            "alarmId": alarm_id
+            "alarmSuppressionId": alarm_suppression_id
         }
 
         path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
@@ -558,7 +1054,7 @@ class MonitoringClient(object):
                 method=method,
                 path_params=path_params,
                 header_params=header_params,
-                response_type="Alarm",
+                response_type="AlarmSuppression",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -569,17 +1065,17 @@ class MonitoringClient(object):
                 method=method,
                 path_params=path_params,
                 header_params=header_params,
-                response_type="Alarm",
+                response_type="AlarmSuppression",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
-    def get_alarm_history(self, alarm_id, **kwargs):
+    def list_alarm_suppressions(self, alarm_id, **kwargs):
         """
-        Get the history of the specified alarm.
-        For more information, see
-        `Getting History of an Alarm`__.
+        Lists alarm suppressions for the specified alarm.
+        Only dimension-level suppressions are listed. Alarm-level suppressions are not listed.
+
         For important limits information, see
         `Limits on Monitoring`__.
 
@@ -587,12 +1083,11 @@ class MonitoringClient(object):
         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.
 
-        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Tasks/get-alarm-history.htm
         __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
 
 
         :param str alarm_id: (required)
-            The `OCID`__ of an alarm.
+            The `OCID`__ of the alarm that is the target of the alarm suppression.
 
             __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
@@ -600,13 +1095,29 @@ class MonitoringClient(object):
             Customer part of the request identifier token. If you need to contact Oracle about a particular
             request, please provide the complete request ID.
 
-        :param str alarm_historytype: (optional)
-            The type of history entries to retrieve. State history (STATE_HISTORY) or state transition history (STATE_TRANSITION_HISTORY).
-            If not specified, entries of both types are retrieved.
+        :param str display_name: (optional)
+            A filter to return only resources that match the given display name exactly.
+            Use this filter to list a alarm suppression by name.
+            Alternatively, when you know the alarm suppression OCID, use the GetAlarmSuppression operation.
 
-            Example: `STATE_HISTORY`
+        :param str lifecycle_state: (optional)
+            A filter to return only resources that match the given lifecycle state exactly. When not specified, only resources in the ACTIVE lifecycle state are listed.
 
-            Allowed values are: "STATE_HISTORY", "STATE_TRANSITION_HISTORY"
+            Allowed values are: "ACTIVE", "DELETED"
+
+        :param str sort_by: (optional)
+            The field to use when sorting returned alarm suppressions. Only one sorting level is provided.
+
+            Example: `timeCreated`
+
+            Allowed values are: "displayName", "timeCreated", "timeSuppressFrom"
+
+        :param str sort_order: (optional)
+            The sort order to use when sorting returned alarm suppressions. Ascending (ASC) or descending (DESC).
+
+            Example: `ASC`
+
+            Allowed values are: "ASC", "DESC"
 
         :param str page: (optional)
             For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call.
@@ -626,16 +1137,6 @@ class MonitoringClient(object):
 
             __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
 
-        :param datetime timestamp_greater_than_or_equal_to: (optional)
-            A filter to return only alarm history entries with timestamps occurring on or after the specified date and time. Format defined by RFC3339.
-
-            Example: `2019-01-01T01:00:00.789Z`
-
-        :param datetime timestamp_less_than: (optional)
-            A filter to return only alarm history entries with timestamps occurring before the specified date and time. Format defined by RFC3339.
-
-            Example: `2019-01-02T01:00:00.789Z`
-
         :param obj retry_strategy: (optional)
             A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
 
@@ -648,58 +1149,65 @@ class MonitoringClient(object):
             allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
             By default, the response will not allow control characters in strings
 
-        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmHistoryCollection`
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmSuppressionCollection`
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/get_alarm_history.py.html>`__ to see an example of how to use get_alarm_history API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/list_alarm_suppressions.py.html>`__ to see an example of how to use list_alarm_suppressions API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']
-        resource_path = "/alarms/{alarmId}/history"
+        resource_path = "/alarmSuppressions"
         method = "GET"
-        operation_name = "get_alarm_history"
-        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmHistoryCollection/GetAlarmHistory"
+        operation_name = "list_alarm_suppressions"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmSuppressionCollection/ListAlarmSuppressions"
 
         # Don't accept unknown kwargs
         expected_kwargs = [
             "allow_control_chars",
             "retry_strategy",
             "opc_request_id",
-            "alarm_historytype",
+            "display_name",
+            "lifecycle_state",
+            "sort_by",
+            "sort_order",
             "page",
-            "limit",
-            "timestamp_greater_than_or_equal_to",
-            "timestamp_less_than"
+            "limit"
         ]
         extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
         if extra_kwargs:
             raise ValueError(
-                f"get_alarm_history got unknown kwargs: {extra_kwargs!r}")
-
-        path_params = {
-            "alarmId": alarm_id
-        }
+                f"list_alarm_suppressions got unknown kwargs: {extra_kwargs!r}")
 
-        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+        if 'lifecycle_state' in kwargs:
+            lifecycle_state_allowed_values = ["ACTIVE", "DELETED"]
+            if kwargs['lifecycle_state'] not in lifecycle_state_allowed_values:
+                raise ValueError(
+                    f"Invalid value for `lifecycle_state`, must be one of { lifecycle_state_allowed_values }"
+                )
 
-        for (k, v) in six.iteritems(path_params):
-            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
-                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+        if 'sort_by' in kwargs:
+            sort_by_allowed_values = ["displayName", "timeCreated", "timeSuppressFrom"]
+            if kwargs['sort_by'] not in sort_by_allowed_values:
+                raise ValueError(
+                    f"Invalid value for `sort_by`, must be one of { sort_by_allowed_values }"
+                )
 
-        if 'alarm_historytype' in kwargs:
-            alarm_historytype_allowed_values = ["STATE_HISTORY", "STATE_TRANSITION_HISTORY"]
-            if kwargs['alarm_historytype'] not in alarm_historytype_allowed_values:
+        if 'sort_order' in kwargs:
+            sort_order_allowed_values = ["ASC", "DESC"]
+            if kwargs['sort_order'] not in sort_order_allowed_values:
                 raise ValueError(
-                    f"Invalid value for `alarm_historytype`, must be one of { alarm_historytype_allowed_values }"
+                    f"Invalid value for `sort_order`, must be one of { sort_order_allowed_values }"
                 )
 
         query_params = {
-            "alarmHistorytype": kwargs.get("alarm_historytype", missing),
+            "alarmId": alarm_id,
+            "displayName": kwargs.get("display_name", missing),
+            "lifecycleState": kwargs.get("lifecycle_state", missing),
+            "sortBy": kwargs.get("sort_by", missing),
+            "sortOrder": kwargs.get("sort_order", missing),
             "page": kwargs.get("page", missing),
-            "limit": kwargs.get("limit", missing),
-            "timestampGreaterThanOrEqualTo": kwargs.get("timestamp_greater_than_or_equal_to", missing),
-            "timestampLessThan": kwargs.get("timestamp_less_than", missing)
+            "limit": kwargs.get("limit", missing)
         }
         query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
 
@@ -723,10 +1231,9 @@ class MonitoringClient(object):
                 self.base_client.call_api,
                 resource_path=resource_path,
                 method=method,
-                path_params=path_params,
                 query_params=query_params,
                 header_params=header_params,
-                response_type="AlarmHistoryCollection",
+                response_type="AlarmSuppressionCollection",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -735,10 +1242,9 @@ class MonitoringClient(object):
             return self.base_client.call_api(
                 resource_path=resource_path,
                 method=method,
-                path_params=path_params,
                 query_params=query_params,
                 header_params=header_params,
-                response_type="AlarmHistoryCollection",
+                response_type="AlarmSuppressionCollection",
                 allow_control_chars=kwargs.get('allow_control_chars'),
                 operation_name=operation_name,
                 api_reference_link=api_reference_link,
@@ -837,7 +1343,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/list_alarms.py.html>`__ to see an example of how to use list_alarms API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/list_alarms.py.html>`__ to see an example of how to use list_alarms API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -941,6 +1447,7 @@ class MonitoringClient(object):
         List the status of each alarm in the specified compartment.
         Status is collective, across all metric streams in the alarm.
         To list alarm status for each metric stream, use :func:`retrieve_dimension_states`.
+        Optionally filter by resource or status value.
         For more information, see
         `Listing Alarm Statuses`__.
         For important limits information, see
@@ -1011,8 +1518,8 @@ class MonitoringClient(object):
             Allowed values are: "ASC", "DESC"
 
         :param str resource_id: (optional)
-            The `OCID`__ of a resource that is monitored by the
-            metric that you are searching for.
+            A filter to return only the resource with the specified `OCID`__.
+            The resource must be monitored by the metric that you are searching for.
 
             Example: `ocid1.instance.oc1.phx.exampleuniqueID`
 
@@ -1025,17 +1532,16 @@ class MonitoringClient(object):
             Example: `logging-analytics`
 
         :param str entity_id: (optional)
-            The `OCID`__ of the entity monitored by the
-            metric that you are searching for.
+            A filter to return only resources that match the given entity `OCID`__ exactly.
+            The resource (entity) must be monitored by the metric that you are searching for.
 
             Example: `ocid1.instance.oc1.phx.exampleuniqueID`
 
             __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
 
         :param str status: (optional)
-            The status of the metric stream to use for alarm filtering. For example, set `StatusQueryParam` to
-            \"FIRING\" to filter results to metric streams of the alarm with that status. Default behaviour is to return
-            alarms irrespective of metric streams' status.
+            A filter to return only metric streams that match the specified status.
+            For example, the value \"FIRING\" returns only firing metric streams.
 
             Example: `FIRING`
 
@@ -1057,7 +1563,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/list_alarms_status.py.html>`__ to see an example of how to use list_alarms_status API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/list_alarms_status.py.html>`__ to see an example of how to use list_alarms_status API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -1238,7 +1744,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/list_metrics.py.html>`__ to see an example of how to use list_metrics API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/list_metrics.py.html>`__ to see an example of how to use list_metrics API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -1376,7 +1882,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/post_metric_data.py.html>`__ to see an example of how to use post_metric_data API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/post_metric_data.py.html>`__ to see an example of how to use post_metric_data API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = []
@@ -1483,7 +1989,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/remove_alarm_suppression.py.html>`__ to see an example of how to use remove_alarm_suppression API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/remove_alarm_suppression.py.html>`__ to see an example of how to use remove_alarm_suppression API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']
@@ -1616,7 +2122,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/retrieve_dimension_states.py.html>`__ to see an example of how to use retrieve_dimension_states API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/retrieve_dimension_states.py.html>`__ to see an example of how to use retrieve_dimension_states API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']
@@ -1698,6 +2204,148 @@ class MonitoringClient(object):
                 api_reference_link=api_reference_link,
                 required_arguments=required_arguments)
 
+    def summarize_alarm_suppression_history(self, alarm_id, **kwargs):
+        """
+        Returns history of suppressions for the specified alarm, including both dimension-specific and and alarm-wide suppressions.
+
+        For important limits information, see
+        `Limits on Monitoring`__.
+
+        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.
+
+        __ https://docs.cloud.oracle.com/iaas/Content/Monitoring/Concepts/monitoringoverview.htm#limits
+
+
+        :param str alarm_id: (required)
+            The `OCID`__ of an alarm.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm
+
+        :param str opc_request_id: (optional)
+            Customer part of the request identifier token. If you need to contact Oracle about a particular
+            request, please provide the complete request ID.
+
+        :param str page: (optional)
+            For list pagination. The value of the `opc-next-page` response header from the previous \"List\" call.
+            For important details about how pagination works, see
+            `List Pagination`__.
+
+            __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
+
+        :param int limit: (optional)
+            For list pagination. The maximum number of results per page, or items to return in a paginated \"List\" call.
+            For important details about how pagination works, see
+            `List Pagination`__.
+
+            Default: 1000
+
+            Example: 500
+
+            __ https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine
+
+        :param oci.monitoring.models.SummarizeAlarmSuppressionHistoryDetails summarize_alarm_suppression_history_details: (optional)
+            summarize history details
+
+        :param obj retry_strategy: (optional)
+            A retry strategy to apply to this specific operation/call. This will override any retry strategy set at the client-level.
+
+            This should be one of the strategies available in the :py:mod:`~oci.retry` module. This operation will not retry by default, users can also use the convenient :py:data:`~oci.retry.DEFAULT_RETRY_STRATEGY` provided by the SDK to enable retries for it.
+            The specifics of the default retry strategy are described `here <https://docs.oracle.com/en-us/iaas/tools/python/latest/sdk_behaviors/retries.html>`__.
+
+            To have this operation explicitly not perform any retries, pass an instance of :py:class:`~oci.retry.NoneRetryStrategy`.
+
+        :param bool allow_control_chars: (optional)
+            allow_control_chars is a boolean to indicate whether or not this request should allow control characters in the response object.
+            By default, the response will not allow control characters in strings
+
+        :return: A :class:`~oci.response.Response` object with data of type :class:`~oci.monitoring.models.AlarmSuppressionHistoryItemCollection`
+        :rtype: :class:`~oci.response.Response`
+
+        :example:
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/summarize_alarm_suppression_history.py.html>`__ to see an example of how to use summarize_alarm_suppression_history API.
+        """
+        # Required path and query arguments. These are in camelCase to replace values in service endpoints.
+        required_arguments = ['alarmId']
+        resource_path = "/alarms/{alarmId}/actions/summarizeAlarmSuppressionHistory"
+        method = "POST"
+        operation_name = "summarize_alarm_suppression_history"
+        api_reference_link = "https://docs.oracle.com/iaas/api/#/en/monitoring/20180401/AlarmSuppression/SummarizeAlarmSuppressionHistory"
+
+        # Don't accept unknown kwargs
+        expected_kwargs = [
+            "allow_control_chars",
+            "retry_strategy",
+            "opc_request_id",
+            "page",
+            "limit",
+            "summarize_alarm_suppression_history_details"
+        ]
+        extra_kwargs = [_key for _key in six.iterkeys(kwargs) if _key not in expected_kwargs]
+        if extra_kwargs:
+            raise ValueError(
+                f"summarize_alarm_suppression_history got unknown kwargs: {extra_kwargs!r}")
+
+        path_params = {
+            "alarmId": alarm_id
+        }
+
+        path_params = {k: v for (k, v) in six.iteritems(path_params) if v is not missing}
+
+        for (k, v) in six.iteritems(path_params):
+            if v is None or (isinstance(v, six.string_types) and len(v.strip()) == 0):
+                raise ValueError(f'Parameter {k} cannot be None, whitespace or empty string')
+
+        query_params = {
+            "page": kwargs.get("page", missing),
+            "limit": kwargs.get("limit", missing)
+        }
+        query_params = {k: v for (k, v) in six.iteritems(query_params) if v is not missing and v is not None}
+
+        header_params = {
+            "accept": "application/json",
+            "content-type": "application/json",
+            "opc-request-id": kwargs.get("opc_request_id", missing)
+        }
+        header_params = {k: v for (k, v) in six.iteritems(header_params) if v is not missing and v is not None}
+
+        retry_strategy = self.base_client.get_preferred_retry_strategy(
+            operation_retry_strategy=kwargs.get('retry_strategy'),
+            client_retry_strategy=self.retry_strategy
+        )
+
+        if retry_strategy:
+            if not isinstance(retry_strategy, retry.NoneRetryStrategy):
+                self.base_client.add_opc_client_retries_header(header_params)
+                retry_strategy.add_circuit_breaker_callback(self.circuit_breaker_callback)
+            return retry_strategy.make_retrying_call(
+                self.base_client.call_api,
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                query_params=query_params,
+                header_params=header_params,
+                body=kwargs.get('summarize_alarm_suppression_history_details'),
+                response_type="AlarmSuppressionHistoryItemCollection",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+        else:
+            return self.base_client.call_api(
+                resource_path=resource_path,
+                method=method,
+                path_params=path_params,
+                query_params=query_params,
+                header_params=header_params,
+                body=kwargs.get('summarize_alarm_suppression_history_details'),
+                response_type="AlarmSuppressionHistoryItemCollection",
+                allow_control_chars=kwargs.get('allow_control_chars'),
+                operation_name=operation_name,
+                api_reference_link=api_reference_link,
+                required_arguments=required_arguments)
+
     def summarize_metrics_data(self, compartment_id, summarize_metrics_data_details, **kwargs):
         """
         Returns aggregated data that match the criteria specified in the request. Compartment OCID required.
@@ -1754,7 +2402,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/summarize_metrics_data.py.html>`__ to see an example of how to use summarize_metrics_data API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/summarize_metrics_data.py.html>`__ to see an example of how to use summarize_metrics_data API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['compartmentId']
@@ -1871,7 +2519,7 @@ class MonitoringClient(object):
         :rtype: :class:`~oci.response.Response`
 
         :example:
-        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.118.2/monitoring/update_alarm.py.html>`__ to see an example of how to use update_alarm API.
+        Click `here <https://docs.cloud.oracle.com/en-us/iaas/tools/python-sdk-examples/2.119.0/monitoring/update_alarm.py.html>`__ to see an example of how to use update_alarm API.
         """
         # Required path and query arguments. These are in camelCase to replace values in service endpoints.
         required_arguments = ['alarmId']