
Alibaba Cloud Upload
CertifiedUpload a file to an OSS bucket
Alibaba Cloud Upload
Upload a file to an OSS bucket
Uploads a file from Kestra internal storage to the given bucket and key. The file is sent in a single request, so it is limited to 5 GB, the maximum size of a simple OSS upload.
type: io.kestra.plugin.alibaba.oss.UploadExamples
Upload a file to a bucket
id: oss_upload
namespace: company.team
inputs:
- id: file
type: FILE
tasks:
- id: upload
type: io.kestra.plugin.alibaba.oss.Upload
accessKeyId: "{{ secret('ALIBABA_ACCESS_KEY_ID') }}"
accessKeySecret: "{{ secret('ALIBABA_ACCESS_KEY_SECRET') }}"
region: cn-hangzhou
bucket: my-bucket
key: "landing/{{ inputs.file | fileName }}"
from: "{{ inputs.file }}"
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.
from *string
Source file
The kestra:// URI of the file to upload.
Pebble expression referencing an Internal Storage URI e.g. {{ outputs.mytask.uri }}.
key *string
Object key
The key (path) of the object in the 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
{}1150endpointOverride string
Endpoint override
Custom http or https endpoint URL. When set, it takes precedence over the endpoint derived from region.
pathStyleAccess booleanstring
falsePath-style access
Address buckets as <endpoint>/<bucket> instead of <bucket>.<endpoint>. Useful with custom endpoints such as a local emulator.
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
etag string
ETag of the uploaded object
key string
Key of the uploaded object