---
title: S3
description: Téléverser, télécharger, lister et gérer les fichiers S3
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="s3"
  color="linear-gradient(45deg, #1B660F 0%, #6CAE3E 100%)"
/>

{/* MANUAL-CONTENT-START:intro */}
[Amazon S3](https://aws.amazon.com/s3/) est un service de stockage cloud hautement évolutif, sécurisé et durable fourni par Amazon Web Services. Il est conçu pour stocker et récupérer n'importe quelle quantité de données depuis n'importe où sur le web, ce qui en fait l'une des solutions de stockage cloud les plus utilisées par les entreprises de toutes tailles.

Avec Amazon S3, vous pouvez :

- **Stocker des données illimitées** : télécharger des fichiers de toute taille et de tout type avec une capacité de stockage pratiquement illimitée
- **Accéder de n'importe où** : récupérer vos fichiers depuis n'importe où dans le monde avec un accès à faible latence
- **Assurer la durabilité des données** : bénéficier d'une durabilité de 99,999999999 % (11 neuf) avec réplication automatique des données
- **Contrôler l'accès** : gérer les permissions et les contrôles d'accès avec des politiques de sécurité précises
- **Évoluer automatiquement** : gérer des charges de travail variables sans intervention manuelle ni planification de capacité
- **S'intégrer facilement** : se connecter avec d'autres services AWS et applications tierces facilement
- **Optimiser les coûts** : choisir parmi plusieurs classes de stockage pour optimiser les coûts en fonction des modèles d'accès

Dans Sim, l'intégration S3 permet à vos agents de récupérer et d'accéder aux fichiers stockés dans vos buckets Amazon S3 en utilisant des URL présignées sécurisées. Cela permet des scénarios d'automatisation puissants tels que le traitement de documents, l'analyse de données stockées, la récupération de fichiers de configuration et l'accès à du contenu multimédia dans le cadre de vos flux de travail. Vos agents peuvent récupérer des fichiers depuis S3 en toute sécurité sans exposer vos identifiants AWS, ce qui facilite l'incorporation d'actifs stockés dans le cloud dans vos processus d'automatisation. Cette intégration comble le fossé entre votre stockage cloud et vos flux de travail IA, permettant un accès transparent à vos données stockées tout en maintenant les meilleures pratiques de sécurité grâce aux mécanismes d'authentification robustes d'AWS.
{/* MANUAL-CONTENT-END */}

## Instructions d'utilisation

Intégrez S3 dans le flux de travail. Téléversez des fichiers, téléchargez des objets, listez le contenu des buckets, supprimez des objets et copiez des objets entre buckets. Nécessite une clé d'accès AWS et une clé d'accès secrète AWS.

## Outils

### `s3_put_object`

Téléverser un fichier vers un bucket AWS S3

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `accessKeyId` | string | Oui | Votre ID de clé d'accès AWS |
| `secretAccessKey` | string | Oui | Votre clé d'accès secrète AWS |
| `region` | string | Oui | Région AWS (ex. : us-east-1) |
| `bucketName` | string | Oui | Nom du bucket S3 |
| `objectKey` | string | Oui | Clé/chemin de l'objet dans S3 (ex. : dossier/nomfichier.ext) |
| `file` | file | Non | Fichier à téléverser |
| `content` | string | Non | Contenu textuel à téléverser (alternative au fichier) |
| `contentType` | string | Non | En-tête Content-Type (détecté automatiquement à partir du fichier si non fourni) |
| `acl` | string | Non | Liste de contrôle d'accès (ex. : private, public-read) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `url` | string | URL de l'objet S3 téléversé |
| `metadata` | object | Métadonnées de téléversement incluant ETag et emplacement |

### `s3_get_object`

Récupérer un objet depuis un bucket AWS S3

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | -------- | ----------- |
| `accessKeyId` | string | Oui | Votre ID de clé d'accès AWS |
| `secretAccessKey` | string | Oui | Votre clé d'accès secrète AWS |
| `s3Uri` | string | Oui | URL de l'objet S3 |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `url` | chaîne | URL présignée pour télécharger l'objet S3 |
| `metadata` | objet | Métadonnées du fichier incluant le type, la taille, le nom et la date de dernière modification |

### `s3_list_objects`

Lister les objets dans un bucket AWS S3

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `bucketName` | chaîne | Oui | Nom du bucket S3 |
| `prefix` | chaîne | Non | Préfixe pour filtrer les objets (par ex., dossier/) |
| `maxKeys` | nombre | Non | Nombre maximum d'objets à retourner (par défaut : 1000) |
| `continuationToken` | chaîne | Non | Jeton pour la pagination |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `objects` | tableau | Liste des objets S3 |

### `s3_delete_object`

Supprimer un objet d'un bucket AWS S3

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `bucketName` | chaîne | Oui | Nom du bucket S3 |
| `objectKey` | chaîne | Oui | Clé/chemin de l'objet à supprimer |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `deleted` | booléen | Indique si l'objet a été supprimé avec succès |
| `metadata` | objet | Métadonnées de suppression |

### `s3_copy_object`

Copier un objet au sein d'un même bucket AWS S3 ou entre différents buckets

#### Entrée

| Paramètre | Type | Obligatoire | Description |
| --------- | ---- | ---------- | ----------- |
| `accessKeyId` | chaîne | Oui | Votre ID de clé d'accès AWS |
| `secretAccessKey` | chaîne | Oui | Votre clé d'accès secrète AWS |
| `region` | chaîne | Oui | Région AWS (par ex., us-east-1) |
| `sourceBucket` | chaîne | Oui | Nom du bucket source |
| `sourceKey` | chaîne | Oui | Clé/chemin de l'objet source |
| `destinationBucket` | chaîne | Oui | Nom du bucket de destination |
| `destinationKey` | chaîne | Oui | Clé/chemin de l'objet de destination |
| `acl` | chaîne | Non | Liste de contrôle d'accès pour l'objet copié (par ex., private, public-read) |

#### Sortie

| Paramètre | Type | Description |
| --------- | ---- | ----------- |
| `url` | chaîne | URL de l'objet S3 copié |
| `metadata` | objet | Métadonnées de l'opération de copie |
