BucketAccessControls: patch

Updates an ACL entry on the specified bucket . This method supports patch semantics.

Important:This method fails with a 400 Bad Request response for buckets with uniform bucket-level access enabled. Use storage.buckets.getIamPolicy and storage.buckets.setIamPolicy to control access instead.

Required permissions

The authenticated user must have the following IAM permissions on the bucket to use this method:

As an alternative to having IAM permissions, the authenticated user can use this method by having the OWNER ACL permission for the bucket.

PATCH https://storage.googleapis.com/storage/v1/b/ bucket 
/acl/ entity

In addition to standard query parameters , the following query parameters apply to this method.

To see an example of how to include query parameters in a request, see the JSON API Overview page.

Parameter name

Value

Description

Path parameters

bucket

string

Name of a bucket.

entity

string

The entity holding the permission. Can be

user- emailAddress

group- groupId

group- emailAddress

, allUsers , or allAuthenticatedUsers .

Optional query parameters

In the request body, supply the relevant portions of a BucketAccessControls resource , according to the rules of patch semantics.

If successful, this method returns a BucketAccessControls resource in the response body.

Use the APIs Explorer below to call this method on live data and see the response.