Update generated code (#1774)

update generated code

Author: async-aws-bot

src/Input/CompleteMultipartUploadRequest.php

@@ -72,8 +72,8 @@ 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 CRC32 checksum 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, 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
      *
@@ -83,7 +83,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 CRC32C 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

src/Input/DeleteObjectsRequest.php

@@ -106,10 +106,10 @@ final class DeleteObjectsRequest extends Input
      * For the `x-amz-checksum-*algorithm*` header, replace `*algorithm*` with the supported algorithm from the following
      * list:
      *
-     * - CRC32
-     * - CRC32C
-     * - SHA1
-     * - SHA256
+     * - `CRC32`
+     * - `CRC32C`
+     * - `SHA1`
+     * - `SHA256`
      *
      * For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *

src/Input/PutObjectRequest.php

@@ -172,10 +172,10 @@ final class PutObjectRequest extends Input
      * For the `x-amz-checksum-*algorithm*` header, replace `*algorithm*` with the supported algorithm from the following
      * list:
      *
-     * - CRC32
-     * - CRC32C
-     * - SHA1
-     * - SHA256
+     * - `CRC32`
+     * - `CRC32C`
+     * - `SHA1`
+     * - `SHA256`
      *
      * For more information, see Checking object integrity [^1] in the *Amazon S3 User Guide*.
      *
@@ -194,8 +194,8 @@ final class PutObjectRequest 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 CRC32 checksum 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, 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
      *
@@ -205,7 +205,7 @@ final class PutObjectRequest 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 CRC32C 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

src/Input/UploadPartRequest.php

@@ -88,8 +88,8 @@ final class UploadPartRequest 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 CRC32 checksum 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, 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
      *
@@ -99,7 +99,7 @@ final class UploadPartRequest 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 CRC32C 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

src/Result/CompleteMultipartUploadOutput.php

@@ -57,7 +57,7 @@ class CompleteMultipartUploadOutput extends Result
     private $etag;
 
     /**
-     * The base64-encoded, 32-bit CRC32 checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32 checksum of the object. This will only be present if it 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
@@ -70,7 +70,7 @@ class CompleteMultipartUploadOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The base64-encoded, 32-bit CRC32C checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32C checksum of the object. This will only be present if it 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

src/Result/GetObjectOutput.php

@@ -92,7 +92,7 @@ class GetObjectOutput extends Result
     private $etag;
 
     /**
-     * The base64-encoded, 32-bit CRC32 checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32 checksum of the object. This will only be present if it 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
@@ -102,7 +102,7 @@ class GetObjectOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The base64-encoded, 32-bit CRC32C checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32C checksum of the object. This will only be present if it 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

@@ -91,7 +91,7 @@ class HeadObjectOutput extends Result
     private $contentLength;
 
     /**
-     * The base64-encoded, 32-bit CRC32 checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32 checksum of the object. This will only be present if it 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
@@ -104,7 +104,7 @@ class HeadObjectOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The base64-encoded, 32-bit CRC32C checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32C checksum of the object. This will only be present if it 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

src/Result/PutObjectOutput.php

@@ -36,7 +36,7 @@ class PutObjectOutput extends Result
     private $etag;
 
     /**
-     * The base64-encoded, 32-bit CRC32 checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32 checksum of the object. This will only be present if it 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
@@ -49,7 +49,7 @@ class PutObjectOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The base64-encoded, 32-bit CRC32C checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32C checksum of the object. This will only be present if it 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

src/Result/UploadPartOutput.php

@@ -24,7 +24,7 @@ class UploadPartOutput extends Result
     private $etag;
 
     /**
-     * The base64-encoded, 32-bit CRC32 checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32 checksum of the object. This will only be present if it 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
@@ -37,7 +37,7 @@ class UploadPartOutput extends Result
     private $checksumCrc32;
 
     /**
-     * The base64-encoded, 32-bit CRC32C checksum of the object. This will only be present if it was uploaded with the
+     * The base64-encoded, 32-bit CRC-32C checksum of the object. This will only be present if it 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

src/S3Client.php

@@ -1601,7 +1601,9 @@ public function getObjectTagging($input): GetObjectTaggingOutput
      *
      *   - **General purpose bucket permissions** - To use `HEAD`, you must have the `s3:GetObject` permission. You need the
      *     relevant read object (or version) permission for this operation. For more information, see Actions, resources,
-     *     and condition keys for Amazon S3 [^2] in the *Amazon S3 User Guide*.
+     *     and condition keys for Amazon S3 [^2] in the *Amazon S3 User Guide*. For more information about the permissions
+     *     to S3 API operations by S3 resource types, see Required permissions for Amazon S3 API operations [^3] in the
+     *     *Amazon S3 User Guide*.
      *
      *     If the object you request doesn't exist, the error that Amazon S3 returns depends on whether you also have the
      *     `s3:ListBucket` permission.
@@ -1612,13 +1614,13 @@ public function getObjectTagging($input): GetObjectTaggingOutput
      *       error.
      *
      *   - **Directory bucket permissions** - To grant access to this API operation on a directory bucket, we recommend that
-     *     you use the `CreateSession` [^3] API operation for session-based authorization. Specifically, you grant the
+     *     you use the `CreateSession` [^4] API operation for session-based authorization. Specifically, you grant the
      *     `s3express:CreateSession` permission to the directory bucket in a bucket policy or an IAM identity-based policy.
      *     Then, you make the `CreateSession` API call on the bucket to obtain a session token. With the session token in
      *     your request header, you can make API requests to this operation. After the session token expires, you make
      *     another `CreateSession` API call to generate a new session token for use. Amazon Web Services CLI or SDKs create
      *     session and refresh the session token automatically to avoid service interruptions when a session expires. For
-     *     more information about authorization, see `CreateSession` [^4].
+     *     more information about authorization, see `CreateSession` [^5].
      *
      *     If you enable `x-amz-checksum-mode` in the request and the object is encrypted with Amazon Web Services Key
      *     Management Service (Amazon Web Services KMS), you must also have the `kms:GenerateDataKey` and `kms:Decrypt`
@@ -1643,12 +1645,12 @@ public function getObjectTagging($input): GetObjectTaggingOutput
      *   - `x-amz-server-side-encryption-customer-key`
      *   - `x-amz-server-side-encryption-customer-key-MD5`
      *
-     *   For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided Encryption Keys) [^5] in the
+     *   For more information about SSE-C, see Server-Side Encryption (Using Customer-Provided Encryption Keys) [^6] in the
      *   *Amazon S3 User Guide*.
      *
      *   > **Directory bucket ** - For directory buckets, there are only two supported options for server-side encryption:
      *   > SSE-S3 and SSE-KMS. SSE-C isn't supported. For more information, see Protecting data with server-side encryption
-     *   > [^6] in the *Amazon S3 User Guide*.
+     *   > [^7] in the *Amazon S3 User Guide*.
      *
      * - `Versioning`:
      *
@@ -1670,23 +1672,24 @@ public function getObjectTagging($input): GetObjectTaggingOutput
      *   > For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints
      *   > support virtual-hosted-style requests in the format
      *   > `https://*bucket_name*.s3express-*az_id*.*region*.amazonaws.com/*key-name*`. Path-style requests are not
-     *   > supported. For more information, see Regional and Zonal endpoints [^7] in the *Amazon S3 User Guide*.
+     *   > supported. For more information, see Regional and Zonal endpoints [^8] in the *Amazon S3 User Guide*.
      *
      *
      * The following actions are related to `HeadObject`:
      *
-     * - GetObject [^8]
-     * - GetObjectAttributes [^9]
+     * - GetObject [^9]
+     * - GetObjectAttributes [^10]
      *
      * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTCommonRequestHeaders.html
      * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/list_amazons3.html
-     * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+     * [^3]: /AmazonS3/latest/userguide/using-with-s3-policy-actions.html
      * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
-     * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
-     * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
-     * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
-     * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
-     * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
+     * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html
+     * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
+     * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
+     * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html
+     * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
+     * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html
      *
      * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectHEAD.html
      * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadObject.html