diff --git a/manifest.json b/manifest.json index 274b82c01..9175114a9 100644 --- a/manifest.json +++ b/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": { diff --git a/src/Service/S3/CHANGELOG.md b/src/Service/S3/CHANGELOG.md index 6ee0d971e..4ab9366af 100644 --- a/src/Service/S3/CHANGELOG.md +++ b/src/Service/S3/CHANGELOG.md @@ -2,6 +2,10 @@ ## NOT RELEASED +### Changed + +- AWS enhancement: Documentation updates. + ## 2.8.0 ### Added diff --git a/src/Service/S3/src/Input/AbortMultipartUploadRequest.php b/src/Service/S3/src/Input/AbortMultipartUploadRequest.php index 840778863..18959923d 100644 --- a/src/Service/S3/src/Input/AbortMultipartUploadRequest.php +++ b/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 diff --git a/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php b/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php index 6debc5666..4aae3c6d8 100644 --- a/src/Service/S3/src/Input/CompleteMultipartUploadRequest.php +++ b/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 diff --git a/src/Service/S3/src/Input/CopyObjectRequest.php b/src/Service/S3/src/Input/CopyObjectRequest.php index f18531d08..dcc7a4a3c 100644 --- a/src/Service/S3/src/Input/CopyObjectRequest.php +++ b/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. * > * diff --git a/src/Service/S3/src/Input/CreateMultipartUploadRequest.php b/src/Service/S3/src/Input/CreateMultipartUploadRequest.php index ecc91e172..c2e67ab56 100644 --- a/src/Service/S3/src/Input/CreateMultipartUploadRequest.php +++ b/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. * > * diff --git a/src/Service/S3/src/Input/DeleteObjectRequest.php b/src/Service/S3/src/Input/DeleteObjectRequest.php index c0e3c689c..fde854506 100644 --- a/src/Service/S3/src/Input/DeleteObjectRequest.php +++ b/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 diff --git a/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php b/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php index 09d409d6b..f00e3d674 100644 --- a/src/Service/S3/src/Input/DeleteObjectTaggingRequest.php +++ b/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*. diff --git a/src/Service/S3/src/Input/DeleteObjectsRequest.php b/src/Service/S3/src/Input/DeleteObjectsRequest.php index c95bb1fb3..70d175f81 100644 --- a/src/Service/S3/src/Input/DeleteObjectsRequest.php +++ b/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 diff --git a/src/Service/S3/src/Input/GetObjectAclRequest.php b/src/Service/S3/src/Input/GetObjectAclRequest.php index e3c5906bb..c207c51b9 100644 --- a/src/Service/S3/src/Input/GetObjectAclRequest.php +++ b/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*. diff --git a/src/Service/S3/src/Input/GetObjectRequest.php b/src/Service/S3/src/Input/GetObjectRequest.php index 3f3c47505..45ff5f93c 100644 --- a/src/Service/S3/src/Input/GetObjectRequest.php +++ b/src/Service/S3/src/Input/GetObjectRequest.php @@ -21,9 +21,10 @@ final class GetObjectRequest 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*. @@ -32,7 +33,7 @@ final class GetObjectRequest extends Input * requests to the Object Lambda access point hostname. The Object Lambda access point hostname takes the form * *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com. * - * > 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 diff --git a/src/Service/S3/src/Input/GetObjectTaggingRequest.php b/src/Service/S3/src/Input/GetObjectTaggingRequest.php index 7ca511854..90aa38dab 100644 --- a/src/Service/S3/src/Input/GetObjectTaggingRequest.php +++ b/src/Service/S3/src/Input/GetObjectTaggingRequest.php @@ -13,9 +13,10 @@ final class GetObjectTaggingRequest extends Input /** * The bucket name containing the object for which to get the tagging 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*. diff --git a/src/Service/S3/src/Input/HeadBucketRequest.php b/src/Service/S3/src/Input/HeadBucketRequest.php index 0353115dd..2b4ef3e84 100644 --- a/src/Service/S3/src/Input/HeadBucketRequest.php +++ b/src/Service/S3/src/Input/HeadBucketRequest.php @@ -19,9 +19,10 @@ final class HeadBucketRequest 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*. @@ -31,7 +32,7 @@ final class HeadBucketRequest extends Input * request is not valid, the error code `InvalidAccessPointAliasError` is returned. For more information about * `InvalidAccessPointAliasError`, see List of Error Codes [^3]. * - * > 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 diff --git a/src/Service/S3/src/Input/HeadObjectRequest.php b/src/Service/S3/src/Input/HeadObjectRequest.php index 854b6aee3..40ac39b28 100644 --- a/src/Service/S3/src/Input/HeadObjectRequest.php +++ b/src/Service/S3/src/Input/HeadObjectRequest.php @@ -21,14 +21,15 @@ final class HeadObjectRequest 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 diff --git a/src/Service/S3/src/Input/ListMultipartUploadsRequest.php b/src/Service/S3/src/Input/ListMultipartUploadsRequest.php index 5b1e306b3..456bdd66e 100644 --- a/src/Service/S3/src/Input/ListMultipartUploadsRequest.php +++ b/src/Service/S3/src/Input/ListMultipartUploadsRequest.php @@ -21,14 +21,15 @@ final class ListMultipartUploadsRequest 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 diff --git a/src/Service/S3/src/Input/ListObjectsV2Request.php b/src/Service/S3/src/Input/ListObjectsV2Request.php index 39a92a3d5..e08c959f6 100644 --- a/src/Service/S3/src/Input/ListObjectsV2Request.php +++ b/src/Service/S3/src/Input/ListObjectsV2Request.php @@ -20,14 +20,15 @@ final class ListObjectsV2Request 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 diff --git a/src/Service/S3/src/Input/ListPartsRequest.php b/src/Service/S3/src/Input/ListPartsRequest.php index ffd96c5a7..8854c0fca 100644 --- a/src/Service/S3/src/Input/ListPartsRequest.php +++ b/src/Service/S3/src/Input/ListPartsRequest.php @@ -20,14 +20,15 @@ final class ListPartsRequest 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 diff --git a/src/Service/S3/src/Input/PutObjectAclRequest.php b/src/Service/S3/src/Input/PutObjectAclRequest.php index 2571ffd34..f9983125d 100644 --- a/src/Service/S3/src/Input/PutObjectAclRequest.php +++ b/src/Service/S3/src/Input/PutObjectAclRequest.php @@ -34,9 +34,10 @@ final class PutObjectAclRequest extends Input /** * The bucket name that contains the object to which you want to attach the ACL. * - * **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*. diff --git a/src/Service/S3/src/Input/PutObjectRequest.php b/src/Service/S3/src/Input/PutObjectRequest.php index 4dc831b0e..7c9ca096b 100644 --- a/src/Service/S3/src/Input/PutObjectRequest.php +++ b/src/Service/S3/src/Input/PutObjectRequest.php @@ -62,14 +62,15 @@ final class PutObjectRequest 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 @@ -424,7 +425,8 @@ final class PutObjectRequest 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. * > * diff --git a/src/Service/S3/src/Input/PutObjectTaggingRequest.php b/src/Service/S3/src/Input/PutObjectTaggingRequest.php index b5fe8c170..22a0883a2 100644 --- a/src/Service/S3/src/Input/PutObjectTaggingRequest.php +++ b/src/Service/S3/src/Input/PutObjectTaggingRequest.php @@ -16,9 +16,10 @@ final class PutObjectTaggingRequest extends Input /** * The bucket name containing the object. * - * **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*. diff --git a/src/Service/S3/src/Input/UploadPartCopyRequest.php b/src/Service/S3/src/Input/UploadPartCopyRequest.php index 08b158589..f75e178c0 100644 --- a/src/Service/S3/src/Input/UploadPartCopyRequest.php +++ b/src/Service/S3/src/Input/UploadPartCopyRequest.php @@ -24,14 +24,15 @@ final class UploadPartCopyRequest 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 direct requests to the S3 on Outposts * hostname. The S3 on Outposts hostname takes the form diff --git a/src/Service/S3/src/Input/UploadPartRequest.php b/src/Service/S3/src/Input/UploadPartRequest.php index 38cb29a1a..23132ca01 100644 --- a/src/Service/S3/src/Input/UploadPartRequest.php +++ b/src/Service/S3/src/Input/UploadPartRequest.php @@ -28,14 +28,15 @@ final class UploadPartRequest 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 diff --git a/src/Service/S3/src/Result/GetObjectOutput.php b/src/Service/S3/src/Result/GetObjectOutput.php index 451613d2f..275953cc9 100644 --- a/src/Service/S3/src/Result/GetObjectOutput.php +++ b/src/Service/S3/src/Result/GetObjectOutput.php @@ -60,8 +60,9 @@ class GetObjectOutput extends Result /** * Provides information about object restoration action and expiration time of the restored object copy. * - * > This functionality is not supported for directory buckets. Only the S3 Express One Zone storage class is supported - * > by directory buckets to store objects. + * > This functionality is not supported for 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. * * @var string|null */ @@ -288,8 +289,8 @@ class GetObjectOutput extends Result * Provides storage class information of the object. Amazon S3 returns this header for all objects except for S3 * Standard storage class objects. * - * > **Directory buckets ** - Only the S3 Express One Zone storage class is supported by directory buckets to store - * > objects. + * > **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. * * @var StorageClass::*|null */ diff --git a/src/Service/S3/src/Result/HeadObjectOutput.php b/src/Service/S3/src/Result/HeadObjectOutput.php index ead427aa5..7daac3015 100644 --- a/src/Service/S3/src/Result/HeadObjectOutput.php +++ b/src/Service/S3/src/Result/HeadObjectOutput.php @@ -59,8 +59,9 @@ class HeadObjectOutput extends Result * * For more information about archiving objects, see Transitioning Objects: General Considerations [^2]. * - * > This functionality is not supported for directory buckets. Only the S3 Express One Zone storage class is supported - * > by directory buckets to store objects. + * > This functionality is not supported for 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. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-transition-general-considerations @@ -310,8 +311,8 @@ class HeadObjectOutput extends Result * * For more information, see Storage Classes [^1]. * - * > **Directory buckets ** - Only the S3 Express One Zone storage class is supported by directory buckets to store - * > objects. + * > **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. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html * diff --git a/src/Service/S3/src/Result/ListPartsOutput.php b/src/Service/S3/src/Result/ListPartsOutput.php index 78dd52bdc..e69fff547 100644 --- a/src/Service/S3/src/Result/ListPartsOutput.php +++ b/src/Service/S3/src/Result/ListPartsOutput.php @@ -128,8 +128,8 @@ class ListPartsOutput extends Result implements \IteratorAggregate /** * The class of storage used to store the uploaded object. * - * > **Directory buckets** - Only the S3 Express One Zone storage class is supported by directory buckets to store - * > objects. + * > **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. * * @var StorageClass::*|null */ diff --git a/src/Service/S3/src/S3Client.php b/src/Service/S3/src/S3Client.php index 96c7a5d1a..a632256cb 100644 --- a/src/Service/S3/src/S3Client.php +++ b/src/Service/S3/src/S3Client.php @@ -1432,9 +1432,10 @@ public function getBucketEncryption($input): GetBucketEncryptionOutput * this operation returns an `InvalidObjectState` error. For information about restoring archived objects, see * Restoring Archived Objects [^8] in the *Amazon S3 User Guide*. * - * **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`. * - `Encryption`: * * Encryption request headers, like `x-amz-server-side-encryption`, should not be sent for the `GetObject` requests, diff --git a/src/Service/S3/src/ValueObject/AwsObject.php b/src/Service/S3/src/ValueObject/AwsObject.php index ac95e2610..4db5e9e07 100644 --- a/src/Service/S3/src/ValueObject/AwsObject.php +++ b/src/Service/S3/src/ValueObject/AwsObject.php @@ -71,8 +71,8 @@ final class AwsObject /** * The class of storage used to store the object. * - * > **Directory buckets** - Only the S3 Express One Zone storage class is supported by directory buckets to store - * > objects. + * > **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. * * @var ObjectStorageClass::*|null */ @@ -92,8 +92,9 @@ final class AwsObject * retrieved. For more information about these storage classes and how to work with archived objects, see Working with * archived objects [^1] in the *Amazon S3 User Guide*. * - * > This functionality is not supported for directory buckets. Only the S3 Express One Zone storage class is supported - * > by directory buckets to store objects. + * > This functionality is not supported for 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. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/archived-objects.html * diff --git a/src/Service/S3/src/ValueObject/MultipartUpload.php b/src/Service/S3/src/ValueObject/MultipartUpload.php index 6074d2223..6e0223c0c 100644 --- a/src/Service/S3/src/ValueObject/MultipartUpload.php +++ b/src/Service/S3/src/ValueObject/MultipartUpload.php @@ -35,8 +35,8 @@ final class MultipartUpload /** * The class of storage used to store the object. * - * > **Directory buckets** - Only the S3 Express One Zone storage class is supported by directory buckets to store - * > objects. + * > **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. * * @var StorageClass::*|null */ diff --git a/src/Service/S3/src/ValueObject/RestoreStatus.php b/src/Service/S3/src/ValueObject/RestoreStatus.php index 51c2e6abc..f51c4b81d 100644 --- a/src/Service/S3/src/ValueObject/RestoreStatus.php +++ b/src/Service/S3/src/ValueObject/RestoreStatus.php @@ -7,8 +7,9 @@ * retrieved. For more information about these storage classes and how to work with archived objects, see Working with * archived objects [^1] in the *Amazon S3 User Guide*. * - * > This functionality is not supported for directory buckets. Only the S3 Express One Zone storage class is supported - * > by directory buckets to store objects. + * > This functionality is not supported for 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. * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/archived-objects.html */