Update generated code

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.344.7"
+        "${LATEST}": "3.346.0"
     },
     "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.7.0
 
 ### Added

src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php

@@ -257,21 +257,22 @@ public function filterLogEvents($input = []): FilterLogEventsResponse
      *
      * - The maximum batch size is 1,048,576 bytes. This size is calculated as the sum of all event messages in UTF-8, plus
      *   26 bytes for each log event.
-     * - None of the log events in the batch can be more than 2 hours in the future.
-     * - None of the log events in the batch can be more than 14 days in the past. Also, none of the log events can be from
-     *   earlier than the retention period of the log group.
+     * - Events more than 2 hours in the future are rejected while processing remaining valid events.
+     * - Events older than 14 days or preceding the log group's retention period are rejected while processing remaining
+     *   valid events.
      * - The log events in the batch must be in chronological order by their timestamp. The timestamp is the time that the
      *   event occurred, expressed as the number of milliseconds after `Jan 1, 1970 00:00:00 UTC`. (In Amazon Web Services
      *   Tools for PowerShell and the Amazon Web Services SDK for .NET, the timestamp is specified in .NET format:
      *   `yyyy-mm-ddThh:mm:ss`. For example, `2017-09-15T13:45:30`.)
-     * - A batch of log events in a single request cannot span more than 24 hours. Otherwise, the operation fails.
+     * - A batch of log events in a single request must be in a chronological order. Otherwise, the operation fails.
      * - Each log event can be no larger than 1 MB.
      * - The maximum number of log events in a batch is 10,000.
-     * -
-     * - ! The quota of five requests per second per log stream has been removed. Instead, `PutLogEvents` actions are
-     * -   throttled based on a per-second per-account quota. You can request an increase to the per-second throttling quota
-     * -   by using the Service Quotas service.
-     * -
+     * - For valid events (within 14 days in the past to 2 hours in future), the time span in a single batch cannot exceed
+     *   24 hours. Otherwise, the operation fails.
+     *
+     * ! The quota of five requests per second per log stream has been removed. Instead, `PutLogEvents` actions are
+     * ! throttled based on a per-second per-account quota. You can request an increase to the per-second throttling quota
+     * ! by using the Service Quotas service.
      *
      * If a call to `PutLogEvents` returns "UnrecognizedClientException" the most likely cause is a non-valid Amazon Web
      * Services access key ID or secret key.

src/Service/S3/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - AWS api-change: Rework regions configuration
+- AWS api-change: Added `tagCount` property to the HeadObject response
 
 ## 2.9.1
 

src/Service/S3/src/Result/HeadObjectOutput.php

@@ -367,6 +367,19 @@ class HeadObjectOutput extends Result
      */
     private $partsCount;
 
+    /**
+     * The number of tags, if any, on the object, when you have the relevant permission to read object tags.
+     *
+     * You can use GetObjectTagging [^1] to retrieve the tag set associated with an object.
+     *
+     * > This functionality is not supported for directory buckets.
+     *
+     * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html
+     *
+     * @var int|null
+     */
+    private $tagCount;
+
     /**
      * The Object Lock mode, if any, that's in effect for this object. This header is only returned if the requester has the
      * `s3:GetObjectRetention` permission. For more information about S3 Object Lock, see Object Lock [^1].
@@ -674,6 +687,13 @@ public function getStorageClass(): ?string
         return $this->storageClass;
     }
 
+    public function getTagCount(): ?int
+    {
+        $this->initialize();
+
+        return $this->tagCount;
+    }
+
     public function getVersionId(): ?string
     {
         $this->initialize();
@@ -725,6 +745,7 @@ protected function populateResult(Response $response): void
         $this->requestCharged = $headers['x-amz-request-charged'][0] ?? null;
         $this->replicationStatus = $headers['x-amz-replication-status'][0] ?? null;
         $this->partsCount = isset($headers['x-amz-mp-parts-count'][0]) ? (int) $headers['x-amz-mp-parts-count'][0] : null;
+        $this->tagCount = isset($headers['x-amz-tagging-count'][0]) ? (int) $headers['x-amz-tagging-count'][0] : null;
         $this->objectLockMode = $headers['x-amz-object-lock-mode'][0] ?? null;
         $this->objectLockRetainUntilDate = isset($headers['x-amz-object-lock-retain-until-date'][0]) ? new \DateTimeImmutable($headers['x-amz-object-lock-retain-until-date'][0]) : null;
         $this->objectLockLegalHoldStatus = $headers['x-amz-object-lock-legal-hold'][0] ?? null;

src/Service/S3/src/Result/ListObjectsV2Output.php

@@ -120,8 +120,7 @@ class ListObjectsV2Output extends Result implements \IteratorAggregate
 
     /**
      * If `ContinuationToken` was sent with the request, it is included in the response. You can use the returned
-     * `ContinuationToken` for pagination of the list response. You can use this `ContinuationToken` for pagination of the
-     * list results.
+     * `ContinuationToken` for pagination of the list response.
      *
      * @var string|null
      */

src/Service/S3/src/S3Client.php

@@ -374,6 +374,15 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
+     * ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
+     * ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
+     * ! However, you will no longer be able to create new Email Grantee ACLs.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * Creates a copy of an object that is already stored in Amazon S3.
      *
      * > You can store individual objects of up to 5 TB in Amazon S3. You create a copy of your object up to 5 GB in size in
@@ -565,6 +574,23 @@ public function copyObject($input): CopyObjectOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
+     * ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
+     * ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
+     * ! However, you will no longer be able to create new Email Grantee ACLs.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+     * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+     * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * > This action creates an Amazon S3 bucket. To create an Amazon S3 on Outposts bucket, see `CreateBucket` [^1].
      *
      * Creates a new S3 bucket. To create a bucket, you must set up Amazon S3 and have a valid Amazon Web Services Access
@@ -691,6 +717,15 @@ public function createBucket($input): CreateBucketOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
+     * ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
+     * ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
+     * ! However, you will no longer be able to create new Email Grantee ACLs.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * This action initiates a multipart upload and returns an upload ID. This upload ID is used to associate all of the
      * parts in the specific multipart upload. You specify this upload ID in each of your subsequent upload part requests
      * (see UploadPart [^1]). You also include this upload ID in the final request to either complete or abort the multipart
@@ -1779,6 +1814,14 @@ public function headObject($input): HeadObjectOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+     * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+     * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * > This operation is not supported for directory buckets.
      *
      * Returns a list of all buckets owned by the authenticated sender of the request. To grant IAM permission to use this
@@ -1814,6 +1857,14 @@ public function listBuckets($input = []): ListBucketsOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+     * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+     * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * This operation lists in-progress multipart uploads in a bucket. An in-progress multipart upload is a multipart upload
      * that has been initiated by the `CreateMultipartUpload` request, but has not yet been completed or aborted.
      *
@@ -1921,6 +1972,14 @@ public function listMultipartUploads($input): ListMultipartUploadsOutput
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+     * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+     * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * > This operation is not supported for directory buckets.
      *
      * Returns metadata about all versions of the objects in a bucket. You can also use request parameters as selection
@@ -2071,6 +2130,14 @@ public function listObjectsV2($input): ListObjectsV2Output
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+     * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+     * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * Lists the parts that have been uploaded for a specific multipart upload.
      *
      * To use this operation, you must provide the `upload ID` in the request. You obtain this uploadID by sending the
@@ -2433,6 +2500,15 @@ public function putBucketTagging($input): Result
     }
 
     /**
+     * ! End of support notice: Beginning October 1, 2025, Amazon S3 will discontinue support for creating new Email Grantee
+     * ! Access Control Lists (ACL). Email Grantee ACLs created prior to this date will continue to work and remain
+     * ! accessible through the Amazon Web Services Management Console, Command Line Interface (CLI), SDKs, and REST API.
+     * ! However, you will no longer be able to create new Email Grantee ACLs.
+     * !
+     * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+     * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+     * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+     *
      * Adds an object to a bucket.
      *
      * > - Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the entire object to the
@@ -2661,7 +2737,8 @@ public function putObject($input): PutObjectOutput
      * - `Grantee Values`:
      *
      *   You can specify the person (grantee) to whom you're assigning access rights (using request elements) in the
-     *   following ways:
+     *   following ways. For examples of how to specify these grantee values in JSON format, see the Amazon Web Services CLI
+     *   example in Enabling Amazon S3 server access logging [^7] in the *Amazon S3 User Guide*.
      *
      *   - By the person's ID:
      *
@@ -2693,7 +2770,7 @@ public function putObject($input): PutObjectOutput
      *     > - Europe (Ireland)
      *     > - South America (São Paulo)
      *     >
-     *     > For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints [^7] in the Amazon
+     *     > For a list of all the Amazon S3 supported Regions and endpoints, see Regions and Endpoints [^8] in the Amazon
      *     > Web Services General Reference.
      *
      *
@@ -2704,18 +2781,19 @@ public function putObject($input): PutObjectOutput
      *
      * The following operations are related to `PutObjectAcl`:
      *
-     * - CopyObject [^8]
-     * - GetObject [^9]
+     * - CopyObject [^9]
+     * - GetObject [^10]
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
      * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
      * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
      * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
      * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
      * [^6]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
-     * [^7]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
-     * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
-     * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+     * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html
+     * [^8]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
+     * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
+     * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
      *
      * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html
      * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putobjectacl

src/Service/S3/src/ValueObject/Owner.php

@@ -3,6 +3,14 @@
 namespace AsyncAws\S3\ValueObject;
 
 /**
+ * ! End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning `DisplayName`. Update your
+ * ! applications to use canonical IDs (unique identifier for Amazon Web Services accounts), Amazon Web Services account
+ * ! ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of `DisplayName`.
+ * !
+ * ! This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N.
+ * ! California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region, Asia
+ * ! Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.
+ *
  * Container for the owner's display name and ID.
  */
 final class Owner