Update generated code (#1386)

update generated code

Author: async-aws-bot

manifest.json

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

src/Service/S3/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Added
 
 - AWS api-change: Added `ap-southeast-4` region.
+- AWS enhancement: Documentation updates.
 
 ## 1.13.0
 

src/Service/S3/src/Enum/ServerSideEncryption.php

@@ -3,9 +3,7 @@
 namespace AsyncAws\S3\Enum;
 
 /**
- * If you specified server-side encryption either with an Amazon S3-managed encryption key or an Amazon Web Services KMS
- * key in your initiate multipart upload request, the response includes this header. It confirms the encryption
- * algorithm that Amazon S3 used to encrypt the object.
+ * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
  */
 final class ServerSideEncryption
 {

src/Service/S3/src/Input/CopyObjectRequest.php

@@ -187,7 +187,7 @@ final class CopyObjectRequest extends Input
     private $taggingDirective;
 
     /**
-     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, aws:kms).
+     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
      *
      * @var ServerSideEncryption::*|null
      */
@@ -207,7 +207,9 @@ final class CopyObjectRequest extends Input
 
     /**
      * If the bucket is configured as a website, redirects requests for this object to another object in the same bucket or
-     * to an external URL. Amazon S3 stores the value of this header in the object metadata.
+     * to an external URL. Amazon S3 stores the value of this header in the object metadata. This value is unique to each
+     * object and is not copied when using the `x-amz-metadata-directive` header. Instead, you may opt to provide this
+     * header in combination with the directive.
      *
      * @var string|null
      */

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

@@ -120,7 +120,7 @@ final class CreateMultipartUploadRequest extends Input
     private $metadata;
 
     /**
-     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, aws:kms).
+     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
      *
      * @var ServerSideEncryption::*|null
      */
@@ -171,10 +171,10 @@ final class CreateMultipartUploadRequest extends Input
     private $sseCustomerKeyMd5;
 
     /**
-     * Specifies the ID of the symmetric customer managed key to use for object encryption. All GET and PUT requests for an
-     * object protected by Amazon Web Services KMS will fail if not made via SSL or using SigV4. For information about
-     * configuring using any of the officially supported Amazon Web Services SDKs and Amazon Web Services CLI, see
-     * Specifying the Signature Version in Request Authentication in the *Amazon S3 User Guide*.
+     * Specifies the ID of the symmetric encryption customer managed key to use for object encryption. All GET and PUT
+     * requests for an object protected by Amazon Web Services KMS will fail if not made via SSL or using SigV4. For
+     * information about configuring using any of the officially supported Amazon Web Services SDKs and Amazon Web Services
+     * CLI, see Specifying the Signature Version in Request Authentication in the *Amazon S3 User Guide*.
      *
      * @see https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
      *

src/Service/S3/src/Input/GetObjectRequest.php

@@ -63,9 +63,9 @@ final class GetObjectRequest extends Input
 
     /**
      * Downloads the specified range bytes of an object. For more information about the HTTP Range header, see
-     * https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.
+     * https://www.rfc-editor.org/rfc/rfc9110.html#name-range.
      *
-     * @see https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
+     * @see https://www.rfc-editor.org/rfc/rfc9110.html#name-range
      *
      * @var string|null
      */

src/Service/S3/src/Input/HeadObjectRequest.php

@@ -62,7 +62,8 @@ final class HeadObjectRequest extends Input
     private $key;
 
     /**
-     * Because `HeadObject` returns only the metadata for an object, this parameter has no effect.
+     * HeadObject returns only the metadata for an object. If the Range is satisfiable, only the `ContentLength` is affected
+     * in the response. If the Range is not satisfiable, S3 returns a `416 - Requested Range Not Satisfiable` error.
      *
      * @var string|null
      */

src/Service/S3/src/Input/PutObjectRequest.php

@@ -53,9 +53,9 @@ final class PutObjectRequest extends Input
 
     /**
      * Specifies presentational information for the object. For more information, see
-     * http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1.
+     * https://www.rfc-editor.org/rfc/rfc6266#section-4.
      *
-     * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
+     * @see https://www.rfc-editor.org/rfc/rfc6266#section-4
      *
      * @var string|null
      */
@@ -64,9 +64,9 @@ final class PutObjectRequest extends Input
     /**
      * Specifies what content encodings have been applied to the object and thus what decoding mechanisms must be applied to
      * obtain the media-type referenced by the Content-Type header field. For more information, see
-     * http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11.
+     * https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding.
      *
-     * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
+     * @see https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
      *
      * @var string|null
      */
@@ -81,9 +81,9 @@ final class PutObjectRequest extends Input
 
     /**
      * Size of the body in bytes. This parameter is useful when the size of the body cannot be determined automatically. For
-     * more information, see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13.
+     * more information, see https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length.
      *
-     * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
+     * @see https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
      *
      * @var string|null
      */
@@ -103,9 +103,9 @@ final class PutObjectRequest extends Input
 
     /**
      * A standard MIME type describing the format of the contents. For more information, see
-     * http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17.
+     * https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type.
      *
-     * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
+     * @see https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
      *
      * @var string|null
      */
@@ -169,9 +169,9 @@ final class PutObjectRequest extends Input
 
     /**
      * The date and time at which the object is no longer cacheable. For more information, see
-     * http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21.
+     * https://www.rfc-editor.org/rfc/rfc7234#section-5.3.
      *
-     * @see http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
+     * @see https://www.rfc-editor.org/rfc/rfc7234#section-5.3
      *
      * @var \DateTimeImmutable|null
      */
@@ -222,7 +222,7 @@ final class PutObjectRequest extends Input
     private $metadata;
 
     /**
-     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, aws:kms).
+     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
      *
      * @var ServerSideEncryption::*|null
      */
@@ -276,9 +276,9 @@ final class PutObjectRequest extends Input
     private $sseCustomerKeyMd5;
 
     /**
-     * If `x-amz-server-side-encryption` is present and has the value of `aws:kms`, this header specifies the ID of the
-     * Amazon Web Services Key Management Service (Amazon Web Services KMS) symmetrical customer managed key that was used
-     * for the object. If you specify `x-amz-server-side-encryption:aws:kms`, but do not provide`
+     * If `x-amz-server-side-encryption` has a valid value of `aws:kms`, this header specifies the ID of the Amazon Web
+     * Services Key Management Service (Amazon Web Services KMS) symmetric encryption customer managed key that was used for
+     * the object. If you specify `x-amz-server-side-encryption:aws:kms`, but do not provide`
      * x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the Amazon Web Services managed key to protect the data.
      * If the KMS key does not exist in the same account issuing the command, you must use the full ARN and not just the ID.
      *
@@ -288,7 +288,9 @@ final class PutObjectRequest extends Input
 
     /**
      * Specifies the Amazon Web Services KMS Encryption Context to use for object encryption. The value of this header is a
-     * base64-encoded UTF-8 string holding JSON with the encryption context key-value pairs.
+     * base64-encoded UTF-8 string holding JSON with the encryption context key-value pairs. This value is stored as object
+     * metadata and automatically gets passed on to Amazon Web Services KMS for future `GetObject` or `CopyObject`
+     * operations on this object.
      *
      * @var string|null
      */

src/Service/S3/src/Result/CompleteMultipartUploadOutput.php

@@ -79,9 +79,7 @@ class CompleteMultipartUploadOutput extends Result
     private $checksumSha256;
 
     /**
-     * If you specified server-side encryption either with an Amazon S3-managed encryption key or an Amazon Web Services KMS
-     * key in your initiate multipart upload request, the response includes this header. It confirms the encryption
-     * algorithm that Amazon S3 used to encrypt the object.
+     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
      */
     private $serverSideEncryption;
 
@@ -92,7 +90,7 @@ class CompleteMultipartUploadOutput extends Result
 
     /**
      * If present, specifies the ID of the Amazon Web Services Key Management Service (Amazon Web Services KMS) symmetric
-     * customer managed key that was used for the object.
+     * encryption customer managed key that was used for the object.
      */
     private $sseKmsKeyId;
 

src/Service/S3/src/Result/CopyObjectOutput.php

@@ -31,7 +31,7 @@ class CopyObjectOutput extends Result
     private $versionId;
 
     /**
-     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, aws:kms).
+     * The server-side encryption algorithm used when storing this object in Amazon S3 (for example, AES256, `aws:kms`).
      */
     private $serverSideEncryption;
 
@@ -49,7 +49,7 @@ class CopyObjectOutput extends Result
 
     /**
      * If present, specifies the ID of the Amazon Web Services Key Management Service (Amazon Web Services KMS) symmetric
-     * customer managed key that was used for the object.
+     * encryption customer managed key that was used for the object.
      */
     private $sseKmsKeyId;