Hide
Google Cloud Storage

BucketAccessControls: patch

Updates an ACL entry on the specified bucket. This method supports patch semantics. Try it now or see an example.

Request

HTTP request

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

Parameters

Parameter name Value Description
Path parameters
bucket string Name of a bucket.
entity string The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.

Request body

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

Response

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

Examples

Note: The code examples available for this method do not represent all supported programming languages (see the client libraries page for a list of supported languages).

Python

Uses the Python client library.

req = client.bucketAccessControls().patch(
        bucket=bucket_name,
        entity='allAuthenticatedUsers',
        body={'role': 'READER'},
        fields='id,role')   # optional
resp = req.execute()
print json.dumps(resp, indent=2)

Try it!

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