Google Cloud CreateBucket

Google Cloud CreateBucket

Certified

Create or update a GCS bucket

Creates a new bucket with provided settings. If the bucket exists, behavior follows ifExists (default ERROR; UPDATE applies changes; SKIP leaves it).

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

Create a new bucket with some options

yaml
id: gcp_gcs_create_bucket
namespace: company.team

tasks:
  - id: create_bucket
    type: io.kestra.plugin.gcp.gcs.CreateBucket
    name: "my-bucket"
    versioningEnabled: true
    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
DefaultERROR
Possible Values
ERRORUPDATESKIP

Existing bucket policy

ERROR by default; UPDATE to apply new settings; SKIP to leave as-is.

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

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

More Plugins in this Category

Prefect
Prefect

Tasks that trigger Prefect deployments and monitor flow runs.

Data

1 tasks

1 blueprints

Azure (EE)
Azure
Enterprise

Tasks that integrate Microsoft Azure services into Kestra enterprise workflows.

CloudDataInfrastructure

7 tasks