Updates a bucket. Changes to the bucket will be readable immediately after writing, but configuration changes may take time to propagate.
Arguments
| Parameters | |
|---|---|
bucket |
Required. Name of a bucket.
|
ifMetagenerationMatch |
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration matches the given value.
|
ifMetagenerationNotMatch |
Makes the return of the bucket metadata conditional on whether the bucket's current metageneration does not match the given value.
|
predefinedAcl |
Apply a predefined set of access controls to this bucket.
|
| Enum type. Can be one of the following: | |
authenticatedRead |
Project team owners get OWNER access, and allAuthenticatedUsers get READER access. |
private |
Project team owners get OWNER access. |
projectPrivate |
Project team members get access according to their roles. |
publicRead |
Project team owners get OWNER access, and allUsers get READER access. |
publicReadWrite |
Project team owners get OWNER access, and allUsers get WRITER access. |
predefinedDefaultObjectAcl |
Apply a predefined set of default object access controls to this bucket.
|
| Enum type. Can be one of the following: | |
authenticatedRead |
Object owner gets OWNER access, and allAuthenticatedUsers get READER access. |
bucketOwnerFullControl |
Object owner gets OWNER access, and project team owners get OWNER access. |
bucketOwnerRead |
Object owner gets OWNER access, and project team owners get READER access. |
private |
Object owner gets OWNER access. |
projectPrivate |
Object owner gets OWNER access, and project team members get access according to their roles. |
publicRead |
Object owner gets OWNER access, and allUsers get READER access. |
projection |
Set of properties to return. Defaults to full.
|
| Enum type. Can be one of the following: | |
full |
Include all properties. |
noAcl |
Omit owner, acl and defaultObjectAcl properties. |
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 Bucket.
Subworkflow snippet
Some fields might be optional or required. To identify required fields, refer to the API documentation.
YAML
- update:
call: googleapis.storage.v1.buckets.update
args:
bucket: ...
ifMetagenerationMatch: ...
ifMetagenerationNotMatch: ...
predefinedAcl: ...
predefinedDefaultObjectAcl: ...
projection: ...
userProject: ...
body:
acl: ...
autoclass:
enabled: ...
toggleTime: ...
billing:
requesterPays: ...
cors:
maxAgeSeconds: ...
method: ...
origin: ...
responseHeader: ...
customPlacementConfig:
dataLocations: ...
defaultEventBasedHold: ...
defaultObjectAcl: ...
encryption:
defaultKmsKeyName: ...
etag: ...
iamConfiguration:
bucketPolicyOnly:
enabled: ...
lockedTime: ...
publicAccessPrevention: ...
uniformBucketLevelAccess:
enabled: ...
lockedTime: ...
id: ...
kind: ...
labels: ...
lifecycle:
rule:
action:
storageClass: ...
type: ...
condition:
age: ...
createdBefore: ...
customTimeBefore: ...
daysSinceCustomTime: ...
daysSinceNoncurrentTime: ...
isLive: ...
matchesPattern: ...
matchesPrefix: ...
matchesStorageClass: ...
matchesSuffix: ...
noncurrentTimeBefore: ...
numNewerVersions: ...
location: ...
locationType: ...
logging:
logBucket: ...
logObjectPrefix: ...
metageneration: ...
name: ...
owner:
entity: ...
entityId: ...
projectNumber: ...
retentionPolicy:
effectiveTime: ...
isLocked: ...
retentionPeriod: ...
rpo: ...
satisfiesPZS: ...
selfLink: ...
storageClass: ...
timeCreated: ...
updated: ...
versioning:
enabled: ...
website:
mainPageSuffix: ...
notFoundPage: ...
result: updateResult
JSON
[
{
"update": {
"call": "googleapis.storage.v1.buckets.update",
"args": {
"bucket": "...",
"ifMetagenerationMatch": "...",
"ifMetagenerationNotMatch": "...",
"predefinedAcl": "...",
"predefinedDefaultObjectAcl": "...",
"projection": "...",
"userProject": "...",
"body": {
"acl": "...",
"autoclass": {
"enabled": "...",
"toggleTime": "..."
},
"billing": {
"requesterPays": "..."
},
"cors": {
"maxAgeSeconds": "...",
"method": "...",
"origin": "...",
"responseHeader": "..."
},
"customPlacementConfig": {
"dataLocations": "..."
},
"defaultEventBasedHold": "...",
"defaultObjectAcl": "...",
"encryption": {
"defaultKmsKeyName": "..."
},
"etag": "...",
"iamConfiguration": {
"bucketPolicyOnly": {
"enabled": "...",
"lockedTime": "..."
},
"publicAccessPrevention": "...",
"uniformBucketLevelAccess": {
"enabled": "...",
"lockedTime": "..."
}
},
"id": "...",
"kind": "...",
"labels": "...",
"lifecycle": {
"rule": {
"action": {
"storageClass": "...",
"type": "..."
},
"condition": {
"age": "...",
"createdBefore": "...",
"customTimeBefore": "...",
"daysSinceCustomTime": "...",
"daysSinceNoncurrentTime": "...",
"isLive": "...",
"matchesPattern": "...",
"matchesPrefix": "...",
"matchesStorageClass": "...",
"matchesSuffix": "...",
"noncurrentTimeBefore": "...",
"numNewerVersions": "..."
}
}
},
"location": "...",
"locationType": "...",
"logging": {
"logBucket": "...",
"logObjectPrefix": "..."
},
"metageneration": "...",
"name": "...",
"owner": {
"entity": "...",
"entityId": "..."
},
"projectNumber": "...",
"retentionPolicy": {
"effectiveTime": "...",
"isLocked": "...",
"retentionPeriod": "..."
},
"rpo": "...",
"satisfiesPZS": "...",
"selfLink": "...",
"storageClass": "...",
"timeCreated": "...",
"updated": "...",
"versioning": {
"enabled": "..."
},
"website": {
"mainPageSuffix": "...",
"notFoundPage": "..."
}
}
},
"result": "updateResult"
}
}
]