update generated code

Author: async-aws-bot

manifest.json

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

src/Service/S3/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: This change enhances integrity protections for new SDK requests to S3. S3 SDKs now support the CRC64NVME checksum algorithm, full object checksums for multipart S3 objects, and new default integrity protections for S3 requests.
+
 ## 2.7.0
 
 ### Added

src/Service/S3/composer.json

@@ -30,7 +30,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "2.7-dev"
+            "dev-master": "2.8-dev"
         }
     }
 }

src/Service/S3/src/Enum/ChecksumAlgorithm.php

@@ -6,6 +6,7 @@ final class ChecksumAlgorithm
 {
     public const CRC32 = 'CRC32';
     public const CRC32C = 'CRC32C';
+    public const CRC64NVME = 'CRC64NVME';
     public const SHA1 = 'SHA1';
     public const SHA256 = 'SHA256';
 
@@ -14,6 +15,7 @@ public static function exists(string $value): bool
         return isset([
             self::CRC32 => true,
             self::CRC32C => true,
+            self::CRC64NVME => true,
             self::SHA1 => true,
             self::SHA256 => true,
         ][$value]);

src/Service/S3/src/Enum/ChecksumType.php

@@ -0,0 +1,17 @@
+<?php
+
+namespace AsyncAws\S3\Enum;
+
+final class ChecksumType
+{
+    public const COMPOSITE = 'COMPOSITE';
+    public const FULL_OBJECT = 'FULL_OBJECT';
+
+    public static function exists(string $value): bool
+    {
+        return isset([
+            self::COMPOSITE => true,
+            self::FULL_OBJECT => true,
+        ][$value]);
+    }
+}

src/Service/S3/src/Input/CompleteMultipartUploadRequest.php

@@ -6,6 +6,7 @@
 use AsyncAws\Core\Input;
 use AsyncAws\Core\Request;
 use AsyncAws\Core\Stream\StreamFactory;
+use AsyncAws\S3\Enum\ChecksumType;
 use AsyncAws\S3\Enum\RequestPayer;
 use AsyncAws\S3\ValueObject\CompletedMultipartUpload;
 
@@ -73,7 +74,7 @@ final class CompleteMultipartUploadRequest extends Input
 
     /**
      * This header can be used as a data integrity check to verify that the data received is the same data that was
-     * originally sent. This header specifies the base64-encoded, 32-bit CRC-32 checksum of the object. For more
+     * originally sent. This header specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object. For more
      * information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
@@ -84,7 +85,7 @@ final class CompleteMultipartUploadRequest extends Input
 
     /**
      * This header can be used as a data integrity check to verify that the data received is the same data that was
-     * originally sent. This header specifies the base64-encoded, 32-bit CRC-32C checksum of the object. For more
+     * originally sent. This header specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the object. For more
      * information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
@@ -95,8 +96,20 @@ final class CompleteMultipartUploadRequest extends Input
 
     /**
      * This header can be used as a data integrity check to verify that the data received is the same data that was
-     * originally sent. This header specifies the base64-encoded, 160-bit SHA-1 digest of the object. For more information,
-     * see Checking object integrity [^1] in the *Amazon S3 User Guide*.
+     * originally sent. This header specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. The
+     * `CRC-64NVME` checksum is always a full object checksum. For more information, see Checking object integrity in the
+     * Amazon S3 User Guide [^1].
+     *
+     * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
+     *
+     * @var string|null
+     */
+    private $checksumCrc64Nvme;
+
+    /**
+     * This header can be used as a data integrity check to verify that the data received is the same data that was
+     * originally sent. This header specifies the Base64 encoded, 160-bit `SHA-1` digest of the object. For more
+     * information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
      *
@@ -106,7 +119,7 @@ final class CompleteMultipartUploadRequest extends Input
 
     /**
      * This header can be used as a data integrity check to verify that the data received is the same data that was
-     * originally sent. This header specifies the base64-encoded, 256-bit SHA-256 digest of the object. For more
+     * originally sent. This header specifies the Base64 encoded, 256-bit `SHA-256` digest of the object. For more
      * information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
@@ -115,6 +128,25 @@ final class CompleteMultipartUploadRequest extends Input
      */
     private $checksumSha256;
 
+    /**
+     * This header specifies the checksum type of the object, which determines how part-level checksums are combined to
+     * create an object-level checksum for multipart objects. You can use this header as a data integrity check to verify
+     * that the checksum type that is received is the same checksum that was specified. If the checksum type doesn’t match
+     * the checksum type that was specified for the object during the `CreateMultipartUpload` request, it’ll result in a
+     * `BadDigest` error. For more information, see Checking object integrity in the Amazon S3 User Guide.
+     *
+     * @var ChecksumType::*|null
+     */
+    private $checksumType;
+
+    /**
+     * The expected total object size of the multipart upload request. If there’s a mismatch between the specified object
+     * size value and the actual object size value, it results in an `HTTP 400 InvalidRequest` error.
+     *
+     * @var int|null
+     */
+    private $mpuObjectSize;
+
     /**
      * @var RequestPayer::*|null
      */
@@ -214,8 +246,11 @@ final class CompleteMultipartUploadRequest extends Input
      *   UploadId?: string,
      *   ChecksumCRC32?: null|string,
      *   ChecksumCRC32C?: null|string,
+     *   ChecksumCRC64NVME?: null|string,
      *   ChecksumSHA1?: null|string,
      *   ChecksumSHA256?: null|string,
+     *   ChecksumType?: null|ChecksumType::*,
+     *   MpuObjectSize?: null|int,
      *   RequestPayer?: null|RequestPayer::*,
      *   ExpectedBucketOwner?: null|string,
      *   IfMatch?: null|string,
@@ -234,8 +269,11 @@ public function __construct(array $input = [])
         $this->uploadId = $input['UploadId'] ?? null;
         $this->checksumCrc32 = $input['ChecksumCRC32'] ?? null;
         $this->checksumCrc32C = $input['ChecksumCRC32C'] ?? null;
+        $this->checksumCrc64Nvme = $input['ChecksumCRC64NVME'] ?? null;
         $this->checksumSha1 = $input['ChecksumSHA1'] ?? null;
         $this->checksumSha256 = $input['ChecksumSHA256'] ?? null;
+        $this->checksumType = $input['ChecksumType'] ?? null;
+        $this->mpuObjectSize = $input['MpuObjectSize'] ?? null;
         $this->requestPayer = $input['RequestPayer'] ?? null;
         $this->expectedBucketOwner = $input['ExpectedBucketOwner'] ?? null;
         $this->ifMatch = $input['IfMatch'] ?? null;
@@ -254,8 +292,11 @@ public function __construct(array $input = [])
      *   UploadId?: string,
      *   ChecksumCRC32?: null|string,
      *   ChecksumCRC32C?: null|string,
+     *   ChecksumCRC64NVME?: null|string,
      *   ChecksumSHA1?: null|string,
      *   ChecksumSHA256?: null|string,
+     *   ChecksumType?: null|ChecksumType::*,
+     *   MpuObjectSize?: null|int,
      *   RequestPayer?: null|RequestPayer::*,
      *   ExpectedBucketOwner?: null|string,
      *   IfMatch?: null|string,
@@ -286,6 +327,11 @@ public function getChecksumCrc32C(): ?string
         return $this->checksumCrc32C;
     }
 
+    public function getChecksumCrc64Nvme(): ?string
+    {
+        return $this->checksumCrc64Nvme;
+    }
+
     public function getChecksumSha1(): ?string
     {
         return $this->checksumSha1;
@@ -296,6 +342,14 @@ public function getChecksumSha256(): ?string
         return $this->checksumSha256;
     }
 
+    /**
+     * @return ChecksumType::*|null
+     */
+    public function getChecksumType(): ?string
+    {
+        return $this->checksumType;
+    }
+
     public function getExpectedBucketOwner(): ?string
     {
         return $this->expectedBucketOwner;
@@ -316,6 +370,11 @@ public function getKey(): ?string
         return $this->key;
     }
 
+    public function getMpuObjectSize(): ?int
+    {
+        return $this->mpuObjectSize;
+    }
+
     public function getMultipartUpload(): ?CompletedMultipartUpload
     {
         return $this->multipartUpload;
@@ -362,12 +421,24 @@ public function request(): Request
         if (null !== $this->checksumCrc32C) {
             $headers['x-amz-checksum-crc32c'] = $this->checksumCrc32C;
         }
+        if (null !== $this->checksumCrc64Nvme) {
+            $headers['x-amz-checksum-crc64nvme'] = $this->checksumCrc64Nvme;
+        }
         if (null !== $this->checksumSha1) {
             $headers['x-amz-checksum-sha1'] = $this->checksumSha1;
         }
         if (null !== $this->checksumSha256) {
             $headers['x-amz-checksum-sha256'] = $this->checksumSha256;
         }
+        if (null !== $this->checksumType) {
+            if (!ChecksumType::exists($this->checksumType)) {
+                throw new InvalidArgument(\sprintf('Invalid parameter "ChecksumType" for "%s". The value "%s" is not a valid "ChecksumType".', __CLASS__, $this->checksumType));
+            }
+            $headers['x-amz-checksum-type'] = $this->checksumType;
+        }
+        if (null !== $this->mpuObjectSize) {
+            $headers['x-amz-mp-object-size'] = (string) $this->mpuObjectSize;
+        }
         if (null !== $this->requestPayer) {
             if (!RequestPayer::exists($this->requestPayer)) {
                 throw new InvalidArgument(\sprintf('Invalid parameter "RequestPayer" for "%s". The value "%s" is not a valid "RequestPayer".', __CLASS__, $this->requestPayer));
@@ -444,6 +515,13 @@ public function setChecksumCrc32C(?string $value): self
         return $this;
     }
 
+    public function setChecksumCrc64Nvme(?string $value): self
+    {
+        $this->checksumCrc64Nvme = $value;
+
+        return $this;
+    }
+
     public function setChecksumSha1(?string $value): self
     {
         $this->checksumSha1 = $value;
@@ -458,6 +536,16 @@ public function setChecksumSha256(?string $value): self
         return $this;
     }
 
+    /**
+     * @param ChecksumType::*|null $value
+     */
+    public function setChecksumType(?string $value): self
+    {
+        $this->checksumType = $value;
+
+        return $this;
+    }
+
     public function setExpectedBucketOwner(?string $value): self
     {
         $this->expectedBucketOwner = $value;
@@ -486,6 +574,13 @@ public function setKey(?string $value): self
         return $this;
     }
 
+    public function setMpuObjectSize(?int $value): self
+    {
+        $this->mpuObjectSize = $value;
+
+        return $this;
+    }
+
     public function setMultipartUpload(?CompletedMultipartUpload $value): self
     {
         $this->multipartUpload = $value;

src/Service/S3/src/Input/CreateMultipartUploadRequest.php

@@ -7,6 +7,7 @@
 use AsyncAws\Core\Request;
 use AsyncAws\Core\Stream\StreamFactory;
 use AsyncAws\S3\Enum\ChecksumAlgorithm;
+use AsyncAws\S3\Enum\ChecksumType;
 use AsyncAws\S3\Enum\ObjectCannedACL;
 use AsyncAws\S3\Enum\ObjectLockLegalHoldStatus;
 use AsyncAws\S3\Enum\ObjectLockMode;
@@ -435,7 +436,7 @@ final class CreateMultipartUploadRequest extends Input
 
     /**
      * Specifies the Amazon Web Services KMS Encryption Context to use for object encryption. The value of this header is a
-     * Base64-encoded string of a UTF-8 encoded JSON, which contains the encryption context as key-value pairs.
+     * Base64 encoded string of a UTF-8 encoded JSON, which contains the encryption context as key-value pairs.
      *
      * **Directory buckets** - You can optionally provide an explicit encryption context value. The value must match the
      * default encryption context - the bucket Amazon Resource Name (ARN). An additional encryption context value is not
@@ -527,6 +528,16 @@ final class CreateMultipartUploadRequest extends Input
      */
     private $checksumAlgorithm;
 
+    /**
+     * Indicates the checksum type that you want Amazon S3 to use to calculate the object’s checksum value. For more
+     * information, see Checking object integrity in the Amazon S3 User Guide [^1].
+     *
+     * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
+     *
+     * @var ChecksumType::*|null
+     */
+    private $checksumType;
+
     /**
      * @param array{
      *   ACL?: null|ObjectCannedACL::*,
@@ -559,6 +570,7 @@ final class CreateMultipartUploadRequest extends Input
      *   ObjectLockLegalHoldStatus?: null|ObjectLockLegalHoldStatus::*,
      *   ExpectedBucketOwner?: null|string,
      *   ChecksumAlgorithm?: null|ChecksumAlgorithm::*,
+     *   ChecksumType?: null|ChecksumType::*,
      *   '@region'?: string|null,
      * } $input
      */
@@ -594,6 +606,7 @@ public function __construct(array $input = [])
         $this->objectLockLegalHoldStatus = $input['ObjectLockLegalHoldStatus'] ?? null;
         $this->expectedBucketOwner = $input['ExpectedBucketOwner'] ?? null;
         $this->checksumAlgorithm = $input['ChecksumAlgorithm'] ?? null;
+        $this->checksumType = $input['ChecksumType'] ?? null;
         parent::__construct($input);
     }
 
@@ -629,6 +642,7 @@ public function __construct(array $input = [])
      *   ObjectLockLegalHoldStatus?: null|ObjectLockLegalHoldStatus::*,
      *   ExpectedBucketOwner?: null|string,
      *   ChecksumAlgorithm?: null|ChecksumAlgorithm::*,
+     *   ChecksumType?: null|ChecksumType::*,
      *   '@region'?: string|null,
      * }|CreateMultipartUploadRequest $input
      */
@@ -668,6 +682,14 @@ public function getChecksumAlgorithm(): ?string
         return $this->checksumAlgorithm;
     }
 
+    /**
+     * @return ChecksumType::*|null
+     */
+    public function getChecksumType(): ?string
+    {
+        return $this->checksumType;
+    }
+
     public function getContentDisposition(): ?string
     {
         return $this->contentDisposition;
@@ -920,6 +942,12 @@ public function request(): Request
             }
             $headers['x-amz-checksum-algorithm'] = $this->checksumAlgorithm;
         }
+        if (null !== $this->checksumType) {
+            if (!ChecksumType::exists($this->checksumType)) {
+                throw new InvalidArgument(\sprintf('Invalid parameter "ChecksumType" for "%s". The value "%s" is not a valid "ChecksumType".', __CLASS__, $this->checksumType));
+            }
+            $headers['x-amz-checksum-type'] = $this->checksumType;
+        }
         if (null !== $this->metadata) {
             foreach ($this->metadata as $key => $value) {
                 $headers["x-amz-meta-$key"] = $value;
@@ -989,6 +1017,16 @@ public function setChecksumAlgorithm(?string $value): self
         return $this;
     }
 
+    /**
+     * @param ChecksumType::*|null $value
+     */
+    public function setChecksumType(?string $value): self
+    {
+        $this->checksumType = $value;
+
+        return $this;
+    }
+
     public function setContentDisposition(?string $value): self
     {
         $this->contentDisposition = $value;