aws-sdk-cloudwatchlogs 1.155.0 → 1.156.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6cb54db34708b79eef1f663f649caa1543e0beea1ec953787c513af57e138b20
-  data.tar.gz: 7c2b3338d21ec391652ea509537a3736dfe5b0d077795b470a139d96e3dd3314
+  metadata.gz: ab5f10c38ad4b140617f81629c5c33fe31a425a7b29d0398c453c58d744ac83b
+  data.tar.gz: 2634cd67d159f34c96a1d507798ce93ac9ba928e7286015bb77c0c940cee3cce
 SHA512:
-  metadata.gz: 757e844b7ae76bd1899f55c2ffe80b374a716e4b517c2a2e49d4e1482823c0b44c6cfab62cea9c6fff49a7017decc1cfa0fe3c185e3502cd167657bef46511b7
-  data.tar.gz: 2c00ef8f1e975e246b586c649bf01ed965a83026614776ca35492b423d4452213dbd9cf21ca4bb05318422400b8335837b65eb2028cdf23cdf0e9f4bb7c6fb76
+  metadata.gz: 4050525b4cb469868446a2e193a4b3ed21f99a68faffec806f38ae0e632be1c0caa376ed55fd9fedc1e1ff585e76c5b443ca40060b6f9dea39ed670f08fbb4db
+  data.tar.gz: b885687169b410826ded26e838f9967837536e3b1c3e9b82e0b6a974278883f9b87b264f061e1b37dba2d448d93bd5b1dc265b56b017fae4009056662ab95f25

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.156.0 (2026-06-18)
+------------------
+
+* Feature - Added optional startFromHead parameter to FilterLogEvents enabling descending timestamp order (newest first) when set to false. Default true preserves existing ascending order. Reverse sorting requires a startTime on or after Jan 1, 2024.
+
 1.155.0 (2026-06-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.155.0
+1.156.0

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

@@ -3626,7 +3626,10 @@ module Aws::CloudWatchLogs
     #
     # The returned log events are sorted by event timestamp, the timestamp
     # when the event was ingested by CloudWatch Logs, and the ID of the
-    # `PutLogEvents` request.
+    # `PutLogEvents` request. By default, the events are returned in
+    # ascending timestamp order (oldest first). To return events in
+    # descending timestamp order (newest first), set the `startFromHead`
+    # parameter to `false`.
     #
     # If you are using CloudWatch cross-account observability, you can use
     # this operation in a monitoring account and view data from the linked
@@ -3706,6 +3709,24 @@ module Aws::CloudWatchLogs
     # @option params [Integer] :limit
     #   The maximum number of events to return. The default is 10,000 events.
     #
+    # @option params [Boolean] :start_from_head
+    #   If the value is true, the earliest log events are returned first. If
+    #   the value is false, the latest log events are returned first. The
+    #   default value is true.
+    #
+    #   The `startFromHead` parameter sets the sort direction on the first
+    #   request. On subsequent requests, the `nextToken` determines the sort
+    #   direction. To continue paginating in the same direction, provide the
+    #   returned `nextToken`. If you provide both `nextToken` and
+    #   `startFromHead`, the direction of the `nextToken` is used.
+    #
+    #   <note markdown="1"> Setting `startFromHead` to `false` is supported only when `startTime`
+    #   is on or after `Jan 1, 2024 00:00:00 UTC`. A request with
+    #   `startFromHead` set to `false` and a `startTime` before this date
+    #   returns an `InvalidParameterException`.
+    #
+    #    </note>
+    #
     # @option params [Boolean] :interleaved
     #   If the value is true, the operation attempts to provide responses that
     #   contain events from multiple log streams within the log group,
@@ -3744,6 +3765,7 @@ module Aws::CloudWatchLogs
     #     filter_pattern: "FilterPattern",
     #     next_token: "NextToken",
     #     limit: 1,
+    #     start_from_head: false,
     #     interleaved: false,
     #     unmask: false,
     #   })
@@ -9325,7 +9347,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.155.0'
+      context[:gem_version] = '1.156.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1373,6 +1373,7 @@ module Aws::CloudWatchLogs
     FilterLogEventsRequest.add_member(:filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "filterPattern"))
     FilterLogEventsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
     FilterLogEventsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: EventsLimit, location_name: "limit"))
+    FilterLogEventsRequest.add_member(:start_from_head, Shapes::ShapeRef.new(shape: StartFromHead, location_name: "startFromHead"))
     FilterLogEventsRequest.add_member(:interleaved, Shapes::ShapeRef.new(shape: Interleaved, deprecated: true, location_name: "interleaved", metadata: {"deprecatedMessage" => "Starting on June 17, 2019, this parameter will be ignored and the value will be assumed to be true. The response from this operation will always interleave events from multiple log streams within a log group."}))
     FilterLogEventsRequest.add_member(:unmask, Shapes::ShapeRef.new(shape: Unmask, location_name: "unmask"))
     FilterLogEventsRequest.struct_class = Types::FilterLogEventsRequest

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

@@ -3572,6 +3572,25 @@ module Aws::CloudWatchLogs
     #   events.
     #   @return [Integer]
     #
+    # @!attribute [rw] start_from_head
+    #   If the value is true, the earliest log events are returned first. If
+    #   the value is false, the latest log events are returned first. The
+    #   default value is true.
+    #
+    #   The `startFromHead` parameter sets the sort direction on the first
+    #   request. On subsequent requests, the `nextToken` determines the sort
+    #   direction. To continue paginating in the same direction, provide the
+    #   returned `nextToken`. If you provide both `nextToken` and
+    #   `startFromHead`, the direction of the `nextToken` is used.
+    #
+    #   <note markdown="1"> Setting `startFromHead` to `false` is supported only when
+    #   `startTime` is on or after `Jan 1, 2024 00:00:00 UTC`. A request
+    #   with `startFromHead` set to `false` and a `startTime` before this
+    #   date returns an `InvalidParameterException`.
+    #
+    #    </note>
+    #   @return [Boolean]
+    #
     # @!attribute [rw] interleaved
     #   If the value is true, the operation attempts to provide responses
     #   that contain events from multiple log streams within the log group,
@@ -3604,6 +3623,7 @@ module Aws::CloudWatchLogs
       :filter_pattern,
       :next_token,
       :limit,
+      :start_from_head,
       :interleaved,
       :unmask)
       SENSITIVE = []
@@ -3623,8 +3643,9 @@ module Aws::CloudWatchLogs
     #   @return [Array<Types::SearchedLogStream>]
     #
     # @!attribute [rw] next_token
-    #   The token to use when requesting the next set of items. The token
-    #   expires after 24 hours.
+    #   The token for the next set of items in the sorting direction
+    #   specified by the `startFromHead` parameter in the first request. The
+    #   token expires after 24 hours.
     #
     #   If the results don't include a `nextToken`, then pagination is
     #   finished.

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.155.0'
+  GEM_VERSION = '1.156.0'
 
 end
 

data/sig/client.rbs

@@ -691,6 +691,7 @@ module Aws
                                ?filter_pattern: ::String,
                                ?next_token: ::String,
                                ?limit: ::Integer,
+                               ?start_from_head: bool,
                                ?interleaved: bool,
                                ?unmask: bool
                              ) -> _FilterLogEventsResponseSuccess

data/sig/types.rbs

@@ -839,6 +839,7 @@ module Aws::CloudWatchLogs
       attr_accessor filter_pattern: ::String
       attr_accessor next_token: ::String
       attr_accessor limit: ::Integer
+      attr_accessor start_from_head: bool
       attr_accessor interleaved: bool
       attr_accessor unmask: bool
       SENSITIVE: []

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.155.0
+  version: 1.156.0
 platform: ruby
 authors:
 - Amazon Web Services