s3cmd

s3cmd est un outil développé en Python qui permet de gérer des buckets de storage objet avec des commandes de type Unix.

Le 16 janvier 2025, Amazon Web Services (AWS) a introduit de nouveaux algorithmes de protection de l’intégrité par défaut lors du chargement et du téléchargement de données à l’aide de l’API S3. Pour en savoir plus, voir Avertissement sur la compatibilité des SDK et de la CLI AWS.

Installation

Si Python est déjà installé sur votre machine, s3cmd est disponible via l’utilitaire pip.

Pour installer s3cmd, lancez la commande suivante :

$ pip3 install s3cmd

Configuration

Dans cet exemple, nous configurons s3cmd pour le service OUTSCALE Object Storage (OOS), sur la Région eu-west-2. Pour en savoir plus, voir À propos d’OOS.

Lancez la commande suivante :
```
$ s3cmd --configure
```
Spécifiez au moins les réglages suivants :
- Votre access key
- Votre secret key
- Votre Région
- S3 Endpoint : oos.eu-west-2.outscale.com
- DNS-style bucket+hostname : %(bucket)s.oos.eu-west-2.outscale.com
Dans votre répertoire home, ouvrez le fichier .s3cfg et modifier l’entrée website_endpoint comme suit :
~/.s3cfg
```
website_endpoint = https://%(bucket)s.oos-website-%(location)s.oos.eu-west-2.outscale.com/
```

Exemples

Créer un bucket :
```
$ s3cmd mb s3://MY_BUCKET
```
Lister vos buckets :
```
$ s3cmd ls
```
Déposer un objet dans un bucket :
```
$ s3cmd put OBJECT s3://MY_BUCKET
```
Vous pouvez définir les droits comme publics lorsque vous ajoutez un objet à votre bucket avec le paramètre suivant :

--acl-public

Copier un objet :

$ s3cmd cp s3://MY_BUCKET/OBJECT_TO_COPY s3://MY_BUCKET_FOR_THE_COPY

Lister le contenu d’un bucket :
```
$ s3cmd ls s3://my_bucket
```

Télécharger un objet depuis un bucket :

$ s3cmd get s3://MY_BUCKET/OBJECT NEW_NAME_FOR_THE_DOWNLOADED_OBJECT

Supprimer un objet :
```
$ s3cmd del s3://my_bucket/bar
```
Signer une URL OOS pour fournir un accès public limité, avec date d’expiration :
```
$ s3cmd signurl s3://my_bucket/my_file.png <expiry_in_epoch>
```

Autoriser un objet pour une semaine :

Allow file for 1 week

$ s3cmd signurl s3://my_bucket/my_file.png $(echo "`date +%s` + 3600 * 24 * 7" | bc)

Supprimer un bucket :
```
$ s3cmd rb s3://MY_BUCKET
```

Pages connexes

À propos d’OOS
Documentation officielle de s3cmd (en anglais)

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.