# Connecter un service à un bucket

> Reliez les variables d'un service aux identifiants d'un bucket, puis lisez et écrivez des fichiers avec le SDK S3 d'AWS.

Votre code accède au bucket par l'API S3. Il lui faut cinq valeurs : le point d'accès, la région, le nom du bucket, l'identifiant de la clé d'accès et sa clé secrète. Ce guide les relie aux variables de votre service, puis montre un envoi et une lecture de fichier en TypeScript.

## Avant de commencer

- Le bucket est **Prêt** dans l'environnement : voir [Provisionner un bucket](/v1.0/stockage/provisionner-un-bucket).
- La définition du service déclare les variables attendues, par exemple `S3_ENDPOINT`, `S3_REGION`, `S3_BUCKET`, `S3_ACCESS_KEY_ID` et `S3_SECRET_ACCESS_KEY`. Voir [Variables et secrets](/v1.0/variables-et-secrets).
- Le service est déployé dans l'environnement.

## Relier les variables

::::steps
### Ouvrir la configuration du service

1. Dans l'environnement, ouvrez l'onglet **Services** et cliquez sur le service.
2. Cliquez sur l'onglet **Configuration du service (N)**.

### Choisir les entrées du bucket

Pour chaque variable, ouvrez la liste **Choisir une valeur...** et sélectionnez l'entrée correspondante du bucket, ici d'identifiant court `docs` :

| Variable du service | Entrée à choisir |
|---|---|
| `S3_ENDPOINT` | `DOCS_ENDPOINT` |
| `S3_REGION` | `DOCS_REGION` |
| `S3_BUCKET` | `DOCS_BUCKET` |
| `S3_ACCESS_KEY_ID` | `DOCS_ACCESS_KEY_ID` |
| `S3_SECRET_ACCESS_KEY` | `DOCS_SECRET_ACCESS_KEY` |

### Enregistrer

Cliquez sur **Enregistrer la configuration**.

Le message **Configuration enregistrée** s'affiche et le service est redéployé.
::::

Répétez la liaison dans chaque environnement : chacun a son propre bucket et ses propres identifiants.

## Lire et écrire des fichiers

Installez le client S3 du SDK AWS :

```bash
npm install @aws-sdk/client-s3
```

Puis, dans votre service :

```typescript
import { S3Client, PutObjectCommand, ListObjectsV2Command } from "@aws-sdk/client-s3";

const s3 = new S3Client({
  endpoint: process.env.S3_ENDPOINT,
  region: process.env.S3_REGION,
  credentials: {
    accessKeyId: process.env.S3_ACCESS_KEY_ID!,
    secretAccessKey: process.env.S3_SECRET_ACCESS_KEY!,
  },
});

const Bucket = process.env.S3_BUCKET!;

await s3.send(
  new PutObjectCommand({
    Bucket,
    Key: "factures/2026/facture-0001.pdf",
    Body: Buffer.from("%PDF-1.7 exemple"),
    ContentType: "application/pdf",
  }),
);

const listing = await s3.send(new ListObjectsV2Command({ Bucket, Prefix: "factures/" }));
console.log(listing.Contents?.map((o) => ({ key: o.Key, size: o.Size })));
```

Résultat attendu dans les logs du service :

```text
[ { key: 'factures/2026/facture-0001.pdf', size: 16 } ]
```

:::note
Le compte d'accès n'a de droits que sur ce bucket. Une commande qui vise un autre bucket, liste les buckets du projet ou supprime le bucket est refusée avec une erreur `AccessDenied`.
:::

## Vérifier le résultat

1. Dans l'onglet **Storage** de l'environnement, cliquez sur **Explorer** sur la ligne du bucket.
2. Ouvrez le dossier `factures/`, puis `2026/` : le fichier `facture-0001.pdf` apparaît avec sa taille.

## Voir aussi

- [Explorer un bucket](/v1.0/stockage/explorer-un-bucket)
- [Fonctionnement d'un bucket](/v1.0/stockage/fonctionnement-d-un-bucket)
- [Antivirus](/v1.0/antivirus)
