@aws-sdk/client-cloudwatch-logs 3.1071.0 → 3.1073.0

package/dist-cjs/schemas/schemas_0.js

@@ -1761,8 +1761,8 @@ const FilteredLogEvent$ = [3, n0, _FLE,
 exports.FilteredLogEvent$ = FilteredLogEvent$;
 const FilterLogEventsRequest$ = [3, n0, _FLER,
     0,
-    [_lGN, _lGIo, _lSNo, _lSNP, _sTt, _eTn, _fP, _nT, _li, _in, _u],
-    [0, 0, 64 | 0, 0, 1, 1, 0, 0, 1, 2, 2]
+    [_lGN, _lGIo, _lSNo, _lSNP, _sTt, _eTn, _fP, _nT, _li, _sFH, _in, _u],
+    [0, 0, 64 | 0, 0, 1, 1, 0, 0, 1, 2, 2, 2]
 ];
 exports.FilterLogEventsRequest$ = FilterLogEventsRequest$;
 const FilterLogEventsResponse$ = [3, n0, _FLERi,

package/dist-es/schemas/schemas_0.js

@@ -1625,8 +1625,8 @@ export var FilteredLogEvent$ = [3, n0, _FLE,
 ];
 export var FilterLogEventsRequest$ = [3, n0, _FLER,
     0,
-    [_lGN, _lGIo, _lSNo, _lSNP, _sTt, _eTn, _fP, _nT, _li, _in, _u],
-    [0, 0, 64 | 0, 0, 1, 1, 0, 0, 1, 2, 2]
+    [_lGN, _lGIo, _lSNo, _lSNP, _sTt, _eTn, _fP, _nT, _li, _sFH, _in, _u],
+    [0, 0, 64 | 0, 0, 1, 1, 0, 0, 1, 2, 2, 2]
 ];
 export var FilterLogEventsResponse$ = [3, n0, _FLERi,
     0,

package/dist-types/commands/FilterLogEventsCommand.d.ts

@@ -62,7 +62,10 @@ declare const FilterLogEventsCommand_base: {
  *       return more log events than the specified limit, but it might return fewer events than the
  *       limit. This is the expected API behavior.</p>
  *          <p>The returned log events are sorted by event timestamp, the timestamp when the event was
- *       ingested by CloudWatch Logs, and the ID of the <code>PutLogEvents</code> request.</p>
+ *       ingested by CloudWatch Logs, and the ID of the <code>PutLogEvents</code> request. By default,
+ *       the events are returned in ascending timestamp order (oldest first). To return events in
+ *       descending timestamp order (newest first), set the <code>startFromHead</code> parameter to
+ *         <code>false</code>.</p>
  *          <p>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 <a href="https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html">CloudWatch cross-account observability</a>.</p>
@@ -94,6 +97,7 @@ declare const FilterLogEventsCommand_base: {
  *   filterPattern: "STRING_VALUE",
  *   nextToken: "STRING_VALUE",
  *   limit: Number("int"),
+ *   startFromHead: true || false,
  *   interleaved: true || false,
  *   unmask: true || false,
  * };

package/dist-types/models/models_0.d.ts

@@ -3884,6 +3884,23 @@ export interface FilterLogEventsRequest {
      * @public
      */
     limit?: number | undefined;
+    /**
+     * <p>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.</p>
+     *          <p>The <code>startFromHead</code> parameter sets the sort direction on the first request.
+     *       On subsequent requests, the <code>nextToken</code> determines the sort direction. To continue
+     *       paginating in the same direction, provide the returned <code>nextToken</code>. If you provide
+     *       both <code>nextToken</code> and <code>startFromHead</code>, the direction of the
+     *         <code>nextToken</code> is used.</p>
+     *          <note>
+     *             <p>Setting <code>startFromHead</code> to <code>false</code> is supported only when
+     *           <code>startTime</code> is on or after <code>Jan 1, 2024 00:00:00 UTC</code>. A request with
+     *           <code>startFromHead</code> set to <code>false</code> and a <code>startTime</code> before
+     *         this date returns an <code>InvalidParameterException</code>.</p>
+     *          </note>
+     * @public
+     */
+    startFromHead?: boolean | undefined;
     /**
      * <p>If the value is true, the operation attempts to provide responses that contain events
      *       from multiple log streams within the log group, interleaved in a single response. If the value
@@ -3942,7 +3959,8 @@ export interface FilterLogEventsResponse {
      */
     searchedLogStreams?: SearchedLogStream[] | undefined;
     /**
-     * <p>The token to use when requesting the next set of items. The token expires after 24
+     * <p>The token for the next set of items in the sorting direction specified by the
+     *         <code>startFromHead</code> parameter in the first request. The token expires after 24
      *       hours.</p>
      *          <p>If the results don't include a <code>nextToken</code>, then pagination is finished.
      *     </p>

package/dist-types/ts3.4/models/models_0.d.ts

@@ -811,6 +811,7 @@ export interface FilterLogEventsRequest {
   filterPattern?: string | undefined;
   nextToken?: string | undefined;
   limit?: number | undefined;
+  startFromHead?: boolean | undefined;
   interleaved?: boolean | undefined;
   unmask?: boolean | undefined;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-cloudwatch-logs",
   "description": "AWS SDK for JavaScript Cloudwatch Logs Client for Node.js, Browser and React Native",
-  "version": "3.1071.0",
+  "version": "3.1073.0",
   "scripts": {
     "build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
     "build:cjs": "node ../../scripts/compilation/inline",