List

yaml
type: "io.kestra.plugin.aws.s3.List"

Examples

yaml
id: aws_s3_list
namespace: company.team

tasks:
  - id: list
    type: io.kestra.plugin.aws.s3.List
    accessKeyId: "{{ secret('AWS_ACCESS_KEY_ID') }}"
    secretKeyId: "{{ secret('AWS_SECRET_KEY_ID') }}"
    region: "eu-central-1"
    bucket: "my-bucket"
    prefix: "sub-dir"

Properties

bucket *string

accessKeyId string

compatibilityMode booleanstring

delimiter string

encodingType string

endpointOverride string

expectedBucketOwner string

filter string

DefaultBOTH

Possible Values

FILESDIRECTORYBOTH

forcePathStyle booleanstring

marker string

maxFiles integerstring

Default25

maxKeys integerstring

Default1000

prefix string

regexp string

region string

requestPayer string

secretKeyId string

sessionToken string

stsEndpointOverride string

stsRoleArn string

stsRoleExternalId string

stsRoleSessionDuration string

DefaultPT15M

Formatduration

stsRoleSessionName string

Outputs

objects array

Definitions

io.kestra.plugin.aws.s3.models.S3Object

etagstring

keystring

lastModifiedstring

Formatdate-time

owner

io.kestra.plugin.aws.s3.models.Owner

displayNamestring

idstring

sizeinteger

uristring

Formaturi

Metrics

s3.objects.count counter

Unitobjects

Ingest data to AWS S3 with Git, Python, Apache Iceberg, AWS Glue and Amazon Athena

Ingest data to AWS S3 with Python, Apache Iceberg, AWS Glue and Athena

List objects in an S3 bucket and process them in parallel

Core Plugins and tasks

Tasks that provide Kestra's built-in orchestration, I/O, and observability capabilities.

CoreStorageScript

PostgreSQL

Tasks that connect to PostgreSQL via JDBC to run queries and loads.

Database

SurrealDB

Tasks that run SurrealQL queries against SurrealDB.