Google Cloud Storage

Interact with GCP objects and buckets

Component key: google-cloud-storage

Description#

Cloud Storage is Google's cloud file/blob storage system. This component allows you to create, download, modify, list, and delete files stored in a Google Cloud Storage bucket.

Documentation for the Node.js client used in this component can be found at https://googleapis.dev/nodejs/storage/latest.

Authorization Methods#

Google Cloud Storage requires one of the following authorization methods:

Auth Type	Key	Description	Fields
Private Key	private_key	Private Key authorization based on a username/private key combination	Private Key \| private_key Username \| username

Auth Type

Key

Description

Fields

Private Key

private_key

Private Key authorization based on a username/private key combination

Private Key | private_key

Username | username

The Google Cloud Storage component requires a username / private key pair for authentication. To create a GCP service account, follow directions on https://cloud.google.com/docs/authentication/getting-started.

After creating a service account, you will have an option to create a key for the account. This will generate a .json file with type, project_id, and a dozen other fields. The client_email field will serve as your credential Username, and the private_key which starts with -----BEGIN PRIVATE KEY----- will serve as your credential Private Key.

Actions#

Copy Files#

Copy a file from one Google Cloud Storage bucket to another | key: copyFile

Input	Key	Notes	Example
Destination Bucket string / Required	destinationBucketName	A Google Cloud Storage 'bucket' is a container where files are stored. The destination bucket indicates the bucket containing the file you want to copy. If you are copying files within a single bucket, list the same bucket as the source and destination bucket.	my-destination-bucket
Destination File Name string / Required	destinationFileName	This represents the destination file's path. Do not include a leading /.	path/to/destination/file.txt
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123
Source Bucket string / Required	sourceBucketName	A Google Cloud Storage 'bucket' is a container where files are stored. The source bucket indicates the bucket containing the file you want to copy. If you are copying files within a single bucket, list the same bucket as the source and destination bucket.	my-source-bucket
Source File Name string / Required	sourceFileName	This represents the source file's path. Do not include a leading /.	path/to/source/file.txt

Delete File#

Delete a file from a Google Cloud Storage bucket | key: deleteFile

Input	Key	Notes	Example
Bucket Name string / Required	bucketName	Buckets in Google Cloud Storage contain files, and can be configured in the GCP console. Bucket names contain only letters, numbers, and dashes.	my-gcs-bucket
File Name string / Required	fileName	A file is saved in a 'bucket'. This represents the file's path without a leading /	path/to/file.txt
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123

Download File#

Download a file from Google Cloud Storage | key: downloadFile

Input	Key	Notes	Example
Bucket Name string / Required	bucketName	Buckets in Google Cloud Storage contain files, and can be configured in the GCP console. Bucket names contain only letters, numbers, and dashes.	my-gcs-bucket
File Name string / Required	fileName	A file is saved in a 'bucket'. This represents the file's path without a leading /	path/to/file.txt
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123

Output Example Payload#

{
  "data": "File Contents",
  "contentType": "text/plain"
}

List Files#

List files in a Google Cloud Storage bucket | key: listFiles

Input	Key	Notes	Example
Bucket Name string / Required	bucketName	Buckets in Google Cloud Storage contain files, and can be configured in the GCP console. Bucket names contain only letters, numbers, and dashes.	my-gcs-bucket
Prefix string	prefix	List only files prefixed with this string. For example, if you only want files in a directory called 'unprocessed', you can enter 'unprocessed/'. If this is left blank, all files in the selected bucket will be listed.	path/to/directory/
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123

Output Example Payload#

{
  "data": [
    {
      "name": "Example",
      "bucket": {},
      "parent": "Example Parent",
      "signer": {},
      "storage": {},
      "generation": 2,
      "kmsKeyName": "Example Key",
      "userProject": "Example Project"
    }
  ]
}

Move File#

Move a file from one Google Cloud Storage bucket to another | key: moveFile

Input	Key	Notes	Example
Destination Bucket string / Required	destinationBucketName	A Google Cloud Storage 'bucket' is a container where files are stored. The destination bucket indicates the bucket containing the file you want to copy. If you are copying files within a single bucket, list the same bucket as the source and destination bucket.	my-destination-bucket
Destination File Name string / Required	destinationFileName	This represents the destination file's path. Do not include a leading /.	path/to/destination/file.txt
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123
Source Bucket string / Required	sourceBucketName	A Google Cloud Storage 'bucket' is a container where files are stored. The source bucket indicates the bucket containing the file you want to copy. If you are copying files within a single bucket, list the same bucket as the source and destination bucket.	my-source-bucket
Source File Name string / Required	sourceFileName	This represents the source file's path. Do not include a leading /.	path/to/source/file.txt

Save File#

Save a file to Google Cloud Storage | key: saveFile

Input	Key	Notes	Example
Bucket Name string / Required	bucketName	Buckets in Google Cloud Storage contain files, and can be configured in the GCP console. Bucket names contain only letters, numbers, and dashes.	my-gcs-bucket
File Contents data / Required	fileContents	The contents to write to a file. This can be a string of text, it can be binary data (like an image or PDF) that was generated in a previous step.	My File Contents
File Name string / Required	fileName	A file is saved in a 'bucket'. This represents the file's path without a leading /	path/to/file.txt
GCP Project ID string / Required	project	Google Cloud Storage Buckets are associated with GCP projects. This is the ID (letters, numbers, and dashes) of the GCP project.	my-sample-project-123

note

File Contents can be a reference to a binary file from a previous step. For example, if you have an HTTP Get action that pulls down a .png image, you can reference its step name to write the .png to Google Cloud Storage. Or, File Contents can be simple text, like 'Hello World'.