🇮🇹 IT

☁️ Amazon S3

Legge e scrive oggetti in Amazon S3 o qualsiasi servizio di storage compatibile S3 (MinIO, Cloudflare R2, Backblaze B2). Supporta il download del contenuto degli oggetti, il caricamento di nuovi oggetti e la generazione di URL pre-firmati per l'accesso temporaneo.

Categoria: Operazioni su File · Identificatore tipo: amazon_s3

Panoramica

Il nodo Amazon S3 offre ai workflow Flusso l'accesso all'object storage AWS S3 e a qualsiasi servizio di storage che espone un'API compatibile S3. Gli oggetti (file) in S3 sono identificati da una chiave — il percorso completo dell'oggetto all'interno del bucket, ad esempio reports/2025/january.csv.

Oltre a leggere e scrivere oggetti, questo nodo può generare URL pre-firmati — link di download a tempo limitato che permettono a utenti esterni di accedere a un oggetto privato senza richiedere credenziali AWS. Questo è utile per condividere file generati tramite email o webhook senza rendere pubblico il bucket.

Configurazione

Campo	Stato	Descrizione
Access Key ID	Obbligatorio	Access key ID AWS o equivalente per servizi compatibili S3.
Secret Access Key	Obbligatorio	Secret access key AWS.
Region	Obbligatorio	Regione AWS, ad esempio `us-east-1`. Per servizi compatibili S3, inserisci la regione appropriata o usa `auto`.
Bucket	Obbligatorio	Il nome del bucket S3.
Operation	Obbligatorio	`get` — scarica il contenuto dell'oggetto. `put` — carica un oggetto. `presign` — genera un URL pre-firmato per il download.
Key	Obbligatorio	La chiave dell'oggetto (percorso all'interno del bucket), ad esempio `reports/2025/january.csv`. Supporta riferimenti `{{ variable }}`.
Body	Obbligatorio per put	Contenuto da caricare. Supporta riferimenti `{{ variable }}`.
Content Type	Opzionale per put	Tipo MIME dell'oggetto caricato, ad esempio `application/json`. Predefinito: `text/plain`.
Expires In	Opzionale per presign	Scadenza dell'URL pre-firmato in secondi. Predefinito: `3600` (1 ora).
Endpoint URL	Opzionale	Endpoint personalizzato per servizi compatibili S3, ad esempio `https://s3.eu-central-1.amazonaws.com`. Lascia vuoto per usare l'endpoint AWS standard.

Dati di Output

I campi di output disponibili dipendono dall'operazione selezionata.

Campo	Tipo	Descrizione
`content`	string	Contenuto dell'oggetto (modalità get).
`url`	string	URL pre-firmato (modalità presign).
`key`	string	Chiave dell'oggetto.
`bucket`	string	Nome del bucket.
`size`	number	Dimensione dell'oggetto in byte (modalità get).
`etag`	string	ETag dell'oggetto caricato (modalità put).

Esempio di Utilizzo

Un nodo Agent genera un report JSON.
Un nodo Amazon S3 con Operation: put carica il JSON in reports/{{ trigger.output.run_id }}.json.
Un secondo nodo Amazon S3 con Operation: presign genera un URL di download valido un'ora per la stessa chiave.
Un nodo Email Notification invia l'URL pre-firmato a un destinatario in modo che possa scaricare il report senza bisogno di accesso AWS.

Suggerimenti & Note

S3 non ha vere cartelle — il carattere / nelle chiavi degli oggetti è una convenzione di denominazione. Qualsiasi stringa può essere usata come prefisso di chiave per organizzare logicamente gli oggetti.
Gli URL pre-firmati scadono dopo il periodo configurato in Expires In. Generali il più vicino possibile al momento dell'utilizzo, oppure aumenta la scadenza per link a lunga durata.
Per servizi compatibili S3 come MinIO o Cloudflare R2, imposta l'Endpoint URL sull'endpoint API del servizio e usa auto come regione se il servizio lo richiede.
L'etag restituito da un'operazione put è un hash MD5 del contenuto caricato, utile per verificare l'integrità negli step successivi.
Conserva la Secret Access Key come segreto del workflow (tramite il pannello Credenziali) anziché incorporarla come testo in chiaro nella configurazione.

Nodi Correlati

Local File — storage locale sul server senza credenziali cloud.
Google Drive — storage cloud Google con funzionalità di condivisione Drive.
Dropbox — storage cloud Dropbox.
HTTP Request — effettua chiamate HTTP arbitrarie, utile per la consegna di URL pre-firmati.