aws-sdk-cloudwatch 1.145.0 → 1.146.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9178d50ad4fbde97cad9ed81cde82cdded7fa5e34588ed96f4749194691951aa
-  data.tar.gz: 8ded76600ccc0c1946c6f64d0786440bbe5d10ba5604dc9e81ee5de73d345855
+  metadata.gz: 3806dffa67d2edcf3c4b36874491a8bfb57d5ab5e0ecc3f8dde87ad88d7f5f74
+  data.tar.gz: 9a053e267bcd6ba6302285687f10e1ac59650253e13868b786f2472a1546c93e
 SHA512:
-  metadata.gz: 9982d62058c3ca0d42f8640a0117b0d8fe6f3deed066a5c6747897bdd246344b15ec48f21e706522b9f40b3edd29c5bd5b20b536b6b3c9c78f0264affc5f79bc
-  data.tar.gz: a9a06dc76ef202ea2392426ed3a72cbebe813a695cc9c9b5f7f86cae55f0ac5e1b383d9ef5de977a544b6440c11dd5c865a41fac70545cf28ec0402464a598c5
+  metadata.gz: b7b27756c4597a8c43fdf535c2bef85a5c3f5d72a0227c18c7397aa787f440f26413ef1801ae56149faefb25810df1e9eb8890d14f9940efa077dc05b24a408c
+  data.tar.gz: 66fcf5bbc50aac3f992cd8f25e353388a4181dfebda83cb52e9149009c7c6e18db56ca89cb15d5c260876a846f889be4074a7dae6eda951258c307dddf64dcba

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.146.0 (2026-08-21)
+------------------
+
+* Feature - Allows customers to specify an initial warm up period to wait for metrics to arrive when creating metric or log alarms
+
 1.145.0 (2026-07-22)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.145.0
+1.146.0

data/lib/aws-sdk-cloudwatch/alarm.rb

@@ -269,6 +269,22 @@ module Aws::CloudWatch
       data[:evaluation_window]
     end
 
+    # The warm-up configuration for the alarm. A warm-up period delays alarm
+    # evaluation after you create or update the alarm. During the warm-up
+    # period, the alarm stays in `INSUFFICIENT_DATA` and does not perform
+    # alarm actions.
+    #
+    # For more information, see [Alarm warm-up periods][1] in the *Amazon
+    # CloudWatch User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    # @return [Types::WarmUpConfiguration]
+    def warm_up_configuration
+      data[:warm_up_configuration]
+    end
+
     # The evaluation criteria for the alarm.
     # @return [Types::EvaluationCriteria]
     def evaluation_criteria

data/lib/aws-sdk-cloudwatch/client.rb

@@ -493,8 +493,18 @@ module Aws::CloudWatch
     #
     # You can call `AssociateDatasetKmsKey` on a dataset that is already
     # associated with a KMS key to replace the existing key with a different
-    # one. To replace a key, the caller must have `kms:Decrypt` permission
-    # on both the current key and the new key.
+    # one. The caller must have `kms:Decrypt` permission on both the current
+    # key and the new key.
+    #
+    # <note markdown="1"> If the currently associated key has been deleted, is scheduled for
+    # deletion, is pending import, is unavailable, or has been disabled,
+    # Amazon CloudWatch does not require `kms:Decrypt` permission on the
+    # current key and the rotation proceeds. If the key was only disabled,
+    # consider re-enabling it instead of rotating, because re-enabling
+    # allows Amazon CloudWatch to resume decrypting your existing metric
+    # data encrypted with that key.
+    #
+    #  </note>
     #
     # The KMS key that you specify must meet all of the following
     # requirements:
@@ -526,15 +536,14 @@ module Aws::CloudWatch
     # `kms:GenerateDataKey`, `kms:Encrypt`, `kms:Decrypt`, and
     # `kms:ReEncrypt*`. After those succeed, a `kms:Decrypt` dry-run is run
     # with the caller's credentials to verify that the calling principal
-    # can use the key. When you are replacing an existing key, the caller's
-    # `kms:Decrypt` dry-run is run on the current key first, and only then
-    # on the new key.
+    # can use the new key. When you are replacing an existing key, the
+    # caller's `kms:Decrypt` dry-run is also run on the current key.
     #
-    # If any of these checks fails, the operation fails and the existing key
-    # association (if any) remains unchanged. Common failure causes include
-    # the key being disabled, the key policy not granting the required
-    # permissions to Amazon CloudWatch, or the caller lacking `kms:Decrypt`
-    # permission on the key.
+    # If any of these checks on the new key fails, the operation fails and
+    # the existing key association (if any) remains unchanged. Common
+    # failure causes include the new key being disabled, the key policy not
+    # granting the required permissions to Amazon CloudWatch, or the caller
+    # lacking `kms:Decrypt` permission on the new key.
     #
     # For more information about using customer managed keys with Amazon
     # CloudWatch, see [Encryption at rest with customer managed keys][1] in
@@ -1219,6 +1228,8 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].evaluation_state #=> String, one of "PARTIAL_DATA", "EVALUATION_FAILURE", "EVALUATION_ERROR"
     #   resp.metric_alarms[0].state_transitioned_timestamp #=> Time
     #   resp.metric_alarms[0].evaluation_window.wall_clock_window.timezone #=> String
+    #   resp.metric_alarms[0].warm_up_configuration.warm_up_period_duration_in_minutes #=> Integer
+    #   resp.metric_alarms[0].warm_up_configuration.only_start_evaluating_after_warm_up_period_ends #=> Boolean
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.query #=> String
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.pending_period #=> Integer
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.recovery_period #=> Integer
@@ -1260,6 +1271,8 @@ module Aws::CloudWatch
     #   resp.log_alarms[0].evaluation_state #=> String, one of "PARTIAL_DATA", "EVALUATION_FAILURE", "EVALUATION_ERROR"
     #   resp.log_alarms[0].action_log_line_count #=> Integer
     #   resp.log_alarms[0].action_log_line_role_arn #=> String
+    #   resp.log_alarms[0].warm_up_configuration.warm_up_period_duration_in_minutes #=> Integer
+    #   resp.log_alarms[0].warm_up_configuration.only_start_evaluating_after_warm_up_period_ends #=> Boolean
     #   resp.next_token #=> String
     #
     #
@@ -1384,6 +1397,8 @@ module Aws::CloudWatch
     #   resp.metric_alarms[0].evaluation_state #=> String, one of "PARTIAL_DATA", "EVALUATION_FAILURE", "EVALUATION_ERROR"
     #   resp.metric_alarms[0].state_transitioned_timestamp #=> Time
     #   resp.metric_alarms[0].evaluation_window.wall_clock_window.timezone #=> String
+    #   resp.metric_alarms[0].warm_up_configuration.warm_up_period_duration_in_minutes #=> Integer
+    #   resp.metric_alarms[0].warm_up_configuration.only_start_evaluating_after_warm_up_period_ends #=> Boolean
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.query #=> String
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.pending_period #=> Integer
     #   resp.metric_alarms[0].evaluation_criteria.prom_ql_criteria.recovery_period #=> Integer
@@ -1641,19 +1656,27 @@ module Aws::CloudWatch
     # it. If the dataset has no associated KMS key, the operation fails with
     # `ResourceNotFoundException`.
     #
-    # Amazon CloudWatch performs a dry-run `kms:Decrypt` call on the key as
-    # part of this operation. This verifies that the caller is authorized to
-    # use the currently associated key. The caller must have `kms:Decrypt`
-    # permission on the currently associated key, and the key must be
-    # enabled and accessible. If the key has been disabled or scheduled for
-    # deletion, you must first re-enable or restore it before you can
-    # disassociate it from the dataset.
+    # Amazon CloudWatch performs a dry-run `kms:Decrypt` call on the
+    # currently associated key as part of this operation. The caller must
+    # have `kms:Decrypt` permission on the currently associated key. If the
+    # key is accessible but the caller lacks `kms:Decrypt` permission, the
+    # operation fails with `AccessDeniedException`.
+    #
+    # <note markdown="1"> If the currently associated key has been deleted, is scheduled for
+    # deletion, is pending import, is unavailable, or has been disabled,
+    # Amazon CloudWatch does not require `kms:Decrypt` permission on that
+    # key and the disassociation proceeds. If the key was only disabled,
+    # consider re-enabling it instead of disassociating, because re-enabling
+    # allows Amazon CloudWatch to resume decrypting your existing metric
+    # data.
+    #
+    #  </note>
     #
     # Disassociating a KMS key from a dataset does not immediately remove
     # the `kms:Decrypt` requirement on data plane operations. For up to
     # three hours after disassociation, callers must continue to have
     # `kms:Decrypt` permission on the previously associated key. Some data
-    # may still be encrypted with that key during this window. After this
+    # might still be encrypted with that key during this window. After this
     # enforcement window elapses, the `kms:Decrypt` requirement is lifted.
     #
     # For more information about using customer managed keys with Amazon
@@ -3948,6 +3971,19 @@ module Aws::CloudWatch
     #   A list of key-value pairs to associate with the alarm. You can use
     #   tags to categorize and manage your alarms.
     #
+    # @option params [Types::WarmUpConfiguration] :warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays alarm
+    #   evaluation after you create or update the alarm. The warm-up period
+    #   reduces alarm noise from missing data while a new resource or service
+    #   starts publishing data.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -3990,6 +4026,10 @@ module Aws::CloudWatch
     #         value: "TagValue", # required
     #       },
     #     ],
+    #     warm_up_configuration: {
+    #       warm_up_period_duration_in_minutes: 1, # required
+    #       only_start_evaluating_after_warm_up_period_ends: false,
+    #     },
     #   })
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutLogAlarm AWS API Documentation
@@ -4564,6 +4604,19 @@ module Aws::CloudWatch
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-evaluation-window.html
     #
+    # @option params [Types::WarmUpConfiguration] :warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays alarm
+    #   evaluation after you create or update the alarm. The warm-up period
+    #   reduces alarm noise from missing data while a new resource or service
+    #   starts publishing metrics.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #
     # @option params [Types::EvaluationCriteria] :evaluation_criteria
     #   The evaluation criteria for the alarm. For each `PutMetricAlarm`
     #   operation, you must specify either `MetricName`, a `Metrics` array, or
@@ -4656,6 +4709,10 @@ module Aws::CloudWatch
     #       sliding_window: {
     #       },
     #     },
+    #     warm_up_configuration: {
+    #       warm_up_period_duration_in_minutes: 1, # required
+    #       only_start_evaluating_after_warm_up_period_ends: false,
+    #     },
     #     evaluation_criteria: {
     #       prom_ql_criteria: {
     #         query: "Query", # required
@@ -5010,7 +5067,7 @@ module Aws::CloudWatch
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     #
     # @option params [Boolean] :include_linked_accounts_metrics
     #   If you are creating a metric stream in a monitoring account, specify
@@ -5370,7 +5427,7 @@ module Aws::CloudWatch
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatch'
-      context[:gem_version] = '1.145.0'
+      context[:gem_version] = '1.146.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatch/client_api.rb

@@ -285,6 +285,7 @@ module Aws::CloudWatch
     Namespace = Shapes::StringShape.new(name: 'Namespace')
     NextToken = Shapes::StringShape.new(name: 'NextToken')
     OTelEnrichmentStatus = Shapes::StringShape.new(name: 'OTelEnrichmentStatus')
+    OnlyStartEvaluatingAfterWarmUpPeriodEnds = Shapes::BooleanShape.new(name: 'OnlyStartEvaluatingAfterWarmUpPeriodEnds')
     OutputFormat = Shapes::StringShape.new(name: 'OutputFormat')
     OwningAccounts = Shapes::ListShape.new(name: 'OwningAccounts')
     PartialFailure = Shapes::StructureShape.new(name: 'PartialFailure')
@@ -370,6 +371,8 @@ module Aws::CloudWatch
     UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
     Values = Shapes::ListShape.new(name: 'Values')
     WallClockWindow = Shapes::StructureShape.new(name: 'WallClockWindow')
+    WarmUpConfiguration = Shapes::StructureShape.new(name: 'WarmUpConfiguration')
+    WarmUpPeriodDurationInMinutes = Shapes::IntegerShape.new(name: 'WarmUpPeriodDurationInMinutes')
 
     AlarmContributor.add_member(:contributor_id, Shapes::ShapeRef.new(shape: ContributorId, required: true, location_name: "ContributorId"))
     AlarmContributor.add_member(:contributor_attributes, Shapes::ShapeRef.new(shape: ContributorAttributes, required: true, location_name: "ContributorAttributes"))
@@ -947,6 +950,7 @@ module Aws::CloudWatch
     LogAlarm.add_member(:evaluation_state, Shapes::ShapeRef.new(shape: EvaluationState, location_name: "EvaluationState"))
     LogAlarm.add_member(:action_log_line_count, Shapes::ShapeRef.new(shape: ActionLogLineCount, location_name: "ActionLogLineCount"))
     LogAlarm.add_member(:action_log_line_role_arn, Shapes::ShapeRef.new(shape: ActionLogLineRoleArn, location_name: "ActionLogLineRoleArn"))
+    LogAlarm.add_member(:warm_up_configuration, Shapes::ShapeRef.new(shape: WarmUpConfiguration, location_name: "WarmUpConfiguration"))
     LogAlarm.struct_class = Types::LogAlarm
 
     LogAlarms.member = Shapes::ShapeRef.new(shape: LogAlarm)
@@ -1010,6 +1014,7 @@ module Aws::CloudWatch
     MetricAlarm.add_member(:evaluation_state, Shapes::ShapeRef.new(shape: EvaluationState, location_name: "EvaluationState"))
     MetricAlarm.add_member(:state_transitioned_timestamp, Shapes::ShapeRef.new(shape: Timestamp, location_name: "StateTransitionedTimestamp"))
     MetricAlarm.add_member(:evaluation_window, Shapes::ShapeRef.new(shape: EvaluationWindow, location_name: "EvaluationWindow"))
+    MetricAlarm.add_member(:warm_up_configuration, Shapes::ShapeRef.new(shape: WarmUpConfiguration, location_name: "WarmUpConfiguration"))
     MetricAlarm.add_member(:evaluation_criteria, Shapes::ShapeRef.new(shape: EvaluationCriteria, location_name: "EvaluationCriteria"))
     MetricAlarm.add_member(:evaluation_interval, Shapes::ShapeRef.new(shape: EvaluationInterval, location_name: "EvaluationInterval"))
     MetricAlarm.struct_class = Types::MetricAlarm
@@ -1184,6 +1189,7 @@ module Aws::CloudWatch
     PutLogAlarmInput.add_member(:comparison_operator, Shapes::ShapeRef.new(shape: ComparisonOperator, required: true, location_name: "ComparisonOperator"))
     PutLogAlarmInput.add_member(:treat_missing_data, Shapes::ShapeRef.new(shape: TreatMissingData, location_name: "TreatMissingData"))
     PutLogAlarmInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
+    PutLogAlarmInput.add_member(:warm_up_configuration, Shapes::ShapeRef.new(shape: WarmUpConfiguration, location_name: "WarmUpConfiguration"))
     PutLogAlarmInput.struct_class = Types::PutLogAlarmInput
 
     PutManagedInsightRulesInput.add_member(:managed_rules, Shapes::ShapeRef.new(shape: ManagedRules, required: true, location_name: "ManagedRules"))
@@ -1215,6 +1221,7 @@ module Aws::CloudWatch
     PutMetricAlarmInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     PutMetricAlarmInput.add_member(:threshold_metric_id, Shapes::ShapeRef.new(shape: MetricId, location_name: "ThresholdMetricId"))
     PutMetricAlarmInput.add_member(:evaluation_window, Shapes::ShapeRef.new(shape: EvaluationWindow, location_name: "EvaluationWindow"))
+    PutMetricAlarmInput.add_member(:warm_up_configuration, Shapes::ShapeRef.new(shape: WarmUpConfiguration, location_name: "WarmUpConfiguration"))
     PutMetricAlarmInput.add_member(:evaluation_criteria, Shapes::ShapeRef.new(shape: EvaluationCriteria, location_name: "EvaluationCriteria"))
     PutMetricAlarmInput.add_member(:evaluation_interval, Shapes::ShapeRef.new(shape: EvaluationInterval, location_name: "EvaluationInterval"))
     PutMetricAlarmInput.struct_class = Types::PutMetricAlarmInput
@@ -1345,6 +1352,10 @@ module Aws::CloudWatch
     WallClockWindow.add_member(:timezone, Shapes::ShapeRef.new(shape: Timezone, location_name: "Timezone"))
     WallClockWindow.struct_class = Types::WallClockWindow
 
+    WarmUpConfiguration.add_member(:warm_up_period_duration_in_minutes, Shapes::ShapeRef.new(shape: WarmUpPeriodDurationInMinutes, required: true, location_name: "WarmUpPeriodDurationInMinutes"))
+    WarmUpConfiguration.add_member(:only_start_evaluating_after_warm_up_period_ends, Shapes::ShapeRef.new(shape: OnlyStartEvaluatingAfterWarmUpPeriodEnds, location_name: "OnlyStartEvaluatingAfterWarmUpPeriodEnds"))
+    WarmUpConfiguration.struct_class = Types::WarmUpConfiguration
+
 
     # @api private
     API = Seahorse::Model::Api.new.tap do |api|

data/lib/aws-sdk-cloudwatch/metric.rb

@@ -374,6 +374,10 @@ module Aws::CloudWatch
     #       sliding_window: {
     #       },
     #     },
+    #     warm_up_configuration: {
+    #       warm_up_period_duration_in_minutes: 1, # required
+    #       only_start_evaluating_after_warm_up_period_ends: false,
+    #     },
     #     evaluation_criteria: {
     #       prom_ql_criteria: {
     #         query: "Query", # required
@@ -796,6 +800,18 @@ module Aws::CloudWatch
     #
     #
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-evaluation-window.html
+    # @option options [Types::WarmUpConfiguration] :warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays alarm
+    #   evaluation after you create or update the alarm. The warm-up period
+    #   reduces alarm noise from missing data while a new resource or service
+    #   starts publishing metrics.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
     # @option options [Types::EvaluationCriteria] :evaluation_criteria
     #   The evaluation criteria for the alarm. For each `PutMetricAlarm`
     #   operation, you must specify either `MetricName`, a `Metrics` array, or

data/lib/aws-sdk-cloudwatch/types.rb

@@ -2116,7 +2116,7 @@ module Aws::CloudWatch
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
     #
     # @!attribute [rw] include_linked_accounts_metrics
@@ -3052,6 +3052,20 @@ module Aws::CloudWatch
     #   notifications. Set when `ActionLogLineCount` is greater than 0.
     #   @return [String]
     #
+    # @!attribute [rw] warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays
+    #   alarm evaluation after you create or update the alarm. During the
+    #   warm-up period, the alarm stays in `INSUFFICIENT_DATA` and does not
+    #   perform alarm actions.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #   @return [Types::WarmUpConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/LogAlarm AWS API Documentation
     #
     class LogAlarm < Struct.new(
@@ -3076,7 +3090,8 @@ module Aws::CloudWatch
       :state_transitioned_timestamp,
       :evaluation_state,
       :action_log_line_count,
-      :action_log_line_role_arn)
+      :action_log_line_role_arn,
+      :warm_up_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3401,6 +3416,20 @@ module Aws::CloudWatch
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-evaluation-window.html
     #   @return [Types::EvaluationWindow]
     #
+    # @!attribute [rw] warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays
+    #   alarm evaluation after you create or update the alarm. During the
+    #   warm-up period, the alarm stays in `INSUFFICIENT_DATA` and does not
+    #   perform alarm actions.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #   @return [Types::WarmUpConfiguration]
+    #
     # @!attribute [rw] evaluation_criteria
     #   The evaluation criteria for the alarm.
     #   @return [Types::EvaluationCriteria]
@@ -3442,6 +3471,7 @@ module Aws::CloudWatch
       :evaluation_state,
       :state_transitioned_timestamp,
       :evaluation_window,
+      :warm_up_configuration,
       :evaluation_criteria,
       :evaluation_interval)
       SENSITIVE = []
@@ -3937,7 +3967,7 @@ module Aws::CloudWatch
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     #
     # @!attribute [rw] include_metrics
     #   An array of metric name and namespace pairs that stream the
@@ -3966,7 +3996,7 @@ module Aws::CloudWatch
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     #   @return [Array<String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/MetricStreamStatisticsConfiguration AWS API Documentation
@@ -4737,6 +4767,20 @@ module Aws::CloudWatch
     #   tags to categorize and manage your alarms.
     #   @return [Array<Types::Tag>]
     #
+    # @!attribute [rw] warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays
+    #   alarm evaluation after you create or update the alarm. The warm-up
+    #   period reduces alarm noise from missing data while a new resource or
+    #   service starts publishing data.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #   @return [Types::WarmUpConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/PutLogAlarmInput AWS API Documentation
     #
     class PutLogAlarmInput < Struct.new(
@@ -4754,7 +4798,8 @@ module Aws::CloudWatch
       :threshold,
       :comparison_operator,
       :treat_missing_data,
-      :tags)
+      :tags,
+      :warm_up_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -5259,6 +5304,20 @@ module Aws::CloudWatch
     #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-evaluation-window.html
     #   @return [Types::EvaluationWindow]
     #
+    # @!attribute [rw] warm_up_configuration
+    #   The warm-up configuration for the alarm. A warm-up period delays
+    #   alarm evaluation after you create or update the alarm. The warm-up
+    #   period reduces alarm noise from missing data while a new resource or
+    #   service starts publishing metrics.
+    #
+    #   For more information, see [Alarm warm-up periods][1] in the *Amazon
+    #   CloudWatch User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/alarm-warm-up.html
+    #   @return [Types::WarmUpConfiguration]
+    #
     # @!attribute [rw] evaluation_criteria
     #   The evaluation criteria for the alarm. For each `PutMetricAlarm`
     #   operation, you must specify either `MetricName`, a `Metrics` array,
@@ -5311,6 +5370,7 @@ module Aws::CloudWatch
       :tags,
       :threshold_metric_id,
       :evaluation_window,
+      :warm_up_configuration,
       :evaluation_criteria,
       :evaluation_interval)
       SENSITIVE = []
@@ -5495,7 +5555,7 @@ module Aws::CloudWatch
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html.html
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/Statistics-definitions.html
     #   @return [Array<Types::MetricStreamStatisticsConfiguration>]
     #
     # @!attribute [rw] include_linked_accounts_metrics
@@ -6133,6 +6193,43 @@ module Aws::CloudWatch
       include Aws::Structure
     end
 
+    # The configuration settings that define the warm-up behavior for an
+    # alarm. Use these settings to delay alarm evaluation after you create
+    # or update the alarm, which reduces alarm noise while a new resource or
+    # service starts publishing data.
+    #
+    # During the warm-up period, the alarm stays in `INSUFFICIENT_DATA` and
+    # does not perform alarm actions.
+    #
+    # @!attribute [rw] warm_up_period_duration_in_minutes
+    #   The length of the warm-up period, in minutes. After you create or
+    #   update the alarm, the alarm stays in `INSUFFICIENT_DATA` for this
+    #   duration. During this time, the alarm does not perform alarm
+    #   actions.
+    #
+    #   You can change this value at any time, including after the warm-up
+    #   period ends. If you change it after the warm-up period ends, the new
+    #   value does not restart the warm-up period.
+    #   @return [Integer]
+    #
+    # @!attribute [rw] only_start_evaluating_after_warm_up_period_ends
+    #   Specifies whether the alarm waits for the full warm-up period before
+    #   it starts to evaluate. The default is `false`. If `true`, the alarm
+    #   waits the entire `WarmUpPeriodDurationInMinutes` before it starts to
+    #   evaluate, even if metric data arrives earlier. If `false`, the alarm
+    #   ends the warm-up period early. Evaluation begins as soon as the
+    #   alarm has enough metric data to fill its evaluation window.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/monitoring-2010-08-01/WarmUpConfiguration AWS API Documentation
+    #
+    class WarmUpConfiguration < Struct.new(
+      :warm_up_period_duration_in_minutes,
+      :only_start_evaluating_after_warm_up_period_ends)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
   end
 end
 

data/lib/aws-sdk-cloudwatch.rb

@@ -58,7 +58,7 @@ module Aws::CloudWatch
   autoload :CompositeAlarm, 'aws-sdk-cloudwatch/composite_alarm'
   autoload :Metric, 'aws-sdk-cloudwatch/metric'
 
-  GEM_VERSION = '1.145.0'
+  GEM_VERSION = '1.146.0'
 
 end
 

data/sig/alarm.rbs

@@ -105,6 +105,9 @@ module Aws
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Alarm.html#evaluation_window-instance_method
       def evaluation_window: () -> Types::EvaluationWindow
 
+      # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Alarm.html#warm_up_configuration-instance_method
+      def warm_up_configuration: () -> Types::WarmUpConfiguration
+
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/CloudWatch/Alarm.html#evaluation_criteria-instance_method
       def evaluation_criteria: () -> Types::EvaluationCriteria
 

data/sig/client.rbs

@@ -683,7 +683,11 @@ module Aws
                                key: ::String,
                                value: ::String
                              }
-                           ]
+                           ],
+                           ?warm_up_configuration: {
+                             warm_up_period_duration_in_minutes: ::Integer,
+                             only_start_evaluating_after_warm_up_period_ends: bool?
+                           }
                          ) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
                        | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> ::Seahorse::Client::_ResponseSuccess[::Aws::EmptyStructure]
 
@@ -751,6 +755,10 @@ module Aws
                                 sliding_window: {
                                 }?
                               },
+                              ?warm_up_configuration: {
+                                warm_up_period_duration_in_minutes: ::Integer,
+                                only_start_evaluating_after_warm_up_period_ends: bool?
+                              },
                               ?evaluation_criteria: {
                                 prom_ql_criteria: {
                                   query: ::String,

data/sig/metric.rbs

@@ -117,6 +117,10 @@ module Aws
                          sliding_window: {
                          }?
                        },
+                       ?warm_up_configuration: {
+                         warm_up_period_duration_in_minutes: ::Integer,
+                         only_start_evaluating_after_warm_up_period_ends: bool?
+                       },
                        ?evaluation_criteria: {
                          prom_ql_criteria: {
                            query: ::String,

data/sig/types.rbs

@@ -706,6 +706,7 @@ module Aws::CloudWatch
       attr_accessor evaluation_state: ("PARTIAL_DATA" | "EVALUATION_FAILURE" | "EVALUATION_ERROR")
       attr_accessor action_log_line_count: ::Integer
       attr_accessor action_log_line_role_arn: ::String
+      attr_accessor warm_up_configuration: Types::WarmUpConfiguration
       SENSITIVE: []
     end
 
@@ -773,6 +774,7 @@ module Aws::CloudWatch
       attr_accessor evaluation_state: ("PARTIAL_DATA" | "EVALUATION_FAILURE" | "EVALUATION_ERROR")
       attr_accessor state_transitioned_timestamp: ::Time
       attr_accessor evaluation_window: Types::EvaluationWindow
+      attr_accessor warm_up_configuration: Types::WarmUpConfiguration
       attr_accessor evaluation_criteria: Types::EvaluationCriteria
       attr_accessor evaluation_interval: ::Integer
       SENSITIVE: []
@@ -960,6 +962,7 @@ module Aws::CloudWatch
       attr_accessor comparison_operator: ("GreaterThanOrEqualToThreshold" | "GreaterThanThreshold" | "LessThanThreshold" | "LessThanOrEqualToThreshold" | "LessThanLowerOrGreaterThanUpperThreshold" | "LessThanLowerThreshold" | "GreaterThanUpperThreshold")
       attr_accessor treat_missing_data: ::String
       attr_accessor tags: ::Array[Types::Tag]
+      attr_accessor warm_up_configuration: Types::WarmUpConfiguration
       SENSITIVE: []
     end
 
@@ -997,6 +1000,7 @@ module Aws::CloudWatch
       attr_accessor tags: ::Array[Types::Tag]
       attr_accessor threshold_metric_id: ::String
       attr_accessor evaluation_window: Types::EvaluationWindow
+      attr_accessor warm_up_configuration: Types::WarmUpConfiguration
       attr_accessor evaluation_criteria: Types::EvaluationCriteria
       attr_accessor evaluation_interval: ::Integer
       SENSITIVE: []
@@ -1164,5 +1168,11 @@ module Aws::CloudWatch
       attr_accessor timezone: ::String
       SENSITIVE: []
     end
+
+    class WarmUpConfiguration
+      attr_accessor warm_up_period_duration_in_minutes: ::Integer
+      attr_accessor only_start_evaluating_after_warm_up_period_ends: bool
+      SENSITIVE: []
+    end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatch
 version: !ruby/object:Gem::Version
-  version: 1.145.0
+  version: 1.146.0
 platform: ruby
 authors:
 - Amazon Web Services