Google Cloud UpdateBucket

Google Cloud UpdateBucket

Certified

Update a GCS bucket

Updates bucket metadata such as labels, lifecycle, IAM config, logging, and defaults.

yaml
type: io.kestra.plugin.gcp.gcs.UpdateBucket

Update some bucket labels

yaml
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

Bucket name

Globally unique bucket ID

ACL

Bucket-level access control list

Definitions
entity*Required

The entity

type*Requiredstring
Possible Values
DOMAINGROUPUSER

The type of the entity (USER, GROUP or DOMAIN)

value*Requiredstring

The value for the entity (ex : user email if the type is USER ...)

role*Requiredstring
Possible Values
READERWRITEROWNER

The role to assign to the entity

CORS rules

Cross-Origin Resource Sharing configuration

Definitions
maxAgeSecondsinteger
methodsarray
SubTypestring
Possible Values
GETHEADPUTPOSTDELETEOPTIONS
originsarray
valuestring
responseHeadersarray
SubTypestring

Default object ACL

Default ACL applied to new objects

Definitions
entity*Required

The entity

type*Requiredstring
Possible Values
DOMAINGROUPUSER

The type of the entity (USER, GROUP or DOMAIN)

value*Requiredstring

The value for the entity (ex : user email if the type is USER ...)

role*Requiredstring
Possible Values
READERWRITEROWNER

The role to assign to the entity

Default event-based hold

If true, new objects are event-based held

Default KMS key

IAM configuration

Uniform bucket-level access and related settings

Definitions
publicAccessPreventionstring
Possible Values
ENFORCEDUNSPECIFIEDUNKNOWNINHERITED
uniformBucketLevelAccessEnabledboolean

The GCP service account to impersonate

Website index page

Served as directory index for static website hosting

Labels

Lifecycle rules

List of lifecycle actions and conditions (age/delete/storage class supported)

Definitions
action*Required

The action to take when a lifecycle condition is met

type*Requiredstring
Possible Values
DELETESET_STORAGE_CLASS

The type of the action (DELETE ...)

valuestring

The value for the action (if any)

condition*Required

The condition

age*Requiredintegerstring

The Age condition is satisfied when an object reaches the specified age (in days). Age is measured from the object's creation time

Location

Bucket data location (region or dual-region)

Logging

Destination bucket and prefix for access logs

Definitions
logBucketstring
logObjectPrefixstring

Website not-found page

Custom 404 page for static website hosting

Reference (ref) of the pluginDefaults to apply to this task.

The GCP project ID

Requester pays

If true, requester bears access egress charges

Retention period (seconds)

Bucket retention duration; can be reduced only if policy is unlocked

SubTypestring
Default["https://www.googleapis.com/auth/cloud-platform"]

The GCP scopes to be used

The GCP service account

Possible Values
REGIONALMULTI_REGIONALNEARLINECOLDLINESTANDARDARCHIVEDURABLE_REDUCED_AVAILABILITY

Storage class

Bucket storage class (cost/SLA); see Cloud Storage docs for values

Versioning enabled

Enable object versioning; if true, previous versions are retained

The bucket's info

Definitions
indexPagestring

The bucket's website index page

locationstring

The bucket's location

namestring

The bucket's unique name

notFoundPagestring

The custom object to return when a requested resource is not found

uristring
Formaturi

The bucket's URI

Defaultfalse

If the bucket was created

Defaultfalse

If the bucket was updated