
Google Cloud UpdateBucket
CertifiedUpdate a GCS bucket
Google Cloud UpdateBucket
Update a GCS bucket
Updates bucket metadata such as labels, lifecycle, IAM config, logging, and defaults.
type: io.kestra.plugin.gcp.gcs.UpdateBucketExamples
Update some bucket labels
id: gcp_gcs_update_bucket
namespace: company.team
tasks:
- id: update_bucket
type: io.kestra.plugin.gcp.gcs.UpdateBucket
name: "my-bucket"
labels:
my-label: my-value
Properties
name *Requiredstring
Bucket name
Globally unique bucket ID
acl Non-dynamicarray
ACL
Bucket-level access control list
io.kestra.plugin.gcp.gcs.models.AccessControl
The entity
io.kestra.plugin.gcp.gcs.models.Entity
DOMAINGROUPUSERThe type of the entity (USER, GROUP or DOMAIN)
The value for the entity (ex : user email if the type is USER ...)
READERWRITEROWNERThe role to assign to the entity
cors Non-dynamicarray
CORS rules
Cross-Origin Resource Sharing configuration
io.kestra.plugin.gcp.gcs.models.Cors
GETHEADPUTPOSTDELETEOPTIONScom.google.cloud.storage.Cors-Origin
defaultAcl Non-dynamicarray
Default object ACL
Default ACL applied to new objects
io.kestra.plugin.gcp.gcs.models.AccessControl
The entity
io.kestra.plugin.gcp.gcs.models.Entity
DOMAINGROUPUSERThe type of the entity (USER, GROUP or DOMAIN)
The value for the entity (ex : user email if the type is USER ...)
READERWRITEROWNERThe role to assign to the entity
defaultEventBasedHold booleanstring
Default event-based hold
If true, new objects are event-based held
defaultKmsKeyName string
Default KMS key
iamConfiguration Non-dynamic
IAM configuration
Uniform bucket-level access and related settings
io.kestra.plugin.gcp.gcs.models.IamConfiguration
ENFORCEDUNSPECIFIEDUNKNOWNINHERITEDimpersonatedServiceAccount string
The GCP service account to impersonate
indexPage string
Website index page
Served as directory index for static website hosting
labels object
Labels
lifecycleRules Non-dynamicarray
Lifecycle rules
List of lifecycle actions and conditions (age/delete/storage class supported)
io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule
The action to take when a lifecycle condition is met
io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule-Action
DELETESET_STORAGE_CLASSThe type of the action (DELETE ...)
The value for the action (if any)
The condition
io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule-Condition
The Age condition is satisfied when an object reaches the specified age (in days). Age is measured from the object's creation time
location string
Location
Bucket data location (region or dual-region)
logging Non-dynamic
Logging
Destination bucket and prefix for access logs
io.kestra.plugin.gcp.gcs.models.Logging
notFoundPage string
Website not-found page
Custom 404 page for static website hosting
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
projectId string
The GCP project ID
requesterPays booleanstring
Requester pays
If true, requester bears access egress charges
retentionPeriod integerstring
Retention period (seconds)
Bucket retention duration; can be reduced only if policy is unlocked
scopes array
["https://www.googleapis.com/auth/cloud-platform"]The GCP scopes to be used
serviceAccount string
The GCP service account
storageClass string
REGIONALMULTI_REGIONALNEARLINECOLDLINESTANDARDARCHIVEDURABLE_REDUCED_AVAILABILITYStorage class
Bucket storage class (cost/SLA); see Cloud Storage docs for values
versioningEnabled booleanstring
Versioning enabled
Enable object versioning; if true, previous versions are retained
Outputs
bucket
The bucket's info
io.kestra.plugin.gcp.gcs.models.Bucket
The bucket's website index page
The bucket's location
The bucket's unique name
The custom object to return when a requested resource is not found
uriThe bucket's URI
created boolean
falseIf the bucket was created
updated boolean
falseIf the bucket was updated