@@ -196,24 +196,21 @@ public function describeLogStreams($input = []): DescribeLogStreamsResponse
196
196
* nextToken in a subsequent `FilterLogEvents` operation. If the results don't include a `nextToken`, then pagination is
197
197
* finished.
198
198
*
199
- * > If you set `startFromHead` to `true` and you don’t include `endTime` in your request, you can end up in a
200
- * > situation where the pagination doesn't terminate. This can happen when the new log events are being added to the
201
- * > target log streams faster than they are being read. This situation is a good use case for the CloudWatch Logs Live
202
- * > Tail [^1] feature.
199
+ * Specifying the `limit` parameter only guarantees that a single page doesn't return more log events than the specified
200
+ * limit, but it might return fewer events than the limit. This is the expected API behavior.
203
201
*
204
202
* The returned log events are sorted by event timestamp, the timestamp when the event was ingested by CloudWatch Logs,
205
203
* and the ID of the `PutLogEvents` request.
206
204
*
207
205
* If you are using CloudWatch cross-account observability, you can use this operation in a monitoring account and view
208
- * data from the linked source accounts. For more information, see CloudWatch cross-account observability [^2 ].
206
+ * data from the linked source accounts. For more information, see CloudWatch cross-account observability [^1 ].
209
207
*
210
- * > If you are using log transformation [^3 ], the `FilterLogEvents` operation returns only the original versions of log
211
- * > events, before they were transformed. To view the transformed versions, you must use a CloudWatch Logs query. [^4 ]
208
+ * > If you are using log transformation [^2 ], the `FilterLogEvents` operation returns only the original versions of log
209
+ * > events, before they were transformed. To view the transformed versions, you must use a CloudWatch Logs query. [^3 ]
212
210
*
213
- * [^1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
214
- * [^2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
215
- * [^3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
216
- * [^4]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
211
+ * [^1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
212
+ * [^2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatch-Logs-Transformation.html
213
+ * [^3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/AnalyzingLogData.html
217
214
*
218
215
* @see https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html
219
216
* @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-logs-2014-03-28.html#filterlogevents
0 commit comments