Skip to main content

S3.List

Examples below assume this module is imported with an imports: entry under alias S3. Kind references (S3.List, S3.Bucket) follow that alias — if you import the module under a different name, substitute your alias accordingly.

Lists object keys in a bucket declared as S3.Bucket. Invocable.


Example

kind: S3.List
metadata:
name: ListModules
bucketRef: !ref ModuleStore

Invoke with an optional key prefix:

- name: list
invoke:
kind: S3.List
bucketRef: !ref ModuleStore
inputs:
prefix: "${{ 'std/' + inputs.name + '/' }}"

Fields

FieldTypeRequiredDescription
bucketRefreferenceyesA !ref to an S3.Bucket resource — local (!ref ModuleStore) or imported (!ref Alias.ModuleStore).

Invocation inputs

InputTypeRequiredDescription
prefixstringnoRestrict the listing to keys starting with this prefix. Defaults to "" (list all).

Output

FieldTypeDescription
keysstring[]Keys of the objects returned by the underlying ListObjects call.