diff --git a/manifest.json b/manifest.json index 4949e1750..5d4787f01 100644 --- a/manifest.json +++ b/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": { diff --git a/src/Service/CloudWatchLogs/CHANGELOG.md b/src/Service/CloudWatchLogs/CHANGELOG.md index 1b3ec9f40..fc4c3ec76 100644 --- a/src/Service/CloudWatchLogs/CHANGELOG.md +++ b/src/Service/CloudWatchLogs/CHANGELOG.md @@ -2,6 +2,10 @@ ## NOT RELEASED +### Changed + +- AWS enhancement: Documentation updates. + ## 2.5.0 ### Added diff --git a/src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php b/src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php index 69c14c515..ba47bee19 100644 --- a/src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php +++ b/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 diff --git a/src/Service/CloudWatchLogs/src/Result/FilterLogEventsResponse.php b/src/Service/CloudWatchLogs/src/Result/FilterLogEventsResponse.php index c3fb6f5fa..a06ef5b7e 100644 --- a/src/Service/CloudWatchLogs/src/Result/FilterLogEventsResponse.php +++ b/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; diff --git a/src/Service/CodeBuild/CHANGELOG.md b/src/Service/CodeBuild/CHANGELOG.md index 2537834ae..499f40e31 100644 --- a/src/Service/CodeBuild/CHANGELOG.md +++ b/src/Service/CodeBuild/CHANGELOG.md @@ -2,6 +2,10 @@ ## NOT RELEASED +### Changed + +- AWS enhancement: Documentation updates. + ## 2.8.0 ### Added diff --git a/src/Service/CodeBuild/src/ValueObject/ProjectEnvironment.php b/src/Service/CodeBuild/src/ValueObject/ProjectEnvironment.php index 1faf59e3c..497dd1dd8 100644 --- a/src/Service/CodeBuild/src/ValueObject/ProjectEnvironment.php +++ b/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*. diff --git a/src/Service/StepFunctions/CHANGELOG.md b/src/Service/StepFunctions/CHANGELOG.md index 4c1a5ef30..507dcd49f 100644 --- a/src/Service/StepFunctions/CHANGELOG.md +++ b/src/Service/StepFunctions/CHANGELOG.md @@ -2,6 +2,10 @@ ## NOT RELEASED +### Added + +- AWS api-change: TODO + ## 1.4.0 ### Added diff --git a/src/Service/StepFunctions/composer.json b/src/Service/StepFunctions/composer.json index 71588c951..304003fef 100644 --- a/src/Service/StepFunctions/composer.json +++ b/src/Service/StepFunctions/composer.json @@ -27,7 +27,7 @@ }, "extra": { "branch-alias": { - "dev-master": "1.4-dev" + "dev-master": "1.5-dev" } } } diff --git a/src/Service/StepFunctions/src/StepFunctionsClient.php b/src/Service/StepFunctions/src/StepFunctionsClient.php index 138cd79b3..527c65e39 100644 --- a/src/Service/StepFunctions/src/StepFunctionsClient.php +++ b/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 [