diff --git a/manifest.json b/manifest.json index b13fa7d0d..3f63d22e7 100644 --- a/manifest.json +++ b/manifest.json @@ -1,6 +1,6 @@ { "variables": { - "${LATEST}": "3.343.16" + "${LATEST}": "3.343.21" }, "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 b3a2c751b..9d780a3b7 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.9.0 ### Added diff --git a/src/Service/S3/src/Enum/RequestCharged.php b/src/Service/S3/src/Enum/RequestCharged.php index 442251621..eacee5729 100644 --- a/src/Service/S3/src/Enum/RequestCharged.php +++ b/src/Service/S3/src/Enum/RequestCharged.php @@ -3,9 +3,12 @@ namespace AsyncAws\S3\Enum; /** - * If present, indicates that the requester was successfully charged for the request. + * If present, indicates that the requester was successfully charged for the request. For more information, see Using + * Requester Pays buckets for storage transfers and usage [^1] in the *Amazon Simple Storage Service user guide*. * * > This functionality is not supported for directory buckets. + * + * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/RequesterPaysBuckets.html */ final class RequestCharged { diff --git a/src/Service/S3/src/S3Client.php b/src/Service/S3/src/S3Client.php index a2e20c011..85e1ea21f 100644 --- a/src/Service/S3/src/S3Client.php +++ b/src/Service/S3/src/S3Client.php @@ -164,7 +164,6 @@ class S3Client extends AbstractApi * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadAbort.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#abortmultipartupload * @@ -341,7 +340,6 @@ public function bucketNotExists($input): BucketNotExistsWaiter * [^14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadComplete.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#completemultipartupload * @@ -506,7 +504,6 @@ public function completeMultipartUpload($input): CompleteMultipartUploadOutput * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * [^12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectCOPY.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#copyobject * @@ -662,7 +659,6 @@ public function copyObject($input): CopyObjectOutput * [^13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * [^14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUT.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#createbucket * @@ -871,7 +867,6 @@ public function createBucket($input): CreateBucketOutput * [^27]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^28]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadInitiate.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#createmultipartupload * @@ -957,7 +952,6 @@ public function createMultipartUpload($input): CreateMultipartUploadOutput * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETE.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#deletebucket * @@ -994,7 +988,6 @@ public function deleteBucket($input): Result * [^2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketDELETEcors.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#deletebucketcors * @@ -1094,7 +1087,6 @@ public function deleteBucketCors($input): Result * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectDELETE.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#deleteobject * @@ -1243,7 +1235,6 @@ public function deleteObjectTagging($input): DeleteObjectTaggingOutput * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/multiobjectdeleteapi.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#deleteobjects * @@ -1294,7 +1285,6 @@ public function deleteObjects($input): DeleteObjectsOutput * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETcors.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketCors.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#getbucketcors * @@ -1495,7 +1485,6 @@ public function getBucketEncryption($input): GetBucketEncryptionOutput * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGET.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#getobject * @@ -1568,7 +1557,6 @@ public function getObject($input): GetObjectOutput * [^5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * [^6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectGETacl.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#getobjectacl * @@ -1749,7 +1737,6 @@ public function getObjectTagging($input): GetObjectTaggingOutput * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html * [^11]: 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 * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#headobject * @@ -1807,7 +1794,6 @@ public function headObject($input): HeadObjectOutput * * [^1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTServiceGET.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#listbuckets * @@ -1910,7 +1896,6 @@ public function listBuckets($input = []): ListBucketsOutput * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListMPUpload.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#listmultipartuploads * @@ -1961,7 +1946,6 @@ public function listMultipartUploads($input): ListMultipartUploadsOutput * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketGETVersion.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectVersions.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#listobjectversions * @@ -2154,7 +2138,6 @@ public function listObjectsV2($input): ListObjectsV2Output * [^12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAttributes.html * [^13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadListParts.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#listparts * @@ -2295,7 +2278,6 @@ public function objectNotExists($input): ObjectNotExistsWaiter * [^3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketCors.html * [^4]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTOPTIONSobject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTcors.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketCors.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putbucketcors * @@ -2430,7 +2412,6 @@ public function putBucketNotificationConfiguration($input): Result * [^7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTBucketPUTtagging.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putbuckettagging * @@ -2550,7 +2531,6 @@ public function putBucketTagging($input): Result * [^10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html * [^11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUT.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putobject * @@ -2737,7 +2717,6 @@ public function putObject($input): PutObjectOutput * [^8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html * [^9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectPUTacl.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAcl.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#putobjectacl * @@ -2973,7 +2952,6 @@ public function putObjectTagging($input): PutObjectTaggingOutput * [^18]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^19]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPart.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#uploadpart * @@ -3150,7 +3128,6 @@ public function uploadPart($input): UploadPartOutput * [^21]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html * [^22]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html * - * @see http://docs.amazonwebservices.com/AmazonS3/latest/API/mpUploadUploadPartCopy.html * @see https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html * @see https://docs.aws.amazon.com/aws-sdk-php/v3/api/api-s3-2006-03-01.html#uploadpartcopy * diff --git a/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php b/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php index cb8010d86..e58096517 100644 --- a/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php +++ b/src/Service/S3/src/ValueObject/CreateBucketConfiguration.php @@ -32,9 +32,8 @@ final class CreateBucketConfiguration * Specifies the location where the bucket will be created. * * **Directory buckets ** - The location type is Availability Zone or Local Zone. To use the Local Zone location type, - * your account must be enabled for Dedicated Local Zones. Otherwise, you get an HTTP `403 Forbidden` error with the - * error code `AccessDenied`. To learn more, see Enable accounts for Dedicated Local Zones [^1] in the *Amazon S3 User - * Guide*. + * your account must be enabled for Local Zones. Otherwise, you get an HTTP `403 Forbidden` error with the error code + * `AccessDenied`. To learn more, see Enable accounts for Local Zones [^1] in the *Amazon S3 User Guide*. * * > This functionality is only supported by directory buckets. *