Updates an ACL entry on the specified bucket.
Arguments
Parameters | |
---|---|
bucket |
Required. Name of a bucket.
|
entity |
Required. The entity holding the permission. Can be user-userId, user-emailAddress, group-groupId, group-emailAddress, allUsers, or allAuthenticatedUsers.
|
userProject |
The project to be billed for this request. Required for Requester Pays buckets.
|
body |
Required.
|
Raised exceptions
Exceptions | |
---|---|
ConnectionError |
In case of a network problem (such as DNS failure or refused connection). |
HttpError |
If the response status is >= 400 (excluding 429 and 503). |
TimeoutError |
If a long-running operation takes longer to finish than the specified timeout limit. |
TypeError |
If an operation or function receives an argument of the wrong type. |
ValueError |
If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout. |
Response
If successful, the response contains an instance of BucketAccessControl
.
Subworkflow snippet
Some fields might be optional or required. To identify required fields, refer to the API documentation.
YAML
- update: call: googleapis.storage.v1.bucketAccessControls.update args: bucket: ... entity: ... userProject: ... body: bucket: ... domain: ... email: ... entity: ... entityId: ... etag: ... id: ... kind: ... projectTeam: projectNumber: ... team: ... role: ... selfLink: ... result: updateResult
JSON
[ { "update": { "call": "googleapis.storage.v1.bucketAccessControls.update", "args": { "bucket": "...", "entity": "...", "userProject": "...", "body": { "bucket": "...", "domain": "...", "email": "...", "entity": "...", "entityId": "...", "etag": "...", "id": "...", "kind": "...", "projectTeam": { "projectNumber": "...", "team": "..." }, "role": "...", "selfLink": "..." } }, "result": "updateResult" } } ]