List files from a GCS bucket.
type: "io.kestra.plugin.gcp.gcs.List"
Examples
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
The directory to list
allVersions booleanstring
If set to true
, lists all versions of a blob. The default is false
.
filter string
BOTH
FILES
DIRECTORY
BOTH
The filter for files or a directory
impersonatedServiceAccount string
The GCP service account to impersonate.
listingType string
DIRECTORY
RECURSIVE
DIRECTORY
The listing type you want (like directory or recursive)
if DIRECTORY, will only list objects in the specified directory
if RECURSIVE, will list objects in the specified directory recursively
Default value is DIRECTORY
When using RECURSIVE value, be careful to move your files to a location not in the from
scope
projectId string
The GCP project ID.
regExp string
A regexp to filter on full path
ex:
regExp: .*
to match all files
regExp: .*2020-01-0.\\.csv
to match files between 01 and 09 of january ending with .csv
scopes array
["https://www.googleapis.com/auth/cloud-platform"]
The GCP scopes to be used.
serviceAccount string
The GCP service account.
Definitions
io.kestra.plugin.gcp.gcs.models.Blob
bucket string
cacheControl string
componentCount integer
contentDisposition string
contentEncoding string
contentLanguage string
contentType string
crc32c string
createTime string
date-time
customTime string
date-time
deleteTime string
date-time
etag string
eventBasedHold boolean
generatedId string
isDirectory boolean
kmsKeyName string
md5 string
mediaLink string
metaGeneration integer
metadata object
name string
retentionExpirationTime integer
selfLink string
size integer
temporaryHold boolean
timeStorageClassUpdated string
date-time
updateTime string
date-time
uri string
uri