Skip to main content


5.2 Ensure That Cloud Storage Buckets Have Uniform Bucket-Level Access Enabled (Automated)

Profile Applicability

• Level 2


Best practices recommend enabling uniform bucket-level access on Cloud Storage buckets.


It is recommended to use uniform bucket-level access to unify and simplify how you grant access to your Cloud Storage resources.

Cloud Storage offers two systems for granting users permission to access your buckets and objects: Cloud Identity and Access Management (Cloud IAM) and Access Control Lists (ACLs). These systems act in parallel - in order for a user to access a Cloud Storage resource, only one of the systems needs to grant the user permission. Cloud IAM is used throughout Google Cloud and allows you to grant a variety of permissions at the bucket and project levels. ACLs are used only by Cloud Storage and have limited permission options, but they allow you to grant permissions on a per-object basis.

In order to support a uniform permissioning system, Cloud Storage has uniform bucket-level access. Using this feature disables ACLs for all Cloud Storage resources: access to Cloud Storage resources then is granted exclusively through Cloud IAM. Enabling uniform bucket-level access guarantees that if a Storage bucket is not publicly accessible, no object in the bucket is publicly accessible either.


If you enable uniform bucket-level access, you revoke access from users who gain their access solely through object ACLs.

Certain Google Cloud services, such as Stackdriver, Cloud Audit Logs, and Datastore, cannot export to Cloud Storage buckets that have uniform bucket-level access enabled.


From Console:

  1. Open the Cloud Storage browser in the Google Cloud Console by visiting:

  2. For each bucket, make sure that Access control column has the value Uniform.

From Command Line:

  1. List all buckets in a project
gsutil ls
  1. For each bucket, verify that uniform bucket-level access is enabled.
gsutil uniformbucketlevelaccess get gs://BUCKET_NAME/

If uniform bucket-level access is enabled, the response looks like:

Uniform bucket-level access setting for gs://BUCKET_NAME/:
Enabled: True
LockedTime: LOCK_DATE


From Console:

  1. Open the Cloud Storage browser in the Google Cloud Console by visiting:

  2. In the list of buckets, click the name of the desired bucket.

  3. Select the Permissions tab near the top of the page.

  4. In the text box that starts with This bucket uses fine-grained access control, click Edit.

  5. In the pop-up menu that appears, select Uniform.

  6. Click Save.

From Command Line:

Use the on option in a uniformbucketlevelaccess set command:

gsutil uniformbucketlevelaccess set on gs://BUCKET_NAME/


You can set up an Organization Policy to enforce that any new bucket has uniform bucket level access enabled. Learn more at:


Additional Information

It is not possible to disable uniform bucket-level access if it has been active on a bucket for 90 consecutive days.