Confusing documentation for create_bucket function

[kalyank23]

Describe the issue

It was mentioned that 'public-read' can be passed to ACL parameter in create_bucket function, but if passed then getting error as mentioned in the below link

https://stackoverflow.com/questions/76629269/confusing-documentation-from-python-boto3-to-create-bucket?noredirect=1#comment135105828_76629269

Please update the documentation to reflect correct details.

Links

https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/s3/client/create_bucket.html

[kalyank23]

As per my understanding, boto3 is yet to catch up with the latest changes from AWS S3.

https://stackoverflow.com/questions/76026251/cloudformation-keeps-throwing-invalidbucketaclwithblockpublicaccesserror-for-my

[RyanFitzSimmonsAK]

Hi @kalyank23, thanks for raising this issue. I was able to reproduce this; any ACL other than 'private' results in an error. The documentation models are auto-generated by service teams, so I've reached out to the documentation team to address this. Since this affects all SDKs, I've created an issue in our cross-SDK repository (aws/aws-sdk#565) to track this issue.