Alibaba Cloud List
CertifiedList ECS instances
Alibaba Cloud List
List ECS instances
Lists the ECS instances of a region, optionally filtered by IDs, status or name. Each instance is returned with the fields of the DescribeInstances API, for example InstanceId, InstanceName and Status.
type: io.kestra.plugin.alibaba.ecs.ListExamples
List running instances and log their IDs
id: ecs_list
namespace: company.team
tasks:
- id: list
type: io.kestra.plugin.alibaba.ecs.List
accessKeyId: "{{ secret('ALIBABA_ACCESS_KEY_ID') }}"
accessKeySecret: "{{ secret('ALIBABA_ACCESS_KEY_SECRET') }}"
region: cn-hangzhou
status: RUNNING
fetchType: FETCH
- id: log
type: io.kestra.plugin.core.log.Log
message: "{{ outputs.list.rows | jq('.[].InstanceId') }}"
Store all instances of a region in internal storage
id: ecs_list_store
namespace: company.team
tasks:
- id: list
type: io.kestra.plugin.alibaba.ecs.List
accessKeyId: "{{ secret('ALIBABA_ACCESS_KEY_ID') }}"
accessKeySecret: "{{ secret('ALIBABA_ACCESS_KEY_SECRET') }}"
region: cn-hangzhou
fetchType: STORE
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.
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.
fetchType string
FETCHSTOREFETCHFETCH_ONENONEFetch type
FETCH outputs all instances as rows, FETCH_ONE outputs the first one as row, STORE writes them to an ION file in internal storage and outputs its uri, NONE only outputs the size.
instanceIds array
Instance IDs
Only return these instances, up to 100 IDs.
instanceName string
Instance name
Only return instances with this name. Supports the * wildcard, for example web-*.
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.
status string
PENDINGRUNNINGSTARTINGSTOPPINGSTOPPEDStatus
Only return instances in this status. These are all the values accepted by the DescribeInstances Status filter.
Outputs
row object
Map containing the first row of fetched data.
Only populated if using fetchType=FETCH_ONE.
rows array
List containing the fetched data.
Only populated if using fetchType=FETCH.
size integer
The number of fetched rows.
uri string
uriKestra's internal storage URI of the stored data.
Only populated if using fetchType=STORE.
