Update generated code (#1856)

update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.342.3"
+        "${LATEST}": "3.342.5"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Service/CloudWatchLogs/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 2.5.0
 
 ### Added

src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php

@@ -176,26 +176,45 @@ public function describeLogStreams($input = []): DescribeLogStreamsResponse
     }
 
     /**
-     * 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.
+     * Lists log events from the specified log group. You can list all the 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.
      *
      * 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.
      *
-     * 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.
+     *
+     * > 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.
      *
      * 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.
      *
      * 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].
+     * data from the linked source accounts. For more information, see CloudWatch cross-account observability [^2].
      *
-     * [^1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch-Unified-Cross-Account.html
+     * > 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]
+     *
+     * [^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
      *
      * @see https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_FilterLogEvents.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-logs-2014-03-28.html#filterlogevents

src/Service/CloudWatchLogs/src/Result/FilterLogEventsResponse.php

@@ -34,6 +34,8 @@ class FilterLogEventsResponse extends Result implements \IteratorAggregate
     /**
      * 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.
+     *
      * @var string|null
      */
     private $nextToken;

src/Service/CodeBuild/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 2.8.0
 
 ### Added

src/Service/CodeBuild/src/ValueObject/ProjectEnvironment.php

@@ -15,22 +15,6 @@ final class ProjectEnvironment
     /**
      * The type of build environment to use for related builds.
      *
-     * - The environment type `ARM_CONTAINER` is available only in regions US East (N. Virginia), US East (Ohio), US West
-     *   (Oregon), EU (Ireland), Asia Pacific (Mumbai), Asia Pacific (Tokyo), Asia Pacific (Sydney), and EU (Frankfurt).
-     * - The environment type `LINUX_CONTAINER` is available only in regions US East (N. Virginia), US East (Ohio), US West
-     *   (Oregon), Canada (Central), EU (Ireland), EU (London), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific (Seoul),
-     *   Asia Pacific (Singapore), Asia Pacific (Sydney), China (Beijing), and China (Ningxia).
-     * - The environment type `LINUX_GPU_CONTAINER` is available only in regions US East (N. Virginia), US East (Ohio), US
-     *   West (Oregon), Canada (Central), EU (Ireland), EU (London), EU (Frankfurt), Asia Pacific (Tokyo), Asia Pacific
-     *   (Seoul), Asia Pacific (Singapore), Asia Pacific (Sydney) , China (Beijing), and China (Ningxia).
-     *
-     * - The environment types `ARM_LAMBDA_CONTAINER` and `LINUX_LAMBDA_CONTAINER` are available only in regions US East (N.
-     *   Virginia), US East (Ohio), US West (Oregon), Asia Pacific (Mumbai), Asia Pacific (Singapore), Asia Pacific
-     *   (Sydney), Asia Pacific (Tokyo), EU (Frankfurt), EU (Ireland), and South America (São Paulo).
-     *
-     * - The environment types `WINDOWS_CONTAINER` and `WINDOWS_SERVER_2019_CONTAINER` are available only in regions US East
-     *   (N. Virginia), US East (Ohio), US West (Oregon), and EU (Ireland).
-     *
      * > If you're using compute fleets during project creation, `type` will be ignored.
      *
      * For more information, see Build environment compute types [^1] in the *CodeBuild user guide*.

src/Service/StepFunctions/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: TODO
+
 ## 1.4.0
 
 ### Added

src/Service/StepFunctions/composer.json

@@ -27,7 +27,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "1.4-dev"
+            "dev-master": "1.5-dev"
         }
     }
 }

src/Service/StepFunctions/src/StepFunctionsClient.php

@@ -311,6 +311,20 @@ protected function getEndpointMetadata(?string $region): array
                     'signService' => 'states',
                     'signVersions' => ['v4'],
                 ];
+            case 'fips-ca-central-1':
+                return [
+                    'endpoint' => 'https://states-fips.ca-central-1.amazonaws.com',
+                    'signRegion' => 'ca-central-1',
+                    'signService' => 'states',
+                    'signVersions' => ['v4'],
+                ];
+            case 'fips-ca-west-1':
+                return [
+                    'endpoint' => 'https://states-fips.ca-west-1.amazonaws.com',
+                    'signRegion' => 'ca-west-1',
+                    'signService' => 'states',
+                    'signVersions' => ['v4'],
+                ];
             case 'fips-us-east-1':
                 return [
                     'endpoint' => 'https://states-fips.us-east-1.amazonaws.com',
@@ -376,6 +390,27 @@ protected function getEndpointMetadata(?string $region): array
                     'signService' => 'states',
                     'signVersions' => ['v4'],
                 ];
+            case 'fips-us-iso-east-1':
+                return [
+                    'endpoint' => 'https://states-fips.us-iso-east-1.c2s.ic.gov',
+                    'signRegion' => 'us-iso-east-1',
+                    'signService' => 'states',
+                    'signVersions' => ['v4'],
+                ];
+            case 'fips-us-iso-west-1':
+                return [
+                    'endpoint' => 'https://states-fips.us-iso-west-1.c2s.ic.gov',
+                    'signRegion' => 'us-iso-west-1',
+                    'signService' => 'states',
+                    'signVersions' => ['v4'],
+                ];
+            case 'fips-us-isob-east-1':
+                return [
+                    'endpoint' => 'https://states-fips.us-isob-east-1.sc2s.sgov.gov',
+                    'signRegion' => 'us-isob-east-1',
+                    'signService' => 'states',
+                    'signVersions' => ['v4'],
+                ];
         }
 
         return [