pluginsplugin-gcpcloud-storage-gcs

CreateBucket​Create​Bucket

Create a GCS 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
Properties

Bucket's unique name

SubType

The bucket's access control configuration

See About Access Control Lists

SubType

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

See Cross-Origin ResourceSharing (CORS)

SubType

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

The default event-based hold for this bucket

The default Cloud KMS key name for this bucket

The Bucket's IAM Configuration

See uniform bucket-level access

Default ERROR
Possible Values
ERRORUPDATESKIP

Policy to apply if a bucket already exists.

The GCP service account to impersonate.

The bucket's website index page

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

SubType string

The labels of this bucket

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

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.

The bucket's logging configuration

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

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

The GCP project ID.

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.

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
Default ["https://www.googleapis.com/auth/cloud-platform"]

The GCP scopes to be used.

The GCP service account.

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.

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.

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

Possible Values
ENFORCEDUNSPECIFIEDUNKNOWNINHERITED
Possible Values
DOMAINGROUPUSER

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

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

SubType string
Possible Values
GETHEADPUTPOSTDELETEOPTIONS
SubType
SubType string

The entity

Possible Values
READERWRITEROWNER

The role to assign to the entity

The action to take when a lifecycle condition is met

The condition

Possible Values
DELETESET_STORAGE_CLASS

The type of the action (DELETE ...)

The value for the action (if any)

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.

Format uri

The bucket's URI.