GCP Cloud Storage Connector
Content Type: Module
Categories: Connectors
Overview
The GCP Cloud Storage Connector enables Mendix developers to interact effortlessly with Google Cloud Platform (GCP) Cloud Storage, providing powerful file management capabilities directly within your low-code applications.
Key Features:
- Upload Files: Easily upload files from your Mendix app to GCP Cloud Storage with just a few clicks.
- Download Files: Retrieve files securely from GCP buckets and use them in your Mendix App.
- List Buckets: Programmatically fetch and manage available storage buckets in your GCP project.
- List Folders: Navigate and organize files by listing directories within your Cloud Storage buckets.
- Create Bucket
Documentation
Typical usage scenario
With this module, you can upload FileDocument objects, including any specialized subclasses, to a Cloud Storage bucket
Features and limitations
- Upload object to GCP Cloud Storage bucket
- Download object from GCP Cloud Storage bucket
- List all buckets under specific project
- List all folders under specific path
- Create Bucket
Releases
Version: 2.2.0
Framework Version: 10.24.0
Release Notes: In this release we've added a new Java Action to create a new Google Cloud Storage (GCS) bucket within a specified Google Cloud Project. It allows for the configuration of key bucket properties such as its storage location, default storage class, and the Autoclass feature for automatic storage optimization.
Parameters:
ProjectID (String): The ID of the Google Cloud Project where the new bucket will be created.
BucketName (String): The globally unique name for the new Cloud Storage bucket.
DefaultStorageClass (String): The default storage class for objects placed in this bucket (e.g., 'STANDARD', 'NEARLINE', 'COLDLINE', 'ARCHIVE'). If Autoclass is enabled, this setting may be overridden by GCS.
EnableAutoclass (Boolean): If true, enables the Autoclass feature for the bucket, which automatically transitions objects to the most cost-effective storage class based on access patterns.
Location (String, Optional): The geographic location for the bucket (e.g., 'US-CENTRAL1', 'EUROPE-WEST1', 'US', 'EU'). Required for regional or multi-regional buckets. If Autoclass is enabled, the bucket must be in a regional or multi-regional location.
ServiceAccountKey (String): The full JSON content of a Google Cloud Service Account key file. This service account must have the "storage.buckets.create" permission to create buckets.
Returns:
Boolean: true if the bucket was successfully created; false otherwise. Check the Mendix application logs for detailed error messages in case of failure.
Version: 2.1.0
Framework Version: 10.23.0
Release Notes: - Improved Documentation: Added detailed documentation for the Download action.
- Enhanced Logging: Introduced logger nodes for better traceability.
- Error Handling: Added specific exceptions and error handling for each action.
- Null Return for Missing Objects: The Download action now returns null if the requested object is not found
- DownloadFromGCPCloudStorageV2: It is a new version of DownloadFromGCPCloudStorage which accepts Instance of FileDocument or your specialization and returns FileDocument or your specialization if object is available on the GCP CS otherwise null
Version: 2.0.0
Framework Version: 10.23.0
Release Notes: New Java Actions Added:
GCPCloudStorageBuckets: Retrieve a list of available buckets in your GCP project.
GCPCloudStorageFolders: List folders within a specified bucket for better file organization.
DownloadFromGCPCloudStorage: Download files directly from GCP Cloud Storage to your Mendix
Upload Enhancement:
Folder path support: Object names now include full paths (e.g., folder1/folder2/ObjectName).
Returns true on success: Easier validation in microflows.
Documentation & Usability:
Added comprehensive docs for UploadToGCPCloudStorage.
Fixed Microflow category for better organization in the Mendix Studio Pro toolbox.
Logging Improvements:
Enhanced logging for debugging and tracking operations.
Bug Fixes & Optimizations
Minor stability and performance improvements.
Version: 1.0.0
Framework Version: 10.23.0
Release Notes: First version