# AWS S3 - Nœud de workflow | Docs - nodulz

Source: https://nodulz.com/fr/docs/nodes/aws_s3

Language: fr

Buckets, fichiers et dossiers sur Amazon S3

## Utilisation et spécificités

Les dossiers sont des préfixes d’objets, pas des répertoires classiques. Configurez bucket et key selon l’opération. delete_folder supprime les objets du préfixe ; une URL présignée donne un accès temporaire.

Type technique : `aws_s3`. Runtime : `nodulz`.

## Identifiants et prérequis

- [Créer et configurer l’identifiant : aws](/docs/credentials/aws)

Créez l’identifiant dans la rubrique Identifiants de votre instance nodulz, puis sélectionnez-le dans le nœud. Les identifiants disponibles dépendent du propriétaire et du partage. Consultez le [guide des identifiants](/docs/credentials) pour les accès et la rotation.

## Paramètres

Les noms ci-dessous correspondent aux clés techniques. Les valeurs par défaut ne constituent pas une configuration prête à exécuter : renseignez les champs requis par votre opération. Les chemins contenant [] décrivent les éléments d’une liste ; certains champs dépendent du mode sélectionné.

| Paramètre | Type | Par défaut | Valeurs / limites |
| --- | --- | --- | --- |
| `credentialId` | `string` | - | - |
| `serviceInstanceId` | `string` | - | - |
| `connectionSource` | `enum` | `"credential"` | `credential`, `service` |
| `operation` | `enum` | `"upload_file"` | `create_bucket`, `delete_bucket`, `list_buckets`, `search_bucket`, `copy_file`, `delete_file`, `download_file`, `presign_url`, `list_files`, `upload_file`, `create_folder`, `delete_folder`, `list_folders` |
| `bucket` | `string` | `""` | - |
| `key` | `string` | `""` | - |
| `sourceKey` | `string` | `""` | - |
| `destKey` | `string` | `""` | - |
| `prefix` | `string` | `""` | - |
| `content` | `string` | `""` | - |
| `encoding` | `enum` | `"base64"` | `utf8`, `base64` |
| `contentType` | `string` | `""` | - |
| `metadata` | `string` | `""` | - |
| `maxKeys` | `number` | `100` | -; ≥ 1, ≤ 1000 |
| `searchName` | `string` | `""` | - |

## Aide de configuration

| Réglage | Rôle et conseils |
| --- | --- |
| `credentialId`<br>Credential stockage | Clés d’accès et endpoint sont gérés sur la page Credentials. |
| `searchName`<br>Nom recherché | Nom exact ou fragment pour la recherche de bucket. |
| `bucket`<br>Bucket | Nom du bucket (minuscules). Expressions de workflow acceptées. |
| `key`<br>Clé objet | Chemin de l’objet dans le bucket (ex. dossier/fichier.txt). |
| `sourceKey`<br>Clé source | Clé de l’objet à copier. |
| `destKey`<br>Clé destination | Clé cible de la copie. |
| `prefix`<br>Préfixe | Préfixe pour lister ou supprimer un arborescence. |
| `encoding`<br>Encodage | Interprétation du contenu avant upload. |
| `content`<br>Contenu | Corps du fichier (UTF-8 ou base64 selon l’encodage). |
| `contentType`<br>Type de contenu | Type MIME optionnel (ex. application/pdf). |
| `metadata`<br>Métadonnées (JSON) | Objet JSON de métadonnées utilisateur (valeurs string uniquement). |
| `maxKeys`<br>Clés max | Nombre max d’objets par liste (1–1000). |

## Configuration initiale

Exemple de configuration initiale du catalogue, à adapter avant exécution. Les secrets doivent rester dans les identifiants.

```json
{
  "connectionSource": "credential",
  "operation": "upload_file",
  "bucket": "",
  "key": "",
  "sourceKey": "",
  "destKey": "",
  "prefix": "",
  "content": "",
  "encoding": "base64",
  "contentType": "",
  "metadata": "",
  "maxKeys": 100,
  "searchName": ""
}
```

## Vérification

Testez le nœud avec des données représentatives. Contrôlez sa sortie dans l’inspecteur et les logs, puis utilisez le mapping de l’éditeur pour les champs des nœuds suivants. Un test de déclencheur avec payload simulé ne valide pas la livraison du service externe.

Voir aussi : [Expressions et données](/docs/expressions), [Exécutions](/docs/executions), [Catalogue des nœuds](/docs/nodes).

## Pour aller plus loin

- [Fonctionnalités - nodulz](https://nodulz.com/fr/product/overview)
- [Catalogue des nœuds - nodulz](https://nodulz.com/fr/product/catalog)
- [Serveur MCP - nodulz](https://nodulz.com/fr/product/mcp)
- [Tarifs - nodulz](https://nodulz.com/fr/pricing)
- [Cas d’usage et automatisations - nodulz](https://nodulz.com/fr/use-cases)
- [Choisissez ce que vos workflows peuvent faire. - nodulz](https://nodulz.com/fr/compare)
- [Documentation - nodulz](https://nodulz.com/fr/docs)