wb resource create gcs-bucket

Name

wb-resource-create-gcs-bucket - Add a controlled GCS bucket.

Synopsis

wb resource create gcs-bucket [–access=<access>] [–bucket-name=<bucketName>] [–cloning=<cloning>] [–description=<description>] [–format=<format>] [–location=<location>] [–storage=<storageClass>] [–workspace=<id>] (–id=<id>) [–lifecycle=<pathToLifecycleFile> | –auto-delete=<autoDelete>]

Description

Adds a controlled GCS bucket resource.

Lifecycle rules

GCS bucket lifecycle rules are specified by passing a JSON-formatted file path to the wb resource create gcs-bucket command.

The expected JSON structure matches the one used by the gsutil lifecycle command. This structure is a subset of the GCS resource specification.

There is a command shortcut for specifying a lifecycle rule which deletes any objects more than N days old:

….

wb resource create gcs-bucket –id=mybucket –bucket-name=mybucket –auto-delete=365

….

Options

• –access=<access>
  Access scope for the resource: SHARED_ACCESS, PRIVATE_ACCESS.

  Default: SHARED_ACCESS
  

• –auto-delete=<autoDelete>
  Number of days after which to auto-delete the objects in the bucket. This option is a shortcut for specifying a lifecycle rule that auto-deletes objects in the bucket after some number of days.

• –bucket-name=<bucketName>
  Name of the GCS bucket, without the prefix. (e.g. ‘my-bucket’, not ‘gs://my-bucket’). If not provided, a unique bucket name will be generated.

• –cloning=<cloning>
  Instructions for handling when cloning the workspace: COPY_NOTHING, COPY_DEFINITION, COPY_RESOURCE, COPY_REFERENCE, COPY_LINK_REFERENCE.

  Default: COPY_RESOURCE
  

• –description=<description>
  Description of the resource.

• –format=<format>
  Set the format for printing command output: JSON, TEXT. Defaults to the config format property.

  Default: null
  

• –id=<id>
  ID of the resource, scoped to the workspace. Only use letters, numbers, dashes, and underscores.

• –lifecycle=<pathToLifecycleFile>
  Lifecycle rules (https://cloud.google.com/storage/docs/lifecycle) specified in a JSON-formatted file. See the README for the expected JSON format.

• –location=<location>
  The Google Cloud location of the bucket (https://cloud.google.com/storage/docs/locations).

  Default: US-CENTRAL1
  

• –storage=<storageClass>
  Storage class (https://cloud.google.com/storage/docs/storage-classes): STANDARD, NEARLINE, COLDLINE, ARCHIVE.

• –workspace=<id>
  Workspace id to use for this command only.