Dernière mise à jour le 27/09/2022
Objectif
Ce guide a pour objectif de vous familiariser avec la gestion de vos conteneurs / objets.
Prérequis
- Un projet Public Cloud dans votre compte OVHcloud
- Être connecté à votre espace client OVHcloud
- Avoir créé un utilisateur S3
En pratique
Utilisation de AWS CLI
Installation
Entrez la commande suivante :
user@host:~$ pip3 install awscli awscli-plugin-endpoint
awscli-plugin-endpointest optionel- Installez le package
groffsi vous souhaitez utiliser l'aide en ligne de commande.
Collecter les informations d'identification
- Vous aurez besoin de l'Access key et de la Secret key de votre utilisateur. Ces informations sont accessibles depuis l'onglet
Utilisateurs S3dans votre espace client. - Vous aurez également besoin de votre url_endpoint. Si vous avez déjà créé votre bucket, cette information est accessible depuis l'onglet
Mes conteneurspuis dans les détails du votre bucket. En cas de besoin, suivez ce guide.
Configuration
Configurez le client aws comme suit :
user@host:~$ cat ~/.aws/credentials
[default]
aws_access_key_id = <access_key>
aws_secret_access_key = <secret_key>
user@host:~$ cat ~/.aws/config
# If you have not installed awscli-plugin-endpoint, delete the next two lines
[plugins]
endpoint = awscli_plugin_endpoint
[profile default]
region = <region_in_lowercase>
s3 =
endpoint_url = <url_endpoint>
signature_version = s3v4
s3api =
endpoint_url = <url_endpoint>
Vous pouvez aussi utiliser la configuration interactive en exécutant la commande suivante :
aws --configure
Voici les valeurs de configuration que vous pouvez définir spécifiquement :
| Variable | Type | Valeur | Définition |
|---|---|---|---|
| max_concurrent_requests | Integer | Défaut : 10 | Le nombre maximum de requêtes simultanées. |
| max_queue_size | Integer | Défaut : 1000 | Le nombre maximal de tâches dans la file d'attente des tâches. |
| multipart_threshold | Integer String |
Défaut : 8MB | Le seuil de taille que l'interface CLI utilise pour les transferts multipart de fichiers individuels. |
| multipart_chunksize | Integer String |
Défaut : 8MB Minimum for uploads: 5MB |
Lors de l'utilisation de transferts multipart, il s'agit de la taille de morceau que l'interface CLI utilise pour les transferts multipart de fichiers individuels. |
| max_bandwidth | Integer | Défaut : None | La bande passante maximale qui sera consommée pour le chargement et le téléchargement de données vers et depuis vos buckets. |
| verify_ssl | Boolean | Défaut : true | Active / Désactive la vérification des certificats SSL |
Utilisation
Si vous n'avez pas installé awscli-plugin-endpoint, vous devez ajouter --endpoint-url https://s3.<region_in_lowercase>.perf.cloud.ovh.net à la ligne de commande.
Si vous avez défini plusieurs profils, ajoutez --profile <profile> à la ligne de commande
Créer un bucket
aws s3 mb s3://<bucket_name>
aws --endpoint-url https://s3.<region_in_lowercase>.perf.cloud.ovh.net --profile default s3 mb s3://<bucket_name>
Lister vos buckets
aws s3 ls
Téléverser vos fichiers en tant qu'objets dans votre bucket
aws s3 cp /datas/test1 s3://<bucket_name>
Par défaut, les objets prennent le nom des fichiers mais ils peuvent être renommés
aws s3 cp /datas/test1 s3://<bucket_name>/other-filename
Télécharger un objet depuis un bucket
aws s3 cp s3://<bucket_name>/test1 .
Télécharger un objet d'un bucket vers un autre bucket
aws s3 cp s3://<bucket_name>/test1 s3://<bucket_name_2>
Télécharger ou téléverser un bucket entier vers l'hôte/bucket
aws s3 cp s3://<bucket_name> . --recursive
aws s3 cp s3://<bucket_name> s3://<bucket_name_2> --recursive
Synchronisation des buckets
aws s3 sync . s3://<bucket_name>
aws s3 sync s3://<bucket_name> s3://<bucket_name_2>
Supprimer des objets et des buckets
# Suppression d'un objet
aws s3 rm s3://<bucket_name>/test1
# Suppression de tous les objets d'un bucket
aws s3 rm s3://<bucket_name> --recursive
# Suppression d'une zone de stockage. Pour supprimer un bucket, il doit être vide.
aws s3 rb s3://<bucket_name>
# Si le bucket n'est pas supprimé, vous pouvez utiliser la même commande avec l'option --force.
# Cette commande supprime tous les objets du bucket, puis supprime le bucket.
aws s3 rb s3://<bucket_name> --force
Définir des tags sur un bucket
aws s3api put-bucket-tagging --bucket <bucket_name> --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>
{
"TagSet": [
{
"Value": "myKeyValue",
"Key": "myKey"
}
]
}
Supprimer les tags sur un bucket
aws s3api s3api delete-bucket-tagging --bucket <bucket_name>
Définir des tags sur un objet
aws s3api put-object-tagging --bucket <bucket_name> --key test1 --tagging 'TagSet=[{Key=myKey,Value=myKeyValue}]'
aws s3api get-bucket-tagging --bucket <bucket_name>
{
"TagSet": [
{
"Value": "myKeyValue",
"Key": "myKey"
}
]
}
Supprimer les tags sur un objet
aws s3api s3api delete-object-tagging --bucket <bucket_name> --key test1
Aller plus loin
Échangez avec notre communauté d'utilisateurs sur https://community.ovh.com/.
Cette documentation vous a-t-elle été utile ?
N’hésitez pas à nous proposer des suggestions d’amélioration afin de faire évoluer cette documentation.
Images, contenu, structure… N’hésitez pas à nous dire pourquoi afin de la faire évoluer ensemble !
Vos demandes d’assistance ne seront pas traitées par ce formulaire. Pour cela, utilisez le formulaire "Créer un ticket" .
Merci beaucoup pour votre aide ! Vos retours seront étudiés au plus vite par nos équipes..