Update generated code (#1979)

update generated code

Author: async-aws-bot

CHANGELOG.md

@@ -10,6 +10,7 @@
 
 - AWS api-change: Added `us-isob-west-1` region
 - Added `S3Client::putPublicAccessBlock()` method
+- AWS api-change: Amazon Simple Storage Service / Features: Add conditional writes in CopyObject on destination key to prevent unintended object modifications.
 
 ### Dependency bumped
 

src/Input/CopyObjectRequest.php

@@ -304,6 +304,37 @@ final class CopyObjectRequest extends Input
      */
     private $grantWriteAcp;
 
+    /**
+     * Copies the object if the entity tag (ETag) of the destination object matches the specified tag. If the ETag values do
+     * not match, the operation returns a `412 Precondition Failed` error. If a concurrent operation occurs during the
+     * upload S3 returns a `409 ConditionalRequestConflict` response. On a 409 failure you should fetch the object's ETag
+     * and retry the upload.
+     *
+     * Expects the ETag value as a string.
+     *
+     * For more information about conditional requests, see RFC 7232 [^1].
+     *
+     * [^1]: https://tools.ietf.org/html/rfc7232
+     *
+     * @var string|null
+     */
+    private $ifMatch;
+
+    /**
+     * Copies the object only if the object key name at the destination does not already exist in the bucket specified.
+     * Otherwise, Amazon S3 returns a `412 Precondition Failed` error. If a concurrent operation occurs during the upload S3
+     * returns a `409 ConditionalRequestConflict` response. On a 409 failure you should retry the upload.
+     *
+     * Expects the '*' (asterisk) character.
+     *
+     * For more information about conditional requests, see RFC 7232 [^1].
+     *
+     * [^1]: https://tools.ietf.org/html/rfc7232
+     *
+     * @var string|null
+     */
+    private $ifNoneMatch;
+
     /**
      * The key of the destination object.
      *
@@ -718,6 +749,8 @@ final class CopyObjectRequest extends Input
      *   GrantRead?: string|null,
      *   GrantReadACP?: string|null,
      *   GrantWriteACP?: string|null,
+     *   IfMatch?: string|null,
+     *   IfNoneMatch?: string|null,
      *   Key?: string,
      *   Metadata?: array<string, string>|null,
      *   MetadataDirective?: MetadataDirective::*|null,
@@ -764,6 +797,8 @@ public function __construct(array $input = [])
         $this->grantRead = $input['GrantRead'] ?? null;
         $this->grantReadAcp = $input['GrantReadACP'] ?? null;
         $this->grantWriteAcp = $input['GrantWriteACP'] ?? null;
+        $this->ifMatch = $input['IfMatch'] ?? null;
+        $this->ifNoneMatch = $input['IfNoneMatch'] ?? null;
         $this->key = $input['Key'] ?? null;
         $this->metadata = $input['Metadata'] ?? null;
         $this->metadataDirective = $input['MetadataDirective'] ?? null;
@@ -810,6 +845,8 @@ public function __construct(array $input = [])
      *   GrantRead?: string|null,
      *   GrantReadACP?: string|null,
      *   GrantWriteACP?: string|null,
+     *   IfMatch?: string|null,
+     *   IfNoneMatch?: string|null,
      *   Key?: string,
      *   Metadata?: array<string, string>|null,
      *   MetadataDirective?: MetadataDirective::*|null,
@@ -967,6 +1004,16 @@ public function getGrantWriteAcp(): ?string
         return $this->grantWriteAcp;
     }
 
+    public function getIfMatch(): ?string
+    {
+        return $this->ifMatch;
+    }
+
+    public function getIfNoneMatch(): ?string
+    {
+        return $this->ifNoneMatch;
+    }
+
     public function getKey(): ?string
     {
         return $this->key;
@@ -1141,6 +1188,12 @@ public function request(): Request
         if (null !== $this->grantWriteAcp) {
             $headers['x-amz-grant-write-acp'] = $this->grantWriteAcp;
         }
+        if (null !== $this->ifMatch) {
+            $headers['If-Match'] = $this->ifMatch;
+        }
+        if (null !== $this->ifNoneMatch) {
+            $headers['If-None-Match'] = $this->ifNoneMatch;
+        }
         if (null !== $this->metadataDirective) {
             if (!MetadataDirective::exists($this->metadataDirective)) {
                 throw new InvalidArgument(\sprintf('Invalid parameter "MetadataDirective" for "%s". The value "%s" is not a valid "MetadataDirective".', __CLASS__, $this->metadataDirective));
@@ -1427,6 +1480,20 @@ public function setGrantWriteAcp(?string $value): self
         return $this;
     }
 
+    public function setIfMatch(?string $value): self
+    {
+        $this->ifMatch = $value;
+
+        return $this;
+    }
+
+    public function setIfNoneMatch(?string $value): self
+    {
+        $this->ifNoneMatch = $value;
+
+        return $this;
+    }
+
     public function setKey(?string $value): self
     {
         $this->key = $value;

src/Input/DeleteObjectRequest.php

@@ -99,13 +99,13 @@ final class DeleteObjectRequest extends Input
     private $expectedBucketOwner;
 
     /**
-     * The `If-Match` header field makes the request method conditional on ETags. If the ETag value does not match, the
-     * operation returns a `412 Precondition Failed` error. If the ETag matches or if the object doesn't exist, the
-     * operation will return a `204 Success (No Content) response`.
+     * Deletes the object if the ETag (entity tag) value provided during the delete operation matches the ETag of the object
+     * in S3. If the ETag values do not match, the operation returns a `412 Precondition Failed` error.
      *
-     * For more information about conditional requests, see RFC 7232 [^1].
+     * Expects the ETag value as a string. `If-Match` does accept a string value of an '*' (asterisk) character to denote a
+     * match of any ETag.
      *
-     * > This functionality is only supported for directory buckets.
+     * For more information about conditional requests, see RFC 7232 [^1].
      *
      * [^1]: https://tools.ietf.org/html/rfc7232
      *

src/Input/PutObjectTaggingRequest.php

@@ -97,6 +97,9 @@ final class PutObjectTaggingRequest extends Input
     private $expectedBucketOwner;
 
     /**
+     * Confirms that the requester knows that she or he will be charged for the tagging object request. Bucket owners need
+     * not specify this parameter in their requests.
+     *
      * @var RequestPayer::*|null
      */
     private $requestPayer;

src/Result/CompleteMultipartUploadOutput.php

@@ -58,11 +58,11 @@ class CompleteMultipartUploadOutput extends Result
     private $etag;
 
     /**
-     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only be present if the checksum was
-     * uploaded with the object. When you use an API operation on an object that was uploaded using multipart uploads, this
-     * value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values
-     * of each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
-     * object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
+     * integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -96,11 +96,11 @@ class CompleteMultipartUploadOutput extends Result
     private $checksumCrc64Nvme;
 
     /**
-     * The Base64 encoded, 160-bit `SHA1` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
-     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
-     * integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 160-bit `SHA1` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value
+     * may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of
+     * each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
+     * object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -109,9 +109,9 @@ class CompleteMultipartUploadOutput extends Result
     private $checksumSha1;
 
     /**
-     * The Base64 encoded, 256-bit `SHA256` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * The Base64 encoded, 256-bit `SHA256` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
      * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
      * integrity [^1] in the *Amazon S3 User Guide*.
      *

src/Result/GetObjectOutput.php

@@ -105,8 +105,8 @@ class GetObjectOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The Base64 encoded, 32-bit `CRC32C` checksum of the object. This will only be present if the object was uploaded with
-     * the object. For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 32-bit `CRC32C` checksum of the object. This checksum is only present if the checksum was
+     * uploaded with 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
      *
@@ -125,8 +125,8 @@ class GetObjectOutput extends Result
     private $checksumCrc64Nvme;
 
     /**
-     * The Base64 encoded, 160-bit `SHA1` digest of the object. This will only be present if the object was uploaded with
-     * the object. For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 160-bit `SHA1` digest of the object. This checksum is only present if the checksum was uploaded
+     * with 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
      *
@@ -135,8 +135,8 @@ class GetObjectOutput extends Result
     private $checksumSha1;
 
     /**
-     * The Base64 encoded, 256-bit `SHA256` digest of the object. This will only be present if the object was uploaded with
-     * the object. For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 256-bit `SHA256` digest of the object. This checksum is only present if the checksum was uploaded
+     * with 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
      *

src/Result/HeadObjectOutput.php

@@ -94,11 +94,11 @@ class HeadObjectOutput extends Result
     private $contentLength;
 
     /**
-     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only be present if the checksum was
-     * uploaded with the object. When you use an API operation on an object that was uploaded using multipart uploads, this
-     * value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values
-     * of each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
-     * object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
+     * integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -130,11 +130,11 @@ class HeadObjectOutput extends Result
     private $checksumCrc64Nvme;
 
     /**
-     * The Base64 encoded, 160-bit `SHA1` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
-     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
-     * integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 160-bit `SHA1` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value
+     * may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of
+     * each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
+     * object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -143,9 +143,9 @@ class HeadObjectOutput extends Result
     private $checksumSha1;
 
     /**
-     * The Base64 encoded, 256-bit `SHA256` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * The Base64 encoded, 256-bit `SHA256` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
      * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
      * integrity [^1] in the *Amazon S3 User Guide*.
      *

src/Result/PutObjectOutput.php

@@ -38,11 +38,11 @@ class PutObjectOutput extends Result
     private $etag;
 
     /**
-     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only be present if the checksum was
-     * uploaded with the object. When you use an API operation on an object that was uploaded using multipart uploads, this
-     * value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values
-     * of each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
-     * object integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 32-bit `CRC32 checksum` of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
+     * integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -76,11 +76,11 @@ class PutObjectOutput extends Result
     private $checksumCrc64Nvme;
 
     /**
-     * The Base64 encoded, 160-bit `SHA1` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
-     * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
-     * integrity [^1] in the *Amazon S3 User Guide*.
+     * The Base64 encoded, 160-bit `SHA1` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value
+     * may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of
+     * each individual part. For more information about how checksums are calculated with multipart uploads, see Checking
+     * object integrity [^1] in the *Amazon S3 User Guide*.
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums
      *
@@ -89,9 +89,9 @@ class PutObjectOutput extends Result
     private $checksumSha1;
 
     /**
-     * The Base64 encoded, 256-bit `SHA256` digest of the object. This will only be present if the object was uploaded with
-     * the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not
-     * be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
+     * The Base64 encoded, 256-bit `SHA256` digest of the object. This checksum is only present if the checksum was uploaded
+     * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may
+     * not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each
      * individual part. For more information about how checksums are calculated with multipart uploads, see Checking object
      * integrity [^1] in the *Amazon S3 User Guide*.
      *