python-boto3/docs/source/guide/s3-example-access-permissions.rst
2021-09-22 09:34:33 -07:00

32 lines
1.1 KiB
ReStructuredText

.. Copyright 2010-2019 Amazon.com, Inc. or its affiliates. All Rights Reserved.
This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0
International License (the "License"). You may not use this file except in compliance with the
License. A copy of the License is located at http://creativecommons.org/licenses/by-nc-sa/4.0/.
This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
either express or implied. See the License for the specific language governing permissions and
limitations under the License.
##################
Access permissions
##################
This section demonstrates how to manage the access permissions for an S3
bucket or object by using an access control list (ACL).
Get a bucket access control list
================================
The example retrieves the current access control list of an S3 bucket.
.. code-block:: python
import boto3
# Retrieve a bucket's ACL
s3 = boto3.client('s3')
result = s3.get_bucket_acl(Bucket='my-bucket')
print(result)