GCS File System

Estimated reading: 4 minutes

Integrate Google Cloud Storage (GCS) directly into your workflows to automate file and folder operations. The GCS File System component enables secure access to GCS buckets and objects, allowing workflows to upload, download, organize, move, and manage files without leaving the automation environment.

By bringing cloud storage operations into a single component, it helps simplify data management, streamline file movement, and support scalable storage processes as part of end-to-end workflow automation.

Supported Operations

Category Operations
File Management Upload, Download, Copy, Move, Delete
Browsing & Validation List, Exists
Folder Management Create Folder
Metadata Get Metadata

Authentication

The component supports authentication through GCP Service Account JSON credentials or Application Default Credentials (ADC). Access is governed by Google Cloud IAM permissions, ensuring workflows can perform only authorized actions on target buckets and objects.

How to Get the Service Account JSON

1. Open the Google Cloud Console and select your target GCP project from the project drop-down menu at the top.
2. In the left navigation menu, go to IAM & Admin > Service Accounts.
3. Create or select a service account:
    a. To create a new one, click + Create service account, enter a Service account name (and an optional description), and click Create and continue. Assign the required Cloud Storage role (such as Storage Admin or Storage Object Admin), click Continue, and then click Done.
   b. To use an existing one, click the email address of the service account you want to use.
4. Open the Keys tab on the service account details page.
5. Click Add key > Create new key.
6. Select JSON as the key type and click Create.
7. The .json key file downloads automatically to your computer. Save it securely.

Important: Google Cloud does not store a copy of the key, and you cannot download the file again later. If it is lost, create a new key and update the component. Never share Service Account JSON files or commit them to public repositories.

How to Obtain a GCS URI

1. Sign in to the Google Cloud Console and open Cloud Storage > Buckets.
2. Open the target bucket and locate the required folder or object.
3. Select the object or folder and copy its gsutil URI, for example, gs://bucket-name/folder/file.ext.

GCS URI Format

Use the following formats:

Supported Path Formats

Type Format Example
Folder or Prefix gs://bucket-name/folder/ gs://claims/documents/2026/
File or Object gs://bucket-name/folder/file.ext gs://claims/documents/2026/october/report.pdf

Note: A GCS URI identifies a location in Google Cloud Storage and differs from a local file path on the machine running the workflow. For example, gs://claims/documents/2026/october/report.pdf resolves to Bucket: claims and Object: documents/2026/october/report.pdf. Standard https://storage.googleapis.com/<bucket>/<object> URLs are also accepted and automatically normalized to gs://. GCS bucket names are globally unique, so no region parameter is required.

Key Benefits

a. Automated Storage Management – Automate file and folder operations within Google Cloud Storage.
b. Unified Storage Operations – Manage cloud storage tasks through a single workflow component.
c. Secure Access – Uses Google Cloud authentication and IAM-based authorization with secure credential handling.
d. Efficient Data Movement – Simplifies file transfers and storage operations across buckets and connected systems.
e. Secure File Sharing – Generate temporary signed URLs for controlled file upload and download access.
f. Scalable Processing – Supports high-volume storage workloads and large file transfers.
g. Workflow Integration – Incorporates cloud storage management into broader business automation processes.

Common Use Cases

1. Automated Data Ingestion – Upload files and processed data directly to GCS buckets.
2. File and Folder Management – Organize, move, copy, or delete objects and folders programmatically.
3. Storage Validation – Verify the existence of required files or folders before executing downstream processes.
4. Secure File Sharing – Generate temporary signed URLs for external upload or download access.
5. Document Archiving – Archive or relocate processed files across storage locations as part of automated workflows.

Share this Doc

GCS File System

Or copy link

CONTENTS
Robility Chatbot
Robility Assistant
Online