@@ -196,24 +196,21 @@ public function describeLogStreams($input = []): DescribeLogStreamsResponse
196196 * nextToken in a subsequent `FilterLogEvents` operation. If the results don't include a `nextToken`, then pagination is
197197 * finished.
198198 *
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.
203201 *
204202 * The returned log events are sorted by event timestamp, the timestamp when the event was ingested by CloudWatch Logs,
205203 * and the ID of the `PutLogEvents` request.
206204 *
207205 * 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 ].
209207 *
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 ]
212210 *
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
217214 *
218215 * @see https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html
219216 * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-logs-2014-03-28.html#filterlogevents
0 commit comments