AWS S3

AWS S3: List Directory of

cloud.aws.s3.list_directory {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  prefix = ""
  next_page_token = ""
} as x1

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
prefix	Directory prefix to list	`"folder/"`, `"uploads/"`
next_page_token	Token for pagination	`"eyJ2IjoiMiIsInMiOjB9"`
as	Alias for the directory listing	`x1`, `directory_contents`

Example

cloud.aws.s3.list_directory {
  bucket = "my-app-uploads"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  prefix = "users/images/"
} as folder_contents

Lists contents of an S3 directory
Supports pagination for large directories
Returns file metadata and continuation token
Can filter by prefix path

AWS S3: Get Signed URL of

cloud.aws.s3.sign_url {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  file_key = ""
  ttl = 300
} as x2

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
file_key	Path to file in bucket	`"folder/file.pdf"`
ttl	Time-to-live in seconds	`300`, `3600`, `86400`
as	Alias for the signed URL	`x2`, `download_url`

Example

cloud.aws.s3.sign_url {
  bucket = "my-app-files"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  file_key = "private/document.pdf"
  ttl = 3600
} as temporary_url

Generates a pre-signed URL for temporary access
URL expires after specified TTL
Useful for secure file sharing
Supports private bucket access

AWS S3: Upload File to

cloud.aws.s3.upload_file {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  file_key = ""
  file = ""
  metadata =
  object_lock_mode = ""
  object_lock_retain_until = ""
} as x3

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
file_key	Destination path in bucket	`"uploads/file.jpg"`
file	File to upload	`$input.file`, `$file_data`
metadata	Custom metadata for file	`{contentType: "image/jpeg"}`
object_lock_mode	S3 Object Lock mode	`"GOVERNANCE"`, `"COMPLIANCE"`
object_lock_retain_until	Lock retention date	`"2024-12-31"`
as	Alias for upload result	`x3`, `upload_result`

Example

cloud.aws.s3.upload_file {
  bucket = "my-app-uploads"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  file_key = "users/"|add:$user.id|add:"/profile.jpg"
  file = $input.profile_photo
  metadata = {
    contentType: "image/jpeg",
    userId: $user.id
  }
} as upload_response

Uploads file to S3 bucket
Supports custom metadata
Optional Object Lock configuration
Returns upload confirmation

AWS S3: Delete File

cloud.aws.s3.delete_file {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  file_key = ""
}

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
file_key	Path to file to delete	`"folder/file.txt"`

Example

cloud.aws.s3.delete_file {
  bucket = "my-app-uploads"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  file_key = "temp/"|add:$file.path
}

Deletes a file from S3 bucket
Permanent deletion (not recoverable)
No response alias needed
Use with caution

AWS S3: Create Var From File Resource

cloud.aws.s3.read_file {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  file_key = ""
} as x4

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
file_key	Path to file to read	`"folder/file.txt"`
as	Alias for file contents	`x4`, `file_data`

Example

cloud.aws.s3.read_file {
  bucket = "my-app-data"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  file_key = "documents/"|add:$doc.id|add:".pdf"
} as document_contents

Reads file contents from S3
Returns file data
Useful for processing file contents
Supports all file types

AWS S3: Get File Metadata

cloud.aws.s3.get_file_info {
  bucket = ""
  region = ""
  key = ""
  secret = ""
  file_key = ""
} as x5

Parameter	Purpose	Example
bucket	S3 bucket name	`"my-bucket"`
region	AWS region	`"us-east-1"`
key	AWS access key ID	`"AKIAXXXXXXXXXXXXXXXX"`
secret	AWS secret access key	`"XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"`
file_key	Path to file	`"folder/file.txt"`
as	Alias for file metadata	`x5`, `file_info`

Example

cloud.aws.s3.get_file_info {
  bucket = "my-app-storage"
  region = "us-west-2"
  key = $env.AWS_KEY_ID
  secret = $env.AWS_SECRET_KEY
  file_key = "uploads/"|add:$file.path
} as file_metadata

Retrieves file metadata from S3
Returns size, last modified, etc.
Does not download file contents
Useful for file verification

Start

AI

References

AWS S3: List Directory of

AWS S3: Get Signed URL of

AWS S3: Upload File to

AWS S3: Delete File

AWS S3: Create Var From File Resource

AWS S3: Get File Metadata

​ AWS S3: List Directory of

​ AWS S3: Get Signed URL of

​ AWS S3: Upload File to

​ AWS S3: Delete File

​ AWS S3: Create Var From File Resource

​ AWS S3: Get File Metadata

AWS S3: List Directory of

AWS S3: Get Signed URL of

AWS S3: Upload File to

AWS S3: Delete File

AWS S3: Create Var From File Resource

AWS S3: Get File Metadata