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

Examples

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

name *string

Bucket name

Globally unique bucket ID

acl array

ACL

Bucket-level access control list

Definitions

io.kestra.plugin.gcp.gcs.models.AccessControl

entity*

The entity

io.kestra.plugin.gcp.gcs.models.Entity

type*string

Possible Values

DOMAINGROUPUSER

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

value*string

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

role*string

Possible Values

READERWRITEROWNER

The role to assign to the entity

assets

Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.

Definitions

io.kestra.core.models.assets.AssetsDeclaration

assetFailureBehaviorstring

Possible Values

IGNOREFAILWARN

Asset failure behavior

Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.

enableAutobooleanstring

Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.

inputsarray

The assets consumed as inputs.

io.kestra.core.models.assets.AssetIdentifier

id*string

Min length1

typestring

outputs

The assets produced as outputs.

io.kestra.plugin.ee.assets.Dataset

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.File

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.Table

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.plugin.ee.assets.VM

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.core.models.assets.External

id*string

Min length1

Max length150

type*object

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

io.kestra.core.models.assets.Custom

id*string

Min length1

Max length150

type*string

Min length1

Custom asset type

descriptionstring

displayNamestring

metadataobject

Default{}

namespacestring

Min length1

Max length150

cors array

CORS rules

Cross-Origin Resource Sharing configuration

Definitions

io.kestra.plugin.gcp.gcs.models.Cors

maxAgeSecondsinteger

methodsarray

SubTypestring

Possible Values

GETHEADPUTPOSTDELETEOPTIONS

originsarray

com.google.cloud.storage.Cors-Origin

valuestring

responseHeadersarray

SubTypestring

defaultAcl array

Default object ACL

Default ACL applied to new objects

Definitions

io.kestra.plugin.gcp.gcs.models.AccessControl

entity*

The entity

io.kestra.plugin.gcp.gcs.models.Entity

type*string

Possible Values

DOMAINGROUPUSER

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

value*string

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

role*string

Possible Values

READERWRITEROWNER

The 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

IAM configuration

Uniform bucket-level access and related settings

Definitions

io.kestra.plugin.gcp.gcs.models.IamConfiguration

publicAccessPreventionstring

Possible Values

ENFORCEDUNSPECIFIEDUNKNOWNINHERITED

uniformBucketLevelAccessEnabledboolean

impersonatedServiceAccount string

The GCP service account to impersonate

indexPage string

Website index page

Served as directory index for static website hosting

labels object

Labels

lifecycleRules array

Lifecycle rules

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

Definitions

io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule

action*

The action to take when a lifecycle condition is met

io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule-Action

type*string

Possible Values

DELETESET_STORAGE_CLASS

The type of the action (DELETE ...)

valuestring

The value for the action (if any)

condition*

The condition

io.kestra.plugin.gcp.gcs.models.BucketLifecycleRule-Condition

age*integerstring

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

Logging

Destination bucket and prefix for access logs

Definitions

io.kestra.plugin.gcp.gcs.models.Logging

logBucketstring

logObjectPrefixstring

notFoundPage string

Website not-found page

Custom 404 page for static website hosting

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

SubTypestring

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

The GCP scopes to be used

serviceAccount string

The GCP service account

storageClass string

Possible Values

REGIONALMULTI_REGIONALNEARLINECOLDLINESTANDARDARCHIVEDURABLE_REDUCED_AVAILABILITY

Storage 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

Definitions

io.kestra.plugin.gcp.gcs.models.Bucket

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

created boolean

Defaultfalse

If the bucket was created

updated boolean

Defaultfalse

If the bucket was updated

Scrapy CLI

Tasks that run Scrapy spiders and CLI commands to scrape data from websites.

Data

Supabase

Tasks that call Supabase APIs for data and storage operations.

Data

Google Cloud UpdateBucketCertifiedUpdate a GCS bucket

Google Cloud UpdateBucket

More Plugins in this Category

Scrapy CLI

Supabase

Google Cloud UpdateBucket
Certified
Update a GCS bucket