From ff4f785d70ad80be182c6b184024d9fccdad56da Mon Sep 17 00:00:00 2001 From: Jay R Date: Thu, 25 Jan 2024 18:16:21 -0500 Subject: [PATCH] docs(s3): better explain behavior of BUCKET_OWNER_PREFERRED (#28867) Update the enum ObjectOwnership docs to be more explicit. As mentioned [here](https://github.com/aws/aws-cdk/issues/28866) the documentation is not explicit but in S3 [documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) its explicit. We had discussed with Kaizen in [issue](https://github.com/aws/aws-cdk/issues/28866) before entering this PR/Issue. Closes #28866 . ---- *By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license* --- packages/aws-cdk-lib/aws-s3/lib/bucket.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/packages/aws-cdk-lib/aws-s3/lib/bucket.ts b/packages/aws-cdk-lib/aws-s3/lib/bucket.ts index 91dd452c71d4d..79395bf7c5dd7 100644 --- a/packages/aws-cdk-lib/aws-s3/lib/bucket.ts +++ b/packages/aws-cdk-lib/aws-s3/lib/bucket.ts @@ -1287,7 +1287,9 @@ export enum ObjectOwnership { */ BUCKET_OWNER_ENFORCED = 'BucketOwnerEnforced', /** - * Objects uploaded to the bucket change ownership to the bucket owner . + * The bucket owner will own the object if the object is uploaded with + * the bucket-owner-full-control canned ACL. Without this setting and + * canned ACL, the object is uploaded and remains owned by the uploading account. */ BUCKET_OWNER_PREFERRED = 'BucketOwnerPreferred', /**