CreateBucket

Create a bucket or update if it already exists.

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

Dynamic YES

Bucket's unique name

SubType

Dynamic NO

The bucket's access control configuration

See About Access Control Lists

SubType

Dynamic NO

The bucket's Cross-Origin Resource Sharing (CORS) configuration

See Cross-Origin ResourceSharing (CORS)

SubType

Dynamic NO

The default access control configuration

The access control configuration to apply to bucket's blobs when no other configuration is specified. See About Access Control Lists

Dynamic YES

The default event-based hold for this bucket

Dynamic YES

The default Cloud KMS key name for this bucket

Dynamic NO

The Bucket's IAM Configuration

See uniform bucket-level access

Dynamic YES

Default ERROR

Possible Values

ERRORUPDATESKIP

Policy to apply if a bucket already exists.

Dynamic YES

The GCP service account to impersonate.

Dynamic YES

The bucket's website index page

Behaves as the bucket's directory index where missing blobs are treated as potential directories.

SubType string

Dynamic YES

The labels of this bucket

SubType

Dynamic NO

The bucket's lifecycle configuration

This configuration is expressed as a number of lifecycle rules, consisting of an action and a condition. See Object Lifecycle Management Only the age condition is supported. Only the delete and SetStorageClass actions are supported

Dynamic YES

The bucket's location

Data for blobs in the bucket resides in physical storage within this region. A list of supported values is available here.

Dynamic NO

The bucket's logging configuration

This configuration defines the destination bucket and optional name prefix for the current bucket's logs.

Dynamic YES

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

Dynamic YES

The GCP project ID.

Dynamic YES

Whether the requester pays or not.

Whether a user accessing the bucket or an object it contains should assume the transit costs related to the access.

Dynamic YES

Retention period

If policy is not locked this value can be cleared, increased, and decreased. If policy is locked the retention period can only be increased.

SubType string

Dynamic YES

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

The GCP scopes to be used.

Dynamic YES

The GCP service account.

Dynamic YES

Possible Values

REGIONALMULTI_REGIONALNEARLINECOLDLINESTANDARDARCHIVEDURABLE_REDUCED_AVAILABILITY

The bucket's storage class

This defines how blobs in the bucket are stored and determines the SLA and the cost of storage. A list of supported values is available here.

Dynamic YES

Whether versioning should be enabled for this bucket

When set to true, versioning is fully enabled.

The bucket's info

Default false

If the bucket was created.

Default false

If the bucket was updated.

Dynamic YES

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

Dynamic NO

Possible Values

ENFORCEDUNSPECIFIEDUNKNOWNINHERITED

Dynamic NO

Dynamic YES

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

Dynamic NO

SubType string

Dynamic NO

Possible Values

GETHEADPUTPOSTDELETEOPTIONS

SubType

Dynamic NO

SubType string

Dynamic NO

Dynamic YES

The entity

Dynamic YES

Possible Values

READERWRITEROWNER

The role to assign to the entity

Dynamic YES

The action to take when a lifecycle condition is met

Dynamic YES

The condition

Dynamic YES

The value for the action (if any)

Dynamic NO

The bucket's website index page.

Dynamic NO

The bucket's location

Dynamic NO

The bucket's unique name

Dynamic NO

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

Dynamic NO

Format uri

The bucket's URI.

​Create​Bucket

CreateBucket