S3

Amazon S3 é um serviço de armazenamento em nuvem altamente escalável, seguro e durável fornecido pela Amazon Web Services. Foi projetado para armazenar e recuperar qualquer quantidade de dados de qualquer lugar na web, tornando-se uma das soluções de armazenamento em nuvem mais amplamente usadas por empresas de todos os portes.

Com o Amazon S3, você pode:

  • Armazenar dados ilimitados: Faça upload de arquivos de qualquer tamanho e tipo com capacidade de armazenamento praticamente ilimitada
  • Acessar de qualquer lugar: Recupere seus arquivos de qualquer lugar do mundo com acesso de baixa latência
  • Garantir durabilidade dos dados: Beneficie-se de 99.999999999% (11 noves) de durabilidade com replicação automática de dados
  • Controlar o acesso: Gerencie permissões e controles de acesso com políticas de segurança granulares
  • Escalar automaticamente: Lidar com cargas de trabalho variáveis sem intervenção manual ou planejamento de capacidade
  • Integrar de forma transparente: Conecte-se facilmente a outros serviços AWS e aplicações de terceiros
  • Otimizar custos: Escolha entre várias classes de armazenamento para otimizar custos com base nos padrões de acesso

No Zoen, a integração do S3 permite que seus agentes recuperem e acessem arquivos armazenados nos seus buckets do Amazon S3 usando URLs pré-assinadas seguras. Isso viabiliza cenários poderosos de automação, como processar documentos, analisar dados armazenados, recuperar arquivos de configuração e acessar conteúdo de mídia como parte dos seus fluxos de trabalho. Seus agentes podem buscar arquivos do S3 com segurança sem expor suas credenciais AWS, facilitando a incorporação de assets armazenados na nuvem aos seus processos de automação. Essa integração preenche a lacuna entre o seu armazenamento em nuvem e os fluxos de trabalho de IA, permitindo acesso transparente aos seus dados armazenados enquanto mantém as melhores práticas de segurança por meio dos robustos mecanismos de autenticação da AWS.

Usage Instructions

Integrate S3 into the workflow. Upload, download, copy, and delete objects (individually or in batches), inspect object metadata, generate time-limited presigned URLs, list bucket contents, and create, list, or delete buckets. Requires AWS access key and secret access key.

Actions

s3_put_object

Upload a file to an AWS S3 bucket

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path in S3 (e.g., folder/filename.ext)
filefileNoFile to upload
contentstringNoText content to upload (alternative to file)
contentTypestringNoContent-Type header (auto-detected from file if not provided)
aclstringNoAccess control list (e.g., private, public-read)

Output

ParameterTypeDescription
urlstringURL of the uploaded S3 object
uristringS3 URI of the uploaded object (s3://bucket/key)
metadataobjectUpload metadata including ETag and location

s3_get_object

Retrieve an object from an AWS S3 bucket

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringNoOptional region override when URL does not include region (e.g., us-east-1, eu-west-1)
s3UristringYesS3 Object URL (e.g., https://bucket.s3.region.amazonaws.com/path/to/file\)

Output

ParameterTypeDescription
urlstringPre-signed URL for downloading the S3 object
filefileDownloaded file stored in execution files
metadataobjectFile metadata including type, size, name, and last modified date

s3_list_objects

List objects in an AWS S3 bucket

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
prefixstringNoPrefix to filter objects (e.g., folder/, images/2024/)
maxKeysnumberNoMaximum number of objects to return (default: 1000)
continuationTokenstringNoToken for pagination from previous list response

Output

ParameterTypeDescription
objectsarrayList of S3 objects
↳ keystringObject key
↳ sizenumberObject size in bytes
↳ lastModifiedstringLast modified timestamp
↳ etagstringEntity tag
metadataobjectListing metadata including pagination info

s3_delete_object

Delete an object from an AWS S3 bucket

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path to delete (e.g., folder/file.txt)

Output

ParameterTypeDescription
deletedbooleanWhether the object was successfully deleted
metadataobjectDeletion metadata

s3_copy_object

Copy an object within or between AWS S3 buckets

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
sourceBucketstringYesSource bucket name (e.g., my-bucket)
sourceKeystringYesSource object key/path (e.g., folder/file.txt)
destinationBucketstringYesDestination bucket name (e.g., my-other-bucket)
destinationKeystringYesDestination object key/path (e.g., backup/file.txt)
aclstringNoAccess control list for the copied object (e.g., private, public-read)

Output

ParameterTypeDescription
urlstringURL of the copied S3 object
uristringS3 URI of the copied object (s3://bucket/key)
metadataobjectCopy operation metadata

s3_list_buckets

List the S3 buckets owned by the authenticated AWS account

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region to address the request to (e.g., us-east-1)
prefixstringNoLimit the response to bucket names that begin with this prefix
maxBucketsnumberNoMaximum number of buckets to return (1-10000)
continuationTokenstringNoToken for pagination from a previous list buckets response

Output

ParameterTypeDescription
bucketsarrayList of S3 buckets owned by the account
↳ namestringBucket name
↳ creationDatestringBucket creation timestamp
↳ regionstringAWS region where the bucket is located
metadataobjectListing metadata including owner and pagination info

s3_head_object

Retrieve metadata for an S3 object without downloading its body

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path to inspect (e.g., folder/file.txt)
versionIdstringNoSpecific object version ID to inspect (for versioned buckets)

Output

ParameterTypeDescription
existsbooleanWhether the object exists and was reachable
metadataobjectObject metadata including size, content type, ETag, and last modified date

s3_create_bucket

Create a new AWS S3 bucket in the specified region

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region to create the bucket in (e.g., us-east-1)
bucketNamestringYesName for the new S3 bucket (must be globally unique)
aclstringNoCanned ACL for the bucket (e.g., private, public-read)

Output

ParameterTypeDescription
metadataobjectCreated bucket metadata including name and location

s3_delete_bucket

Delete an empty AWS S3 bucket

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region where the bucket is located (e.g., us-east-1)
bucketNamestringYesName of the S3 bucket to delete (must be empty)

Output

ParameterTypeDescription
deletedbooleanWhether the bucket was successfully deleted
metadataobjectDeletion metadata including bucket name

s3_presigned_url

Generate a time-limited presigned URL to download or upload an S3 object

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region where the bucket is located (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
objectKeystringYesObject key/path for the presigned URL (e.g., folder/file.txt)
methodstringYesOperation the URL grants: get (download) or put (upload)
expiresInnumberNoURL validity in seconds (1-604800, default 3600)
contentTypestringNoContent-Type the upload must use (only applies to put URLs)

Output

ParameterTypeDescription
urlstringThe generated presigned URL
metadataobjectPresigned URL metadata including method and expiration

s3_delete_objects

Delete multiple objects from an AWS S3 bucket in a single batch request

Input

ParameterTypeRequiredDescription
accessKeyIdstringYesYour AWS Access Key ID
secretAccessKeystringYesYour AWS Secret Access Key
regionstringYesAWS region (e.g., us-east-1)
bucketNamestringYesS3 bucket name (e.g., my-bucket)
keysjsonYesArray of object keys to delete (e.g., ["a.txt", "folder/b.txt"]). Max 1000.
quietbooleanNoReturn only deletion errors, omitting successfully deleted keys

Output

ParameterTypeDescription
deletedarrayObjects that were successfully deleted
↳ keystringDeleted object key
↳ versionIdstringVersion ID of the deleted object
↳ deleteMarkerbooleanWhether a delete marker was created
errorsarrayObjects that failed to delete
↳ keystringObject key that failed
↳ codestringError code
↳ messagestringError message
metadataobjectBatch deletion summary including counts
PreviousRootlyNextSalesforce

On this page

Usage Instructions
Actions
s3_put_object
Input
Output
s3_get_object
Input
Output
s3_list_objects
Input
Output
s3_delete_object
Input
Output
s3_copy_object
Input
Output
s3_list_buckets
Input
Output
s3_head_object
Input
Output
s3_create_bucket
Input
Output
s3_delete_bucket
Input
Output
s3_presigned_url
Input
Output
s3_delete_objects
Input
Output