Google Cloud List
CertifiedList GCS objects
Google Cloud List
List GCS objects
Lists blobs under a gs:// prefix with optional regex filtering and directory/file selection.
type: io.kestra.plugin.gcp.gcs.ListExamples
List files in a GCS bucket
id: gcp_gcs_list
namespace: company.team
tasks:
- id: list
type: io.kestra.plugin.gcp.gcs.List
from: "gs://my_bucket/dir/"
Properties
from *Requiredstring
Source prefix
gs:// path to list
allVersions booleanstring
Include all versions
If true, includes object versions; default false
filter string
BOTHFILESDIRECTORYBOTHListing filter
Choose FILES, DIRECTORY, or BOTH; defaults to BOTH
impersonatedServiceAccount string
The GCP service account to impersonate
listingType string
DIRECTORYRECURSIVEDIRECTORYListing type
DIRECTORY lists only immediate children; RECURSIVE traverses all descendants. Default DIRECTORY.
maxFiles integerstring
25Max files
The maximum number of files to retrieve at once. Defaults to 25.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
projectId string
The GCP project ID
regExp string
Regex filter
Optional regex applied to full object path (e.g., .*2020-01-0.\.csv)
scopes array
["https://www.googleapis.com/auth/cloud-platform"]The GCP scopes to be used
serviceAccount string
The GCP service account
Outputs
blobs array
Blobs
io.kestra.plugin.gcp.gcs.models.Blob
date-timedate-timedate-timedate-timedate-timeuriMetrics
size counter
filesNumber of blobs listed.
