Alibaba Cloud List
CertifiedList objects in an OSS bucket
Alibaba Cloud List
List objects in an OSS bucket
Lists the objects of a bucket, optionally filtered by prefix and regular expression. Folder placeholder objects (keys ending with /) are skipped. Results are capped by maxFiles.
type: io.kestra.plugin.alibaba.oss.ListExamples
List the CSV files under a prefix
id: oss_list
namespace: company.team
tasks:
- id: list
type: io.kestra.plugin.alibaba.oss.List
accessKeyId: "{{ secret('ALIBABA_ACCESS_KEY_ID') }}"
accessKeySecret: "{{ secret('ALIBABA_ACCESS_KEY_SECRET') }}"
region: cn-hangzhou
bucket: my-bucket
prefix: landing/
regexp: ".*\\.csv"
Properties
accessKeyId *string
AccessKey ID
The AccessKey ID used to authenticate against Alibaba Cloud.
accessKeySecret *string
AccessKey secret
The AccessKey secret paired with the AccessKey ID.
bucket *string
Bucket
The name of the OSS bucket.
assets
Assets this task consumes as inputs or produces as outputs, for lineage tracking and the asset graph (Enterprise Edition). A flow declaring this property on a task is rejected in the open-source edition.
io.kestra.core.models.assets.AssetsDeclaration
IGNOREFAILWARNAsset failure behavior
Behavior applied to the task state when a declared asset fails to render, emit, or be persisted (e.g. a lock conflict): FAIL escalates it to FAILED, WARN (default) warns it if it would otherwise succeed, IGNORE leaves the state untouched.
Whether to auto-register assets referenced dynamically at runtime that are not statically declared in inputs or outputs.
The assets consumed as inputs.
io.kestra.core.models.assets.AssetIdentifier
1The assets produced as outputs.
io.kestra.plugin.ee.assets.Dataset
1150{}1150io.kestra.plugin.ee.assets.File
1150{}1150io.kestra.plugin.ee.assets.Table
1150{}1150io.kestra.plugin.ee.assets.VM
1150{}1150io.kestra.core.models.assets.External
1150{}1150io.kestra.core.models.assets.Custom
11501Custom asset type
{}1150delimiter string
Delimiter
Groups keys that share the prefix up to the next delimiter, for example / to list a single folder level. Grouped keys are not returned.
endpointOverride string
Endpoint override
Custom http or https endpoint URL. When set, it takes precedence over the endpoint derived from region.
maxFiles integerstring
25Maximum number of files
Maximum number of objects returned, between 1 and 1000 (default 25). A warning is logged when more objects match.
pathStyleAccess booleanstring
falsePath-style access
Address buckets as <endpoint>/<bucket> instead of <bucket>.<endpoint>. Useful with custom endpoints such as a local emulator.
prefix string
Prefix
Only objects whose key starts with this prefix are listed.
regexp string
Regular expression
Only objects whose full key matches this Java regular expression are returned. It is limited to 256 characters and evaluation is time-boxed to guard against catastrophic backtracking.
region string
Region
The Alibaba Cloud region ID, for example cn-hangzhou. The service endpoint is derived from it unless endpointOverride is set.
securityToken string
Security token
Optional Security Token Service (STS) token, required when using temporary credentials.
Outputs
objects array
The matching objects
io.kestra.plugin.alibaba.oss.OssObject
ETag
Object key
date-timeLast modified time
Size in bytes
Storage class
