# Le stockage AOS

> Arkya Object Storage te livre un bucket S3 compatible, hébergé en Europe, facturé à la seconde. Aucun frais de sortie. Interopérable avec les SDK AWS, boto3, mc et rclone.

Source : https://docs.arkya.gg/stockage

## Ce que tu reçois

Un bucket S3 compatible, isolé, sous un endpoint unique `s3.arkya.gg`. Tu paies :

- le **stockage effectif** par Go-mois (facturé à la seconde)
- les **requêtes** (Class A et Class B au tarif S3 standard)
- **pas de frais d'egress** — le trafic sortant est gratuit, quelle que soit la destination.

Le bucket se range dans un projet et apparaît sous la gamme `AOS`.

## Créer un bucket

Depuis l'espace client : **Ressources** → **Commander du stockage** → nom + offre → **Créer le bucket**.

Depuis le CLI :

```bash
ark bucket create "Mes sauvegardes 2026"
```

La commande renvoie l'endpoint, la région et le slug à utiliser dans tes SDK. Si ce nom est déjà utilisé sur ton compte, un court suffixe est ajouté au slug (par exemple `mes-sauvegardes-2026-a4f1`) et un nouveau bucket est créé.

## Émettre une clé d'accès

Chaque bucket peut avoir plusieurs couples access key / secret. Le secret n'est affiché **qu'une seule fois** à la création — note-le immédiatement.

Depuis le CLI :

```bash
ark bucket keys mes-sauvegardes-2026 create --label rclone-backup
```

Sortie :

```
AWS_ACCESS_KEY_ID      ARKYA...
AWS_SECRET_ACCESS_KEY  ...
```

Pour une clé en lecture seule, ajoute `--readonly`.

## Utiliser le bucket

Le bucket s'utilise comme n'importe quel bucket S3. Trois paramètres à poser dans ton client :

| Paramètre  | Valeur                 |
| ---------- | ---------------------- |
| Endpoint   | `https://s3.arkya.gg`  |
| Région     | `auto`                 |
| Bucket     | ton slug (ex. `mes-sauvegardes-2026`) |

Voir [Configuration des SDK](https://docs.arkya.gg/stockage/configuration) pour AWS CLI, boto3, mc et rclone.

## Révoquer une clé

```bash
ark bucket keys mes-sauvegardes-2026 rm ARKYA...
```

Une clé révoquée est refusée instantanément par le point d'entrée `s3.arkya.gg` (propagation sous 60 s).

## Supprimer un bucket

Le bucket doit être **vide** avant d'être supprimé (supprime les objets avec `aws s3 rm --recursive` ou l'espace client).

```bash
ark bucket rm mes-sauvegardes-2026
```

## Juridiction

Par défaut, tes données sont hébergées dans l'Union européenne (`jurisdiction: "EU"`). Cette information est verrouillée à la création — pour changer de juridiction, il faut créer un nouveau bucket et copier les objets.