aws-sdk-cloudwatchlogs 1.109.0 → 1.110.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9933c2237cedea63fb431280e07206aed9d7d4e6ed2903f6f61972015dbf1487
-  data.tar.gz: 6ab53515acd6217339a425cebc2bae6f10af87e59dd4a4b9750cc0555ebd50ef
+  metadata.gz: 710c640081bd102225217071bb96ca11c5a26bcc07959ad33091e0cca213d02e
+  data.tar.gz: c62a419aabe834d25815f6a0ce90fb174c23d3da96b55dc725714a3d2ef55080
 SHA512:
-  metadata.gz: 351e88fcdf2ecb17194b0afc5179bd5e6befd4f73795a9a05a4f33543ba71737b3db5daf67fb19f43ad020a40cb923d64794ae4fb8268dc174a5a4ff55da4f42
-  data.tar.gz: 3305ce0c50d267f89190bad9be59227fb15c0782adf18e6440508bbc480008af867dc566af1e07b21b312ee47a53be09c3803b785337071e47f0b85174323fdf
+  metadata.gz: a0b00f176b28d9b797ee0d7a268eb423952d0b410eab6dd7f124c058f145861e3ec09169ff446db358a2ef8a899e91505601a7e5a083d042a5d1eb8c0ef110e3
+  data.tar.gz: '028a11906af4c662ae66fcdc2acb7544cb8432eddb053c49cd91475e1c28a6e9b2df0bd5ae07f14fa88a505e63520c03c43fc9474ffb9fbe7fc17e04a8c73e81'

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.110.0 (2025-03-13)
+------------------
+
+* Feature - Updated CreateLogAnomalyDetector to accept only kms key arn
+
 1.109.0 (2025-02-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.109.0
+1.110.0

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

@@ -936,8 +936,9 @@ module Aws::CloudWatchLogs
     #   this key and for the anomaly detector to retrieve information about
     #   the anomalies that it finds.
     #
-    #   For more information about using a KMS key and to see the required IAM
-    #   policy, see [Use a KMS key with an anomaly detector][1].
+    #   Make sure the value provided is a valid KMS key ARN. For more
+    #   information about using a KMS key and to see the required IAM policy,
+    #   see [Use a KMS key with an anomaly detector][1].
     #
     #
     #
@@ -973,7 +974,7 @@ module Aws::CloudWatchLogs
     #     detector_name: "DetectorName",
     #     evaluation_frequency: "ONE_MIN", # accepts ONE_MIN, FIVE_MIN, TEN_MIN, FIFTEEN_MIN, THIRTY_MIN, ONE_HOUR
     #     filter_pattern: "FilterPattern",
-    #     kms_key_id: "KmsKeyId",
+    #     kms_key_id: "DetectorKmsKeyArn",
     #     anomaly_visibility_time: 1,
     #     tags: {
     #       "TagKey" => "TagValue",
@@ -2858,8 +2859,14 @@ module Aws::CloudWatchLogs
     end
 
     # Lists log events from the specified log group. You can list all the
-    # log events or filter the results using a filter pattern, a time range,
-    # and the name of the log stream.
+    # log events or filter the results using one or more of the following:
+    #
+    # * A filter pattern
+    #
+    # * A time range
+    #
+    # * The log stream name, or a log stream name prefix that matches
+    #   mutltiple log streams
     #
     # You must have the `logs:FilterLogEvents` permission to perform this
     # operation.
@@ -2868,13 +2875,28 @@ module Aws::CloudWatchLogs
     # `logGroupIdentifier` or `logGroupName`. You must include one of these
     # two parameters, but you can't include both.
     #
-    # By default, this operation returns as many log events as can fit in 1
-    # MB (up to 10,000 log events) or all the events found within the
-    # specified time range. If the results include a token, that means there
-    # are more log events available. You can get additional results by
-    # specifying the token in a subsequent call. This operation can return
-    # empty results while there are more log events available through the
-    # token.
+    # `FilterLogEvents` is a paginated operation. Each page returned can
+    # contain up to 1 MB of log events or up to 10,000 log events. A
+    # returned page might only be partially full, or even empty. For
+    # example, if the result of a query would return 15,000 log events, the
+    # first page isn't guaranteed to have 10,000 log events even if they
+    # all fit into 1 MB.
+    #
+    # Partially full or empty pages don't necessarily mean that pagination
+    # is finished. If the results include a `nextToken`, there might be more
+    # log events available. You can return these additional log events by
+    # providing the nextToken in a subsequent `FilterLogEvents` operation.
+    # If the results don't include a `nextToken`, then pagination is
+    # finished.
+    #
+    # <note markdown="1"> If you set `startFromHead` to `true` and you don’t include `endTime`
+    # in your request, you can end up in a situation where the pagination
+    # doesn't terminate. This can happen when the new log events are being
+    # added to the target log streams faster than they are being read. This
+    # situation is a good use case for the CloudWatch Logs [Live Tail][1]
+    # feature.
+    #
+    #  </note>
     #
     # The returned log events are sorted by event timestamp, the timestamp
     # when the event was ingested by CloudWatch Logs, and the ID of the
@@ -2883,11 +2905,21 @@ module Aws::CloudWatchLogs
     # If you are using CloudWatch cross-account observability, you can use
     # this operation in a monitoring account and view data from the linked
     # source accounts. For more information, see [CloudWatch cross-account
-    # observability][1].
+    # observability][2].
+    #
+    # <note markdown="1"> If you are using [log transformation][3], the `FilterLogEvents`
+    # operation returns only the original versions of log events, before
+    # they were transformed. To view the transformed versions, you must use
+    # a [CloudWatch Logs query.][4]
     #
+    #  </note>
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
+    # [4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
     #
     # @option params [String] :log_group_name
     #   The name of the log group to search.
@@ -3276,6 +3308,7 @@ module Aws::CloudWatchLogs
     end
 
     # Retrieves information about the log anomaly detector that you specify.
+    # The KMS key ARN detected is valid.
     #
     # @option params [required, String] :anomaly_detector_arn
     #   The ARN of the anomaly detector to retrieve information about. You can
@@ -3329,24 +3362,51 @@ module Aws::CloudWatchLogs
     # Lists log events from the specified log stream. You can list all of
     # the log events or filter using a time range.
     #
-    # By default, this operation returns as many log events as can fit in a
-    # response size of 1MB (up to 10,000 log events). You can get additional
-    # log events by specifying one of the tokens in a subsequent call. This
-    # operation can return empty results while there are more log events
-    # available through the token.
+    # `GetLogEvents` is a paginated operation. Each page returned can
+    # contain up to 1 MB of log events or up to 10,000 log events. A
+    # returned page might only be partially full, or even empty. For
+    # example, if the result of a query would return 15,000 log events, the
+    # first page isn't guaranteed to have 10,000 log events even if they
+    # all fit into 1 MB.
+    #
+    # Partially full or empty pages don't necessarily mean that pagination
+    # is finished. As long as the `nextBackwardToken` or `nextForwardToken`
+    # returned is NOT equal to the `nextToken` that you passed into the API
+    # call, there might be more log events available. The token that you use
+    # depends on the direction you want to move in along the log stream. The
+    # returned tokens are never null.
+    #
+    # <note markdown="1"> If you set `startFromHead` to `true` and you don’t include `endTime`
+    # in your request, you can end up in a situation where the pagination
+    # doesn't terminate. This can happen when the new log events are being
+    # added to the target log streams faster than they are being read. This
+    # situation is a good use case for the CloudWatch Logs [Live Tail][1]
+    # feature.
+    #
+    #  </note>
     #
     # If you are using CloudWatch cross-account observability, you can use
     # this operation in a monitoring account and view data from the linked
     # source accounts. For more information, see [CloudWatch cross-account
-    # observability][1].
+    # observability][2].
     #
     # You can specify the log group to search by using either
     # `logGroupIdentifier` or `logGroupName`. You must include one of these
     # two parameters, but you can't include both.
     #
+    # <note markdown="1"> If you are using [log transformation][3], the `GetLogEvents` operation
+    # returns only the original versions of log events, before they were
+    # transformed. To view the transformed versions, you must use a
+    # [CloudWatch Logs query.][4]
     #
+    #  </note>
     #
-    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
+    # [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
+    # [4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
     #
     # @option params [String] :log_group_name
     #   The name of the log group.
@@ -7001,7 +7061,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.109.0'
+      context[:gem_version] = '1.110.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -152,6 +152,7 @@ module Aws::CloudWatchLogs
     DestinationField = Shapes::StringShape.new(name: 'DestinationField')
     DestinationName = Shapes::StringShape.new(name: 'DestinationName')
     Destinations = Shapes::ListShape.new(name: 'Destinations')
+    DetectorKmsKeyArn = Shapes::StringShape.new(name: 'DetectorKmsKeyArn')
     DetectorName = Shapes::StringShape.new(name: 'DetectorName')
     Dimensions = Shapes::MapShape.new(name: 'Dimensions')
     DimensionsKey = Shapes::StringShape.new(name: 'DimensionsKey')
@@ -664,7 +665,7 @@ module Aws::CloudWatchLogs
     CreateLogAnomalyDetectorRequest.add_member(:detector_name, Shapes::ShapeRef.new(shape: DetectorName, location_name: "detectorName"))
     CreateLogAnomalyDetectorRequest.add_member(:evaluation_frequency, Shapes::ShapeRef.new(shape: EvaluationFrequency, location_name: "evaluationFrequency"))
     CreateLogAnomalyDetectorRequest.add_member(:filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "filterPattern"))
-    CreateLogAnomalyDetectorRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: KmsKeyId, location_name: "kmsKeyId"))
+    CreateLogAnomalyDetectorRequest.add_member(:kms_key_id, Shapes::ShapeRef.new(shape: DetectorKmsKeyArn, location_name: "kmsKeyId"))
     CreateLogAnomalyDetectorRequest.add_member(:anomaly_visibility_time, Shapes::ShapeRef.new(shape: AnomalyVisibilityTime, location_name: "anomalyVisibilityTime"))
     CreateLogAnomalyDetectorRequest.add_member(:tags, Shapes::ShapeRef.new(shape: Tags, location_name: "tags"))
     CreateLogAnomalyDetectorRequest.struct_class = Types::CreateLogAnomalyDetectorRequest

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

@@ -298,7 +298,7 @@ module Aws::CloudWatchLogs
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
-    #   The ID of the KMS key assigned to this anomaly detector, if any.
+    #   The ARN of the KMS key assigned to this anomaly detector, if any.
     #   @return [String]
     #
     # @!attribute [rw] creation_time_stamp
@@ -815,8 +815,9 @@ module Aws::CloudWatchLogs
     #   both this key and for the anomaly detector to retrieve information
     #   about the anomalies that it finds.
     #
-    #   For more information about using a KMS key and to see the required
-    #   IAM policy, see [Use a KMS key with an anomaly detector][1].
+    #   Make sure the value provided is a valid KMS key ARN. For more
+    #   information about using a KMS key and to see the required IAM
+    #   policy, see [Use a KMS key with an anomaly detector][1].
     #
     #
     #
@@ -2843,6 +2844,9 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] next_token
     #   The token to use when requesting the next set of items. The token
     #   expires after 24 hours.
+    #
+    #   If the results don't include a `nextToken`, then pagination is
+    #   finished.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/FilterLogEventsResponse AWS API Documentation
@@ -3124,7 +3128,7 @@ module Aws::CloudWatchLogs
     #   @return [String]
     #
     # @!attribute [rw] kms_key_id
-    #   The ID of the KMS key assigned to this anomaly detector, if any.
+    #   The ARN of the KMS key assigned to this anomaly detector, if any.
     #   @return [String]
     #
     # @!attribute [rw] creation_time_stamp

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -55,7 +55,7 @@ module Aws::CloudWatchLogs
   autoload :Endpoints, 'aws-sdk-cloudwatchlogs/endpoints'
   autoload :EventStreams, 'aws-sdk-cloudwatchlogs/event_streams'
 
-  GEM_VERSION = '1.109.0'
+  GEM_VERSION = '1.110.0'
 
 end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.109.0
+  version: 1.110.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-02-18 00:00:00.000000000 Z
+date: 2025-03-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core