> ## Documentation Index
> Fetch the complete documentation index at: https://www.octoparse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integrazione Amazon S3

> Carica i file esportati da Octoparse in Amazon S3: autorizzazioni IAM, Access Key, nomi dei file e sovrascrittura.

Carica i dati estratti direttamente in un bucket Amazon S3. Sono supportati diversi formati di file.

## Prerequisiti

* Piano Professionale Octoparse o superiore
* Account AWS con il bucket S3 di destinazione già creato
* Utente IAM con autorizzazione `s3:PutObject` sul bucket

***

## Configurare le autorizzazioni IAM

Octoparse usa una Access Key per scrivere su S3: crea un utente IAM dedicato e concedigli soltanto le autorizzazioni minime necessarie.

Esempio di policy con autorizzazioni minime:

```json theme={null}
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": ["s3:PutObject"],
      "Resource": "arn:aws:s3:::your-bucket-name/*"
    }
  ]
}
```

Dopo aver creato l'utente IAM, genera una Access Key in **Credenziali di sicurezza** e salva Access Key ID e Secret Access Key.

***

## Configurare l'esportazione

Compila le impostazioni nell'ordine seguente:

**Nome configurazione**

Assegna un nome alla configurazione per poterla riutilizzare. Dal menu puoi scegliere una configurazione esistente o digitare un nuovo nome per crearne una.

**Dettagli di connessione**

| Campo | Descrizione |
| - | - |
| Autenticazione | Metodo di autenticazione; al momento soltanto Access key |
| Access key ID | Access Key ID dell'utente IAM |
| Secret access key | Secret Access Key dell'utente IAM |
| Area di servizio | Regione AWS, selezionata dal menu |
| Bucket | Nome del bucket di destinazione |

> **Sicurezza:** la Access Key può scrivere nel bucket. Non condividerla, non inserirla in un repository di codice e ruotala periodicamente.

**Esporta dati come**

Scegli il formato del file: Excel, CSV, HTML, JSON o XML.

**Impostazioni del nome file**

| Opzione | Descrizione |
| - | - |
| Uguale al nome dell'attività | Il file usa il nome dell'attività; le esportazioni ripetute lo sovrascrivono |
| Aggiungi timestamp al nome dell'attività | Ogni esportazione crea un nuovo file e conserva la cronologia |
| Usa nome personalizzato | Specifica manualmente il nome del file |

**Quando esiste già un file con lo stesso nome**

| Opzione | Descrizione |
| - | - |
| Crea nuovo file con timestamp corrente | Conserva l'originale e aggiunge un timestamp al nuovo file |
| Sostituisci il file esistente | Sovrascrive l'originale |
| Aggiungi nuovi dati al file esistente | Accoda i dati al file esistente, solo CSV o Excel |

Fai clic su **Conferma** per salvare la configurazione e avviare l'esportazione.

***

## Errori comuni

| Errore | Causa | Soluzione |
| - | - | - |
| `InvalidKeySecret` | Access Key ID o Secret Access Key errata | Verifica nuovamente le credenziali |
| `NoSuchBucket` | Nome bucket errato o inesistente | Verifica il nome del bucket |
| `PermissionDenied` | Autorizzazioni IAM insufficienti | Controlla che la policy includa `s3:PutObject` |
| `IllegalLocation` | Regione del bucket diversa dall'Area di servizio | Seleziona la regione effettiva del bucket |
| `FormatError` | Configurazione non valida | Verifica che ogni campo sia compilato |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.