Update generated code (#1869)

update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.342.16"
+        "${LATEST}": "3.342.17"
     },
     "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
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 2.8.0
 
 ### Added

src/Service/S3/src/Input/AbortMultipartUploadRequest.php

@@ -20,14 +20,15 @@ final class AbortMultipartUploadRequest extends Input
      * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket
      * naming rules [^1] in the *Amazon S3 User Guide*.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts
      * hostname. The S3 on Outposts hostname takes the form

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

@@ -22,14 +22,15 @@ final class CompleteMultipartUploadRequest extends Input
      * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket
      * naming rules [^1] in the *Amazon S3 User Guide*.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts
      * hostname. The S3 on Outposts hostname takes the form

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

@@ -58,14 +58,15 @@ final class CopyObjectRequest extends Input
      * > is in Amazon Web Services Local Zones. The source and destination buckets must have the same parent Amazon Web
      * > Services Region. Otherwise, you get an HTTP `400 Bad Request` error with the error code `InvalidRequest`.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must use the Outpost bucket access point ARN
      * or the access point alias for the destination bucket. You can only copy objects within the same Outpost bucket. It's
@@ -433,9 +434,10 @@ final class CopyObjectRequest extends Input
      * default. The `STANDARD` storage class provides high durability and high availability. Depending on performance needs,
      * you can specify a different Storage Class.
      *
-     * > - **Directory buckets ** - For directory buckets, only the S3 Express One Zone storage class is supported to store
-     * >   newly created objects. Unsupported storage class values won't write a destination object and will respond with
-     * >   the HTTP status code `400 Bad Request`.
+     * > - **Directory buckets ** - Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone storage class)
+     * >   in Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent Access storage class) in Dedicated Local
+     * >   Zones. Unsupported storage class values won't write a destination object and will respond with the HTTP status
+     * >   code `400 Bad Request`.
      * > - **Amazon S3 on Outposts ** - S3 on Outposts only uses the `OUTPOSTS` Storage Class.
      * >
      *

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

@@ -49,14 +49,15 @@ final class CreateMultipartUploadRequest extends Input
      * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket
      * naming rules [^1] in the *Amazon S3 User Guide*.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts
      * hostname. The S3 on Outposts hostname takes the form
@@ -358,7 +359,8 @@ final class CreateMultipartUploadRequest extends Input
      * provides high durability and high availability. Depending on performance needs, you can specify a different Storage
      * Class. For more information, see Storage Classes [^1] in the *Amazon S3 User Guide*.
      *
-     * > - For directory buckets, only the S3 Express One Zone storage class is supported to store newly created objects.
+     * > - Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in Availability Zones
+     * >   and `ONEZONE_IA` (the S3 One Zone-Infrequent Access storage class) in Dedicated Local Zones.
      * > - Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
      * >
      *

src/Service/S3/src/Input/DeleteObjectRequest.php

@@ -20,14 +20,15 @@ final class DeleteObjectRequest extends Input
      * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket
      * naming rules [^1] in the *Amazon S3 User Guide*.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts
      * hostname. The S3 on Outposts hostname takes the form

src/Service/S3/src/Input/DeleteObjectTaggingRequest.php

@@ -12,9 +12,10 @@ final class DeleteObjectTaggingRequest extends Input
     /**
      * The bucket name containing the objects from which to remove the tags.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*.

src/Service/S3/src/Input/DeleteObjectsRequest.php

@@ -22,14 +22,15 @@ final class DeleteObjectsRequest extends Input
      * `*amzn-s3-demo-bucket*--*usw2-az1*--x-s3`). For information about bucket naming restrictions, see Directory bucket
      * naming rules [^1] in the *Amazon S3 User Guide*.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^2] in the *Amazon S3 User Guide*.
      *
-     * > Access points and Object Lambda access points are not supported by directory buckets.
+     * > Object Lambda access points are not supported by directory buckets.
      *
      * **S3 on Outposts** - When you use this action with S3 on Outposts, you must direct requests to the S3 on Outposts
      * hostname. The S3 on Outposts hostname takes the form

src/Service/S3/src/Input/GetObjectAclRequest.php

@@ -13,9 +13,10 @@ final class GetObjectAclRequest extends Input
     /**
      * The bucket name that contains the object for which to get the ACL information.
      *
-     * **Access points** - When you use this action with an access point, you must provide the alias of the access point in
-     * place of the bucket name or specify the access point ARN. When using the access point ARN, you must direct requests
-     * to the access point hostname. The access point hostname takes the form
+     * **Access points** - When you use this action with an access point for general purpose buckets, you must provide the
+     * alias of the access point in place of the bucket name or specify the access point ARN. When you use this action with
+     * an access point for directory buckets, you must provide the access point name in place of the bucket name. When using
+     * the access point ARN, you must direct requests to the access point hostname. The access point hostname takes the form
      * *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com. When using this action with an access point
      * through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more
      * information about access point ARNs, see Using access points [^1] in the *Amazon S3 User Guide*.